Authentification Entra ID vers Azure SQL depuis PowerShell
Jetons d'accès, identités managées, principaux de service : quelle identité pour quel travail, et le moindre privilège côté base.
Les mots de passe SQL dans des fichiers de configuration appartiennent au passé. Avec Azure SQL, un script PowerShell s'authentifie auprès de Microsoft Entra ID, obtient un jeton d'accès et le présente à la base. Il n'y a plus de secret à stocker si l'on utilise une identité managée. Voici le mécanisme, les types d'identités et comment choisir.
Le principe : un jeton pour la ressource Azure SQL
Entra ID émet un jeton OAuth 2.0 dont l'audience (la ressource) est https://database.windows.net/. Le client le passe à SQL (AccessToken de la connexion), la base le valide et mappe l'identité à un utilisateur de la base.
sequenceDiagram
participant S as "Script PowerShell"
participant M as "Point de terminaison d'identité (IMDS ou Entra ID)"
participant Q as "Azure SQL"
S->>M: "Demande un jeton (ressource database.windows.net)"
M-->>S: "Jeton d'accès (courte durée)"
S->>Q: "Connexion SQL avec le jeton"
Q->>Q: "Valide le jeton, mappe l'utilisateur de la base"
Q-->>S: "Session ouverte avec les droits de cet utilisateur"
Obtenir un jeton
Depuis un poste ou une session déjà connectée avec le module Az :
$t = Get-AzAccessToken -ResourceUrl 'https://database.windows.net/'
# Selon la version du module, Token est une SecureString
$token = if ($t.Token -is [securestring]) { $t.Token | ConvertFrom-SecureString -AsPlainText } else { $t.Token }
$cn = [Microsoft.Data.SqlClient.SqlConnection]::new('Server=tcp:sql-contoso-prd.database.windows.net,1433;Database=AppDb;Encrypt=True')
$cn.AccessToken = $token
$cn.Open()
$cmd = $cn.CreateCommand(); $cmd.CommandText = 'SELECT SUSER_SNAME()'
$cmd.ExecuteScalar()
$cn.Close()
Sur une machine Azure avec identité managée, deux voies : Connect-AzAccount -Identity (ajouter -AccountId <clientId> pour une identité affectée par l'utilisateur) puis Get-AzAccessToken, ou appeler directement le point de terminaison de métadonnées (IMDS) :
$uri = 'http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=https://database.windows.net/&client_id=00000000-0000-0000-0000-000000000000'
(Invoke-RestMethod -Uri $uri -Headers @{ Metadata = 'true' }).access_token
Le paramètre client_id n'est nécessaire que pour choisir une identité affectée par l'utilisateur. La valeur de Authentication=Active Directory Managed Identity dans la chaîne de connexion de Microsoft.Data.SqlClient fait la même chose sans écrire de code de jeton.
Quelle identité pour quel travail
| Identité | Secret à gérer | Pour quoi |
|---|---|---|
| Votre compte (interactif) | non (MFA) | travail manuel, dépannage |
| Identité managée affectée par le système | non | une seule ressource (une VM, une fonction) qui possède l'identité |
| Identité managée affectée par l'utilisateur | non | plusieurs ressources qui partagent des droits : pool Batch, agents, session de gestion |
| Principal de service (secret ou certificat) | oui | l'extérieur d'Azure : pipeline sans fédération, outil tiers |
| Connexion de pipeline (fédération OIDC) | non | exécution dans un pipeline Azure DevOps |
Mon arbre de décision : si ça tourne sur Azure, identité managée ; sinon, fédération si possible ; principal de service avec secret en dernier recours, secret dans un coffre, rotation planifiée.
Pour détecter le contexte d'exécution, mon script regarde les variables d'environnement du système (TF_BUILD dans un pipeline Azure DevOps, AZ_BATCH_NODE_ID sur un nœud Batch) et choisit l'identité de la configuration en conséquence.
Donner des droits : le moindre privilège
Côté base, l'identité devient un utilisateur contenu, sans connexion au niveau serveur :
CREATE USER [uami-dba-batch] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [uami-dba-batch];
GRANT EXECUTE ON SCHEMA::dba TO [uami-dba-batch];
Règles que j'applique :
- une identité par type de travail (rapport en lecture seule, maintenance, collecte), pas une identité universelle ;
db_datareaderplutôt quedb_owner,EXECUTEsur un schéma précis plutôt que sur la base ;- les droits d'administration (création d'utilisateurs,
ALTER ANY) restent à l'identité qui en a besoin, jamais à celle du rapport ; - on crée l'utilisateur en connexion Entra, car
FROM EXTERNAL PROVIDERexige que l'appelant soit lui-même authentifié par Entra ID.
Retour d'expérience
- L'identifiant à fournir varie : l'API de jeton attend le client id de l'identité, SQL et RBAC voient son object id. Confondre les deux donne des erreurs trompeuses.
- « Login failed for user '' » : l'identité obtient un jeton mais n'existe pas comme utilisateur dans cette base. Tester jeton et
SELECTbase par base. - Plusieurs identités sur la même machine : sans
client_id, l'IMDS répond une erreur ; toujours préciser laquelle. - Les jetons expirent (environ une heure) : redemander un jeton avant chaque longue opération, ne pas le mettre en cache indéfiniment.
- Ne jamais journaliser un jeton, même partiellement.