Erste Schritte mit der Jira-Integration

Die Einrichtung der Jira-Integration ist schnell und einfach. Dieses Dokument wird Sie durch die notwendigen Einrichtungsschritte und Konfigurationen führen, die es Ihrer gesamten Organisation ermöglichen, diese leistungsstarke Integration zu nutzen.

Verbindung mit Jira Cloud herstellen

Um zu beginnen, muss eine authentifizierte Verbindung zu Ihrer Jira-Instanz von einem axe-Kontoportal-Administrator hergestellt werden. Diese Verbindung wird in Ihrer gesamten Organisation genutzt, daher ist es wichtig, dass der **Benutzer, der die Verbindung herstellt, Zugang zu jedem Projekt hat, an das Sie Probleme senden möchten**.

1. Navigieren Sie zur „KONFIGURATION“-Seite im axe-Kontoportal
2. Klicken Sie auf den Link „Integrationen“ innerhalb der „Konfiguration“-Navigation
3. Klicken Sie auf die Schaltfläche „Neue Verbindung zu Jira Cloud hinzufügen“
4. Ein neues Popup-Fenster (OAuth-Zustimmung) wird gestartet, in dem Sie aufgefordert werden, sich anzumelden (wenn Sie bereits eine aktive Jira-Sitzung haben, wird dieser Schritt übersprungen)
5. Sobald Sie sich bei Jira authentifiziert haben, werden Sie aufgefordert, eine Jira-Instanz im Auswahlmenü „App verwenden auf“ auszuwählen
6. Klicken Sie auf „Akzeptieren“, sobald Sie eine Jira-Instanz ausgewählt haben
7. Das Popup-Fenster wird geschlossen und ein Bestätigungsdialog wird angezeigt
8. Bestätigen Sie die Jira-Instanz, mit der Sie sich verbinden möchten, im Dropdown-Menü
9. Klicken Sie auf „Fertigstellen“
10. Eine Meldung „Erfolgreich mit Jira verbunden“ wird angezeigt, sobald die Verbindung hergestellt ist

Verbindung mit dem Jira Data Center herstellen

1. Navigieren Sie zur „KONFIGURATION“-Seite im axe-Kontoportal
2. Klicken Sie auf den Link „Integrationen“ innerhalb der „Konfiguration“-Navigation
3. Klicken Sie auf die Schaltfläche „Neue Verbindung zum Jira Data Center hinzufügen“
4. Klicken Sie auf die Schaltfläche „Einstellungen konfigurieren“ (unter dem Text „Nicht konfigurierte Verbindung“)
5. Geben Sie Ihre Jira Data Center-URL ein (z. B. https://jira.mycompany.com)
6. Geben Sie Ihren Consumer Key ein (muss mit dem übereinstimmen, was Sie in Jira eingeben).
7. Im Jira Data Center...
   • Klicken Sie auf die Schaltfläche „Einstellungen“ (Zahnradsymbol oben rechts auf der Seite)
   • Klicken Sie auf den Link „Anwendungen“
   • Klicken Sie auf den Link „Anwendungslinks“
   • Geben Sie https://www.deque.com als URL in das Texteingabefeld ein
   • Klicken Sie auf die Schaltfläche „Neuen Link erstellen“
   • Klicken Sie auf die Schaltfläche „Weiter“
     • Wenn Sie eine Warnung wie „Keine Antwort von der eingegebenen URL erhalten“ oder bezüglich Weiterleitungen sehen, können Sie diese sicher ignorieren. Die URL selbst wird nicht für irgendeine Art von Validierung verwendet; sie ist lediglich ein Pflichtfeld, um die Verbindung korrekt einzurichten
   • Geben Sie einen *Anwendungsnamen* ein (z. B. „Deque Jira Integration“; Sie müssen diesen Wert auf der Jira Data Center Einstellungsseite angeben)
   • Aktivieren Sie das Kontrollkästchen „Eingehenden Link erstellen“
   • Klicken Sie auf die Schaltfläche „Weiter“
   • Geben Sie einen Wert in das Feld Verbraucherschlüssel ein (z. B. „DequeOAuthKey“)
   • Geben Sie einen Wert in das Feld *Consumer Name* Feld (z. B. „Deque Jira Integration“)
   • Geben Sie den öffentlichen Schlüssel ein, der auf der Seite „Jira Data Center Einstellungen“ angezeigt wird, in das Öffentlicher Schlüssel -Feld ein
8. Zurück auf der Seite Jira Data Center Einstellungen im Axe-Kontoportal...
   • geben Sie denselben Verbraucherschlüssel ein, der im Jira Data Center eingegeben wurde
   • Klicken Sie auf die Schaltfläche „Speichern“
   • Klicken Sie auf die Schaltfläche „Mit Integration verbinden“
   • Melden Sie sich im Popup-Fenster im Data Center an, falls Sie nicht bereits angemeldet sind
   • Klicken Sie auf „Erlauben“
   • Schließen Sie das Fenster

Voraussetzung für die Jira Cloud-Verbindung von der Deque On-Premises-Instanz

Registrieren Sie die Jira-Client-App

1. Navigieren Sie zu https://developer.atlassian.com/console/myapps/
2. Klicken Sie auf die Schaltfläche „Erstellen“ und wählen Sie „OAuth 2.0“ Integration
3. Geben Sie einen Namen an (z. B. „Acme Corp - Axe on-prem - Jira Cloud Integration“)
4. Markieren Sie das Ich stimme den Entwicklerbedingungen von Atlassian zu -Kontrollkästchen und klicken Sie auf die Schaltfläche „Erstellen“
5. Klicken Sie im Tab „Verteilung“ auf „Bearbeiten“ und wählen Sie „Teilen“ für den „Verteilungsstatus“
   • Setzen Sie „Anbietername“ auf „Deque“
   • Setzen Sie „Datenschutzerklärung“ auf „https://www.deque.com/privacy-policy/“
   • Setzen Sie „Speichert Ihre App persönliche Daten?“ auf „Nein“
   • Änderungen speichern
6. Klicken Sie im Tab „Berechtigungen“ auf die Schaltfläche „Hinzufügen“ (neben „Jira API“)
7. Sobald es für die Konfiguration bereit ist (lassen Sie etwas Zeit), wird die Schaltfläche „Hinzufügen“ durch eine neue Schaltfläche „Konfigurieren“ ersetzt
   • Wenn die Schaltfläche „Konfigurieren“ nicht erscheint, versuchen Sie die Seite neu zu laden
8. Klicken Sie auf „Konfigurieren“
9. Klicken Sie auf „Scopes bearbeiten“
   • aktivieren Sie die folgenden Kontrollkästchen: „read:jira-work“, „read:jira-user“, „write:jira-work“ und „manage:jira-webhook“
10. Klicken Sie im Tab „Autorisierung“ auf die Schaltfläche „Hinzufügen“
11. Setzen Sie „Callback-URL“ auf „https://axe.deque.com/jira-direct/connected“
12. Klicken Sie auf die Schaltfläche „Änderungen speichern“
13. Laden Sie dieses Bild herunter (Rechtsklick > Bild speichern unter):
14. Klicken Sie im Tab „Einstellungen“ auf „Avatar ändern“ und wählen Sie das gerade gespeicherte Axe-Logo aus
15. Speichern Sie im Abschnitt „Authentifizierungsdetails“ die „Client-ID“ und das „Geheimnis“, da sie Teil Ihrer On-Prem-Installation sind
16. Sobald Ihre Deque-On-Prem-Installation abgeschlossen ist, folgen Sie den obigen Schritten, um die Verbindung zur Jira-Cloud herzustellen

Trennen einer aktiven Verbindung

Durch Klicken auf „Trennen von Jira“ wird die zuvor mit Jira hergestellte aktive Authentifizierungssitzung ungültig. Außerdem können keine Probleme mehr an die getrennte Jira-Instanz gesendet werden.

Um eine getrennte Verbindung wiederherzustellen, klicken Sie auf die Schaltfläche „Mit Jira verbinden“, die Sie durch die Verbindungsschritte erneut führt.

Löschen einer Verbindung

Sobald eine Verbindung getrenntwurde, können Sie sie löschen, indem Sie auf „Jira-Verbindung löschen“ klicken.

Vorlagen

Sobald eine Verbindung hergestellt wurde, können Vorlagen erstellt werden, um zu standardisieren, wie Axe-Issues auf Jira-Felder abgebildet werden. Vorlagen helfen dabei, eine konsistente Issue-Erstellung in Ihrer Organisation sicherzustellen.

Für detaillierte Informationen zum Erstellen, Verwalten und Verwenden von Vorlagen sehen Sie in unserer Vorlagen-Dokumentation.

Versenden von Issues an Jira

Sobald Sie eine Jira-Verbindung hergestellt und Vorlagen erstellt haben, können Sie beginnen, Axe-Issues an Jira zu senden. Der Prozess ermöglicht es Ihnen, einzelne Issues oder Gruppen von Issues zu senden, um Jira-Tickets zu erstellen.

• Senden von Issues von der Axe DevTools-Erweiterung an Jira
• Senden von Issues von Axe Monitor an Jira
• Senden von Issues vom Axe Developer Hub an Jira