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

# Iru Access bereitstellen

> Verteilen Sie die Iru Access-App über Ihr MDM, damit Mac-Computer, iPhone-Geräte, iPad-Geräte und Windows-Computer als verwaltet erkannt werden.

**Iru Access** enthält die gerätegebundenen Anmeldedaten jedes Benutzers und meldet den
[Gerätezustand](/de/identity/authentication/device-trust). *Wie* Sie die App bereitstellen,
entscheidet darüber, ob ein Gerät als **verwaltet** erkannt wird:

* **Verwaltete Bereitstellung:** über Ihr MDM installiert und konfiguriert. Iru
  erkennt das Gerät als verwaltet, sodass [Authentifizierungs-
  richtlinien](/de/identity/authentication/authentication-policies), die das Attribut
  **managed** verlangen, erfüllt sind.
* **Nicht verwaltete Bereitstellung:** ein persönliches oder BYO-Gerät, das der Benutzer selbst
  einrichtet. Es registriert weiterhin einen funktionierenden Authentifikator und meldet Zustands-
  signale, wird aber **nicht** als verwaltet erkannt, sodass Richtlinien, die das
  Attribut managed verlangen, darauf nicht bestanden werden.

<Note>
  Beide Wege stellen dem Benutzer einen funktionierenden Iru Access-Authentifikator bereit und melden den Geräte-
  zustand. Der einzige Unterschied besteht darin, ob das Gerät bei Entscheidungen zum Gerätevertrauen als **verwaltet**
  gilt.
</Note>

## Verwaltete Bereitstellung

Installieren und konfigurieren Sie Iru Access über Ihr MDM, damit registrierte Geräte für das
[Gerätevertrauen](/de/identity/authentication/device-trust) als **verwaltet** gelten.

### Eine MDM-Verbindung erstellen

Über eine [MDM-Verbindung](/de/identity/authentication/mdm-connections) kann
Iru in Ihrem MDM registrierte Geräte als verwaltet erkennen. Erstellen Sie eine für jede MDM-
Instanz, die Sie mit Iru Identity verwenden.

1. Gehen Sie in Iru Identity zu **Policies → MDM Connections** und wählen Sie **+ MDM Connection**.
2. Wählen Sie unter **Select a connection type** eine Option:
   * **Iru Endpoint-Instanz**: Verbindungsfelder aus Ihrer Iru Endpoint-Instanz vorab ausfüllen.
   * **Benutzerdefinierte MDM-Verbindung**: Eine benutzerdefinierte MDM-Verbindung mit manueller Eingabe erstellen.
3. Geben Sie der Verbindung einen **Anzeigenamen**. Wir empfehlen die Domäne Ihres MDM-Servers.
4. Wählen Sie eine **Plattform**: Apple, Windows oder beide.
5. Geben Sie die Plattformdetails ein:
   * **Apple:** das **APNs-Topic** und die **Check-in-URL** Ihres MDM-Servers.
   * **Windows:** die **Provider ID** und die **Discovery-Service-URL** Ihres
     MDM-Servers.

<Tip>
  Sie kennen diese Werte nicht genau? Unter [Ressourcen](#resources) finden Sie Hilfsskripte, die Sie
  auf einem bereits registrierten Gerät ausführen können, um sie auszulesen.
</Tip>

Stellen Sie nach dem Erstellen der Verbindung Iru Access für jede der folgenden Plattformen bereit.

### macOS

<Steps>
  <Step title="Iru Access-Konfigurationsprofil bereitstellen">
    Wählen Sie in Iru Identity unter **Policies → MDM Connections** die Download-
    Schaltfläche links neben **+ MDM Connection** und dann **macOS Profile**.
    Stellen Sie das Profil auf Ihren Mac-Computern bereit. Es enthält bereits die Einstellungen für Associated Domains
    und die Single-Sign-On-Erweiterung (mit den Domänen Ihrer Organisation),
    sodass Sie sie nicht manuell zusammenstellen müssen.

    <Expandable title="Profil manuell erstellen">
      Wenn Ihr MDM diese als native Payloads statt als hochgeladenes
      Profil konfiguriert, bilden Sie Folgendes nach. Ersetzen Sie `<your-iru-domain>` durch
      jede Domäne, die Ihre Verbindung verwendet (eine Verbindung kann mehr als
      eine enthalten).

      * **Associated Domains:** App-Kennung
        `N5M3B34269.com.iru.Access` mit einer zugeordneten Domäne
        `authsrv:<your-iru-domain>` für jede Domäne.
      * **Single-Sign-On-Erweiterung** (Extensible SSO, Typ **Redirect**):
        Erweiterungskennung `com.iru.Access.SSOExtension`, Team Identifier
        `N5M3B34269` und diese Weiterleitungs-URL-Werte für jede Domäne:

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        https://<your-iru-domain>/api/v1/saml/login
        ```
      * **Verwaltete Anmeldeobjekte:** Team Identifier `N5M3B34269` für
        `com.iru.Access`, `com.iru.Access.IruDaemon` und `com.iru.Access.Menu` zulassen,
        damit das Iru Access-Hilfsprogramm, der Hintergrunddienst und das Update-Programm ausgeführt werden können.
    </Expandable>
  </Step>

  <Step title="Iru Access-App bereitstellen">
    **Mit Iru Endpoint:** Fügen Sie die Auto App **Iru Access** für Mac aus
    **Auto Apps** in der Library hinzu, weisen Sie sie über einen Blueprint zu und beschränken Sie sie auf
    Ihre Mac-Computer. Siehe
    [Übersicht über Auto Apps](/de/endpoint/library/auto-apps/auto-apps-overview).

    **Mit einem anderen MDM:** Laden Sie
    [Iru Access für macOS](https://updater.iru.com/iru-access-macOS/download) herunter,
    laden Sie das Paket in Ihr MDM hoch und beschränken Sie es auf Ihre Mac-Computer.
  </Step>

  <Step title="Registrierungsskript herunterladen">
    Kopieren Sie das
    [Skript zur verwalteten Registrierung von Iru Access](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_macos.zsh)
    aus dem
    [GitHub-Repository von Iru Support](https://github.com/kandji-inc/support/tree/main/Identity).
  </Step>

  <Step title="Skript konfigurieren">
    Setzen Sie im Abschnitt **USER INPUT** am Anfang der Datei `regToken` auf den
    **geheimen Clientschlüssel** Ihrer MDM-Verbindung und `regTokenDomain` auf Ihre **Basis**-Mandanten-
    domäne:

    ```zsh theme={null}
    # USER INPUT
    regToken="mdm-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    regTokenDomain="yourcompany.iru.com"
    ```
  </Step>

  <Step title="Skript mit Iru Endpoint bereitstellen">
    Fügen Sie aus der Library ein Library Item **Mac Custom Script** hinzu, fügen Sie das geänderte
    Skript in **Überwachungsskript** ein und weisen Sie es über denselben Blueprint wie die
    Iru Access-App zu. Setzen Sie **Ausführungshäufigkeit** auf **Run every 15 minutes**, damit das
    Skript bei jedem Check-in erneut versucht wird, bis Iru Access installiert und das Geheimnis
    gespeichert ist. Da das Skript idempotent ist, funktioniert auch **Run daily**, wenn Sie
    seltenere Ausführungen bevorzugen. Siehe
    [Übersicht über Custom Scripts](/de/endpoint/library/library-items-profiles/custom-scripts-overview)
    (Registerkarte Mac).
  </Step>

  <Step title="Skript mit einem anderen MDM bereitstellen">
    Laden Sie das geänderte Skript mit den Werkzeugen für benutzerdefinierte Skripte oder Richtlinien Ihrer Plattform hoch.
    Führen Sie es nach der Installation von Iru Access regelmäßig aus, damit neue
    Geräte das Geheimnis übernehmen, sobald die App vorhanden ist.
  </Step>
</Steps>

### iOS, iPadOS und visionOS

**Anforderungen**

* **iOS und iPadOS:** Geräte müssen **18.4 oder neuer** ausführen.
* **Apple Vision Pro:** Iru Access wird als iPad-App installiert.

<Steps>
  <Step title="Iru Access-Konfigurationsprofil bereitstellen">
    Wählen Sie in Iru Identity unter **Policies → MDM Connections** die Download-
    Schaltfläche links neben **+ MDM Connection** und dann **iOS Profile**.
    Stellen Sie das Profil auf Ihren Geräten bereit.

    <Expandable title="Profil manuell erstellen">
      * **Single-Sign-On-Erweiterung** (Extensible SSO, Typ **Redirect**):
        Erweiterungskennung `com.iru.AccessMobile.SSOExtension`, Team
        Identifier `N5M3B34269` und diese Weiterleitungs-URL-Werte für jede Domäne:

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        ```
    </Expandable>
  </Step>

  <Step title="Iru Access-App bereitstellen">
    Verteilen Sie
    [Iru Access im App Store](https://apps.apple.com/us/app/iru-access/id6752437810)
    über Ihr MDM als verwaltete App und beschränken Sie sie auf Ihre Geräte.
  </Step>

  <Step title="Verwaltete Registrierung konfigurieren">
    Legen Sie in Ihrem MDM eine **verwaltete App-Konfiguration** für Iru Access fest (Bundle-ID
    `com.iru.AccessMobile`). Setzen Sie zwei Schlüssel:

    * **`mdmSecret`** (String, erforderlich): der **geheime Clientschlüssel** Ihrer MDM-Verbindung.
    * **`mdmSecretDomain`** (String, erforderlich): Ihre **Basis**-Mandantendomäne
      (zum Beispiel `yourcompany.iru.com`).

    <Warning>
      Setzen Sie `mdmSecretDomain` auf Ihre **Basis**domäne (`yourcompany.iru.com`), nicht
      auf die `id.`-Subdomäne, die Einladungslinks verwenden
      (`yourcompany.id.iru.com`). Wenn die `id.`-Subdomäne enthalten ist, wird das Geheimnis
      nicht angewendet und der Benutzer muss es manuell eingeben.
    </Warning>

    ```xml Managed app configuration (plist) theme={null}
    <dict>
        <key>mdmSecret</key>
        <string>mdm-REPLACE-WITH-MDM-CONNECTION-CLIENT-SECRET</string>
        <key>mdmSecretDomain</key>
        <string>yourcompany.iru.com</string>
    </dict>
    ```

    <Note>
      Mit dieser Konfiguration erfolgt die Registrierung **ohne Anmeldedaten**: Der Benutzer
      gibt nie ein Geheimnis ein, scannt keinen QR-Code und wartet nicht auf eine manuelle Genehmigung. Er
      öffnet weiterhin seine **Einladung** (per E-Mail erhalten oder als Link, den Sie an
      verwaltete Geräte senden) oder den Onboarding-Bildschirm in der App, tippt auf **Fortfahren** und
      bestätigt mit Face ID oder Touch ID.
    </Note>

    Wenden Sie dieses Dictionary mit Iru Endpoint über **Set app configuration**
    in der App Store-App Iru Access an. Die Bereitstellungsschritte finden Sie unter
    [AppConfig verwenden](/de/endpoint/library/library-items-profiles/using-appconfig).
  </Step>
</Steps>

### Windows

**Anforderungen**

* **Windows 11 24H2, 25H2 oder 26H2**

Die Windows-Bereitstellung besteht aus zwei Teilen: Stellen Sie **Iru Access** über Ihr MDM bereit und
speichern Sie dann mit dem Registrierungsskript den **geheimen Clientschlüssel** Ihrer MDM-Verbindung auf jedem Windows-Computer.
Für die Registrierung muss der Benutzer weiterhin seine Einladung öffnen und
mit **Windows Hello** bestätigen.

<Steps>
  <Step title="Iru Access-App bereitstellen">
    **Mit Iru Endpoint:** Fügen Sie die Auto App **Iru Access** für Windows aus
    **Auto Apps** in der Library hinzu, weisen Sie sie über einen Blueprint zu und beschränken Sie sie auf
    Ihre Windows-Computer. Siehe
    [Übersicht über Auto Apps](/de/endpoint/library/auto-apps/auto-apps-overview).

    **Mit einem anderen MDM:** Laden Sie
    [Iru Access für Windows](https://updater.iru.com/iru-access-windows/download) herunter,
    laden Sie das Paket in Ihr MDM hoch und beschränken Sie es auf Ihre Windows-Computer.
  </Step>

  <Step title="Registrierungsskript herunterladen">
    Kopieren Sie das
    [Skript zur verwalteten Registrierung von Iru Access](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_windows.ps1)
    aus dem
    [GitHub-Repository von Iru Support](https://github.com/kandji-inc/support/tree/main/Identity).
  </Step>

  <Step title="Skript mit Iru Endpoint bereitstellen">
    Fügen Sie aus der Library ein Library Item **Windows Custom Script** hinzu, laden Sie das
    Skript hoch und weisen Sie es über denselben Blueprint wie die Iru Access-App zu. Übergeben Sie unter
    [**Command line parameters**](/de/endpoint/library/library-items-profiles/custom-scripts-overview#command-line-parameters-optional)
    Ihren geheimen Clientschlüssel und Ihre Basis-Mandantendomäne:

    ```
    manage --secret <client-secret> --domain yourcompany.iru.com
    ```

    <Warning>
      Verwenden Sie den **geheimen Clientschlüssel** Ihrer Verbindung und die **Basis**-Mandantendomäne
      (`yourcompany.iru.com`), also dieselben Werte wie unter macOS und iOS. Speichern Sie den
      geheimen Clientschlüssel mit diesem Skript, statt direkt in die Registrierung zu schreiben.
      Er wird für das Gerät verschlüsselt, sodass ein über die Registrierung oder OMA-URI übertragener Wert
      nicht verwendbar ist.
    </Warning>

    Setzen Sie **Execute in** auf **64 bit**. Windows Custom Scripts werden bei Zuweisung einmal pro Gerät
    ausgeführt. Siehe
    [Übersicht über Custom Scripts](/de/endpoint/library/library-items-profiles/custom-scripts-overview)
    (Registerkarte Windows).
  </Step>

  <Step title="Skript mit einem anderen MDM bereitstellen">
    Stellen Sie das Skript mit den Skript- oder PowerShell-Richtlinienwerkzeugen bereit, die Ihre
    Plattform unterstützt. Übergeben Sie die Argumente `manage --secret` und `--domain`, die Ihr
    MDM zulässt, und führen Sie es mit erhöhten Rechten aus, damit das Skript in `HKLM` schreiben kann:

    ```powershell theme={null}
    .\iru_access_managed_registration_windows.ps1 manage --secret <client-secret> --domain yourcompany.iru.com
    ```
  </Step>

  <Step title="Überprüfen oder rotieren (optional)">
    Um zu bestätigen, dass das Geheimnis gespeichert ist, oder um es zu löschen, führen Sie das Skript in einer
    PowerShell-Sitzung mit erhöhten Rechten mit Argumenten aus. Wie Sie PowerShell als Administrator öffnen, erfahren Sie in Microsofts Artikel
    [Erste Schritte mit PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/01-getting-started?view=powershell-7.5#starting-powershell-elevated-as-an-administrator).

    ```powershell theme={null}
    # Verify: prints "<domain>:<hash>", never the secret itself
    .\iru_access_managed_registration_windows.ps1 manage --list

    # Rotate or remove
    .\iru_access_managed_registration_windows.ps1 manage --clear "yourcompany.iru.com"
    ```
  </Step>

  <Step title="Registrierung abschließen">
    Wenn die App bereitgestellt und der geheime Clientschlüssel gespeichert ist, öffnet der Benutzer seine
    **Einladung**, die Iru Access startet, und bestätigt mit **Windows
    Hello**. Da das Gerät in Ihrem MDM registriert ist und den
    gespeicherten geheimen Clientschlüssel enthält, erkennt Iru es als **verwaltet**.
  </Step>
</Steps>

<Note>
  Iru Access registriert sein **Passkey-Plug-in** beim ersten Start automatisch bei Windows,
  danach erscheint es unter **Settings ▸ Accounts ▸
  Passkeys ▸ Advanced options**. Das Einschalten dieses Schalters liegt bei Windows
  und dem Benutzer. Es kann derzeit nicht zentral über MDM erzwungen werden. Der
  [Endbenutzerleitfaden](/de/identity/end-user/installing-iru-access) behandelt diesen
  Schritt.
</Note>

## Nicht verwaltete Bereitstellung

Für persönliche oder eigene Geräte (BYOD) muss in einem MDM nichts konfiguriert werden.
Der Benutzer installiert Iru Access und registriert sich über seine Einladung.

### macOS

Teilen Sie
[Iru Access für macOS](https://updater.iru.com/iru-access-macOS/download)
mit dem Benutzer. Er lädt die App herunter, installiert sie und registriert sich dann über seine
Einladung. Eine Schritt-für-Schritt-Anleitung finden Sie unter
[Iru Access installieren](/de/identity/end-user/installing-iru-access).

### iOS, iPadOS und visionOS

Teilen Sie
[Iru Access im App Store](https://apps.apple.com/us/app/iru-access/id6752437810)
oder den Einladungslink mit dem Benutzer. Er installiert die App und registriert sich dann.

**Anforderungen**

* **iOS und iPadOS:** Das Gerät muss **18.4 oder neuer** ausführen.
* **Apple Vision Pro:** Aus dem App Store als iPad-App installieren.

Eine Schritt-für-Schritt-Anleitung finden Sie unter
[Iru Access installieren](/de/identity/end-user/installing-iru-access).

### Windows

Teilen Sie
[Iru Access für Windows](https://updater.iru.com/iru-access-windows/download)
mit dem Benutzer. Er lädt die App herunter, installiert sie und registriert sich dann über seine
Einladung.

**Anforderungen**

* **Windows 11 24H2, 25H2 oder 26H2**

Eine Schritt-für-Schritt-Anleitung finden Sie unter
[Iru Access installieren](/de/identity/end-user/installing-iru-access).

<Note>
  Nicht verwaltete Geräte registrieren weiterhin einen funktionierenden Authentifikator und melden Zustands-
  signale, werden aber **nicht** als verwaltet erkannt. Richtlinien, die
  das Attribut managed verlangen, werden auf ihnen nicht bestanden. Verwenden Sie eine **verwaltete Bereitstellung** für
  Geräte, die diese Richtlinien erfüllen müssen.
</Note>

## Ressourcen

Führen Sie diese Hilfsskripte auf einem bereits in Ihrem MDM registrierten Gerät aus, um
die MDM-Serverdetails zu erfassen, die Sie beim Erstellen einer Verbindung benötigen. Beide werden
im [GitHub-Repository von Iru Support](https://github.com/kandji-inc/support/tree/main/Identity) gepflegt.

<AccordionGroup>
  <Accordion title="macOS: APNs-Topic und Check-in-URL erfassen" icon="apple">
    Das
    [macOS-Skript zum Erfassen von MDM-Details](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_macos.zsh)
    liest das **APNs-Topic** und die **MDM-Check-in-URL** von einem registrierten Mac aus.
  </Accordion>

  <Accordion title="Windows: Provider ID und Discovery-Service-URL erfassen" icon="windows">
    Das
    [Windows-Skript zum Erfassen von MDM-Details](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_windows.ps1)
    liest die **Provider ID** und die **Discovery-Service-URL** des MDM-Servers von einem
    registrierten Windows-Computer aus. Führen Sie es in PowerShell aus.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<CardGroup cols={2}>
  <Card title="Fehlerbehebung bei der macOS-SSO-Erweiterung" icon="bug" href="/de/identity/authentication/troubleshoot-macos-sso">
    Genehmigung zugeordneter Domänen und das Laden der Erweiterung auf einem Mac diagnostizieren.
  </Card>

  <Card title="MDM-Verbindungen" icon="tower-broadcast" href="/de/identity/authentication/mdm-connections">
    Die Verbindung einrichten und verwalten, durch die ein Gerät als verwaltet gilt.
  </Card>

  <Card title="Gerätevertrauen" icon="laptop" href="/de/identity/authentication/device-trust">
    Verwaltete, intakte Geräte als Zugriffsbedingung verlangen.
  </Card>

  <Card title="Iru Access installieren" icon="download" href="/de/identity/end-user/installing-iru-access">
    Die Anleitung für Endbenutzer zur Einrichtung von Iru Access auf einem persönlichen Gerät.
  </Card>

  <Card title="Authentifikatoren" icon="key" href="/de/identity/authentication/authenticators">
    Wie Iru Access neben Passkeys als Authentifikator eingesetzt wird.
  </Card>
</CardGroup>