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

# ADE-Token mit der Iru API erneuern, aktualisieren oder löschen

> Erneuern, aktualisieren oder löschen Sie Automated Device Enrollment-Token mit der Iru Endpoint API, um einen Ablauf zu verhindern und Verbindungen zu Apple Business aufrechtzuerhalten.

<Note title="Namensänderung zu Apple Business">
  **Apple Business Manager** heißt jetzt **Apple Business**. **Apple School Manager** bleibt unverändert. Weitere Informationen finden Sie unter [Introducing Apple Business](https://www.apple.com/newsroom/2026/03/introducing-apple-business-a-new-all-in-one-platform-for-businesses-of-all-sizes/) und [Apple Business Manager is now Apple Business](https://support.apple.com/guide/apple-business-manager/apple-business-manager-is-now-apple-business-axmd79d79dea/web).
</Note>

### Über die Verwaltung von ADE-Token

Automated Device Enrollment (ADE)-Token müssen regelmäßig erneuert und verwaltet werden, um die Geräteregistrierung aufrechtzuerhalten. Mit diesem Prozess können Sie mehrere ADE-Token effizient mittels API-Automatisierung verwalten, den manuellen Aufwand reduzieren und ein konsistentes Token-Lebenszyklusmanagement sicherstellen.

### Funktionsweise

Bei der Verwaltung von ADE-Token verwenden Sie die Iru Endpoint API über Postman, um Massenvorgänge für mehrere Token auszuführen. Der Prozess umfasst die Konfiguration des API-Zugriffs, das Einrichten von Umgebungsvariablen, das Herunterladen von Token aus Apple Business oder Apple School Manager und die Verwendung automatisierter Workflows, um Token effizient zu erneuern, zu aktualisieren oder zu löschen.

<Warning>
  Wenn Sie sich nicht sicher sind, diesen Prozess selbst durchzuführen, wenden Sie sich für weitere Unterstützung an den [Iru Endpoint Support](/de/iru/iru-support/access-to-iru-support).
</Warning>

### Voraussetzungen

* Zugriff auf Iru Endpoint mit Berechtigungen zum Erstellen von API-Token
* Installierte und konfigurierte Postman-Anwendung
* Zugriff auf Apple Business oder Apple School Manager
* Mehrere ADE-Token, die erneuert oder verwaltet werden müssen
* Grundlegendes Verständnis von API-Vorgängen und Postman-Workflows

### Iru Endpoint API-Token konfigurieren

Bereiten Sie ein API-Token vor und bewahren Sie es an einem sicheren Ort auf. Weitere Informationen finden Sie in unserem Artikel zur [Iru Endpoint API](/en/endpoint/api/iru-api-overview). Wenn Sie bereits ein API-Token vorbereitet haben, können Sie diesen Abschnitt überspringen.

<Steps>
  <Step title="API-Token erstellen oder ändern">
    Erstellen Sie ein neues API-Token oder ändern Sie ein vorhandenes mit den erforderlichen Berechtigungen.
  </Step>

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

  <Step title="Berechtigungen konfigurieren">
    Erstellen oder ändern Sie das vorhandene API-Token so, dass es alle Berechtigungen im Zusammenhang mit Automated Device Enrollment enthält.
  </Step>
</Steps>

### Postman vorbereiten

Die meisten der folgenden Schritte werden in der Postman-Anwendung auf Ihrem Gerät ausgeführt. Wenn Sie Postman bereits konfiguriert haben, können Sie diesen Abschnitt überspringen.

<Steps>
  <Step title="Collection-Struktur überprüfen">
    Prüfen Sie, ob Ihre Collection den Ordner für Automated Device Enrollment-Integrationen enthält.
  </Step>

  <Step title="API-URL definieren">
    Definieren Sie Ihre API-URL, falls sie im Ordner Iru Endpoint API oben in der Collection noch nicht definiert ist.
  </Step>

  <Step title="Umgebungsvariablen konfigurieren">
    Definieren Sie das API-Token in Ihren Umgebungsvariablen gemäß unserem Artikel zur Einrichtung der Iru Endpoint API in Postman.
  </Step>
</Steps>

### Postman-Umgebungsvariablen konfigurieren

Nachdem die Grundlagen von Postman konfiguriert sind, müssen Sie in Postman einige Umgebungsvariablen definieren, um die Automated Device Enrollment-Server zu verfolgen.

<Steps>
  <Step title="Umgebungsvariablen erstellen">
    Wählen Sie in Postman in der linken Seitenleiste die Registerkarte **Environments** und dann **Create Environment** aus, um eine neue Umgebung zu erstellen. Benennen Sie Ihre Umgebung (z. B. „Iru Endpoint API“) und fügen Sie die folgenden Variablen hinzu:

    * **Variable**: `base_url`
      * **Initial Value**: `https://<subdomain>.api.iru.com/api/v1`
      * **Current Value**: `https://<subdomain>.api.iru.com/api/v1`

    <Note>Ersetzen Sie `<subdomain>` durch die tatsächliche Subdomain Ihres Tenants oder kopieren Sie die Basis-URL direkt aus Ihrem Tenant. Die in Ihrem Tenant angezeigte URL verwendet möglicherweise die Domain `api.kandji.io`. Sowohl `<subdomain>.api.iru.com` als auch `<subdomain>.api.kandji.io` funktionieren ohne Änderung.</Note>

    * **Variable**: `token`
      * **Initial Value**: `your_api_token_here`
      * **Current Value**: `your_api_token_here`

    Wählen Sie **Speichern** aus, um Ihre Umgebung zu speichern, und wählen Sie dann Ihre neu erstellte Umgebung im Umgebungs-Dropdown oben rechts aus.
  </Step>

  <Step title="Zu vorhandenen Variablen hinzufügen">
    Wenn Sie bereits Umgebungsvariablen konfiguriert haben, können Sie die neuen Elemente zu den vorhandenen Variablen hinzufügen.
  </Step>

  <Step title="ADE-Integrationen auflisten">
    Navigieren Sie in der Collection zu **Iru Endpoint API** > **Automated Device Enrollment Integrations** > **GET List ADE Integrations**.
  </Step>

  <Step title="Anfrage ausführen">
    Wählen Sie die Schaltfläche **Senden** aus, um die Anfrage auszuführen.
  </Step>

  <Step title="Token-IDs kopieren">
    Kopieren Sie im Abschnitt **Body** der Ergebnisse die IDs der obersten Ebene jedes Automated Device Enrollment-Tokens.
  </Step>

  <Step title="Token-Variablen erstellen">
    Erstellen Sie für jede Token-ID eine Umgebungsvariable mit einem Benennungsschema wie `ade_token_1`, `ade_token_2` usw., wobei Sie die Zahl für jedes Token erhöhen.
  </Step>

  <Step title="Servernamen notieren">
    Notieren Sie sich den zugehörigen `server_name` für jedes Token. Sie benötigen diese Information beim Herunterladen der Token aus Apple Business oder Apple School Manager.
  </Step>

  <Step title="Variablenwerte festlegen">
    Fügen Sie den ID-Wert für jedes Token in die entsprechende Variable `ade_token_#` ein (z. B. `ade_token_1`, `ade_token_2`).
  </Step>

  <Step title="Variablen schützen">
    Sie können den Variablentyp auf „secret“ setzen, damit der Wert der Variablen nicht sichtbar ist.
  </Step>
</Steps>

### ADE-Token herunterladen

<Steps>
  <Step title="Apple Business oder Apple School Manager öffnen">
    Melden Sie sich bei Ihrem [Apple Business](https://business.apple.com)- oder [Apple School Manager](https://school.apple.com)-Konto an.
  </Step>

  <Step title="Registerkarte „Geräte“ öffnen">
    Wählen Sie oben auf der Seite die Registerkarte **Geräte** aus.
  </Step>

  <Step title="Management öffnen">
    Wählen Sie in der linken Seitenleiste **Management** aus.
  </Step>

  <Step title="Passenden Geräteverwaltungsdienst auswählen">
    Wählen Sie in der Liste **Management Services** den Dienst aus, dessen Name dem `server_name` der ersten ADE-Integration aus der Liste entspricht, die Sie zuvor in Postman erstellt haben.
  </Step>

  <Step title="Aktionsmenü des Dienstes öffnen">
    Wählen Sie die Auslassungspunkte (**…**) für diesen Dienst aus.
  </Step>

  <Step title="Token herunterladen">
    Wählen Sie **Download Token** aus.
  </Step>

  <Step title="Für alle Token wiederholen">
    Wiederholen Sie diesen Vorgang für jedes Token, das Sie erneuern möchten.
  </Step>
</Steps>

### Postman-Ordnervorlage erstellen

Das Erstellen von Ordnern in Postman erleichtert es, den Überblick über Ihre Automated Device Enrollment-Token zu behalten.

<Steps>
  <Step title="Ordneroptionen öffnen">
    Wählen Sie die Auslassungspunkte neben dem Ordner Automated Device Enrollment Integrations aus.
  </Step>

  <Step title="Neuen Ordner hinzufügen">
    Wählen Sie Add folder aus.
  </Step>

  <Step title="Ordner benennen">
    Benennen Sie den Ordner ADE\_Token1.
  </Step>

  <Step title="Integrationselemente auswählen">
    Navigieren Sie zum Ordner **Automated Device Enrollment Integrations** und wählen Sie die Elemente **Renew ADE Integration** und **Update ADE Integration** aus.
  </Step>

  <Step title="Elemente kopieren">
    Klicken Sie mit der rechten Maustaste (oder bei gedrückter Ctrl-Taste) auf die ausgewählten Elemente und wählen Sie **Kopieren** aus.
  </Step>

  <Step title="Neuen Ordner öffnen">
    Wählen Sie die Auslassungspunkte neben dem Ordner ADE\_Token1 aus.
  </Step>

  <Step title="Elemente einfügen">
    Wählen Sie **Paste** aus, um die kopierten Elemente dem neuen Ordner hinzuzufügen.
  </Step>
</Steps>

### Renew-Element anpassen

<Steps>
  <Step title="Renew-Element auswählen">
    Wählen Sie in Ihrem Token-Ordner das Element **Renew ADE Integration** aus.
  </Step>

  <Step title="Element umbenennen">
    Benennen Sie es in **Renew ADE1 Integration** um (oder **Renew ADE2 Integration** usw., je nach Token-Nummer).
  </Step>

  <Step title="Adressleiste aktualisieren">
    Wählen Sie im rechten Bereich die Adressleiste links neben der Schaltfläche **Senden** aus.
  </Step>

  <Step title="Token-Variable aktualisieren">
    Wählen Sie den Text in `{{ade_token_ade}}` aus und ändern Sie ihn in `{{ade_token_1}}` (oder `{{ade_token_2}}` usw., je nach Token-Nummer).
  </Step>

  <Step title="Body konfigurieren">
    Wählen Sie unten die Registerkarte Body aus.
  </Step>

  <Step title="Token-Details eingeben">
    Geben Sie `blueprint_id`, Telefonnummer und E-Mail-Adresse ein, die dem Token zugeordnet werden sollen.
  </Step>

  <Step title="Token-Datei auswählen">
    Wählen Sie für die Datei das x neben allen aktuellen Dateien und dann die Schaltfläche Select Files aus.
  </Step>

  <Step title="P7M-Datei auswählen">
    Wählen Sie die .p7m-Datei aus, die zu diesem ADE-Token gehört.
  </Step>

  <Step title="Änderungen speichern">
    Speichern Sie die Änderungen.
  </Step>
</Steps>

### Update-Element anpassen

<Steps>
  <Step title="Update-Element auswählen">
    Wählen Sie in Ihrem Token-Ordner das Element **Update ADE Integration** aus.
  </Step>

  <Step title="Element umbenennen">
    Benennen Sie es in **Update ADE1 Integration** um (oder **Update ADE2 Integration** usw., je nach Token-Nummer).
  </Step>

  <Step title="Adressleiste aktualisieren">
    Wählen Sie im rechten Bereich die Adressleiste links neben der Schaltfläche **Senden** aus.
  </Step>

  <Step title="Token-Variable aktualisieren">
    Wählen Sie den Text in `{{ade_token_ade}}` aus und ändern Sie ihn in `{{ade_token_1}}` (oder `{{ade_token_2}}` usw., je nach Token-Nummer).
  </Step>

  <Step title="Body konfigurieren">
    Wählen Sie unten die Registerkarte Body aus.
  </Step>

  <Step title="Update-Informationen eingeben">
    Hier können Sie neue Angaben für `blueprint_id`, Telefonnummer und E-Mail-Adresse eingeben.
  </Step>

  <Step title="Änderungen speichern">
    Speichern Sie die Änderungen.
  </Step>
</Steps>

### ADE\_Token-Ordner duplizieren

<Steps>
  <Step title="Ordneroptionen öffnen">
    Wählen Sie die Auslassungspunkte neben dem Ordner ADE\_Token1 aus.
  </Step>

  <Step title="Ordner duplizieren">
    Wählen Sie Duplicate aus.
  </Step>

  <Step title="Ordnerinhalte aktualisieren">
    Aktualisieren Sie den Inhalt des Ordners mit dem oben beschriebenen Vorgang.
  </Step>

  <Step title="Weitere Ordner erstellen">
    Erstellen Sie Duplikate des Ordners für jedes Ihrer ADE-Token.
  </Step>
</Steps>

### ADE-Integration erneuern

Nachdem alles konfiguriert ist, können Sie den Renew-Befehl senden.

<Steps>
  <Step title="Renew-Befehl auswählen">
    Navigieren Sie zu dem von Ihnen erstellten Token-Ordner (z. B. **ADE\_Token1**, **ADE\_Token2** usw.) und wählen Sie das Element **Renew ADE1 Integration** (oder **Renew ADE2 Integration** usw.) aus, das Ihrer Token-Nummer entspricht.
  </Step>

  <Step title="Befehl ausführen">
    Wählen Sie die Schaltfläche Send aus.
  </Step>
</Steps>

### ADE-Integration aktualisieren

Durch das Aktualisieren der ADE-Integration können Sie die zugeordnete Blueprint-ID, Telefonnummer und E-Mail-Adresse ändern.

<Steps>
  <Step title="Update-Befehl auswählen">
    Navigieren Sie zu dem von Ihnen erstellten Token-Ordner (z. B. **ADE\_Token1**, **ADE\_Token2** usw.) und wählen Sie das Element **Update ADE1 Integration** (oder **Update ADE2 Integration** usw.) aus, das Ihrer Token-Nummer entspricht.
  </Step>

  <Step title="Details aktualisieren">
    Aktualisieren Sie im Abschnitt Body die Details, die geändert werden müssen.
  </Step>

  <Step title="Befehl ausführen">
    Wählen Sie die Schaltfläche Send aus.
  </Step>
</Steps>

### Aktuelle Integrationen prüfen

Der Befehl Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations liefert alle aktuellen ADE-Integrationen, sodass wir überprüfen können, ob die Integration erfolgreich erneuert oder aktualisiert wurde.

<Steps>
  <Step title="List-Befehl auswählen">
    Wählen Sie in der Collection Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations aus.
  </Step>

  <Step title="Befehl ausführen">
    Wählen Sie die Schaltfläche Send aus.
  </Step>

  <Step title="Erneuerung überprüfen">
    Die Variable `days_left` sollte 364 betragen, wenn der Renew-Befehl erfolgreich war.
  </Step>

  <Step title="Aktualisierungen überprüfen">
    Um eine Aktualisierung zu überprüfen, kontrollieren Sie die dem ADE-Token zugeordneten Informationen.
  </Step>
</Steps>

### Integration löschen

Der Befehl Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration löscht die ADE-Integration, die der angegebenen ADE-Token-ID zugeordnet ist.

<Steps>
  <Step title="Delete-Befehl auswählen">
    Wählen Sie in der Collection Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration aus.
  </Step>

  <Step title="Token-ID festlegen">
    Befüllen Sie die Variable `ade_token_id` mit der ID des ADE-Tokens.
  </Step>

  <Step title="Befehl ausführen">
    Wählen Sie die Schaltfläche Send aus.
  </Step>
</Steps>

### Überlegungen

<AccordionGroup>
  <Accordion title="API-Sicherheit, Postman und Umgebungseinrichtung">
    * **Sicherheit des API-Tokens**: Stellen Sie sicher, dass API-Token sicher aufbewahrt werden und über die passenden Berechtigungen für ADE-Vorgänge verfügen
    * **Postman-Konfiguration**: Eine ordnungsgemäße Einrichtung von Postman ist für erfolgreiche API-Vorgänge unerlässlich
    * **Umgebungsvariablen**: Verwenden Sie Umgebungsvariablen, um mehrere Token-IDs effizient zu verwalten
    * **Fehlerbehandlung**: Seien Sie darauf vorbereitet, API-Fehler und Probleme bei der Token-Validierung zu beheben
  </Accordion>

  <Accordion title="Token, Dateien und Zugriff auf das Apple-Portal">
    * **Token-Lebenszyklus**: ADE-Token haben Ablaufdaten und müssen regelmäßig erneuert werden, um die Registrierung aufrechtzuerhalten
    * **Verwaltung der Token-Dateien**: Behalten Sie die heruntergeladenen .p7m-Dateien im Blick und ordnen Sie sie den richtigen Token-IDs zu
    * **Zugriff auf Apple Business oder Apple School Manager**: Stellen Sie sicher, dass Sie sich beim Portal anmelden und Token herunterladen können
    * **Überprüfungsprozess**: Überprüfen Sie erfolgreiche Vorgänge immer anhand des Integrationsstatus und des Token-Ablaufs
  </Accordion>

  <Accordion title="Massenvorgänge und Zugriffskontrolle">
    * **Massenvorgänge**: Verwenden Sie Ordnervorlagen, um mehrere Token effizient zu verwalten
    * **Zugriffskontrolle**: Stellen Sie sicher, dass nur autorisiertes Personal Zugriff auf Vorgänge zur Token-Verwaltung hat
  </Accordion>

  <Accordion title="Tests, Überwachung und Kontinuität">
    * **Tests**: Testen Sie Vorgänge in kleinem Maßstab, bevor Sie Massenvorgänge ausführen
    * **Überwachung**: Überwachen Sie regelmäßig die Ablaufdaten der Token und die Erneuerungszeitpläne
    * **Dokumentation**: Dokumentieren Sie Token-Konfigurationen und zugehörige Servernamen
    * **Backup-Strategie**: Bewahren Sie Sicherungen der Token-Konfigurationen und API-Einstellungen auf
  </Accordion>
</AccordionGroup>