Kunde erstellen

Erstellt ein Company-Objekt, um ein Unternehmen (Kunden) für die Knox- oder Zero-Touch-Registrierung eindeutig zu identifizieren. Nachdem die Methode erfolgreich zurückgegeben wurde, können die angegebenen Inhaber (primary_emails) oder Administratoren (secondary_emails) ihre E-Mail-Adressen mit einem Google-Konto verknüpfen, um auf das Zero-Touch-Portal zuzugreifen (Zero-Touch-Registrierung für IT-Administratoren) oder mit einem Samsung-Konto, um auf das Knox Mobile Enrollment (KME)-Portal zuzugreifen.

Methodensignatur

public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;

CreateCustomerRequest

Property-Name Wert Erforderlich Beschreibung
customer_name string Ja Name des Unternehmens Beispiel: XYZ Corp. Wird den Mitarbeitern des Unternehmens im Portal für die Zero-Touch-Registrierung angezeigt.
primary_emails Liste mit object(string) Ja Zero-Touch: E-Mail-Adresse des Kunden mit der Rolle „Inhaber“. Es muss mindestens eine E-Mail-Adresse eingegeben werden. Jede E-Mail-Adresse muss mit einem Google-Konto verknüpft sein. Inhaber haben denselben Zugriff wie Administratoren. Als Inhaber können sie aber auch die Nutzer des Portals Ihrer Organisation hinzufügen, löschen und bearbeiten.

Samsung: E-Mail-Adresse des Super Admins des Kunden. Samsung verwendet nur die erste E-Mail-Adresse in der Liste. Die E-Mail-Adresse muss mit einem Samsung-Konto verknüpft sein.
secondary_emails Liste mit object(string) Nein E-Mail-Adresse der Nutzer des Kunden mit der Administratorrolle. Jede E-Mail-Adresse muss mit einem Google-Konto verknüpft sein. Hinweis:Diese Eigenschaft wird von Samsung nicht unterstützt.
vendorParams map Zero-Touch: Nein

Samsung: Ja
Zusätzliche Felder, vom Anbieter angegebenes Schlüssel/Wert-Paar. Für Anfragen der Klasse SamsungResellerService müssen folgende Werte angegeben werden:

„country“: ISO 3166-1-Ländercode des Kunden, z. B. „US“.

„firstName“: Vorname des Kunden (max. 60 Zeichen).

„lastName“: Nachname des Kunden (max. 60 Zeichen).

„service“: „KME“ ist der einzige unterstützte Wert.

CreateCustomerResponse

Property-Name Wert Beschreibung
customer object(Company) Objekt mit Details zum neu erstellten Kunden.
vendor_params map Zusätzliche Felder, vom Anbieter angegebenes Schlüssel/Wert-Paar (nur Samsung).

Fehlerverhalten

Wenn ein Fehler auftritt, gibt die Bibliothek eine CommonException aus, die eines der folgenden Fehlercodes:

CommonException

Fehlercode
INTERNAL_SERVER_ERROR