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

# Envoy

> Verbinden Sie Envoy über OAuth mit Iru Compliance, um Besucherprotokolle, Einladungen, Standorte und Metadaten des Mitarbeiterverzeichnisses als Nachweise zur physischen Sicherheit zu erfassen.

### Über Envoy

Iru liest **Besucherzutrittsprotokolle**, **Einladungen**, **Standorte** und Metadaten des **Mitarbeiter**verzeichnisses über die Envoy-API mithilfe von **OAuth 2.0** (**Authorization Code**). Typische Scopes sind **`entry_logs.read`**, **`invites.read`**, **`locations.read`**, **`employees.read`** sowie **`refresh_tokens`**, damit Iru Zugriffstoken ohne wiederholte Anmeldungen erneuern kann.

### So funktioniert es

Iru verwendet den **OAuth 2.0 Authorization Code**-Flow von Envoy. Wenn Sie die Quelle aktivieren, leitet ein **Browser-Pop-up** zum Autorisierungsserver von Envoy weiter. Sie melden sich an, prüfen die Scopes und erteilen den Zugriff; Envoy gibt einen Code zurück, den Iru gegen ein **Zugriffstoken** und ein **Aktualisierungstoken** austauscht.

| Detail | Wert |
| - | - |
| **Kategorie** | Produktivität |
| **Authentifizierung** | OAuth 2.0 |
| **Typische Tarife** | Premium oder Enterprise für API-Zugriff |

Offizielle Referenzen: [Developer Hub](https://developers.envoy.com/hub/docs), [Autorisierung](https://developers.envoy.com/hub/docs/authorization), [Scopes](https://developers.envoy.com/hub/docs/scopes).

### Voraussetzungen

* **Administrator** oder **Global Admin** in Envoy.
* Browser-**Pop-ups** sind zugelassen.

### Envoy mit Iru verbinden

<Tabs>
  <Tab title="Envoy">
    <Note>
      Schließen Sie diese Registerkarte ab, bevor Sie **Envoy** in **Iru Compliance** aktivieren, damit der richtige Administrator OAuth durchführt.
    </Note>

    <Steps>
      <Step title="Bei Envoy anmelden">
        Öffnen Sie Ihr Envoy-Dashboard (zum Beispiel [dashboard.envoy.com](https://dashboard.envoy.com) oder die URL, die Ihr Unternehmen verwendet) und melden Sie sich mit **Administrator**- oder **Global Admin**-Rechten an.
      </Step>

      <Step title="Premium- oder Enterprise-API-Zugriff bestätigen">
        Die Entwickler-APIs von Envoy erfordern einen Tarif, der die von Iru angeforderten Scopes bereitstellt. Bestätigen Sie, dass Ihr Abonnement den **Voraussetzungen** in diesem Artikel entspricht.
      </Step>

      <Step title="OAuth-Scopes prüfen">
        Lesen Sie [Envoy-Autorisierung](https://developers.envoy.com/hub/docs/authorization) und [Scopes](https://developers.envoy.com/hub/docs/scopes) durch, damit der Zustimmungsbildschirm Ihrer Sicherheitsprüfung entspricht.
      </Step>

      <Step title="Pop-ups für Iru zulassen">
        Lassen Sie in dem Browserprofil, das Sie für Compliance verwenden, **Pop-ups** für Ihren **Iru**-Hostnamen zu, damit das Envoy-OAuth-Fenster nicht blockiert wird.
      </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 [**Envoy**](#envoy) 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="Envoy aktivieren">
        Suchen Sie **Envoy** (verwenden Sie **Kategorie** oder **Nach Name oder Beschreibung suchen**). Aktivieren Sie auf dieser Karte den **Schalter**. Möglicherweise öffnet sich ein Browser-Tab oder -Fenster für den Connector-Assistenten.
      </Step>

      <Step title="Bei Envoy anmelden">
        Schließen Sie im OAuth-Pop-up die Envoy-Anmeldung ab, falls Sie dazu aufgefordert werden.
      </Step>

      <Step title="Envoy autorisieren">
        Wählen Sie im OAuth-Pop-up von Envoy **Authorize** (oder das entsprechende Genehmigungssteuerelement).
      </Step>

      <Step title="Verbindung abschließen">
        Wenn sich das Pop-up schließt und Iru den Tokenaustausch abgeschlossen hat, 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 **Envoy** 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="Pop-up blockiert">
    Lassen Sie Pop-ups für Ihre Iru-Origin zu; versuchen Sie es erneut.
  </Accordion>

  <Accordion title="Zugriff verweigert">
    Unzureichende Envoy-Rolle – verwenden Sie Admin/Global Admin.
  </Accordion>

  <Accordion title="Keine API-Daten">
    Der **Standard**-Tarif enthält möglicherweise keinen API-Zugriff – führen Sie gemäß der Envoy-Lizenzierung ein Upgrade durch.
  </Accordion>

  <Accordion title="Veraltete Verbindung">
    Deaktivierter Administrator – **autorisieren Sie erneut** mit einem aktiven Konto.
  </Accordion>
</AccordionGroup>

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