Skip to main content
Apple Business Manager heißt jetzt Apple Business. Apple School Manager bleibt unverändert. Weitere Informationen finden Sie unter Introducing Apple Business und Apple Business Manager is now Apple Business.

​
Ü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.
Wenn Sie sich nicht sicher sind, diesen Prozess selbst durchzuführen, wenden Sie sich für weitere Unterstützung an den Iru Endpoint Support.

​
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. Wenn Sie bereits ein API-Token vorbereitet haben, können Sie diesen Abschnitt überspringen.
1

API-Token erstellen oder ändern

Erstellen Sie ein neues API-Token oder ändern Sie ein vorhandenes mit den erforderlichen Berechtigungen.
2

API-Token öffnen

Wählen Sie in Ihrem Iru Endpoint-Tenant in der Seitenleiste die Schaltfläche Kontomenü und dann Zugriff → API-Token aus.
3

Berechtigungen konfigurieren

Erstellen oder ändern Sie das vorhandene API-Token so, dass es alle Berechtigungen im Zusammenhang mit Automated Device Enrollment enthält.

​
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.
1

Collection-Struktur überprüfen

Prüfen Sie, ob Ihre Collection den Ordner für Automated Device Enrollment-Integrationen enthält.
2

API-URL definieren

Definieren Sie Ihre API-URL, falls sie im Ordner Iru Endpoint API oben in der Collection noch nicht definiert ist.
3

Umgebungsvariablen konfigurieren

Definieren Sie das API-Token in Ihren Umgebungsvariablen gemäß unserem Artikel zur Einrichtung der Iru Endpoint API in Postman.

​
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.
1

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
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.
  • 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.
2

Zu vorhandenen Variablen hinzufügen

Wenn Sie bereits Umgebungsvariablen konfiguriert haben, können Sie die neuen Elemente zu den vorhandenen Variablen hinzufügen.
3

ADE-Integrationen auflisten

Navigieren Sie in der Collection zu Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations.
4

Anfrage ausführen

Wählen Sie die Schaltfläche Senden aus, um die Anfrage auszuführen.
5

Token-IDs kopieren

Kopieren Sie im Abschnitt Body der Ergebnisse die IDs der obersten Ebene jedes Automated Device Enrollment-Tokens.
6

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

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

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).
9

Variablen schützen

Sie können den Variablentyp auf „secret“ setzen, damit der Wert der Variablen nicht sichtbar ist.

​
ADE-Token herunterladen

1

Apple Business oder Apple School Manager öffnen

Melden Sie sich bei Ihrem Apple Business- oder Apple School Manager-Konto an.
2

Registerkarte „Geräte“ öffnen

Wählen Sie oben auf der Seite die Registerkarte Geräte aus.
3

Management öffnen

Wählen Sie in der linken Seitenleiste Management aus.
4

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

Aktionsmenü des Dienstes öffnen

Wählen Sie die Auslassungspunkte (…) für diesen Dienst aus.
6

Token herunterladen

Wählen Sie Download Token aus.
7

Für alle Token wiederholen

Wiederholen Sie diesen Vorgang für jedes Token, das Sie erneuern möchten.

​
Postman-Ordnervorlage erstellen

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

Ordneroptionen öffnen

Wählen Sie die Auslassungspunkte neben dem Ordner Automated Device Enrollment Integrations aus.
2

Neuen Ordner hinzufügen

Wählen Sie Add folder aus.
3

Ordner benennen

Benennen Sie den Ordner ADE_Token1.
4

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

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

Neuen Ordner öffnen

Wählen Sie die Auslassungspunkte neben dem Ordner ADE_Token1 aus.
7

Elemente einfügen

Wählen Sie Paste aus, um die kopierten Elemente dem neuen Ordner hinzuzufügen.

​
Renew-Element anpassen

1

Renew-Element auswählen

Wählen Sie in Ihrem Token-Ordner das Element Renew ADE Integration aus.
2

Element umbenennen

Benennen Sie es in Renew ADE1 Integration um (oder Renew ADE2 Integration usw., je nach Token-Nummer).
3

Adressleiste aktualisieren

Wählen Sie im rechten Bereich die Adressleiste links neben der Schaltfläche Senden aus.
4

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).
5

Body konfigurieren

Wählen Sie unten die Registerkarte Body aus.
6

Token-Details eingeben

Geben Sie blueprint_id, Telefonnummer und E-Mail-Adresse ein, die dem Token zugeordnet werden sollen.
7

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

P7M-Datei auswählen

Wählen Sie die .p7m-Datei aus, die zu diesem ADE-Token gehört.
9

Änderungen speichern

Speichern Sie die Änderungen.

​
Update-Element anpassen

1

Update-Element auswählen

Wählen Sie in Ihrem Token-Ordner das Element Update ADE Integration aus.
2

Element umbenennen

Benennen Sie es in Update ADE1 Integration um (oder Update ADE2 Integration usw., je nach Token-Nummer).
3

Adressleiste aktualisieren

Wählen Sie im rechten Bereich die Adressleiste links neben der Schaltfläche Senden aus.
4

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).
5

Body konfigurieren

Wählen Sie unten die Registerkarte Body aus.
6

Update-Informationen eingeben

Hier können Sie neue Angaben für blueprint_id, Telefonnummer und E-Mail-Adresse eingeben.
7

Änderungen speichern

Speichern Sie die Änderungen.

​
ADE_Token-Ordner duplizieren

1

Ordneroptionen öffnen

Wählen Sie die Auslassungspunkte neben dem Ordner ADE_Token1 aus.
2

Ordner duplizieren

Wählen Sie Duplicate aus.
3

Ordnerinhalte aktualisieren

Aktualisieren Sie den Inhalt des Ordners mit dem oben beschriebenen Vorgang.
4

Weitere Ordner erstellen

Erstellen Sie Duplikate des Ordners für jedes Ihrer ADE-Token.

​
ADE-Integration erneuern

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

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

Befehl ausführen

Wählen Sie die Schaltfläche Send aus.

​
ADE-Integration aktualisieren

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

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

Details aktualisieren

Aktualisieren Sie im Abschnitt Body die Details, die geändert werden müssen.
3

Befehl ausführen

Wählen Sie die Schaltfläche Send aus.

​
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.
1

List-Befehl auswählen

Wählen Sie in der Collection Iru Endpoint API > Automated Device Enrollment Integrations > GET List ADE Integrations aus.
2

Befehl ausführen

Wählen Sie die Schaltfläche Send aus.
3

Erneuerung überprüfen

Die Variable days_left sollte 364 betragen, wenn der Renew-Befehl erfolgreich war.
4

Aktualisierungen überprüfen

Um eine Aktualisierung zu überprüfen, kontrollieren Sie die dem ADE-Token zugeordneten Informationen.

​
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.
1

Delete-Befehl auswählen

Wählen Sie in der Collection Iru Endpoint API > Automated Device Enrollment Integrations > DEL Delete ADE Integration aus.
2

Token-ID festlegen

Befüllen Sie die Variable ade_token_id mit der ID des ADE-Tokens.
3

Befehl ausführen

Wählen Sie die Schaltfläche Send aus.

​
Überlegungen

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