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

# Ihren Iru-Tenant für Okta Workflows autorisieren

> Autorisieren Sie Ihren Iru Endpoint-Tenant für die Okta Workflows-Integration. Generieren Sie API-Token, konfigurieren Sie den Connector und aktivieren Sie automatisierte Geräte-Workflows.

<Callout icon="list-check" color="#B84A7A" iconType="regular">Dieser Leitfaden gilt für Mac-Computer und Windows-Computer</Callout>

<Note>
  In Okta Workflows wird der Connector weiterhin als **Kandji** aufgeführt. Die Schritte in diesem Leitfaden zum Erstellen eines API-Tokens und Kopieren Ihrer Domain werden in **Iru Endpoint** durchgeführt. Wenn Sie die Verbindung in Okta Workflows konfigurieren, wählen Sie **Kandji** und geben Sie Ihr Iru Endpoint-API-Token und Ihre Domain ein.
</Note>

### Über die Autorisierung Ihres Iru-Tenants für Okta Workflows

Wenn Sie Ihren Iru Endpoint-Tenant für Okta Workflows autorisieren, kann Okta Workflows über den Connector **Kandji** eine Verbindung zu Ihrem Tenant herstellen, sodass Sie Geräteverwaltungsaufgaben in Ihren Workflows automatisieren können.

### Funktionsweise

Der Connector **Kandji** in Okta Workflows verbindet sich mithilfe eines API-Tokens und einer Domain mit Ihrem Iru Endpoint-Tenant. Nachdem Sie die Verbindung konfiguriert haben, können Sie Workflows erstellen, die auf Ereignisse im Benutzerlebenszyklus und Geräteverwaltungsaufgaben reagieren, ohne manuelle Schritte in Iru Endpoint.

### Voraussetzungen

Stellen Sie vor Beginn sicher, dass Sie über Folgendes verfügen:

* Okta Workflows-Administratoranmeldedaten
* Administratorzugriff auf Iru Endpoint
* In Ihrem Iru Endpoint-Tenant aktivierten API-Zugriff

Nachdem Sie Ihren Iru Endpoint-Tenant erfolgreich für Okta Workflows autorisiert haben, können Sie [Kandji-Connector-Aktionskarten in Okta Workflows verwenden](/de/endpoint/integrations/okta-workflows/use-kandji-connector-action-cards-with-okta-workflows).

### Ihren Iru-Tenant autorisieren

Die Autorisierung besteht aus zwei Teilen: Erstellen Sie ein API-Token und kopieren Sie Ihre Domain in **Iru Endpoint**, und konfigurieren Sie dann den Connector **Kandji** in **Okta Workflows** mit diesen Werten.

Wenn Sie einem Workflow zum ersten Mal eine **Kandji**-Karte hinzufügen, fordert Okta Workflows Sie auf, die Verbindung zu konfigurieren. Sie können die Verbindung speichern und für zukünftige Workflows wiederverwenden.

<Note>
  Sie können auf Ihrer Seite **Connections** mehrere Verbindungen erstellen und verwalten.
</Note>

#### Ein API-Token in Iru Endpoint erstellen

Führen Sie diese Schritte in der Web-App von **Iru Endpoint** durch.

So erstellen Sie ein API-Token für den Kandji-Connector in Okta Workflows:

<Steps>
  <Step title="Iru Endpoint aufrufen">
    Melden Sie sich mit Administratoranmeldedaten bei der Iru Endpoint-Web-App an.
  </Step>

  <Step title="Zugriff öffnen">
    Wählen Sie in der Seitenleiste die [**Schaltfläche Kontomenü**](/de/iru/platform-overview/account-menu) und dann **Zugriff**.

    <Frame>
      <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-access.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=466fdf5fb47efd6bab8b450a5a1e8302" alt="Screenshot des Kontomenüs mit hervorgehobener Option Access" width="562" height="1040" data-path="assets/media/images/iru-nav-access.png" />
    </Frame>
  </Step>

  <Step title="Token hinzufügen">
    Wählen Sie auf der Registerkarte **API-Token** die Option **Add Token**.
  </Step>

  <Step title="Token-Namen konfigurieren">
    Geben Sie im Feld **Name** einen Namen wie Okta Workflows ein.
  </Step>

  <Step title="Token-Beschreibung hinzufügen">
    Geben Sie im Feld „Description“ eine Beschreibung wie *Okta Workflows die Nutzung der Iru Endpoint-API erlauben* ein.
  </Step>

  <Step title="Token erstellen">
    Wählen Sie **Erstellen**.
  </Step>

  <Step title="API-Token kopieren">
    Wählen Sie im Dialog **Copy your API token** die Option **Copy Token**.
  </Step>

  <Step title="Token sicher aufbewahren">
    Bewahren Sie das kopierte Token an einem sicheren Ort auf. Wenn Sie den Text des Tokens verlieren, können Sie es vor der Verwendung löschen und mit den obigen Schritten ein neues erstellen. Sie verwenden dieses Token in Schritt 4 des nächsten Abschnitts.
  </Step>

  <Step title="Kopieren des Tokens bestätigen">
    Aktivieren Sie das Kontrollkästchen **Ich habe das Token kopiert und verstehe, dass ich diese Details nicht erneut sehen kann**.
  </Step>

  <Step title="Einrichtung fortsetzen">
    Wählen Sie „Next“.
  </Step>

  <Step title="Berechtigungen konfigurieren">
    Wählen Sie im Dialog **Manage API Permissions** die Option **Konfigurieren**.
  </Step>

  <Step title="Berechtigungen auswählen">
    Aktivieren Sie im Abschnitt „Permissions“ das Kontrollkästchen für jeden Bereich, auf den Okta Workflows Zugriff haben soll. Aktivieren Sie zum Beispiel das Kontrollkästchen für **Blueprints Management**, um alle Berechtigungen zum Anzeigen und Ändern von Blueprints zu aktivieren. Hinweis: Sie können das Dreieckssymbol rechts neben dem Berechtigungstyp auswählen, um spezifischere Berechtigungen anzuzeigen.
  </Step>

  <Step title="Berechtigungen prüfen">
    Prüfen Sie die Berechtigungen, die Sie für das API-Token konfiguriert haben.
  </Step>

  <Step title="Konfiguration speichern">
    Wählen Sie **Speichern** und dann **Schließen**.
  </Step>

  <Step title="Token-Erstellung überprüfen">
    Vergewissern Sie sich auf der Registerkarte **API-Token**, dass Ihr neues Token angezeigt wird.
  </Step>

  <Step title="API-URL kopieren">
    Kopieren oder notieren Sie im Feld **Your organization's API URL is** Ihre Iru Endpoint-Domain.

    <Frame>
      <img src="https://mintcdn.com/iru/97IKZnNVEzytYzut/assets/media/images/iru-okta-workflows-api-url.png?fit=max&auto=format&n=97IKZnNVEzytYzut&q=85&s=05f21971cae8156ca02cc0ab32a3e559" alt="Feld für die API-URL in Iru Endpoint mit der API-URL der Organisation, die für die Okta Workflows-Verbindung kopiert werden muss" width="1898" height="866" data-path="assets/media/images/iru-okta-workflows-api-url.png" />
    </Frame>
  </Step>
</Steps>

#### Den Kandji-Connector in Okta Workflows einrichten

Führen Sie diese Schritte in **Okta Workflows** durch. Sie benötigen das API-Token und die Domain aus dem vorherigen Abschnitt.

Sie können mehr als eine Verbindung erstellen. Beispielsweise haben Sie möglicherweise mehrere Iru Endpoint-Tenants oder testen mehrere API-Token. Das API-Token muss mindestens die Berechtigung **Devices: Device Information: Device list** enthalten. Erteilen Sie zusätzliche Berechtigungen je nach den Workflow-Aktionen, die Sie verwenden möchten. Um beispielsweise alle Geräte aufzulisten, benötigt das Token:

| Berechtigung | Beschreibung |
| - | - |
| **Devices: Device Information: Device list** | Eine Liste aller Geräte im Iru Endpoint-Tenant abrufen |
| **Devices: Device Information: Device details** | Die vollständigen Details eines bestimmten Geräts abrufen |

<Steps>
  <Step title="Neue Verbindung erstellen">
    Wählen Sie in Okta Workflows auf der Seite „Connections“ oder in einer beliebigen Karte **New Connection**.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-new-connection.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8660bcbc03e426c96c8324fe11b45111" alt="Seite Connections in Okta Workflows mit der Schaltfläche New Connection, die zum Erstellen einer neuen Verbindung ausgewählt werden muss" width="686" height="234" data-path="assets/media/images/iru-okta-workflows-new-connection.png" />
    </Frame>
  </Step>

  <Step title="Kandji-Connector auswählen">
    Scrollen Sie im Fenster „New Connection“ bei Bedarf und wählen Sie dann **Kandji**. Dies ist der Connector-Name in Okta Workflows; er verbindet sich mit Ihrem Iru Endpoint-Tenant.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-kandji-connector.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=efffbbe77501dc2b238574cb3a248e58" alt="Fenster New Connection in Okta Workflows mit der Liste verfügbarer Connectors, wobei Kandji zur Auswahl hervorgehoben ist" width="651" height="725" data-path="assets/media/images/iru-okta-workflows-select-kandji-connector.png" />
    </Frame>
  </Step>

  <Step title="Verbindungsnamen konfigurieren">
    Geben Sie im Feld **Connection Nickname** einen eindeutigen Namen ein, mit dem Sie mehrere Iru Endpoint-Tenants oder mehrere Iru Endpoint-API-Schlüssel unterscheiden können.
  </Step>

  <Step title="API-Schlüssel eingeben">
    Geben Sie im Feld **API key** den Text des API-Tokens ein, das Sie in Schritt 7 des vorherigen Abschnitts generiert haben, oder fügen Sie ihn ein.
  </Step>

  <Step title="Domain eingeben">
    Geben Sie im Feld **Kandji domain** Ihre vollständige Iru Endpoint-Domain aus Schritt 16 des vorherigen Abschnitts ein. Okta Workflows bezeichnet dieses Feld als **Kandji domain**, der Wert ist jedoch Ihre Iru Endpoint-API-URL (zum Beispiel *accuhive.api.kandji.io* oder *accuhive.api.eu.kandji.io*).
  </Step>

  <Step title="Verbindung erstellen">
    Wählen Sie **Erstellen**.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-connection-credentials.jpg?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=a854c9253adb5fc41e84bf3e642dfff9" alt="Konfigurationsformular für die Verbindung in Okta Workflows mit ausgefüllten Feldern Connection Nickname, API key und Iru Endpoint-Domain sowie der Schaltfläche Create" width="1084" height="1194" data-path="assets/media/images/iru-okta-workflows-connection-credentials.jpg" />
    </Frame>
  </Step>
</Steps>

Der Connector **Kandji** ist jetzt konfiguriert und mit Ihrem Iru Endpoint-Tenant verbunden. Sie können ihn mit den verfügbaren Connector-Karten verwenden.

#### Die Verbindung in Workflows verwenden

<Steps>
  <Step title="Neuen Flow erstellen">
    Gehen Sie in Workflows zum Bereich „Flows“ und wählen Sie **+New Flow**.
  </Step>

  <Step title="App-Aktion hinzufügen">
    Wählen Sie **Add app action**.
  </Step>

  <Step title="Kandji auswählen">
    Wählen Sie im Bereich **My Connected Apps** die App **Kandji**. Okta Workflows zeigt weiterhin diesen App-Namen an; sie bietet Zugriff auf Ihren Iru Endpoint-Tenant.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-connected-app.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=8273f6867296d243a8f4c86dc45aaafb" alt="Bereich My Connected Apps in Okta Workflows mit Iru Endpoint als verfügbarer verbundener App, die für Workflow-Aktionen ausgewählt werden kann" width="684" height="470" data-path="assets/media/images/iru-okta-workflows-select-connected-app.png" />
    </Frame>
  </Step>

  <Step title="Connector-Karte auswählen">
    Wählen Sie eine Connector-Karte aus.
  </Step>

  <Step title="Konfigurieren und fortfahren">
    Konfigurieren Sie die Karte und setzen Sie die Erstellung Ihres Workflows fort.

    <Frame>
      <img src="https://mintcdn.com/iru/gptx2MM5S_bBcDGe/assets/media/images/iru-okta-workflows-select-action-card.png?fit=max&auto=format&n=gptx2MM5S_bBcDGe&q=85&s=b4b164f71f667efc1bebdc6654649c4a" alt="Auswahloberfläche für Connector-Karten in Okta Workflows mit verfügbaren Iru Endpoint-Aktionskarten, die für den Workflow ausgewählt werden können" width="1230" height="1248" data-path="assets/media/images/iru-okta-workflows-select-action-card.png" />
    </Frame>
  </Step>
</Steps>