Einrichten

Einleitung

Um mit diesem Aktivitätspaket eine Verbindung mit Jira herzustellen, müssen Sie zuerst die Anmeldeinformationen erstellen, die für den Jira Scope erforderlich sind, um alle nachfolgenden Aufrufe zu authentifizieren. Der Scope unterstützt derzeit zwei Authentifizierungstypen:

• API-Token: Ein Authentifizierungstoken wird von Jira für Ihren Benutzer generiert. Diese Methode unterstützt vollständige Unattended-Automatisierungen.
• OAuth 2.0: Eine Client-ID und ein geheimer Schlüssel werden von Jira generiert und können für alle Benutzer innerhalb einer Organisation verwendet werden. Diese Methode zeigt zur Runtimeeinen Anmeldebildschirm an, auf dem ein Benutzer seine Anmeldeinformationen für Jira oder einen seiner SSO-Anbieter eingeben kann. Ein Token wird erstellt und lokal gespeichert. Dieses Token ist von kurzer Dauer und muss möglicherweise zu einem späteren Zeitpunkt aktualisiert werden. Aus diesem Grund unterstützt diese Methode Attended- und einige Unattended-Automatisierungen.

Please follow the steps below to prepare a set of credentials for your activities.

Credentials

Option 1: API Token

1. Folgen Sie den Anweisungen von Atlassian hier , um ein API-Token zu generieren.
2. Fügen Sie Ihrem Workflow einen Jira-Scope hinzu und ändern Sie den Parameter Authentifizierungstyp in Api Token.
3. Geben Sie in die Eigenschaft Server-URL die URL der Jira-Instanz Ihrer Organisation ein. Bei Cloud-Instanzen hat dies in der Regel die Form https://<your org>.atlassian.net.
4. Füllen Sie schließlich die Eigenschaft API- Token mit dem in Schritt 1 generierten Token und die Eigenschaft Benutzername mit der E-Mail-Adresse aus, die Sie zum Anmelden bei der angegebenen Jira-Instanz verwenden. Jira Scope ist jetzt einsatzbereit.

Option 2: OAuth 2.0

1. Befolgen Sie die Anweisungen von Atlassian hier zum Aktivieren von OAuth 2.0 (3LO) und erstellen Sie eine neue „App“.

   
   

   

   
   
2. Wählen Sie unter APIS AND FEATURESdie Option OAuth 2.0 (3LO) aus. Geben Sie http://127.0.0.1:10001/authorize/ in das Feld Rückruf-URL ein. Dadurch wird die Jira-App angewiesen, zu der Maschine zurückzukehren, auf der die Aktivitäten ausgeführt werden, sobald die Authentifizierung eines Benutzers abgeschlossen ist.
   
   

   

   
   

3. Wählen Sie unter APIS UND FUNKTIONEN die Option Hinzufügen aus, um der App Zugriff auf Atlassian-APIs zu geben. Wählen Sie die Schaltfläche Hinzufügen unter REST-API der Jira-Plattformaus.

   
   

   

   
   
4. Die Schaltfläche Hinzufügen wird durch Konfigurierenersetzt. Klicken Sie darauf, um die Berechtigungen auszuwählen, die der App erteilt werden. Fügen Sie read:jira-work, manage:jira-project, manage:jira-configuration, read:jira-userund write:jira-work.
   
   

   

   
   
   
   

   

   
   

5. Navigieren Sie zurück zu App-Details und kopieren Sie Ihre Client-ID und Ihren Geheimschlüssel. Diese können nun in einem Workflow verwendet werden.

   
   

   

   
   
6. Fügen Sie Ihrem Workflow einen Jira-Scope hinzu und ändern Sie den Parameter Authentifizierungstyp in OAuth 2.0.
7. Geben Sie in die Eigenschaft Server-URL die URL der Jira-Instanz Ihrer Organisation ein. Bei Cloud-Instanzen hat dies in der Regel die Form https://<your org>.atlassian.net.

8. Füllen Sie schließlich die Eigenschaften Client-ID und Geheimer Clientschlüssel mit den in Schritt 5 kopierten Werten aus. Jira Scope ist jetzt einsatzbereit.

   Um den Variablentyp von String in SecureString zu transformieren, können Sie im Standardparameter für clientSecretdiesen Befehl verwenden:

   (new System.Net.NetworkCredential("","*YOUR_SECRET*")).SecurePassword

   
   

   

   
   
9. Wenn Sie die obigen Schritte in Studio ausführen und beim Versuch, den Jira Scope auszuführen, die Fehlermeldung RemoteException wrapping System.Net.HttpListenerException: The network location cannot be reached. For information about network troubleshooting, see Windows Help erhalten, besteht die Lösung darin, cmd.exe als Administrator zu öffnen und diesen Befehl auszuführen:

   netsh http add iplisten ipaddress=127.0.0.1

   
   

   

   
   

10. Nach der ersten Ausführung von Jira Scope erhalten Sie in Ihrem Standardbrowser ein Fenster zur Autorisierungsanforderung, in dem Sie die Jira-Site angeben und dann auf Akzeptierenklicken müssen.