Die Jira-Integration fördert die Zusammenarbeit zwischen Produktteams und dem Supportteam. Version 4 der Jira-Integration unterstützt sowohl Atlassian Jira Cloud (OnDemand) als auch Jira Data Center und Jira Server (OnPremise) ab Version 7x.
Im vorliegenden Beitrag behandelte Themen:
- Installationsanforderungen
- Installieren und Konfigurieren der Integration
- Einschränken des Zugriffs auf die App „Jira Cloud“
- Hinzufügen von Feldern zur Jira-App in Zendesk Support
- Verwenden der Option zum Erstellen eines dedizierten Integrationsbenutzers
- Anweisungen speziell für Jira Server
- Neuinstallieren der Integration
Verwandte Themen:
Installationsanforderungen
Zur Einrichtung der Integration sind sowohl in Jira als auch in Zendesk Support Administratorrechte erforderlich.
Darüber hinaus müssen Sie die folgenden Anforderungen erfüllen:
- Sie gehören den Gruppen jira-administrators und jira-software-users an.
- Sie werden nicht durch andere Berechtigungsschemas daran gehindert, Projekte zu erstellen oder zu aktualisieren.
- Das Feld reporter erscheint auf dem Bildschirm Create Issue für die betreffenden Projekte.
- Sie verwenden das Jira Internal Directory als Ihr Benutzerverzeichnis.
-
Atlassian-Add-ons sind berechtigt, auf Ihre Jira-Projekte zuzugreifen. Dies ist die Standardeinstellung. Sie können die Einstellung auf der Seite Project Permissions des jeweiligen Jira-Projekts überprüfen. Die verschiedenen Projektaktionen sollten eine Projektrolle namens
Project Role (atlassian-addons-project-access)enthalten. -
Cookies von Dritten sind aktiviert. Falls Cookies von Dritten auf Ihrem System deaktiviert bleiben müssen, fügen Sie den Eintrag
jiraplugin.zendesk.comzur Liste der Inhaltsausnahmen hinzu.
Installieren und Konfigurieren der Integration
Zur Einrichtung der Integration müssen Sie in Ihrem Jira-Konto die Zendesk Support-App für Jira aus dem Atlassian Marketplace installieren und dann konfigurieren.
So installieren und konfigurieren Sie die Integration
- Klicken Sie in Jira in der oberen Navigationsleiste auf Apps und dann auf Find new apps.
- Suchen Sie auf der Seite Marketplace apps nach Zendesk.
- Klicken Sie in den Suchergebnissen auf den Eintrag Zendesk Support for Jira.
- Klicken Sie auf Get app.
- Klicken Sie auf Get it Now.
- Klicken Sie im Modalfenster, in dem die erfolgreiche Installation bestätigt wird, auf Configure.
- Geben Sie die Zendesk-Subdomäne ein. Das Kästchen Create a new dedicated Zendesk user for this integration ist standardmäßig aktiviert. Wir empfehlen die Verwendung dieser Option, damit alle Eskalationen von Jira zu Zendesk Support nicht von dem Administrator stammen müssen, der die Integration eingerichtet hat, sondern vom dedizierten Benutzer stammen können. Dabei wird in Ihrem Zendesk-Konto automatisch ein neuer Admin-Benutzer erstellt, der ausschließlich für die Jira-Integration verwendet wird. Weitere Informationen finden Sie unter Verwenden der Option zum Erstellen eines dedizierten Integrationsbenutzers.
- Klicken Sie auf Authenticate.
- In einer zweiten Browserseite werden Sie aufgefordert, sich bei Ihrem Zendesk-Konto anzumelden. Geben Sie Ihre Anmeldeinformationen ein. Die Seite wird geschlossen.
- Wählen Sie auf der Einstellungsseite der App die Details aus, die in verknüpften Jira-Vorgängen angezeigt werden sollen.
- Klicken Sie auf Speichern.
- Wenn Sie Jira Cloud verwenden, können Sie prüfen, ob die Integration funktioniert, indem Sie den Benutzer
add_on_zendesk_for_jiraauf der Jira-Administrationsseite zur Gruppejira-usershinzufügen.
Die Integration erstellt in Jira Cloud einen kostenlosen Admin-Benutzer namens „Zendesk for Jira“. Sie können den Avatar des Benutzers auf der Profilseite ändern.
Einschränken des Zugriffs auf die App „Jira Cloud“
Wenn Sie festlegen möchten, wer auf die App zugreifen kann (z. B. nur Administratoren oder Agenten), können Sie die entsprechende Einstellung in Zendesk ändern.
So schränken Sie den Zugriff auf die App „Jira Cloud“ ein.
- Klicken Sie in Zendesk Support auf das Symbol Admin (
), gehen Sie zu App > Verwalten und suchen Sie die App Jira Cloud. - Setzen Sie den Mauszeiger auf die App „Jira Cloud“. Klicken Sie im Dropdownmenü rechts neben dem App-Symbol auf Einstellungen ändern.
- Markieren Sie unter Installation das Kästchen Rollenbeschränkungen aktivieren?.
- Klicken Sie auf das Textfeld Rollenbeschränkungen und wählen Sie die Rollen aus, die die App nutzen dürfen.
- Klicken Sie auf Aktualisieren, um die Änderungen zu übernehmen.
So einfach ist es. Ihre Teams können jetzt über Zendesk und Jira zusammenarbeiten. Weitere Informationen finden Sie unter Verwenden der Zendesk Support-Integration für Jira.
Hinzufügen von Feldern zur Jira-App in Zendesk Support
Wenn Sie von einem Zendesk Support-Ticket aus einen Jira-Vorgang erstellen, werden Sie aufgefordert, Details zu diesem Vorgang im Formular Neuen Jira-Vorgang erstellen einzugeben.
- Projekt
- Vorgangstyp
- Melder
- Mitarbeiter
- Überblick
- Beschreibung
Diese Standardfelder können nicht entfernt werden. Sie können aber weitere vorhandene oder angepasste Felder aus Jira zum Formular hinzufügen.
Weitere Informationen finden Sie unter Specifying field behavior (Englisch) auf der Website von Atlassian.
Konfigurieren des Formulars zum Erstellen von Vorgängen
Sie können festlegen, welche Jira-Felder der Agent sieht, wenn er von Zendesk Support aus einen neuen Jira-Vorgang erstellt. Das ist eine erhebliche Verbesserung in Version 4 der Jira-App.
Diese Jira-Felder gelten jeweils für ein bestimmtes Jira-Projekt und einen bestimmten Vorgangstyp. Vorgangsfelder, die in Jira als erforderlich definiert sind, werden ungeachtet der Konfiguration in diesem Formular angezeigt.
Verwenden der Option zum Erstellen eines dedizierten Integrationsbenutzers
Wenn Sie die Option zum Erstellen eines dedizierten Integrationsbenutzers in Ihrem Zendesk Support-Konto wählen, wird automatisch ein neuer bestätigter Administrator (Jira Integration) zusammen mit einer E-Mail-Adresse (jira_integration_XXXXXX@jira.zendesk-integrations.com) erstellt. Dieses Benutzerkonto wird komplett von der Integration verwaltet und gesperrt, wenn die Integration entfernt wird.
- Für den dedizierten Integrationsbenutzer ist eine verfügbare Agentenlizenz erforderlich. Solange dieser Benutzer aktiv ist, kann die entsprechende Lizenz nicht von einem anderen Agenten in Anspruch genommen werden.
- Das Admin-Konto, das die Jira-Integration installiert hat, und der dedizierte Integrationsbenutzer müssen immer über Administratorrechte verfügen und aktiv sein, damit die Integration funktioniert. Wenn Sie das Admin-Konto oder den dedizierten Integrationsbenutzer sperren oder herabstufen, funktioniert die Integration nicht.
Der Integrationsservice kann nach Abschluss der Authentifizierung und Erstellung verwendet werden. Alle Kommentierungs- und Feldsynchronisationsaktionen werden im Namen des dedizierten Integrationsbenutzers durchgeführt.
Wenn Sie den dedizierten Integrationsbenutzer nicht mehr verwenden möchten, können Sie die Integration von Jira aus trennen. Nach der Trennung verwendet Jira den dedizierten Integrationsbenutzer nicht mehr. Der dedizierte Integrationsbenutzer wird in Ihrem Zendesk Support-Konto auf einen Endbenutzer herabgestuft und gesperrt. Wenn Sie das Plug-in deinstallieren, wird der Benutzer ebenfalls herabgestuft und gesperrt,
So trennen Sie den dedizierten Integrationsbenutzer
- Klicken Sie in Jira auf Jira settings und dann auf Apps > Manage apps.
- Klicken Sie auf Zendesk Support for Jira, um die App zu erweitern, und dann auf Configure.
- Klicken Sie auf Disconnect, um Ihre Subdomäne zu trennen.
- Geben Sie Ihre Subdomäne erneut ein und deaktivieren Sie die Option Create dedicated integration user.
- Klicken Sie auf Authenticate, um Ihre Subdomäne erneut zu authentifizieren.
Anweisungen speziell für Jira Server
- Legen Sie eine Zulassungsliste mit den folgenden Einträgen an, damit Zendesk eine Verbindung zu Ihrem Jira-Server herstellen kann:
- IP-Adressen für Ihr Zendesk-Konto. Unter Konfigurieren der Firewall zur Verwendung mit Zendesk erfahren Sie, wo Sie diese Adressen finden.
- IP-Adressbereich der Jira-Integration (Pod 19), siehe Abrufen von IP-Adressen für zusätzliche Zendesk-Produkte.
- Wir empfehlen dringend, die Kommunikation zwischen Jira und Zendesk insbesondere in Produktionsumgebungen mit SSL-Verschlüsselung zu schützen. Wenn SSL aktiviert ist, benötigen Sie einen vollen SSL-Zertifikatsstack von einer Zertifizierungsstelle. Selbstsignierte Zertifikate werden nicht unterstützt. Das Zwischenzertifikat wird in der Regel nicht auf dem Jira-Server installiert.
- Stellen Sie sicher, dass in Ihrem Netzwerk der richtige Port für den ein- und abgehenden Datenverkehr zwischen Zendesk und Jira geöffnet ist (je nach SSL-Einstellungen in der Regel
80/8080/443). - Beim Konfigurieren des Add-ons in Jira ist die „Jira Base URL“ möglicherweise eine andere URL als die, die Sie für den Zugriff auf Jira auf Ihrem privaten Server verwenden. Die „Jira Base URL“ muss eine öffentlich zugängliche Adresse sein, da Zendesk Support über diese URL Netzwerkanforderungen an Ihre Jira-Instanz sendet. Sie können diese öffentlich zugängliche Adresse über NAT oder Reverse Proxy mit der Adresse Ihres privaten Servers verbinden.
- Das Zendesk-Add-on in Jira muss mit Administratorrechten ausgeführt werden. Wir empfehlen, ein dediziertes Konto zu erstellen (siehe unten) und dieses zu den Gruppen
jira-administratorsundjira-software-usershinzuzufügen.Vollständiger Name: Zendesk for Jira
Benutzername: addon_zendesk
Neuinstallieren der Integration
- Der Benutzer der Integration wird geändert.
- Die mit Ihrem Zendesk Support-Konto verknüpfte Jira-Instanz wird geändert.
- Die mit Ihrem Jira-Konto verknüpfte Zendesk Support-Instanz wird geändert (einschließlich Sandboxen).
- Die Verbindung zwischen Zendesk und Jira wird nach einem Neustart des Jira-Servers oder nach dem Löschen des Plug-in-Cache wiederhergestellt.
Wenn Sie dasselbe Zendesk- und Jira-Konto erneut integrieren, bleiben die Daten zu den verknüpften Vorgängen erhalten.
So installieren Sie die Integration neu
- Klicken Sie in Jir auf Apps > Manage your apps.
- Klicken Sie im Akkordeon Zendesk Support for Jira auf Configure.
- Klicken Sie auf Disconnect.
- Kehren Sie zur Seite „Manage your apps” zurück und klicken Sie im Akkordeon Zendesk Support for Jira auf Uninstall.
- Schließen Sie den Einrichtungsvorgang ab. Weitere Informationen finden Sie unter Installing and configuring the integration.
0 Kommentare
Zu diesem Beitrag können keine Kommentare hinterlassen werden.