Erstellt ein Company
Objekt zur eindeutigen Identifizierung eines Unternehmens (Kunden) für Knox oder Zero-Touch
Registrierung. Nachdem die Methode erfolgreich zurückgegeben wurde, haben die angegebenen Inhaber (primary_emails
)
oder Administratoren (secondary_emails
) können ihre E-Mail-Adressen mit einem
Konto für den Zugriff auf das Zero-Touch-Portal
Weitere Informationen finden Sie unter Zero-Touch-Registrierung für IT-Administratoren.
oder ein Samsung-Konto, um auf das Knox Mobile Enrollment-Portal (KME) zuzugreifen.
Methodensignatur
public CreateCustomerResponse createCustomer(CreateCustomerRequest request) throws CommonException;
CreateCustomerRequest
Property-Name | Wert | Erforderlich | Beschreibung |
---|---|---|---|
customer_name |
string |
Ja | Der 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 der Nutzer 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 übernimmt nur die erste E-Mail 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. Anfragen aus der Klasse „SamsungResellerService “ müssen Folgendes enthalten:„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 |