SecSign ID JIRA REST API OAuth

JIRA ist eine Webanwendung für operatives Projektmanagement sowie Fehlermanagement und Störungsbehebung.
Zahlreiche Drittanbieterapps können auf JIRA zugreifen, um Inhalte zu posten, updaten oder verändern. Die meisten Firmen betreiben die JIRA Instanzen als Inhouse Lösungen um in ihrer eigenen Anwendung auf JIRA Daten zuzugreifen.

Diese Drittanbieter-Anwendungen nutzen die JIRA REST API, um Informationen auszutauschen. Das folgende Tutorial beschreibt, warum Sie OAuth mit der SecSign ID nutzen sollten, um Ihre JIRA REST API abzusichern.

SecSign ID ist ein Plugin für sichere Zwei-Faktor Authentifizierung (2FA) für JIRA. 2FA fügt ein zusätzliches Schutzschild hinzu, indem es einen zweiten Token für die Anmeldung fordert. In dem Fall der SecSign ID ist dieses Token das Smartphone.

Mehr Informationen bezüglich der Zwei-Faktor Authentifizierung in Kombination mit JIRA finden Sie auf dem Atlassian Marketplace JIRA Marketplace oder der SecSign ID Github site.

ATLASSIAN ÜBERBLICKJIRA ÜBERBLICK

Die JIRA REST API ist der primäre Weg, um extern mit JIRA zu interagieren. Das gilt sowohl für das Bauen von Apps, die Verschriftung von Interaktionen mit JIRA oder die Entwicklung von anderen Integrationen.

OAuth Authentifizierung

Wenn Sie die JIRA Cloud REST APIs direkt integrieren, empfehlen wir die OAuth Authentifizierungsmethode. Das OAuth Framework ermöglicht Drittanbieter-Anwendungen begrenzten Zugriff auf JIRA Ressourcen. Diese Anwendungen speichern keine empfindlichen Daten wie Passwörter oder Nutzerinformationen. SecSign empfiehlt in diesem Fall OAuth für die Authentifizierung der Nutzer gegenüber der JIRA REST API.
Mehr Informationen zu OAuth und SecSign ID

Einfache Authentifizierung

Für Ausführungen mit niedrigen Sicherheitsanforderungen, zum Beispiel Skripte und Bots, können Sie die einfache Authentifizierungsmethode nutzen. Dafür werden vom Nutzer lediglich Nutzername und Passwort gefordert. Diese Angaben werden in Plain Text übertragen und stellen ein Sicherheitsrisiko dar.

Einen ersten Einblick in die Integration der JIRA REST API mit der OAuth Authentifizierung bietet das JIRA Developer Tutorial:

Jira REST OAuth Doc

Nachdem Sie JIRA aufgesetzt haben, müssen Sie Ihre Drittanbieter-App unter Administration > Anwendungen > Anwendungslinks registrieren.

Ihr Client braucht die folgenden URLs, um Authentifizierungsanfragen zu JIRA zu machen:

Die Drittanbieter-App oder -Client kann in einer beliebigen Sprache geschrieben sein, es muss lediglich das OAuth Protokoll implementiert haben. OAuth bietet zahlreiche Bibliotheken und Services die OAuth 2.0 für alle gängigen Sprachen unterstützt, beispielsweise Java, PHP, Swift, Python, Ruby und andere.

OAuth 2.0 ist aktuell nur für Atlassian Connect Add-ons verfügbar. Für REST API Aufrufe wird nur OAuth unterstützt.

Das JIRA Tutorial bietet einen Java Beispiel-Client(rest-oauth-client-1.0.one-jar.jar).Darüber hinaus finden Sie Beispiel-Clients in Perl, PHP, Python, Ruby etc. im Bitbucket Archiv.

Das SecSign ID Plugin muss in Ihrer JIRA Instanz installiert werden. Das Tutorial für die Integration finden Sie hier:

Jira SecSign Tutorial

Sie benötigen ein Request Token mit dem Beispiel-Client. Eine Anleitung zum Erlangen dieses Tokens finden Sie im JIRA OAuth Tutorial.
Mit dem Token erhalten Sie die Access URL. Der Nutzer muss die URL entweder im Browser oder in der internen Webansicht öffnen um sich mit JIRA zu authentifizieren. Wenn das SecSign ID Plugin korrekt integriert wurde, kann der Nutzer sich mit der SecSign ID sicher authentifizieren.

Sie müssen der Drittanbieter-App Lese- und Schreibeberechtigungen in JIRA geben. JIRA wird diese Berechtigungen bestätigen und Ihnen einen Verifikations-Code zuordnen, den Sie für den Access Token benötigen. Eine ausführliche Beschreibung des Vorgangs finden Sie in dem Atlassian Jira Tutorial.