> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Jira

> Verbinden Sie Jira Cloud über OAuth mit Iru Compliance, um Projekte, Issues, Workflows, Change-Tickets und Nachweise zu Jira Service Management-Anfragen für Audits zu erfassen.

### Über Jira

Die Quelle **Jira** überträgt **Projektkonfiguration**, **Issue-Metadaten**, **Workflow-Definitionen**, **Benutzer- und Bearbeiterinformationen** sowie Anfragedaten aus **Jira Service Management** von **Jira Cloud** in Iru Compliance, wo sie zu Nachweisen werden, die Sie Aktionen und Kontrollen zuordnen können. Iru verbindet sich über den **dreibeinigen OAuth 2.0 (3LO)** Authorization-Code-Flow von **Atlassian**. Die Integration ist **schreibgeschützt**: Iru erstellt oder ändert keine Issues, Projekte oder Workspace-Einstellungen.

Dieser Connector ist ausschließlich für **Jira Cloud** vorgesehen. **Jira Data Center** (selbst gehostet) verwendet ein anderes Authentifizierungsmodell und wird von dieser Quelle **nicht** unterstützt.

### So funktioniert es

Nachdem Sie Ihre **Cloud ID** angegeben haben, leitet Sie der Connector-Assistent zu Atlassian weiter, wo Sie sich anmelden und zustimmen. Iru erhält ein kurzlebiges **Zugriffstoken** und ein **rotierendes Aktualisierungstoken** und erneuert die Tokens bei den Synchronisierungszyklen automatisch.

| Scope | Was er erlaubt |
| - | - |
| `read:jira-work` | Lesen von Issues, Projekten, Workflows und Anhängen |
| `read:jira-user` | Lesen von Benutzerprofilen und Bearbeiterinformationen |
| `read:jira-service-desk` | Lesen von Jira Service Management-Anfragen und SLA-Metriken |

| Detail | Wert |
| - | - |
| **Kategorie** | Projektmanagement |
| **Authentifizierung** | OAuth 2.0 (Jira Cloud 3LO) |
| **Anbietertarif** | **Kostenpflichtiger** Jira Cloud-Tarif (der **Free**-Tarif unterstützt den von diesem Connector benötigten OAuth-API-Zugriff nicht) |

Dokumentations-Hub: [Atlassian Support - Jira](https://support.atlassian.com/jira/). OAuth: [Jira Cloud OAuth 2.0 (3LO)](https://developer.atlassian.com/cloud/jira/platform/oauth-2-3lo-apps/), [OAuth 2.0-Scopes](https://developer.atlassian.com/cloud/jira/platform/scopes-for-oauth-2-3LO-and-forge-apps/). Cloud ID: [Atlassian Cloud ID abrufen](https://support.atlassian.com/jira/kb/retrieve-my-atlassian-sites-cloud-id/).

### Voraussetzungen

* Eine **kostenpflichtige** Jira Cloud-Site (**Free** unterstützt den hier erforderlichen OAuth-API-Zugriff nicht).
* Ihre **Jira Cloud ID** (UUID). Siehe **Jira Cloud ID ermitteln** weiter unten.
* Browser-**Pop-ups** sind für Ihre **Iru**-Domain zugelassen, damit der OAuth-Schritt geöffnet werden kann.
* Der sich anmeldende Benutzer muss **kein** Jira-Administrator sein, Iru kann jedoch nur Daten lesen, auf die dieser Benutzer Zugriff hat. Für eine umfassende Nachweiserfassung verwenden Sie ein Konto mit mindestens:
  * **Browse projects** für jedes Projekt, das Iru lesen soll.
  * **Browse users and groups** (globale Berechtigung), wenn Sie Benutzer- und Bearbeitermetadaten benötigen.

Ein **dediziertes Dienstkonto** mit Lesezugriff auf die richtigen Projekte ist oft der einfachste Weg, den Umfang stabil zu halten.

### Jira mit Iru verbinden

<Tabs>
  <Tab title="Jira">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie die Quelle in Compliance verbinden.
    </Note>

    #### Jira Cloud ID ermitteln

    Ihre **Cloud ID** ist die UUID, die Iru mit `https://api.atlassian.com/ex/jira/{cloudId}` verwendet.

    <Steps>
      <Step title="Jira Cloud und kostenpflichtigen Zugriff bestätigen">
        Dieser Connector unterstützt **Jira Cloud** mit einem **kostenpflichtigen** Tarif, der den von Iru benötigten OAuth-API-Zugriff erlaubt. Vergewissern Sie sich, dass Sie keine **Free**-Site verwenden, die die Integration blockiert.
      </Step>

      <Step title="Jira-Site öffnen">
        Öffnen Sie in einem Browser Ihre Jira Cloud-URL (zum Beispiel `https://yoursite.atlassian.net`), damit Sie die **Subdomain** kennen, die Sie in den folgenden Schritten einsetzen.
      </Step>

      <Step title="Methode zum Ermitteln der Cloud ID wählen">
        Verwenden Sie **Option A** für eine schnelle JSON-Abfrage oder **Option B**, wenn Sie ohnehin mit **Atlassian Admin** arbeiten.
      </Step>

      <Step title="Option A: Tenant-Informationen (am schnellsten)">
        Öffnen Sie in einer neuen Browser-Registerkarte (ersetzen Sie `yoursite` durch Ihre Jira-Subdomain):

        `https://yoursite.atlassian.net/_edge/tenant_info`

        Kopieren Sie in der JSON-Antwort den Wert von **`cloudId`**.
      </Step>

      <Step title="Option B: Atlassian Admin">
        Melden Sie sich unter [admin.atlassian.com](https://admin.atlassian.com) an, wählen Sie Ihre Organisation aus und suchen Sie die Cloud ID in der Browser-URL (sie erscheint nach `/s/`).
      </Step>

      <Step title="Cloud ID für Iru speichern">
        Bewahren Sie die UUID sicher auf, bis Sie sie im Connector-Assistenten von Iru auf der Registerkarte [**Iru Compliance**](#iru-compliance) in das Feld **cloudId** einfügen.
      </Step>
    </Steps>

    <Note>
      Fahren Sie auf der Registerkarte [**Iru Compliance**](#iru-compliance) fort.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Schließen Sie zuerst die Registerkarte [**Jira**](#jira) ab, damit Sie Ihre **Cloud ID** für den Connector-Assistenten haben.
    </Note>

    <Steps>
      <Step title="Quellen öffnen">
        Erweitern Sie in Iru Compliance in der linken Navigationsleiste **Compliance** und wählen Sie **Quellen**.

        <Frame>
          <img src="https://mintcdn.com/iru/tI0HDLDwHj8r9Ile/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=tI0HDLDwHj8r9Ile&q=85&s=87dcef15fc17d2fb9a6e53f454e41710" alt="Linke Navigation: Compliance erweitert, Sources ausgewählt" width="410" height="1024" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Jira aktivieren">
        Suchen Sie **Jira** (setzen Sie **Kategorie** auf **Project management** oder verwenden Sie **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. In einer Browser-Registerkarte wird der Connector-Assistent geöffnet.
      </Step>

      <Step title="Schritt 1 von 2: Servervariablen konfigurieren">
        Geben Sie Ihre **Cloud ID** in das Feld **cloudId** ein und wählen Sie dann **Configure Server Variables**. Warten Sie auf die Bestätigung, dass die Servervariablen erfolgreich aktualisiert wurden, bevor Sie fortfahren.
      </Step>

      <Step title="Schritt 2 von 2: OAuth">
        Wählen Sie **Launch OAuth Authentication**. Wenn sich das Atlassian-Pop-up öffnet, melden Sie sich an und wählen Sie **Accept**, um die angeforderten Berechtigungen zu erteilen.
      </Step>

      <Step title="Verbindung abschließen">
        Wenn sich das Pop-up schließt, schließt Iru den OAuth-Austausch ab. Wenn die Verbindung erfolgreich ist, zeigt der Assistent **Verbindung konfiguriert** an.
      </Step>

      <Step title="Bestätigen, dass die Quelle aktiv ist">
        Schließen Sie die Browser-Registerkarte **Iru fordert Zugriff auf externe Dienste an**, kehren Sie dann zu **Compliance** → **Quellen** zurück und bestätigen Sie, dass die Karte **Jira** den Status **Aktiv** hat.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Fehlerbehebung

<AccordionGroup>
  <Accordion title="Beim Aktivieren der Quelle öffnet sich nichts">
    Prüfen Sie die Einstellungen des **Pop-up-Blockers** für die Iru-Website und versuchen Sie **Launch OAuth Authentication** erneut.
  </Accordion>

  <Accordion title="Servervariablen konnten nicht aktualisiert werden">
    Der Link zum Assistenten ist möglicherweise abgelaufen. Deaktivieren Sie **Jira** unter **Quellen** und aktivieren Sie es erneut; geben Sie dann Ihre **Cloud ID** erneut ein.
  </Accordion>

  <Accordion title="Fehlende Projekte oder Issues">
    Dem Konto, das OAuth abgeschlossen hat, fehlt möglicherweise **Browse projects** für einige Bereiche. Passen Sie die Jira-Berechtigungen an oder verbinden Sie sich mit einem **Dienstkonto**, das die benötigte Leseabdeckung hat.
  </Accordion>

  <Accordion title="Token abgelaufen oder Aufforderungen zur erneuten Verbindung">
    Jira Cloud verwendet ein **rotierendes Aktualisierungstoken** mit einer Gültigkeit von **90 Tagen**. Wenn die Verbindung länger inaktiv ist, führen Sie den OAuth-Flow erneut über die Quellkarte **Jira** aus.
  </Accordion>

  <Accordion title="Jira Free-Tarif">
    Der **Free**-Tarif unterstützt den für diesen Connector erforderlichen OAuth-API-Zugriff nicht. Verwenden Sie für die Verbindung einen **kostenpflichtigen** Jira Cloud-Tarif.
  </Accordion>

  <Accordion title="Falsche Site oder falsche Cloud ID">
    Bestätigen Sie, dass die **Cloud ID** zur gewünschten Site passt (siehe **Jira Cloud ID ermitteln**). Bei einer Abweichung greift Iru auf den falschen Tenant zu.
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Aktualisierungstokens und inaktive Verbindungen" icon="circle-info">
    Iru aktualisiert Zugriffstokens bei den Synchronisierungszyklen. Wenn **90 Tage** lang keine Synchronisierung läuft, planen Sie eine **erneute Authentifizierung** über die Quellkarte ein.
  </Card>

  <Card title="Umfangreiche Projekte und Aufbewahrung" icon="shield">
    Große Projekte erzeugen umfangreiche Verläufe. Grenzen Sie den Projektumfang nach Möglichkeit ein und stimmen Sie **Aufbewahrungs**- und **Datenschutz**richtlinien ab, bevor Sie sich bei Audits auf Workflow-Nachweise verlassen.
  </Card>
</CardGroup>

### Verwandte Artikel

<CardGroup cols={2}>
  <Card title="Quellenverwaltung" icon="plug" href="/de/compliance/sources-management">
    Alle Compliance-Quellen durchsuchen und verwalten.
  </Card>

  <Card title="Erste Schritte mit Compliance" icon="rocket" href="/de/compliance/getting-started-with-compliance">
    Frameworks, Aktionen und **Artefakte**.
  </Card>

  <Card title="Iru-Übersicht" icon="layer-group" href="/de/iru/platform-overview/iru-overview">
    Wie Endpoint, Compliance und Identity zusammenwirken.
  </Card>

  <Card title="Artifacts-Verwaltung" icon="folder-open" href="/de/compliance/artifacts-management">
    Nachweise aus Quellen und Aktionen hochladen, prüfen und organisieren.
  </Card>
</CardGroup>