Autoriser un appareil

Obtenez un code d’appareil pour lancer le Device Authorization Flow sur des appareils à capacités de saisie limitées.

​

Point de terminaison

POST /oauth/device/code

Ce flux est conçu pour permettre à des appareils à saisie limitée d’accéder à une API. Utilisez ce point de terminaison pour obtenir un code d’appareil qui permet à l’utilisateur d’autoriser l’appareil.

​

Exemple de requête

POST https://{yourDomain}/oauth/device/code
Content-Type: application/x-www-form-urlencoded

client_id=${account.clientId}&scope=SCOPE&audience=API_IDENTIFIER

​

Valeurs de réponse

Valeur	Description
device_code	Le code unique de l’appareil.
user_code	Le code que l’utilisateur doit saisir pour autoriser l’appareil.
verification_uri	L’URL que l’utilisateur doit visiter pour autoriser l’appareil.
verification_uri_complete	L’URL complète, y compris le code utilisateur, pour y accéder facilement.
expires_in	La durée de validité des codes de l’appareil et de l’utilisateur, en secondes.
interval	L’intervalle d’interrogation, en secondes, pour effectuer une demande de jeton.

​

Remarques

• Incluez offline_access dans le scope pour obtenir un jeton d’actualisation.
• Utilisez le code d’appareil renvoyé pour demander un jeton d’accès au point de terminaison des jetons.

​

Exemple de requête de jeton

POST https://{yourDomain}/oauth/token
Content-Type: application/x-www-form-urlencoded

client_id=${account.clientId}&device_code=YOUR_DEVICE_CODE&grant_type=urn:ietf:params:oauth:grant-type:device_code

​

Réponses

​

200

Une requête réussie retourne un jeton d’accès.

HTTP/1.1 200 OK
Content-Type: application/json
{
   "access_token": "eyJz93a...k4laUWw",
   "id_token": "eyJ...0NE",
   "refresh_token": "eyJ...MoQ",
   "expires_in": 86400,
   "token_type": "Bearer"
}

​

Réponses d’erreur

HTTP/1.1 403 Forbidden
Content-Type: application/json
{ "error": "authorization_pending", "error_description": "User has yet to authorize device code." }

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
{ "error": "slow_down", "error_description": "You are polling faster than the specified interval of 5 seconds." }

HTTP/1.1 403 Forbidden
Content-Type: application/json
{ "error": "access_denied", "error_description": "User cancelled the confirmation prompt." }

​

En savoir plus

• Device Authorization Flow
• Appeler une API à l’aide du Device Authorization Flow
• Configurer une autorisation Device Code à l’aide du Dashboard de gestion

​

Paramètres du corps

client_id · string · requis

L’ID de votre application.

scope · string

Les scopes pour lesquels vous souhaitez demander une autorisation.

audience · string

L’identifiant unique de l’API cible à laquelle vous souhaitez accéder.

resource · string

L’identifiant de l’API cible (serveur de ressources) à laquelle vous souhaitez accéder. Il doit correspondre à un identifiant d’API enregistré dans votre tenant Auth0. Il est utilisé à la place de audience lorsque le profil de compatibilité du paramètre de ressource du tenant est défini sur compatibility.

​

Schéma de réponse

​

Messages de réponse

Statut	Description
200	Renvoie les codes de l’appareil et de l’utilisateur.