UEM-functionaliteit gebruiken met een REST API

U kunt externe applicaties configureren om de belangrijkste productfunctionaliteit van Workspace ONE UEM te gebruiken door REST API's in de UEM-infrastructuur te integreren, en connectiviteit te faciliteren. U kunt ook een OAuth-token-URL selecteren die het dichtst bij uw datacentrum ligt om API-aanroepen te verifiëren.

Aan de slag met REST API's

Met de vereenvoudigde REST-softwarearchitectuur, ondersteunen Workspace ONE UEM REST API's momenteel meerdere functies, zoals het beheer van organisatiegroepen, consolebeheer, mobiele applicaties, mobiele toestellen, e-mail, inschrijving van gebruikers, profielen, smart groups en gebruikersgroepen.

Het gebruik van REST API's biedt verschillende voordelen voor ondernemingen, zoals de besparing van kosten en tijd die anders worden besteed aan het zelf ontwikkelen van applicaties. Workspace ONE UEM REST API's zijn volledig functioneel en klaar om te worden geïntegreerd met bedrijfsservers, -programma's en -processen. Workspace ONE UEM REST API's zijn efficiënter, worden probleemloos uitgevoerd en kunnen makkelijk worden aangepast voor bedrijven. Deze API's zijn voor applicatieontwikkelaars. Deze handleiding biedt inzicht in het ontwerp en de architectuur van de API-bibliotheek en faciliteert bedrijfsspecifieke ontwikkeling en integratie met Workspace ONE UEM.

Documentatie voor API bekijken

U kunt gedetailleerde API-documentatie inkijken door naar de API-helppagina van Workspace ONE UEM te navigeren.

1. Meld u aan bij de Workspace ONE UEM Console als beheerder.
2. In de adresbalk van uw browser vervangt u de "cn" in de URL door "as" en voegt u vervolgens /api/help toe na .com.

Bijvoorbeeld: API-documentatie voor de URL van een SaaS-omgeving van ...

https://cn4855.awmdm.com

...is...

https://as4855.awmdm.com/api/help

Datacentra en token-URL's voor ondersteuning van OAuth 2.0

Workspace ONE UEM ondersteunt het OAuth 2.0 industriestandaardprotocol voor veilige verificatie en autorisatie van REST API-aanroepen. Workspace ONE Token Service is de tokenuitgever voor OAuth-verificatie en wordt ondersteund in SaaS-omgevingen. De token-URL's zijn specifiek voor een regio.

Een OAuth-client maken voor gebruik voor API-commando's (SaaS)

U kunt een OAuth-client maken voor gebruik voor API-commando's, die alleen wordt ondersteund in SaaS-omgevingen. Maak een OAuth-client voor uw SaaS-omgeving door de volgende stappen uit te voeren.

1. Navigeer naar Groepen en instellingen > Configuraties.

2. Typ OAuth in het zoekvak met de tekst Voer een naam of categorie in.

3. Selecteer de optie OAuth-clientbeheer die in de resultaten wordt weergegeven. Het scherm OAuth-clientbeheer wordt weergegeven.

4. Selecteer de knop Toevoegen.

5. Voer de Naam, Omschrijving, Organisatiegroep en Rol in.

   Opmerking: Voor meer informatie over specifieke REST API bevoegdheden voor de rol die u selecteert, raadpleegt u de sectie in dit onderwerp Een rol maken die REST API's kan gebruiken.

6. Zorg ervoor dat de Status is Ingeschakeld.

7. Selecteer Opslaan.

8. BELANGRIJK: Kopieer de Client-ID en het Clientgeheim naar het klembord en sla deze op voordat u dit scherm sluit. Selecteer het kopieer-icoon () om het Clientgeheim op het klembord te zetten.

   U kunt hier niet terugkeren om deze informatie op te halen nadat u Sluiten hebt geselecteerd.

9. Gebruik de client-ID, het clientgeheim en de token-URL om het toegangstoken in de volgende indeling te genereren:

   HTTP-AANVRAAG

   API-aanroep: POST {Region-Specific Token URL from section above}

   INVOERPARAMETERS

   Variabele	Vereist	Beschrijving
   tenant_url	Ja (URL)	Hostnaam van uw tenant
   grant_type=client_credentials	Ja (hoofdtekst)	Vereist om het toegangstoken te ontvangen
   application/x-www-form-urlencoded	Ja (koptekst)	Indeling van de codering
   Autorisatie: basis	Ja (koptekst)	U moet de gecodeerde Base64-tekenreeks van de client_id:Client_secret goedkeuren

10. Gebruik het geretourneerde toegangstoken om vervolgaanroepen naar Workspace ONE UEM API-servers te autoriseren. U moet het toegangstoken in de aanvraagheaders als volgt formatteren.

    API-aanroep: {UEM API}

    Sleutel	Waarde
    Autorisatie	{Toegangstoken}

Een rol maken die REST API's kan gebruiken

Elke API-aanroep heeft een bijbehorende bron (of recht) die u moet opnemen in de rol die u aan de OAuth-client toewijst. De op te nemen bevoegdheden in de rol die u toewijst aan de komen overeen met de soorten API-aanroepen die u uitvoert.

Gebruik de informatie in de volgende tabel om u te helpen bij het selecteren van de bevoegdheden die u moet opnemen in de rol die u toewijst. Ga dan naar de sectie Beheerdersrol maken in Rol-gebaseerde toegang voor instructies over het maken van die rol.