> ## 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.

# Okta

> Verbinden Sie Okta mit einem API-Token mit Iru Compliance, um Verzeichnisbenutzer und -gruppen, Anwendungszuweisungen, MFA-Richtlinien und Audit-Nachweise aus dem System Log zu erfassen.

### Über Okta

Der **Okta**-Connector liest Verzeichnisdaten, Gruppenmitgliedschaften, Anwendungszuweisungen, Richtlinien, den MFA-Status und auditbezogene Signale aus Ihrer Okta-Organisation und stellt sie in Iru Compliance als Artefakte bereit. Die Authentifizierung erfolgt mit einem **Okta-API-Token** über die **Okta Management API**. Die Integration ist für die **schreibgeschützte** Nachweiserfassung vorgesehen. Iru stellt in Okta keine Benutzer bereit und ändert keine Richtlinien über das hinaus, was die Administratorberechtigungen Ihres Tokens bei API-Lesevorgängen zulassen.

### So funktioniert es

Okta akzeptiert API-Tokens mit dem **SSWS**-Schema:

```http theme={null}
Authorization: SSWS YOUR_API_TOKEN
```

Tokens übernehmen die Berechtigungen des Administrators, der sie erstellt hat. **Nicht verwendete Tokens laufen nach 30 Tagen ab**; erfolgreiche API-Aufrufe setzen diesen Zeitraum zurück.

Der Iru-Connector führt Sie durch die Server-URLs für Ihren Tenant (Produktion, EMEA, Gov, Preview oder benutzerdefinierte Domain) und fragt im letzten Schritt Ihr **API-Token** ab. Frühere Schritte des Assistenten gleichen OAuth-bezogene URLs dort ab, wo das Produkt sie erwartet; die **SSWS-Token-Authentifizierung** autorisiert die Management-API-Aufrufe für diese Quelle.

| Detail | Wert |
| - | - |
| **Kategorie** | Sicherheit |
| **Authentifizierung** | Okta-API-Token (`Authorization: SSWS YOUR_TOKEN`) |
| **Okta-Tarif** | Jeder Tarif, der den von Ihnen benötigten Management-API-Zugriff umfasst |

Dokumentation: [API-Token erstellen](https://developer.okta.com/docs/guides/create-an-api-token/main/), [API-Token-Verwaltung](https://help.okta.com/en-us/content/topics/security/api.htm), [Ratenbegrenzungen](https://developer.okta.com/docs/reference/rate-limits/).

### Voraussetzungen

* Eine Okta-Administratorrolle, die **API-Tokens erstellen** kann (**Super Admin**, **Organisationsadministrator** oder **Read-only Admin**, je nachdem, was Ihre Organisation für Automatisierungskonten zulässt).
* Die **Subdomain** oder die vollständige **Okta-Domain** Ihrer Organisation (zum Beispiel `acme`, wenn sich Benutzer unter `https://acme.okta.com` anmelden).

### Okta mit Iru verbinden

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

    <Steps>
      <Step title="Bei der Okta Admin Console anmelden">
        Öffnen Sie die Administrator-URL Ihrer Organisation (zum Beispiel `https://YOUR_SUBDOMAIN.okta.com/admin`) und melden Sie sich mit einer Rolle an, die **API-Tokens** erstellen kann (**Super Admin**, **Organisationsadministrator** oder **Read-only Admin**, je nachdem, was Ihre Organisation für Automatisierungskonten zulässt).
      </Step>

      <Step title="Sicherheit öffnen">
        Erweitern Sie in der linken Navigation **Sicherheit** (oder suchen Sie in der Suchleiste der Administratorkonsole nach **API**).
      </Step>

      <Step title="API-Token-Verwaltung öffnen">
        Wählen Sie **API** → **Tokens**, um die Liste der vorhandenen Tokens und **Token erstellen** zu öffnen.
      </Step>

      <Step title="Neues Token erstellen">
        Wählen Sie **Token erstellen**, geben Sie einen wiedererkennbaren Namen ein (zum Beispiel **Iru Compliance**) und bestätigen Sie dann die Erstellung, damit Okta das Secret einmalig anzeigen kann.
      </Step>

      <Step title="Token sofort kopieren">
        Kopieren Sie den Tokenwert, bevor Sie das Dialogfeld schließen. Nach dem Verlassen der Seite können Sie ihn nicht mehr anzeigen. Bewahren Sie ihn in einem Tresor auf, bis Sie ihn in Iru einfügen.

        Planen Sie den **Ablauf bei Inaktivität** ein: Wenn das Token **30 Tage** lang für keinen erfolgreichen API-Aufruf verwendet wird, macht Okta es ungültig, und Sie müssen ein neues Token erstellen.
      </Step>

      <Step title="Optionale Netzwerkeinschränkungen">
        Wenn Ihre Umgebung feste ausgehende IP-Adressen verwendet, können Sie dem Token gemäß der Okta-Dokumentation optional eine **Network Zone**-Richtlinie zuordnen.
      </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 [**Okta**](#okta) ab.
    </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="Okta aktivieren">
        Suchen Sie **Okta** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. In einer neuen Registerkarte wird der Connector-Assistent geöffnet.
      </Step>

      <Step title="Server-URL wählen, die zu Ihrem Tenant passt">
        Wählen Sie die Zeile, die dem Standort Ihrer Organisation entspricht:

        | Umgebung | Muster der Basis-URL |
        | - | - |
        | Produktion (USA) | `https://YOUR_SUBDOMAIN.okta.com` |
        | EMEA | `https://YOUR_SUBDOMAIN.okta-emea.com` |
        | Preview / Sandbox | `https://YOUR_SUBDOMAIN.oktapreview.com` |
        | US Gov | `https://YOUR_SUBDOMAIN.okta-gov.com` |
        | Benutzerdefinierte Domain | `https://YOUR_OKTA_DOMAIN` |

        Bestätigen Sie Ihre Auswahl, damit der Assistent die richtige Basis-URL für die Management API erstellen kann.
      </Step>

      <Step title="Subdomain- und Domain-Variablen eingeben">
        Folgen Sie jedem Bildschirm des Assistenten: Geben Sie Ihre **Subdomain** oder Domain-Werte ein, wenn Sie dazu aufgefordert werden, damit die OAuth-bezogenen URLs mit Ihrem Tenant übereinstimmen.

        <Note>
          Schritte in der Mitte des Assistenten, die OAuth-URLs erwähnen, sind vorhanden, weil die Connector-Vorlage die Endpunkte vollständig konfiguriert. Für Management-API-Lesevorgänge dieser Quelle verwendet Iru die **SSWS-Token-Authentifizierung** im letzten Schritt.
        </Note>
      </Step>

      <Step title="API-Token einfügen">
        Fügen Sie im Schritt für die Anmeldeinformationen Ihr **API-Token** in das Autorisierungsfeld ein.
      </Step>

      <Step title="Verbindung abschließen">
        Wählen Sie **API-Schlüssel senden**. 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 **Okta** 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 es erneut.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Überprüfen Sie die Token-Zeichenfolge, ob das Administratorkonto noch aktiv ist und ob das Token nicht widerrufen wurde.
  </Accordion>

  <Accordion title="Token abgelaufen">
    Erstellen Sie das Token unter **Sicherheit** → **API** → **Tokens** neu, wenn es 30 Tage lang inaktiv war.
  </Accordion>

  <Accordion title="403 Forbidden">
    Dem mit dem Token verknüpften Administratorprofil fehlt möglicherweise der Lesezugriff auf einige Endpunkte. Bestätigen Sie mindestens **Read-only Admin** (oder Gleichwertiges) für die benötigten Nachweise.
  </Accordion>

  <Accordion title="Falscher Host / falsche Domain">
    Trennen Sie die Verbindung und stellen Sie sie erneut her; überprüfen Sie dabei Subdomain und Region (USA, EMEA, Gov oder Preview).
  </Accordion>
</AccordionGroup>

### Hinweise

<CardGroup cols={2}>
  <Card title="Behandeln Sie API-Tokens wie Anmeldeinformationen" icon="circle-info">
    Behandeln Sie API-Tokens wie Anmeldeinformationen. Bevorzugen Sie ein **Dienstkonto** mit der **minimalen** Administratorrolle, die die Nachweisanforderungen noch erfüllt.
  </Card>

  <Card title="Okta wendet Ratenbegrenzungen auf den Management-API-Datenverkehr an;…" icon="shield">
    Okta wendet **Ratenbegrenzungen** auf den Management-API-Datenverkehr an; bei großen Organisationen kann die Synchronisierung während der ersten Erfassung länger dauern.
  </Card>

  <Card title="Iru liest Daten, die von den APIs bereitgestellt werden, auf die Ihr Token…" icon="server">
    Iru liest Daten, die von den APIs bereitgestellt werden, auf die Ihr Token zugreifen kann – Okta-Berechtigungen, die Sie nicht erteilen, können nicht umgangen werden.
  </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>