Wer kann das durchführen: Unternehmens-Admins
Welche Preispläne: Enterprise
Dieser Artikel liefert technische Details zur Verwendung eines Drittanbieter-Autorisierungsservers mit OAuth 2.0 zur Integration von Jira in Miro.
Anleitung zum Einrichten einer Verbindung findest du in Mit OAuth 2.0 eine Verbindung zu lokal gehostetem Jira über Drittanbieter-Autorisierungsserver herstellen.
Wie die Integration von Jira in Miro mit lokaler Autorisierung und OAuth 2.0 funktioniert
Das folgende Diagramm zeigt den Kommunikationsablauf zwischen Miro und einem lokal gehosteten Jira-Autorisierungsserver.
Miro- und Jira-Integration mit einem lokalen Autorisierungsserver über ein API-Gateway
Konfigurationsparameter
Um den Autorisierungs-Flow zwischen Miro und Jira mit einem Drittanbieter-Autorisierungsserver und OAuth 2.0 zu konfigurieren, musst du die folgenden Parameter angeben:
-
Autorisierungsserver
- URL für die Autorisierungsanfrage
- URL für die Token-Anfrage
- Geltungsbereich
-
Konfiguration der Autorisierungs-App
- Client-ID
- Geheimer Clientschlüssel
-
Jira-Instanz
- Öffentliche Jira-URL
- Jira-Basis-URL; interne URL
✏️ Miro stellt die Redirect-URL bereit, die der Autorisierungsserver anhand der registrierten App validiert.
Weitere Informationen: Siehe Mit Drittanbieter-Autorisierungsservern per OAuth 2.0 mit Jira On-Premise verbinden.
Autorisierungsanfragen von Nutzern zwischen Miro und einem On-Premise-Autorisierungsserver
Für eine Integration zwischen Miro und Jira mit einem Drittanbieter-Autorisierungsserver zeigt die folgende Grafik den Ablauf der Nutzerautorisierungsanfragen.
Nutzerautorisierungsanfrage
Autorisierungsanfrage
https://{authorization_URL}?
response_type=code&
client_id={CLIENT_ID}&
redirect_uri={Miro Redirect URI}&
scope={scope}&
state={state}Der Nutzer kann in der Konfiguration Parameter als Schlüssel-Wert-Paare zur Autorisierungsanfrage hinzufügen.
Token-Anfrage
curl --request POST \
--url '{token request URL}' \
--header 'content-type: application/x-www-form-urlencoded' \
--data grant_type=authorization_code \
--data 'client_id={CLIENT_ID}' \
--data 'client_secret={CLIENT_SECRET}' \
--data 'code={Obtained Authorization Code}' \
--data 'redirect_uri={Miro Redirect URI}' \Nachdem Miro den Autorisierungscode erhalten hat, übergibt Miro den state und fordert ein Token-Paar an.
Austausch von Refresh-Token
curl --request POST \
--url '{token request URL}' \
--header 'content-type: application/x-www-form-urlencoded' \
--data grant_type=refresh_token \
--data 'client_id={CLIENT_ID}' \
--data 'refresh_token={current valid refresh token}' \Stelle sicher, dass die Refresh-Token-Funktion aktiviert ist; aktiviere den Offline-Zugriff auf APIs.
Jira-API-Anfragen
curl --request GET \
--url {Jira Public URL}/rest/api/{apiversion}/... \
--header 'authorization: Bearer {accessToken}' \
--header 'content-type: application/json'Jede Anfrage verwendet die angegebene öffentliche Jira-URL als Basis-URL und das Nutzer-Zugriffstoken als Bearer-Token.