LLI Wiki — My Digital Knowledge Base

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 :

Retour d'expérience

Mastodon LLIMastodon SocialFosstodon