Condividi tramite

Ottenere i token di accesso al servizio

L'accesso alle API REST ARR viene concesso solo agli utenti autorizzati. Per dimostrare l'autorizzazione, è necessario inviare un token di accesso insieme alle richieste REST. Questi token vengono emessi dal servizio token di sicurezza (STS) in cambio di una chiave dell'account. I token hanno una durata di 24 ore e quindi possono essere rilasciati agli utenti senza concedere loro l'accesso completo al servizio.

Questo articolo descrive come creare tale token di accesso.

Prerequisiti

Crea un account ARR, se non ne hai ancora uno.

API REST del servizio token

Per creare token di accesso, il servizio token sicuro fornisce una singola API REST. L'URL del servizio token di sicurezza dipende dal dominio dell'account dell'account di rendering remoto. È nel formato https://sts.[dominio account], ad esempio https://sts.southcentralus.mixedreality.azure.com

Richiesta 'Get token'

URI metodo
/accounts/accountId/token GET
Intestazione Valore
Autorizzazione "Bearer accountId:accountKey"

Sostituire accountId e accountKey con i rispettivi dati.

Risposta 'Get token'

Codice di stato payload JSON Commenti
200 AccessToken: stringa Success
Intestazione Scopo
MS-CV Questo valore può essere usato per tracciare la chiamata all'interno del servizio

Recupero di un token con PowerShell

Il codice di PowerShell seguente illustra come inviare la richiesta REST necessaria al servizio token di sicurezza. Quindi stampa il token al prompt di PowerShell.

$accountId = "<account_id_from_portal>"
$accountKey = "<account_key_from_portal>"
$accountDomain = "<account_domain_from_portal>

[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12;
$webResponse = Invoke-WebRequest -Uri "https://sts.$accountDomain/accounts/$accountId/token" -Method Get -Headers @{ Authorization = "Bearer ${accountId}:$accountKey" }
$response = ConvertFrom-Json -InputObject $webResponse.Content

Write-Output "Token: $($response.AccessToken)"

Lo script stampa solo il token nell'output, da dove è possibile copiarlo e incollarlo. Per un progetto reale, è consigliabile automatizzare questo processo.

Passaggi successivi