

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Eine Amazon OpenSearch Ingestion-Pipeline mithilfe von 2.0 mit Atlassian Jira oder Confluence verbinden OAuth
<a name="configure-client-atlassian-OAuth2-setup"></a>

Mithilfe der Informationen in diesem Thema können Sie mithilfe der 2.0-Authentifizierung eine Amazon OpenSearch Ingestion-Pipeline konfigurieren und mit einem Jira- oder Confluence-Konto verbinden. OAuth Führe diese Aufgabe aus, wenn du die [Voraussetzungen](configure-client-atlassian.md#atlassian-prerequisites) für die Nutzung einer OpenSearch Ingestion-Pipeline mit Atlassian Services erstellst, dich aber dafür entscheidest, keine API-Schlüsselanmeldedaten zu verwenden.

**Topics**
+ [Erstelle eine 2.0-Integrations-App OAuth](#create-OAuth2-integration-app)
+ [Ein Atlassian Developer-Zugriffstoken generieren und aktualisieren](#generate-and-refresh-jira-access-token)

## Erstelle eine 2.0-Integrations-App OAuth
<a name="create-OAuth2-integration-app"></a>

Verwende das folgende Verfahren, um dir bei der Erstellung einer OAuth 2.0-Integrations-App auf der Atlassian Developer-Website zu helfen.

**So erstellst du eine OAuth 2.0-Integrations-App**

1. [Melde dich bei deinem Atlassian Developer-Konto unter myapps/ an https://developer.atlassian.com/console/.](https://developer.atlassian.com/console/myapps/)

1. ****Wähle Create, 2.0-Integration. OAuth ****

1. Geben Sie unter **Name** einen Namen ein, um den Zweck der App zu identifizieren.

1. **Aktiviere das Kontrollkästchen **Ich stimme zu, an die Nutzungsbedingungen von Atlassian für Entwickler gebunden zu sein**, und wähle dann Erstellen aus.**

1. **Wähle in der linken Navigationsleiste **Autorisierung** und dann Hinzufügen aus.**

1. Geben Sie für **Callback-URL** eine beliebige URL ein, z. B. **https://www.amazon.com** oder**https://www.example.com**, und wählen Sie dann **Änderungen speichern** aus.

1. Wählen Sie in der linken Navigationsleiste die Seite „**Berechtigungen**“ und dann in der Zeile für Jira API die Option **Hinzufügen** und dann „**Konfigurieren**“ aus. Wählen Sie alle Leseberechtigungen für Classic Scopes aus (Liste unten) und wählen Sie dann Speichern aus

1. Wählen Sie die Registerkarte **Granular Scopes** und dann **Edit Scopes aus, um das Dialogfeld „Jira-API** **bearbeiten“** zu öffnen.

1. Wählen Sie die Berechtigungen für das Quell-Plugin aus, das Sie verwenden:

------
#### [ Jira ]

   ```
   read:audit-log:jira
   read:issue:jira
   read:issue-meta:jira
   read:attachment:jira
   read:comment:jira
   read:comment.property:jira
   read:field:jira
   read:field.default-value:jira
   read:field.option:jira
   read:field-configuration-scheme:jira
   read:field-configuration:jira
   read:issue-link:jira
   read:issue-link-type:jira
   read:issue-link-type:jira
   read:issue.remote-link:jira
   read:issue.property:jira
   read:resolution:jira
   read:issue-details:jira
   read:issue-type:jira
   read:issue-worklog:jira
   read:issue-field-values:jira
   read:issue.changelog:jira
   read:issue.transition:jira
   read:issue.vote:jira
   read:jira-expressions:jira
   ```

------
#### [ Confluence ]

   ```
   read:content:confluence
   read:content-details:confluence
   read:space-details:confluence
   read:audit-log:confluence
   read:page:confluence
   read:blogpost:confluence
   read:custom-content:confluence
   read:comment:confluence
   read:space:confluence
   read:space.property:confluence
   read:space.setting:confluence
   read:content.property:confluence
   read:content.metadata:confluence
   read:task:confluence
   read:whiteboard:confluence
   read:app-data:confluence
   manage:confluence-configuration
   ```

------

1. Wählen Sie **Speichern**.

Weitere Informationen findest du auf der Atlassian Developer-Website unter [Implementierung von OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/oauth/getting-started/implementing-oauth-3lo/) und [Bestimmung der für einen Vorgang erforderlichen Bereiche](https://developer.atlassian.com/cloud/oauth/getting-started/determining-scopes/).

## Ein Atlassian Developer-Zugriffstoken generieren und aktualisieren
<a name="generate-and-refresh-jira-access-token"></a>

Verwende das folgende Verfahren, um dir bei der Generierung und Aktualisierung eines Atlassian Developer-Zugriffstoken auf der Atlassian Developer-Website zu helfen.

**So generierst und aktualisierst du ein Jira-Zugriffstoken**

1. [Melde dich bei deinem Atlassian Developer-Konto unter myapps/ an. https://developer.atlassian.com/console/](https://developer.atlassian.com/console/myapps/)

1. Wähle die App aus, in der du sie erstellt hast. [Erstelle eine 2.0-Integrations-App OAuth](#create-OAuth2-integration-app)

1. Wählen Sie in der linken Navigationsleiste **Autorisierung aus.**

1. Kopiere den detaillierten URL-Wert für die Atlassian-API-Autorisierung unten auf der Seite und füge ihn in den Texteditor deiner Wahl ein.

   Das Format der URL lautet wie folgt:

   ```
   https://auth.atlassian.com/authorize?
   audience=api.atlassian.com 
   &client_id=YOUR_CLIENT_ID
   &scope=REQUESTED_SCOPE%20REQUESTED_SCOPE_TWO
   &redirect_uri=https://YOUR_APP_CALLBACK_URL
   &state=YOUR_USER_BOUND_VALUE 
   &response_type=code
   &prompt=consent
   ```

1. Ändern Sie für `state=YOUR_USER_BOUND_VALUE` den Parameterwert einen beliebigen Wert, z. B. state=“**sample\$1text**“.

   Weitere Informationen finden Sie unter [Wofür wird der State-Parameter verwendet](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/#what-is-the-state-parameter-used-for-)? auf der Atlassian Developer-Website.

1. Beachte, dass in `scope` diesem Abschnitt die detaillierten Bereiche aufgeführt sind, die du in einer früheren Aufgabe ausgewählt hast. Beispiel: `scope=read%3Ajira-work%20read%3Ajira-user%20offline_access`

   `offline_access`gibt an, dass Sie eine generieren möchten. `refresh_token`

1. Öffnen Sie ein Webbrowser-Fenster und geben Sie die Autorisierungs-URL, die Sie kopiert haben, in die Adressleiste des Browserfensters ein.

1. Wenn die Zielseite geöffnet wird, überprüfen Sie, ob die Informationen korrekt sind, und wählen Sie dann **Akzeptieren**, um auf Ihre Jira- oder Confluence-Homepage weitergeleitet zu werden.

1. Nachdem die Homepage geladen wurde, kopieren Sie die URL dieser Seite. Sie enthält den Autorisierungscode für Ihre Anwendung. Sie verwenden diesen Code, um Ihr Zugriffstoken zu generieren. Der gesamte Abschnitt danach `code=` ist der Autorisierungscode.

1. Verwenden Sie den folgenden cURL-Befehl, um das Zugriffstoken zu generieren. Ersetzen Sie *placeholder values* durch Ihre Informationen.
**Tipp**  
Sie können auch einen Drittanbieterdienst wie Postman verwenden.

   ```
   curl --request POST --url 'https://auth.atlassian.com/oauth/token' \
   --header 'Content-Type: application/json' \
   --data '{"grant_type": "authorization_code",
   "client_id": "YOUR_CLIENT_ID",
   "client_secret": "YOUR_CLIENT_SECRET",
   "code": "AUTHORIZATION_CODE",
   "redirect_uri": "YOUR_CALLBACK_URL"}'
   ```

   Die Antwort auf diesen Befehl enthält die Werte für `access_code` und`refresh_token`.