Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’authentification basée sur les sessions réduit le temps d’authentification et d’autorisation par demande pour les agents et applications IA tout en préservant les contrôles de sécurité sur lesquels les organisations comptent déjà. Avec l’authentification basée sur une session, un agent ou une application s’authentifie une fois avec Microsoft Entra ID, établit une session de courte durée pour un conteneur, puis utilise cette session pour les lectures ultérieures.
L’authentification basée sur les sessions est idéale pour les charges de travail sensibles à la latence et à forte lecture qui effectuent de nombreuses requêtes au même conteneur en utilisant la même identité, telles que les agents IA, l’entraînement et l’inférence IA, l’analyse et l’informatique haute performance.
Important
L’authentification basée sur la session est actuellement en aperçu. Consultez les Conditions d’utilisation complémentaires pour les préversions de Microsoft Azure pour les termes applicables aux fonctionnalités Azure en aperçu.
Benefits
- Performances améliorées. L’identité et les permissions sont vérifiées une fois lors de la création de la session. Les requêtes de lecture ultérieures vers le conteneur utilisent cette session, ce qui réduit la latence d’authentification et d’autorisation par requête.
- Le même accès à privilèges minimaux, désormais de courte durée. Les sessions utilisent le modèle d'autorisation existant de votre organisation pour l'accès à moindre privilège, Azure RBAC et Azure ABAC. Chaque session est également limitée à un seul conteneur, expire après cinq minutes, est liée au client qui l’a créée, et nécessite que chaque requête soit signée.
- Traçabilité complète. Les journaux de diagnostic stockage Azure enregistrent actuellement l’identité Microsoft Entra ID derrière chaque requête, et il en va de même pour les sessions. Avec les sessions, chaque requête reste liée à l’identité Microsoft Entra ID qui a créé la session, de sorte que les équipes de sécurité gardent une visibilité sur l’identité, humaine ou logicielle, qui a consulté quelles données, et quand.
- Aucun changement à la logique d’application. En utilisant les bibliothèques clients stockage Azure, vous activez l’authentification basée sur la session avec une seule option de configuration client.
Comment fonctionne l’authentification basée sur la session
Lorsqu'un client appelle l'opération Créer une session, stockage Azure vérifie l'identité Microsoft Entra ID du client, évalue les attributions de rôles RBAC Azure et les conditions Azure ABAC pour le conteneur, lance une session de cinq minutes et renvoie les identifiants de session. Les identifiants de session se composent de deux parties :
- Jeton de session : identifie la session.
- Clé de session : utilisée par le client pour signer chaque requête effectuée au sein de la session.
Pour les requêtes Get Blob ultérieures vers le même conteneur, le client envoie le jeton de session accompagné d’une signature calculée avec la clé de session, au lieu d’un jeton d’accès Microsoft Entra ID. Parce que l’identité et les permissions ont été vérifiées lors de la création de la session, le temps d’authentification et d’autorisation par demande est réduit.
Le flux de session comprend les étapes suivantes :
- Le client obtient un jeton d’accès pour stockage Azure via Microsoft Entra ID.
- Le client appelle l’opération Créer une session pour le conteneur cible. stockage Azure autorise la requête à l’aide du jeton d’accès Microsoft Entra ID.
- stockage Azure renvoie les identifiants de session et l’heure d’expiration de la session.
- Le client utilise les identifiants de session pour autoriser les requêtes Get Blob pour les blobs dans le même conteneur.
- Pour continuer à lire les données, le client crée une nouvelle session avant l’expiration de la session en cours.
Note
Lorsque vous utilisez le SDK stockage Azure, la bibliothèque client gère automatiquement l’intégralité du cycle de vie de la session.
Les sessions sont conçues selon les limites de sécurité suivantes :
- Portée à un seul conteneur. Une session ne peut autoriser les requêtes que pour les blobs dans le conteneur pour lequel elle a été créée.
- Lié à l’identité d’origine. Une session n’accorde jamais d’autorisations au-delà de celles attribuées au principal de sécurité Microsoft Entra ID qui l’a créée. Toutes les demandes faites au cours de la session sont attribuées à cette identité.
- De courte durée. Une session expire après cinq minutes. Les identifiants de session ne peuvent pas être étendus ni actualisés ; le client doit créer une nouvelle session pour continuer.
- Lié au contexte réseau du client. Une session est liée à l’adresse IP du client qui l’a créée, ce qui aide à empêcher les identifiants de session capturés d’être rediffusés par un autre client. La même session peut être utilisée sur plusieurs connexions depuis la même adresse IP client.
- Requêtes signées. Chaque requête effectuée au sein d’une session est signée avec la clé de session.
- Audit. Les requêtes effectuées au sein d’une session sont enregistrées dans les journaux de diagnostic stockage Azure.
Quand utiliser l’authentification basée sur la session
Considérez l’authentification basée sur la session lorsque toutes les conditions suivantes sont vraies :
- L’application utilise Microsoft Entra ID pour l’authentification et Azure RBAC pour l’autorisation.
- L’application effectue des requêtes Get Blob répétées contre des blobs dans le même conteneur.
- L’application peut gérer de manière sécurisée les identifiants temporaires des sessions et recréer les sessions selon besoin. Le SDK stockage Azure gère cela automatiquement.
N’utilisez pas l’authentification basée sur la session lorsque l’une des conditions suivantes est remplie :
- L’agent ou l’application utilise la délégation utilisateur SAS, la SAS du service, le SAS du compte ou la clé partagée pour l’authentification et l’autorisation.
- L’agent ou l’application doit effectuer une opération autre que Get Blob. Ces opérations doivent utiliser un jeton d’accès Microsoft Entra ID pour l’authentification et l’autorisation. Le SDK stockage Azure gère cela automatiquement.
- L’application ne fait qu’une demande Get Blob occasionnelle ou unique et ne bénéficie pas d’une demande supplémentaire de création de session.
Billing
La création d’une session est facturée comme une transaction d’écriture standard pour votre compte de stockage. Les requêtes Get Blob effectuées avec une session sont facturées aux tarifs de transaction standard correspondant à votre type de compte de stockage. Pour en savoir plus, consultez la tarification stockage Azure.
Get started
Pour commencer, inscrivez-vous à l’aperçu en utilisant Azure PowerShell ou Azure CLI.
Exécutez les commandes suivantes pour vous inscrire à la préversion :
Connect-AzAccount -SubscriptionId <subscription-id>
Register-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage
Pour vérifier votre état d’enregistrement, exécutez les commandes suivantes :
Connect-AzAccount -SubscriptionId <subscription-id>
Get-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage
Note
Il peut falloir quelques jours pour que votre inscription soit approuvée. Après l’approbation de votre inscription, l’état d’enregistrement apparaît comme Enregistré.
Utilisez les sessions avec le SDK stockage Azure
Le SDK stockage Azure offre la manière la plus simple d’utiliser l’authentification basée sur les sessions. Activez l’authentification basée sur la session lorsque vous initialisez votre client Blob ; le reste de votre logique applicative reste le même.
Lorsque l’authentification basée sur la session est activée, le SDK gère automatiquement l’intégralité du cycle de vie de la session :
- Crée une session et met en cache ses identifiants.
- Signe automatiquement chaque requête avec la clé de session.
- Utilise le jeton de session pour les opérations Get Blob et un jeton d’accès Microsoft Entra ID pour d’autres opérations.
- Renouvelle la session avant expiration sans affecter l’accès aux données, afin que votre application n’ait jamais besoin de suivre la durée de vie des sessions.
Votre code existant continue de lire les blobs en utilisant les mêmes méthodes, identifiants Microsoft Entra ID et assignations de rôles RBAC, tout en bénéficiant de lectures à faible latence.
Note
Pour utiliser l’authentification basée sur la session avec le SDK stockage Azure, installez le dernier paquet de bibliothèque client Azure Blob pour accéder aux données. Par exemple, pour Python, installez le package version 12.31.1 ou ultérieur. Pour .NET, installez le paquet version 12.31.0-beta.1 ou ultérieure.
Les exemples suivants de SDK lisent un blob en utilisant une session.
using System;
using System.IO;
using System.Threading.Tasks;
using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
string accountName = "<storage-account-name>";
string containerName = "<container-name>";
string blobName = "<blob-name>";
var options = new BlobClientOptions
{
SessionOptions = new SessionOptions
{
SessionMode = SessionMode.Enabled
}
};
var serviceClient = new BlobServiceClient(
new Uri($"https://{accountName}.blob.core.windows.net"),
new DefaultAzureCredential(),
options);
BlobContainerClient containerClient =
serviceClient.GetBlobContainerClient(containerName);
BlobClient blobClient = containerClient.GetBlobClient(blobName);
var response = await blobClient.DownloadStreamingAsync();
using Stream content = response.Value.Content;
using var reader = new StreamReader(content);
string text = await reader.ReadToEndAsync();
Console.WriteLine(text);
Utilisez les sessions avec l’API REST
Si vous appelez directement les API REST au lieu d’utiliser le SDK stockage Azure, votre application doit créer une session, signer les requêtes et créer une session de remplacement avant l’expiration de la session actuelle.
Créez une session. Appelez l’opération Créer une session sur le conteneur et autorisez la requête avec un jeton d’accès Microsoft Entra ID. Une réponse réussie renvoie le jeton de session, la clé de session et l’heure d’expiration de la session. Stockez les identifiants de session de manière sécurisée et associez-les au conteneur pour lequel ils ont été créés.
Exemple de demande
POST https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session Authorization: Bearer {Entra access token} x-ms-date: {date} x-ms-version: {version} <?xml version="1.0" encoding="utf-8"?> <CreateSessionRequest> <AuthenticationType>HMAC</AuthenticationType> </CreateSessionRequest>Create Session n’est prise en charge que dans la version 2026-02-06 ou ultérieure. Pour plus de détails, consultez la documentation Create Session REST API .
Lisez un blob en utilisant la session. Appelez l’opération Get Blob. L’en-tête Authorization contient le jeton de session et une signature calculée avec la clé de session. La clé de session elle-même n’est jamais envoyée.
Exemple de demande
GET https://myaccount.blob.core.windows.net/mycontainer/myblob Authorization: Session {SessionToken}:{Signature} x-ms-version: {version}Pour plus de détails, consultez la documentation Create Session REST API .
Renouveler avant l’expiration. Une session expire après cinq minutes et ne peut pas être prolongée. Les requêtes faites avec une session expirée échouent. Lorsque l’accès ininterrompu est requis, créez une session de remplacement avant l’expiration de la session en cours.
Considérations et limites
- Pour utiliser cette fonctionnalité, vous devez être approuvé pour participer à la préversion. Pour plus d’informations, consultez Démarrer.
- L’authentification basée sur la session est limitée aux opérations Get Blob. Les jetons de session supportent uniquement l’opération Get Blob ; toutes les autres opérations nécessitent un jeton d’accès Microsoft Entra ID. Les SDK stockage Azure gèrent cela automatiquement en choisissant le jeton à utiliser en fonction de l’opération.
- L’authentification basée sur la session réduit le temps d’authentification et d’autorisation pour les charges de lecture à haute fréquence. Plutôt que d’effectuer une validation complète des jetons OAuth et une évaluation d’autorisation sur chaque requête Get Blob, stockage Azure établit un contexte de sécurité temporaire qui peut être réutilisé lors des requêtes suivantes. Cela réduit le temps d’authentification et d’autorisation par requête et permet d’offrir une latence plus prévisible pour les charges de travail gourmandes en débit et sensibles à la latence.
- Les plus grands avantages se réalisent lorsque de nombreuses requêtes Get Blob sont effectuées en peu de temps. L’authentification basée sur les sessions est destinée aux applications effectuant des lectures répétées à grande échelle, où la réduction du temps d’authentification et d’autorisation sur de nombreuses requêtes peut améliorer l’efficacité globale et la cohérence de la latence. Il n’y a aucun avantage de performance à créer plusieurs sessions par conteneur pour chaque utilisateur. Ainsi, chaque utilisateur ayant accès au conteneur ne doit utiliser qu’une seule session à la fois.
- L’authentification basée sur une session nécessite Microsoft Entra ID pour créer une session. Le client authentifie la requête de création de session avec un jeton d’accès Microsoft Entra ID. stockage Azure renvoie des identifiants temporaires de session qui peuvent être utilisés pour les requêtes Get Blob ultérieures durant la durée de vie de la session. Les permissions ne sont ni élevées ni étendues ; la session hérite des autorisations déjà accordées à l'identité Microsoft Entra ID via Azure RBAC et Azure ABAC. L’authentification basée sur la session ne supporte pas le SAS de délégation utilisateur lié aux utilisateurs, ni le SAS de délégation utilisateur, ni le SAS de service, ni le SAS des comptes, ni l’autorisation de clé partagée.
- Les sessions reçoivent une autorisation au niveau du conteneur. Les politiques Azure RBAC et Azure ABAC du conteneur sont évaluées au niveau du conteneur lors de la création de la session, et ces permissions sont utilisées tout au long de la durée de vie de la session. Cela signifie que les politiques Azure ABAC à un niveau plus granulaire que le conteneur ne sont pas évaluées. De plus, si une autorisation Azure RBAC ou Azure ABAC au niveau du conteneur est modifiée dans les cinq minutes suivant la durée de vie de la session, elle n'est appliquée que lorsqu'un nouveau jeton de session est créé. Suivez le principe du privilège minimal lorsque vous attribuez des rôles Azure. Accordez l’accès en lecture uniquement dans la portée la plus étroite requise par l’application. Pour plus d’informations, consultez Attribuer un rôle Azure pour l’accès aux données BLOB.
- Les sessions sont conçues avec des limites de sécurité transparentes. Une session est limitée à un seul conteneur, liée à l’identité qui l’a créée, et expire après cinq minutes. Toutes les requêtes effectuées au cours de la session sont attribuées à l’identité originale de Microsoft Entra ID. Les identifiants de session ne peuvent pas être réutilisés indéfiniment et doivent être recréés après expiration. Les sessions sont également liées à l’IP client d’origine, ce qui aide à empêcher la réutilisation des identifiants de session par une autre machine.
-
Non pris en charge :
- Les balises d’index de blob ne sont pas prises en charge pour l’opération Get Blob, ce qui signifie que vous ne pouvez voir aucune balise associée au blob auquel vous accédez en utilisant un jeton de session.
- Lectures Get Blob sur des comptes secondaires ; vous pouvez appeler Get Blob avec un jeton de session comme méthode d’authentification uniquement sur le compte principal.
- Les blobs de page et les blobs d’ajout, seuls les blobs de blocs sont pris en charge.
- SAS de délégation utilisateur liée à l’utilisateur, SAS de délégation utilisateur, SAS de service, SAS de compte et autorisation de clé partagée, seul Microsoft Entra ID est pris en charge pour l’authentification.
- Microsoft Purview n'est pas supporté avec les jetons de session.
Surveiller l’authentification basée sur la session
stockage Azure journalise les requêtes Create Session et les requêtes effectuées au sein d’une session dans les journaux de ressources Azure Monitor. Pour collecter ces journaux, configurez un paramètre de diagnostic pour Stockage Blob qui envoie les journaux StorageRead à un espace de travail Log Analytics, un compte de stockage ou un hub d’événements. Pour plus d’informations, consultez Monitor Stockage Blob Azure.
Requêtes Create Session
Les requêtes Create Session apparaissent sous le nom d’opération CreateSession dans la catégorie StorageRead , avec un type d’authentification OAuth. Chaque entrée inclut :
- Identité de l’appelant : le principal de sécurité Microsoft Entra ID qui a créé la session, incluant son ID d’objet, son ID de locataire, son nom de principal utilisateur et son ID d’application client.
- Décision d’autorisation : l’action évaluée, l’attribution et la définition du rôle Azure qui ont accordé l’accès, et le résultat.
- ID de session : un identifiant unique pour la session.
- Conteneur cible : le compte de stockage et le conteneur auxquels la session est associée.
- Détails réseau et de requête : adresse IP de l’appelant, protocole, version TLS, code d’état, latence, ID de requête client et agent utilisateur.
Demandes effectuées au sein d’une session
Les requêtes Get Blob autorisées par une session apparaissent avec le nom d’opération GetBlob dans la catégorie StorageRead, avec un type d’authentification Session. Au lieu de l’identité de l’appelant et des détails d’autorisation, chaque entrée inclut l’ID de session de la session utilisée pour autoriser la requête, ainsi que le blob lu, l’adresse IP de l’appelant et les détails standards de la requête.
Pour trouver l’identité Microsoft Entra ID derrière une requête effectuée au sein d’une session, associez l’ID de session dans l’opération GetBlob à l’ID de session de l’opération CreateSession correspondante. L’entrée Créer une session enregistre l’identité dans Microsoft Entra ainsi que l’attribution de rôle Azure qui a autorisé la session.
Troubleshooting
Lorsqu’une requête de session échoue, vérifiez l’en-tête de la réponse pour des informations spécifiques sur l’échec.
| Problème | Action recommandée |
|---|---|
| La requête de création de session échoue | Vérifiez que la requête utilise un jeton d’accès Microsoft Entra ID valide, cible le conteneur prévu, utilise HTTPS et que le principal de sécurité dispose des autorisations requises. |
| La requête Get Blob renvoie une erreur d’autorisation | Vérifiez que la session a été créée pour le même conteneur et que le principal de sécurité Microsoft Entra ID dispose d’un accès en lecture au blob demandé. |
| La session a expiré ou n’a pas été trouvée | Créez une nouvelle session et réessayez la requête Get Blob avec les nouvelles informations d’identification de session. |
| Le jeton de session est invalide | Supprimez les identifiants de session actuels, créez une nouvelle session et assurez-vous que les valeurs d’identification ne soient pas modifiées. |
| Une autre opération échoue avec l’authentification de session | Utilisez l’authentification basée sur la session uniquement pour l’opération Get Blob. Utilisez un jeton d’accès Microsoft Entra ID pour d’autres opérations. |