Émettre des jetons Entra avec Azure CLI

Utilisez Azure CLI pour émettre un jeton Microsoft Entra et appeler des API REST Azure DevOps. Étant donné que les jetons d’accès Entra ne durent qu’une heure, ils sont idéaux pour les opérations ponctuelles rapides. Vous pouvez utiliser Azure CLI pour acquérir un jeton utilisateur pour vous-même ou pour le compte d’un principal de service.

Conditions préalables

Catégorie	Spécifications
Entra tenant et abonnement	Vérifiez que l’abonnement est associé au locataire connecté à l’organisation Azure DevOps auquel vous essayez d’accéder. Si vous ne connaissez pas votre locataire ou votre ID d’abonnement, vous pouvez le trouver dans le portail Azure.
Azure CLI	Téléchargez et installez Azure CLI.
Application Entra	(Si l'authentification pour un principal de service est nécessaire) Créez l'application Entra et veillez à disposer de l'ID client et de la clé secrète client de l'application.

Connectez-vous à l’Azure CLI en utilisant la commande az login et suivez les instructions affichées à l’écran.
Définissez l’abonnement approprié pour l’utilisateur connecté avec ces commandes bash. Assurez-vous que l’ID d’abonnement Azure est associé au locataire connecté à l’organisation Azure DevOps à laquelle vous essayez d’accéder. Si vous ne connaissez pas votre ID d’abonnement, vous pouvez le trouver dans le portail Azure.
```
az account set -s <subscription-id>
```
Générez un jeton d’accès d’ID Microsoft Entra avec la commande az account get-access-token à l’aide de l’ID de ressource Azure DevOps : 499b84ac-1321-427f-aa17-267ca6975798.
```
az account get-access-token \
--resource 499b84ac-1321-427f-aa17-267ca6975798 \
--query "accessToken" \
-o tsv
```

Obtenir un jeton pour un utilisateur

Connectez-vous à Azure PowerShell à l’aide de la commande Connect-AzAccount et suivez les instructions à l’écran.
Définissez l’abonnement approprié pour l’utilisateur connecté avec ces commandes PowerShell. Assurez-vous que l’ID d’abonnement Azure est associé au locataire connecté à l’organisation Azure DevOps à laquelle vous essayez d’accéder. Si vous ne connaissez pas votre ID d’abonnement, vous pouvez le trouver dans le portail Azure.
```
Set-AzContext -Subscription <subscriptionID>
```
Générez un jeton d’accès d’ID Microsoft Entra avec la commande Get-AzAccessToken à l’aide de l’ID de ressource Azure DevOps : 499b84ac-1321-427f-aa17-267ca6975798.
```
Get-AzAccessToken -ResourceUrl '499b84ac-1321-427f-aa17-267ca6975798'
```

Remarque

Get-AzAccessToken retourne le jeton en tant que SecureString. Si vous ne savez pas comment utiliser SecureString, reportez-vous à la documentation. Pour convertir un SecureString en texte brut à utiliser dans un en-tête d’authentification, tirez parti de la classe .NET [System.Runtime.InteropServices.Marshal] pour convertir SecureString en pointeur BSTR (chaîne binaire), puis lisez le pointeur en tant que chaîne de texte brut en variable.

Obtenir un jeton pour un principal de service

Connectez-vous à Azure CLI en tant que principal de service à l’aide de la az devops login commande.
Suivez les instructions à l’écran et terminez la connexion.

# To authenticate a service principal with a password or cert:
az login --service-principal -u <app-id> -p <password-or-cert> --tenant <tenant>

# To authenticate a managed identity:
az login --identity

Définissez l’abonnement correct et approprié pour le service principal connecté en entrant la commande :

az account set -s <subscription-id>

Générez un jeton d’accès d’ID Microsoft Entra avec l’ID az account get-access-token de ressource Azure DevOps : 499b84ac-1321-427f-aa17-267ca6975798.

$accessToken = az account get-access-token --resource 499b84ac-1321-427f-aa17-267ca6975798 --query "accessToken" --output tsv

Remarque

Utilisez l’ID d’application Azure DevOps, et non notre URI de ressource, pour générer des jetons.

À présent, vous pouvez utiliser az cli comme d'habitude. Essayons d’appeler une API Azure DevOps en transmettant un Bearer jeton dans les en-têtes :

$apiVersion = "7.1-preview.1"
$uri = "https://dev.azure.com/${yourOrgname}/_apis/projects?api-version=${apiVersion}"
$headers = @{
    Accept = "application/json"
    Authorization = "Bearer $accessToken"
}
Invoke-RestMethod -Uri $uri -Headers $headers -Method Get | Select-Object -ExpandProperty value ` | Select-Object id, name

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-09-18

Partager via

Émettre des jetons Entra avec Azure CLI

Conditions préalables

Obtenir un jeton Entra pour vous-même

Commentaires

Ressources supplémentaires