Erneuern, Aktualisieren oder Löschen mehrerer Token für die automatische Geräteregistrierung

Wenn Sie automatisierte Device Enrollment -Token hinzufügen müssen, lesen Sie bitte den Configure Multiple Automated Device Enrollment Tokens Artikel.

Wenn Sie sich nicht sicher sind, diesen Vorgang selbst durchzuführen, wenden Sie sich bitte an Kandji Support, um weitere Informationen zu erhalten.

Konfigurieren Kandji API-Tokens

Bereiten Sie das API-Token vor, und speichern Sie es an einem sicheren Ort. Mehr dazu erfährst du in unserem Kandji API-Artikel. Sie können diesen Abschnitt überspringen, wenn Sie bereits ein API-Token vorbereitet haben.

  1. Erstellen oder ändern Sie ein vorhandenes API-Token.

  2. Navigieren Sie in Ihrem Kandji Mandanten zu Einstellungen > Zugriff auf > API-Token.

  3. Erstellen oder ändern Sie das vorhandene API-Token, um alle Berechtigungen für automatisierte Device Enrollment einzuschließen.

Vorbereitung von Postman

Für die grundlegende Konfiguration befolgen Sie bitte unseren Artikel So richten Sie die Kandji -API in Postman ein. Die meisten Schritte werden in der Postman-Anwendung auf Ihrem Gerät ausgeführt. Sie können diesen Abschnitt überspringen, wenn Sie Postman bereits konfiguriert haben.

  1. Suchen Sie in Ihrer Sammlung nach dem Ordner Automatisierte Device Enrollment Integrationen.

  2. Wenn dieser Ordner fehlt, gehen Sie zu api-docs.kandji.io, klicken Sie auf die Schaltfläche In Postman ausführen und führen Sie die Schritte zum Importieren der neuen API-Version aus.

  3. Definieren Sie Ihre API-URL, falls nicht definiert, im API-Ordner Kandji oben in der Sammlung.

  4. Definieren Sie das API-Token in Ihren Umgebungsvariablen, indem Sie unserem Artikel Einrichten der Kandji -API in Postman folgen.

Konfigurieren von Postman-Umgebungsvariablen

Nachdem Sie nun die Grundlagen von Postman konfiguriert haben, müssen Sie einige Umgebungsvariablen in Postman definieren, um den Überblick über die automatisierten Device Enrollment Server zu behalten.

  1. Befolgen Sie die Anweisungen im Abschnitt Create Environment Variables unseres Artikels Einrichten der Kandji-API in Postman.

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

  3. Wählen Sie die Kandji API > Automated Device Enrollment Integrations > GET List ADE Integrations in der Collection aus.

  4. Klicken Sie auf die Schaltfläche Senden. 

  5. Im Abschnitt Text der Ergebnisse kopieren Sie die IDs der obersten Ebene jedes Tokens für automatisierte Device Enrollment.

  6. Für jede dieser IDs erstellen Sie eine Umgebungsvariable mit einem Benennungsschema wie "ade_token_1" und erhöhen die Zahl am Ende für jedes Token.

  7. Notieren Sie sich die zugeordneten server_name für jedes Token. Sie benötigen diese Informationen, wenn Sie die Token von Apple Business Managerherunterladen. 

  8. Fügen Sie den ID-Wert für jedes Token in den Wert für die Maschinenvariable "ade_token_#" ein.

  9. Sie können den Variablentyp auf secret setzen, sodass der Wert der Variablen nicht sichtbar ist. 

ADE-Token herunterladen

  1. Melden Sie sich bei Ihrem Apple Business Manager Konto an.

  2. Klicken Sie unten links auf Ihr Profil und wählen Sie Einstellungen. 

  3. Klicken Sie auf den ersten MDM Server, der mit dem ersten ADE-Token aus der zuvor erstellten Liste übereinstimmt.

  4. Klicken Sie auf Servertoken MDM herunterladen

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

Erstellen einer Postman-Ordnervorlage

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

  1. Klicken Sie auf die Auslassungspunkte neben dem Ordner Automated Device Enrollment Integrations.

  2. Klicken Sie auf Ordner hinzufügen. 

  3. Nennen Sie den Ordner ADE_Token1.

  4. Wählen Sie die Elemente ADE-Integration erneuern und ADE-Integration aktualisieren im Ordner Automatisierte Device Enrollment Integrationen aus.

  5. Klicken Sie mit der rechten Maustaste darauf, und wählen Sie Kopieren aus.

  6. Klicken Sie auf die Ellipse neben dem Ordner ADE_Token1.

  7. Klicken Sie auf Einfügen.

Modifiziere Renew Item

  1. Wählen Sie das Element ADE-Integration erneuern aus.

  2. Benennen Sie es in Renew ADE1 Integration um.

  3. Klicken Sie im rechten Bereich auf die Adressleiste links neben der Schaltfläche Senden.

  4. Markieren Sie den Text innerhalb von {{ade_token_ade}} und aktualisieren Sie ihn auf {{ade_token_1}}.

  5. Klicken Sie unten auf die Registerkarte Körper.

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

  7. Klicken Sie für die Datei neben allen aktuellen Dateien auf x, und klicken Sie dann auf Dateien auswählen.

  8. Wählen Sie die .p7m-Datei aus, die diesem ADE-Token entspricht.

  9. Speichern Sie die Änderungen.

Modifiziere Update Item

  1. Wählen Sie das Element ADE-Integration aktualisieren aus.

  2. Benennen Sie es in Update ADE1 Integration um.

  3. Klicken Sie im rechten Bereich auf die Adressleiste links neben der Schaltfläche Senden.

  4. Markieren Sie den Text innerhalb von {{ade_token_ade}} und aktualisieren Sie ihn auf {{ade_token_1}}.

  5. Klicken Sie unten auf die Registerkarte Körper.

  6. Hier können Sie neue blueprint_id-, Telefon- und E-Mail-Informationen eingeben. 

  7. Speichern Sie die Änderungen.

Duplizieren ADE_Token Ordner

  1. Klicken Sie auf die Ellipse neben dem Ordner ADE_Token1.

  2. Wählen Sie Duplizieren aus. 

  3. Aktualisieren Sie den Inhalt des Ordners mit dem oben beschriebenen Verfahren.

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

ADE-Integration erneuern

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

  1. Wählen Sie die Kandji API > Automatisierte Device Enrollment Integrationen > ADE_Token# > ADE#-Integration erneuern aus.

  2. Klicken Sie auf die Schaltfläche Senden. 

Aktualisieren der ADE-Integration

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

  1. Wählen Sie die Kandji-API > automatisierte Device Enrollment Integrationen > ADE_Token# aus, > ADE#-Integration aktualisieren.

  2. Aktualisieren Sie die Details im Abschnitt Text, die aktualisiert werden müssen.

  3. Klicken Sie auf die Schaltfläche Senden. 

Überprüfen Sie die aktuellen Integrationen

Kandji API > Automatisierte Device Enrollment-Integrationen > Befehl GET List ADE Integrations gibt uns alle aktuellen ADE-Integrationen, damit wir überprüfen können, ob die Integration erfolgreich erneuert oder aktualisiert wurde.

  1. Wählen Sie Kandji API > Automatisierte Device Enrollment Integrationen aus > GET Listen Sie ADE-Integrationen in der Sammlung auf.

  2. Klicken Sie auf die Schaltfläche Senden.

  3. Die Variable days_left sollte 364 sein, wenn der Befehl Renew erfolgreich war. 

  4. Um ein Update zu überprüfen, überprüfen Sie die Informationen, die dem ADE-Token zugeordnet sind, um sicherzustellen, dass es aktualisiert wurde.

Integration löschen

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

  • Wählen Sie Kandji API > Automatisierte Device Enrollment Integrationen > DEL Delete ADE-Integration in der Sammlung aus.

  • Füllen Sie die Variable ade_token_id mit der ID des ADE-Tokens auf.

  • Klicken Sie auf die Schaltfläche Senden.