English

Massenimport und Claim

Zweck

Eine Charge gefertigter Geräte aus einer CSV-Datei importieren und sie dann von einer Organisation übernehmen lassen. So bringen Sie Geräte in großer Zahl auf die Plattform; das ist der Weg für die Produktion.

Voraussetzungen

• Sie sind angemeldet. Für Import und Export brauchen Sie Orders (Menügruppe OEM), für die Übernahme Devices (Menügruppe FLEET). Siehe Anmelden.
• Für den Import die Rolle Org Admin. Zum Übernehmen von Geräten brauchen Sie die Berechtigung device:import, also die Rolle Org Admin in der Organisation, in die Sie die Geräte übernehmen.
• Eine Fertigungs-CSV: eine Zeile pro Gerät, getrennt durch Komma oder Semikolon.

In der Konsole gibt es keinen Schritt „Bestellung anlegen“

Unter Orders gibt es keine Schaltfläche, um eine Bestellung anzulegen. Wenn Sie auf Import devices from CSV klicken, landen die Geräte automatisch in der eigenen Bestellung Ihrer Organisation für manuelle Einträge (derselben, die auch Gerät hinzufügen verwendet). Sie müssen vorher nichts einrichten.

Schritte

Aus einer CSV importieren

1. Öffnen Sie Orders und klicken Sie auf Import devices from CSV.

   

2. 1. Upload: Ziehen Sie Ihre CSV-Datei in das Feld oder wählen Sie sie über den Dateidialog aus.

   

3. 2. Map columns (erscheint nur, wenn der Import eine Bestätigung von Ihnen braucht, zum Beispiel für eine Spalte, die er nicht erkennt. Eine CSV mit genau den vier unten genannten Spaltennamen springt direkt zur Vorschau). Die Spalten werden über ihre Überschrift zugeordnet. Spalten ohne Zuordnung werden ignoriert.

4. 3. Preview: zeigt eine Zeile pro Gerät, mit VALID oder BLOCKED und dem Grund.

   

5. Klicken Sie auf Commit N valid rows.

   

Die CSV-Spalten

Spalte	Pflicht	Hinweise
eui	Ja	16 Hex-Zeichen (0–9, a–f); Doppelpunkte, Bindestriche, Punkte und Leerzeichen sind erlaubt und werden entfernt. Gespeichert werden 16 Kleinbuchstaben. Eine Zeile mit einer anderen EUI wird blockiert. Zwei Zeilen mit derselben EUI in unterschiedlicher Schreibweise zählen als Duplikat.
serial_number	Ja	Freier Text, es sei denn, für die Bestellung ist ein Format für Seriennummern festgelegt. Dann muss jede Seriennummer dazu passen, sonst wird die Zeile mit Serial doesn't match this order's format: … blockiert.
attestation_level	Ja	tpm oder soft. Es gibt keinen Standardwert. Wählen Sie den Weg, den die Hardware tatsächlich zur Attestierung nutzt.
ak_fingerprint	Für tpm-Zeilen, nur im Allowlist-Modus	Der Hinweis beim Hochladen nennt sie: „One row per device: EUI, serial, ak_fingerprint, attestation level.“ (eine Zeile pro Gerät). Ist der Vertrauensanker dieser Bestellung stattdessen eine Geräte-CA, lassen Sie diese Spalte leer: Dann beweist das Geburtszertifikat des Geräts seine Echtheit, nicht ein hinterlegter Fingerprint.
—	Für soft-Zeilen	Für das Geheimnis der Soft-Attestierung gibt es keine Spalte, die funktioniert (auch device_secret, das im Hinweistext des Dialogs Gerät hinzufügen genannt wird, wird nicht erkannt). Jede soft-Zeile wird blockiert, bevor Sie Commit erreichen. Fragen Sie den Support, wie Sie sie über die API importieren, bis der Assistent ein Feld dafür hat.

Statt ak_fingerprint kann eine tpm-Zeile das eigene Zertifikat des Geräts in einer Spalte identity_cert tragen, und ein erneuter Import kann die Identität von Geräten aktualisieren, die schon in der Bestellung sind: siehe Identität eines Geräts registrieren.

Was jeder Modus des Vertrauensankers für diese Geräteliste bedeutet, steht unter Wie die Geräteidentität funktioniert, dort auch, was ein Hersteller pro Charge liefert.

Früher importierte Geräte mit einer EUI, die nicht aus Hex-Zeichen besteht

Geräte, die importiert wurden, bevor es diese Prüfung gab, können eine Kennung haben, die nicht aus 16 Hex-Zeichen besteht. Sie bleiben nutzbar, und nichts wird umgestellt. Alle anderen Felder können Sie weiter bearbeiten; ihr Feld EUI ist schreibgeschützt, mit einer kurzen Erklärung. Siehe Gerät bearbeiten.

Ergebnis

Wenn Sie gültige Zeilen übernehmen, schreibt die Plattform einen Audit-Eintrag (batch.imported), und der Dialog schließt sich. Fehler blockieren nur ihre eigene Zeile. Auch aus einer teilweise fehlerhaften CSV wird also alles übernommen, was die Prüfung bestanden hat.

Claim-Codes exportieren

1. Klicken Sie wieder unter Orders auf Export claim codes.

   Damit startet ein Datei-Download (eine CSV mit Claim-Codes); die Seite selbst ändert sich nicht. Es gibt also keine Bestätigung auf dem Bildschirm, die man zeigen könnte.

Geräte übernehmen

Die Organisation, die die Charge bekommt, übernimmt sie unter Devices. Das ist der letzte Schritt dieser Seite, keine eigene Anleitung.

1. Öffnen Sie Devices und klicken Sie auf Claim devices. Der Dialog steht zuerst auf By claim code: Fügen Sie einen Code pro Zeile ein.

   

2. Oder wechseln Sie zu By order number und geben Sie stattdessen die Bestellnummer ein.

   

Häufige Fehler

Meldung in der Konsole	Was Sie tun
Missing ak_fingerprint, Zeile BLOCKED	Bei einer tpm-Zeile: Tragen Sie den Fingerprint in einer Spalte ak_fingerprint ein. Bei einer soft-Zeile: Mit diesem Assistenten lässt sich das derzeit nicht beheben; fragen Sie den Support.
Serial doesn't match this order's format: …	Die Seriennummer passt nicht zu dem Format, das für diese Bestellung festgelegt ist. Korrigieren Sie sie und laden Sie die Datei erneut hoch.
1 ROWS BLOCKED / „Fix the CSV and re-upload, or commit the 0 valid rows now and import the rest later.“ (CSV korrigieren und neu hochladen, oder die gültigen Zeilen jetzt übernehmen und den Rest später importieren)	Fehler blockieren nur ihre eigene Zeile. Sie können die gültigen Zeilen übernehmen und für den Rest eine korrigierte Datei erneut hochladen.
Beim Übernehmen heißt es, ein Code sei unbekannt oder schon benutzt	Ein Tippfehler, oder das Gateway wurde schon übernommen. Prüfen Sie den Code. Hat jemand anderes es übernommen, wenden Sie sich an den Support.