Dépannage : une identité managée ne peut pas se connecter à Azure SQL depuis Azure Batch
Runbook : symptômes, messages d'erreur et vérifications (identité affectée au pool, CREATE USER FROM EXTERNAL PROVIDER, audience du jeton, pare-feu, point de terminaison privé, caches).
Une tâche Azure Batch qui se connecte à Azure SQL avec une identité managée affectée à l'utilisateur (UAMI) et qui reçoit Login failed : c'est un classique, et la cause est rarement là où on la cherche en premier. Voici le runbook que j'applique, dans l'ordre, du plus rapide au plus lourd.
Symptômes et messages
| Message | Piste |
|---|---|
Login failed for user '<guid>@<tenant>' (erreur 18456) |
jeton émis, mais refusé côté SQL |
Login failed for user '<token-identified principal>' |
idem, utilisateur de base absent ou mal créé |
Client with IP address '...' is not allowed to access the server (40615) |
pare-feu du serveur |
Login timeout expired / hôte injoignable |
réseau, point de terminaison privé, DNS |
Échec à l'obtention du jeton (Connect-AzAccount -Identity ou appel au service de métadonnées) |
identité non affectée au pool |
Point utile : Azure SQL renvoie toujours le même état (1) au client pour un 18456 ; il ne dit rien de la cause. Le GUID dans le message est le ClientID de l'identité : s'il correspond à l'identité attendue, le jeton est bon et le problème est côté SQL.
Schéma de décision
flowchart TD
A["Login failed"] --> B["Jeton obtenu ?"]
B -->|non| C["Identité affectée au pool ?"]
B -->|oui| D["Audience et ClientID corrects ?"]
D -->|non| E["Corriger config / audience"]
D -->|oui| F["Utilisateur dans la base ?"]
F -->|non| G["CREATE USER FROM EXTERNAL PROVIDER"]
F -->|oui| H["Réseau : pare-feu / endpoint privé"]
H --> I["Cache d'authentification : flush et attente"]
Étape 1 : l'identité est-elle affectée au pool ?
Sur le nœud, le service de métadonnées ne peut émettre un jeton que pour une identité attachée au pool (ou à la VM). Vérifiez dans la définition du pool que l'UAMI est bien listée. Une identité ajoutée au pool après sa création peut exiger de recréer ou redimensionner les nœuds pour être visible : testez sur un nœud récent.
Étape 2 : la configuration vise-t-elle la bonne identité ?
Erreur fréquente : une configuration copiée d'un environnement avec seulement le nom changé, donc des identifiants (ObjectId, ClientID) d'une autre identité. Le jeton est valide mais pour le mauvais principal, et tout ce qui suit paraît cassé. Vérifiez en 30 secondes :
Get-AzADServicePrincipal -DisplayName 'uami-dba-batch' |
Select-Object Id, AppId # Id = ObjectId, AppId = ClientID
Étape 3 : décoder le jeton (audience et revendications)
Depuis un nœud où l'identité est affectée, demandez un jeton pour l'audience Azure SQL et décodez-le :
$uri = 'http://169.254.169.254/metadata/identity/oauth2/token' +
'?api-version=2018-02-01&resource=https%3A%2F%2Fdatabase.windows.net%2F' +
'&client_id=00000000-0000-0000-0000-000000000000'
$t = (Invoke-RestMethod -Uri $uri -Headers @{ Metadata = 'true' }).access_token
$p = $t.Split('.')[1].Replace('-','+').Replace('_','/')
switch ($p.Length % 4) { 2 { $p += '==' } 3 { $p += '=' } }
[Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($p)) |
ConvertFrom-Json | Select-Object aud, oid, appid, iat
Contrôlez : aud désigne bien Azure SQL (ressource https://database.windows.net/) ; oid et appid sont ceux attendus ; iat est récent. Un jeton peut être mis en cache : un jeton émis avant un changement Entra (appartenance à un groupe, par exemple) ne le contient pas.
Étape 4 : l'utilisateur existe-t-il dans la base ?
Dans la base cible, en administrateur :
SELECT name, type_desc, authentication_type_desc,
DATALENGTH(sid) AS sid_bytes
FROM sys.database_principals
WHERE type IN ('E', 'X'); -- E = utilisateur externe, X = groupe externe
S'il manque :
CREATE USER [uami-dba-batch] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [uami-dba-batch];
Le SID doit faire 16 octets. Ne validez pas un SID avec CONVERT(uniqueidentifier, sid) : la conversion tronque en silence et masque un SID mal formé. En cas de doute, DROP USER puis recréation. L'identité peut aussi passer par un groupe Entra : dans ce cas c'est le groupe qui doit exister comme utilisateur, et le jeton doit porter l'appartenance.
Étape 5 : pare-feu et réseau
- Pare-feu : le nœud sort-il par une adresse autorisée, ou l'option « services Azure » est-elle active ? L'erreur 40615 le dit explicitement.
- Point de terminaison privé : le nom du serveur doit se résoudre en adresse privée depuis le réseau du pool (
Resolve-DnsName). Une résolution vers l'adresse publique alors que l'accès public est coupé donne un échec de connexion. - Testez le port :
Test-NetConnection <serveur>.database.windows.net -Port 1433.
Étape 6 : caches, puis attente
Après une correction, videz le cache d'authentification de la base et attendez :
DBCC FLUSHAUTHCACHE; -- dans la base utilisateur, et dans master
La propagation peut prendre plusieurs minutes (j'ai observé jusqu'à une quinzaine). Un test qui échoue quelques secondes après la correction ne prouve rien : automatisez un nouvel essai toutes les quelques minutes.
Si rien ne marche
Comparez avec une autre base du même serveur où l'identité fonctionne, ou créez une base vide de test avec le même groupe : si elle passe, le problème est local à la base. Un basculement (failover) de la base, voire du pool élastique, force un nouveau nœud d'exécution ; la cause est alors un état d'authentification en mémoire, invisible dans les vues de catalogue. Gardez les traces (journal de connectivité du serveur) pour un éventuel ticket au support.
Retour d'expérience
- Commencez par le GUID du message : il dit si le problème est côté jeton ou côté SQL.
- Plusieurs causes peuvent s'empiler (mauvaise configuration, puis SID mal formé, puis état de pool) : corrigez une à la fois et retestez après l'attente.
- Un jeton récupéré dans une session de test n'est pas forcément celui de la tâche : testez depuis le nœud réel.