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.
Important
L’authentification basée sur la session est actuellement en aperçu. Votre abonnement doit être activé pour une prévisualisation avant de pouvoir utiliser l’opération Créer une session.
Create Session Operation crée une session de cinq minutes qui est portée sur un conteneur. Une session fournit des identifiants pouvant être utilisés pour autoriser les requêtes ultérieures aux ressources de ce conteneur.
Les sessions sont destinées à des charges de travail qui effectuent plusieurs requêtes sur le même conteneur et peuvent réduire le traitement d’authentification et d’autorisation nécessaire pour les requêtes suivantes.
Requête
Vous pouvez construire la requête Create Session comme suit. HTTPS est requis.
| Méthode | URI de la requête | Version HTTP |
|---|---|---|
POST |
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session |
HTTP/1.1 |
Remplacez myaccount par le nom de votre compte de stockage et mycontainer par le nom du conteneur pour lequel la session est créée.
Paramètres d’URI
Les paramètres suivants sont requis sur l’URI de la requête.
| Parameter | Description |
|---|---|
restype |
Required. Ça doit être un contenant. Précise que la requête s’applique à la ressource conteneur. |
comp |
Required. Ça doit être une session. Spécifie l’opération Créer une session. |
En-têtes de requête
Les en-têtes de requête suivants sont requis :
| En-tête de requête | Description |
|---|---|
Authorization |
Required. Autorise la requête Create Session en utilisant un jeton d’accès Microsoft Entra. |
Date ou x-ms-date |
Required. Spécifie le temps universel coordonné (UTC) de la requête. |
x-ms-version |
Required. Spécifie la version de l’opération à utiliser pour cette requête. Create Session n’est prise en charge qu’en version 2026-02-06 ou ultérieure. Pour plus d'informations, consultez la page Contrôle de version pour les services de Stockage Microsoft Azure. |
Create Session doit être autorisé à l’aide d’un jeton d’accès Microsoft Entra. L’autorisation basée sur la session ne peut pas être utilisée pour créer une session.
Corps de la demande
Le corps de la requête a le format XML suivant :
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
<AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>
Le tableau suivant décrit les éléments du corps de la demande.
| Element | Required | Description |
|---|---|---|
AuthenticationType |
Yes | Spécifie le mécanisme d’authentification pour les requêtes utilisant la session. La valeur actuellement prise en charge est HMAC. Lorsque HMAC est spécifié, Créer une session renvoie une clé de session que le client utilise pour signer les requêtes suivantes. |
Exemple de requête
POST /mycontainer?restype=container&comp=session HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Bearer {Microsoft Entra access token}
x-ms-date: {date}
x-ms-version: {version}
Content-Type: application/xml
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
<AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>
Response
Une opération réussie renvoie le code de statut 201 (Créé).
Corps de réponse
Le corps de réponse contient les informations et les identifiants pour la session nouvellement créée.
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionResult>
<Id>4e6a585b-5fd9-49f5-aa81-014a9dbaa5cc</Id>
<Expiration>2025-08-25T19:48:17.8038151Z</Expiration>
<AuthenticationType>HMAC</AuthenticationType>
<Credentials>
<SessionToken>aB1cD2eF-3gH4iJ5kL6-mN7oP8qR=</SessionToken>
<SessionKey>aaaaaaaa0b0b1c1c2d2d333333333333==</SessionKey>
</Credentials>
</CreateSessionResult>
La réponse comprend les éléments suivants :
| Element | Description |
|---|---|
Id |
Identificateur unique de la session. |
Expiration |
L’heure à laquelle la session expire. |
AuthenticationType |
Le mécanisme d’authentification associé à la session. |
Credentials |
Contient les identifiants nécessaires pour autoriser les requêtes utilisant la session. |
SessionToken |
Un jeton opaque utilisé pour autoriser les requêtes ultérieures de la session. Considérez le jeton de session comme une certification de sécurité. |
SessionKey |
Pour une session HMAC, la clé symétrique utilisée pour signer les requêtes en utilisant le protocole de signature de clé partagée. Considérez la clé de session comme une certification de sécurité. |
Authorization
Create Session nécessite l’autorisation Microsoft Entra ID.
- Autorisez la demande avec un jeton d’accès Microsoft Entra.
La session est portée au conteneur spécifié dans l'URI de la requête et n'accorde pas d'autorisations au-delà de celles attribuées au principal de sécurité Microsoft Entra. Le principal doit avoir la permission d’effectuer Get Blob pour la ressource demandée.
Utiliser la session avec Get Blob
Pour une session HMAC, utilisez le SessionToken et le SessionKey retournés pour autoriser les requêtes Get Blob ultérieures.
Le client signe la requête à l’aide de la clé de session et inclut la signature et le jeton de session résultants dans l’en-tête d’autorisation :
Authorization: Session {SessionToken}:{Signature}
Par exemple:
GET /mycontainer/myblob HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Session {SessionToken}:{Signature}
x-ms-version: {version}
La session est rattachée au conteneur pour lequel elle a été créée.
Durée de vie et renouvellement des sessions
Une session expire après cinq minutes mais peut devenir invalide plus tôt si le jeton oauth fourni expire plus tôt. Les clients doivent obtenir une nouvelle session lorsque la session actuelle expire ou ne sera plus valide.
Statut des sessions
Les réponses aux requêtes utilisant l’autorisation de session peuvent contenir des informations sur l’état de la session.
| Statut des sessions | Description |
|---|---|
session_expiring |
La session est sur le point d’expirer ou de devenir invalide. Le client doit obtenir une nouvelle session avant que celle-ci ne devienne inutilisable. |
session_expired |
La session a expiré, n’a pas été retrouvée ou a été annulée. La session ne peut plus être utilisée. Le client doit créer une nouvelle session. |
session_token_invalid |
Le jeton de session fourni est mal formé ou autrement invalide syntaxiquement. |
Le session_expiring statut peut être retourné dans l’en-tête x-ms-auth-info de la réponse.
Lorsque l’autorisation de session échoue avec 401 Unauthorized, le service peut renvoyer les informations d’erreur de session dans l’en-tête WWW-Authenticate .
Une requête peut également échouer avec 403 interdit lorsque la session fournie est valide mais n’autorise pas la ressource ou l’opération demandée.
Remarks
Context
Lorsqu'une session est créée, Stockage Blob Azure évalue l'identité Microsoft Entra de l'appelant ainsi que les permissions RBAC et ABAC applicables. Les requêtes ultérieures sont autorisées en utilisant ce contexte de session.
Scope
Une session est portée au conteneur spécifié dans la Create Session requête et ne peut pas être utilisée pour accéder à d’autres conteneurs. Il n’accorde pas d’autorisations autres que celles de l’identité qui l’a créé.
Les modifications des permissions effectuées pendant la durée de vie de la session prennent effet lorsqu’une nouvelle session est créée.
Évaluation des autorisations
Create Session évalue l’autorisation lors de la création de la session. Les modifications apportées au compte, au conteneur ou aux permissions ne sont pas prises en compte dans une session existante. Les changements sont pris en compte lorsqu’une nouvelle session est créée après l’expiration de la session existante de cinq minutes.
Contexte réseau
Une session conserve le contexte réseau qui s’applique lors de la création de la session. Les requêtes ultérieures qui utilisent la session doivent provenir de la même adresse IP client. Les requêtes provenant d’une adresse IP client différente sont rejetées.
Security
SessionToken et SessionKey sont des identifiants de sécurité et doivent être protégés contre toute divulgation.
Limitations
L’authentification basée sur la session ne supporte actuellement que l’opération Get Blob. Les scénarios suivants ne sont pas pris en charge :
- Des tags blob avec des requêtes Get Blob qui utilisent les identifiants de session.
- Envoyez les requêtes Blob vers des comptes secondaires.
- Microsoft Purview avec les identifiants de session.
D’autres opérations de Stockage Blob doivent utiliser un mécanisme d’autorisation pris en charge existant.
Billing
Les demandes de tarification peuvent provenir de clients utilisant des API Stockage Blob, soit directement via l’API Stockage Blob REST, soit via une bibliothèque client stockage Azure. Ces demandes accumulent des frais par transaction. Le type de transaction détermine la manière dont le compte est débité. Par exemple, les transactions de lecture engagent des charges dans une catégorie de facturation différente des transactions d’écriture.
Le tableau suivant présente la catégorie de facturation pour les requêtes de création de session en fonction du type de compte de stockage :
| Operation | Type de compte de stockage | Catégorie de facturation |
|---|---|---|
| Créer une session | Blob de blocs Premium Standard à usage général v2 Standard v1 à usage général |
Opérations d’écriture |
Pour en savoir plus sur les tarifs pour la catégorie de facturation spécifiée, consultez Stockage Blob Azure pricing.