Uso della funzionalità UEM con un'API REST

È possibile configurare le applicazioni esterne in modo che utilizzino la funzionalità di base del prodotto di Workspace ONE UEM integrando le API REST con l'infrastruttura UEM e facilitando la connettività. È inoltre possibile selezionare un URL del token OAuth più vicino al data center per autenticare le chiamate API.

Introduzione alle API REST

Utilizzando l'architettura semplificata del software REST, le API REST di Workspace ONE UEM supportano attualmente più funzionalità, tra cui gruppo, amministrazione della console, applicazione mobile, dispositivo mobile, e-mail, utente di registrazione, profilo, gruppo smart e gestione gruppi utente.

L'utilizzo di API basate su REST offre diversi vantaggi alle aziende, tra cui la riduzione dei costi e dei tempi per lo sviluppo di applicazioni in-house. Le API REST di Workspace ONE UEM dispongono di funzionalità complete e sono pronte per essere integrate nei server, programmi e processi aziendali. Le API REST di Workspace ONE UEM sono più efficienti, possono essere eseguite senza alcuna difficoltà e commercializzate facilmente. Queste API sono destinate agli sviluppatori di applicazioni. Questa guida illustra la progettazione e l'architettura della libreria API e facilita lo sviluppo e l'integrazione personalizzati con Workspace ONE UEM.

Accesso alla documentazione dell'API

Esaminare la documentazione dettagliata dell'API andando alla pagina della Guida relativa all'API di Workspace ONE UEM.

1. Accedi alla Workspace ONE UEM Console come amministratore.
2. Nella barra degli indirizzi del browser, sostituire "cn" nell'URL con "as", quindi aggiungere /api/help .com.

Ad esempio, la documentazione dell'API per l'URL di un ambiente SaaS di...

https://cn4855.awmdm.com

...è...

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

Data center e URL token per il supporto di OAuth 2.0

Workspace ONE UEM supporta il protocollo OAuth 2.0 standard del settore per l'autenticazione sicura e l'autorizzazione per le chiamate API REST. Workspace ONE Token Service è l'emittente del token per l'autenticazione OAuth ed è supportato solo negli ambienti SaaS. Gli URL dei token sono specifici per regione.

Creare un client OAuth da utilizzare per i comandi API (SaaS)

È possibile creare un client OAuth da utilizzare per i comandi API, supportato solo negli ambienti SaaS. Creare un client OAuth per l'ambiente SaaS utilizzando i passaggi seguenti.

1. Vai su Gruppi e impostazioni > Configurazioni.

2. Immettere OAuth nella casella di testo di ricerca denominata "Immettere un nome o una categoria".

3. Selezionare la voce Gestione client OAuth visualizzata nei risultati. Viene visualizzata la schermata Gestione client OAuth.

4. Selezionare il pulsante Aggiungi.

5. Immettere Nome, Descrizione, Gruppo organizzazione e Ruolo.

   Nota: per ulteriori informazioni riguardo specifici permessi API REST per il suolo selezionato, consulta le sezione di questo argomento intitolata Crea un ruolo che possa usare gli API REST.

6. Assicurarsi che lo Stato sia Abilitato.

7. Seleziona Salva.

8. IMPORTANTE: Copia l'ID Client e il Client segreto negli appunti e salvali prima che di chiudere questa schermata. Seleziona l'icona Copia ()per inviare ilClient segreto negli appunti.

   Non è possibile ritornare a questa schermata per recuperare le informazioni dopo aver selezionato Chiudi.

9. Utilizzare l'ID client, il segreto client e l'URL del token per generare il token di accesso nel formato seguente:

   RICHIESTA HTTP

   Chiamata API: POST {URL del token specifico per la regione dalla sezione precedente}

   PARAMETRI DI INPUT.

   Parametro	Necessario	Descrizione
   tenant_url	Sì (URL)	Nome host del tenant
   grant_type=client_credentials	Sì (corpo)	Necessario per ricevere il token di accesso
   application/x-www-form-urlencoded	Sì (intestazione)	Formato della codifica
   Autorizzazione: Base	Sì (intestazione)	È necessario passare la stringa codificata Base64 del client_id:Client_secret

10. Utilizzare il token di accesso restituito per autorizzare le richieste API future ai server API di Workspace ONE UEM. È necessario formattare il token di accesso nelle intestazioni della richiesta, come indicato di seguito.

    Chiamata API: {API UEM}

    Chiave	Valore
    Autorizzazione	{Token di accesso}

Creazione di un ruolo che possa utilizzare le REST API

Ogni chiamata API ha una risorsa (o autorizzazione) corrispondente che è necessario includere nel ruolo assegnato al client OAuth. Pertanto, le autorizzazioni da includere nel ruolo assegnato si allineano con i tipi di chiamate API che si stanno effettuando.

Utilizzare le informazioni riportate nella tabella seguente per selezionare le autorizzazioni da includere nel ruolo assegnato. Passare quindi alla sezione intitolata Crea ruolo amministratore in Accesso basato sul ruolo per istruzioni sulla creazione di tale ruolo.