Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Important
Sessiegebaseerde authenticatie bevindt zich momenteel in preview. Je abonnement moet voor de preview zijn ingeschakeld voordat je de Sessie Aanmaken kunt gebruiken.
Create Session Operation creëert een sessie van vijf minuten die beperkt is tot een container. Een sessie levert inloggegevens die kunnen worden gebruikt om opeenvolgende verzoeken naar resources binnen die container te autoriseren.
Sessies zijn bedoeld voor workloads die meerdere verzoeken uitvoeren tegen dezelfde container en kunnen de authenticatie- en autorisatieverwerking voor latere verzoeken verminderen.
Request
U kunt de Create Session aanvraag als volgt samenstellen. HTTPS is vereist.
| Method | URI-aanvraag | HTTP-versie |
|---|---|---|
POST |
https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session |
HTTP/1.1 |
Vervang myaccount door de naam van je opslagaccount en mycontainer door de naam van de container waarvoor de sessie is aangemaakt.
URI Parameters
De volgende parameters zijn vereist op de request URI.
| Parameter | Description |
|---|---|
restype |
Required. Moet een container zijn. Specificeert dat het verzoek van toepassing is op de containerresource. |
comp |
Required. Moet wel sessie zijn. Specificeert de Sessie Aanmaken-operatie. |
Headers aanvragen
De volgende verzoekheaders zijn vereist:
| Header van het verzoek | Description |
|---|---|
Authorization |
Required. Autoriseert het verzoek om Sessie aanmaken door gebruik te maken van een Microsoft Entra toegangstoken. |
Date of x-ms-date |
Required. Hiermee geeft u de Coordinated Universal Time (UTC) voor de aanvraag. |
x-ms-version |
Required. Hiermee geeft u de versie van de bewerking die moet worden gebruikt voor deze aanvraag. Create Session wordt alleen ondersteund in een versie 2026-02-06 of later. Zie Versiebeheer voor de Azure Storage-services voor meer informatie. |
Create Session moet geautoriseerd zijn met een Microsoft Entra toegangstoken. Sessiegebaseerde autorisatie kan niet worden gebruikt om een sessie aan te maken.
aanvraaginhoud
Het verzoeklichaam heeft het volgende XML-formaat:
<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
<AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>
De volgende tabel beschrijft de elementen van het verzoeklichaam.
| Element | Required | Description |
|---|---|---|
AuthenticationType |
Yes | Specificeert het authenticatiemechanisme voor verzoeken die de sessie gebruiken. De momenteel ondersteunde waarde is HMAC. Wanneer HMAC wordt gespecificeerd, geeft Create Session een sessiesleutel terug die de client gebruikt om volgende verzoeken te ondertekenen. |
Voorbeeldaanvraag
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>
Antwoord
Een succesvolle operatie geeft statuscode 201 (Aangemaakt) terug.
Hoofdtekst van de reactie
De responstekst bevat informatie en inloggegevens voor de nieuw aangemaakte sessie.
<?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>
De reactie bevat de volgende elementen:
| Element | Description |
|---|---|
Id |
Een unieke identificatie voor de sessie. |
Expiration |
Het tijdstip waarop de sessie eindigt. |
AuthenticationType |
Het authenticatiemechanisme dat bij de sessie hoort. |
Credentials |
Bevat de inloggegevens die nodig zijn om verzoeken te autoriseren via de sessie. |
SessionToken |
Een ondoorzichtig token dat wordt gebruikt om opeenvolgende verzoeken in de sessie te autoriseren. Behandel het sessietoken als een beveiligingscredential. |
SessionKey |
Voor een HMAC-sessie is de symmetrische sleutel die wordt gebruikt om verzoeken te ondertekenen met het Shared Key signingprotocol. Behandel de sessiesleutel als een beveiligingscredential. |
Autorisatie
Sessie aanmaken vereist autorisatie voor Microsoft Entra ID.
- Autoriseer het verzoek met een Microsoft Entra toegangstoken.
De sessie is scoped naar de container die in de request URI is gespecificeerd en verleent geen rechten die verder gaan dan die aan de Microsoft Entra security principal. De principal moet toestemming hebben om Get Blob uit te voeren voor de gevraagde resource.
De sessie gebruiken met Get Blob
Voor een HMAC-sessie gebruik je de teruggegeven SessionToken en SessionKey om volgende Get Blob-verzoeken te autoriseren.
De client ondertekent het verzoek met de sessiesleutel en neemt de resulterende handtekening en sessietoken op in de autorisatieheader:
Authorization: Session {SessionToken}:{Signature}
Voorbeeld:
GET /mycontainer/myblob HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Session {SessionToken}:{Signature}
x-ms-version: {version}
De sessie is beperkt tot de container waarvoor deze is gemaakt.
Sessieduur en verlenging
Een sessie verloopt na vijf minuten, maar kan eerder ongeldig worden als de aangeboden oauth-token eerder verloopt. Clients zouden een nieuwe sessie moeten verkrijgen wanneer de huidige sessie afloopt of niet meer geldig is.
Sessiestatus
Reacties op verzoeken die gebruikmaken van sessieautorisatie kunnen sessiestatusinformatie bevatten.
| Sessiestatus | Description |
|---|---|
session_expiring |
De sessie staat op het punt te verlopen of ongeldig te worden. De client moet een nieuwe sessie aanschaffen voordat de bestaande sessie onbruikbaar wordt. |
session_expired |
De sessie is verlopen, niet gevonden of ingetrokken. De sessie kan niet langer worden gebruikt. De cliënt moet een nieuwe sessie aanmaken. |
session_token_invalid |
Het bijgeleverde sessietoken is verkeerd gevormd of anderszins syntactisch ongeldig. |
De session_expiring status kan worden teruggegeven in de x-ms-auth-info antwoordheader.
Wanneer sessieautorisatie faalt met 401 Unauthorized, kan de service sessiefoutinformatie teruggeven in de WWW-Authenticate header.
Een verzoek kan ook falen met 403 Forbidden wanneer de geleverde sessie geldig is, maar de gevraagde resource of operatie niet autoriseert.
Remarks
Context
Wanneer een sessie wordt aangemaakt, evalueert Azure Blob Storage de Microsoft Entra-identiteit van de aanroeper en de toepasselijke RBAC- en ABAC-rechten. Vervolgverzoeken worden geautoriseerd met behulp van deze sessiecontext.
Scope
Een sessie is scoped naar de container die in het Create Session verzoek is gespecificeerd en kan niet worden gebruikt om toegang te krijgen tot andere containers. Het verleent geen rechten buiten die van de identiteit die het heeft gemaakt.
Wijzigingen in de rechten die tijdens de sessielevensduur zijn aangebracht, gaan in wanneer een nieuwe sessie wordt aangemaakt.
Beoordeling van toestemmingen
Create Session evalueert de autorisatie wanneer de sessie wordt aangemaakt. Wijzigingen aan het account, de container of de rechten worden niet weergegeven in een bestaande sessie. De wijzigingen worden weergegeven wanneer een nieuwe sessie wordt aangemaakt nadat de bestaande sessie van vijf minuten is verlopen.
Netwerkcontext
Een sessie behoudt de netwerkcontext die van toepassing is wanneer de sessie wordt aangemaakt. Vervolgverzoeken die de sessie gebruiken, moeten afkomstig zijn van hetzelfde client-IP-adres. Verzoeken van een ander client-IP-adres worden geweigerd.
Security
SessionToken en SessionKey zijn beveiligingsgegevens en moeten beschermd worden tegen openbaarmaking.
Limitations
Sessiegebaseerde authenticatie ondersteunt momenteel alleen de Get Blob-operatie. De volgende scenario's worden niet ondersteund:
- Blob-tags met Get Blob-verzoeken die gebruikmaken van sessiegegevens.
- Stuur Blob-verzoeken naar secundaire accounts.
- Microsoft Purview met sessiegegevens.
Andere Blob Storage-operaties moeten gebruikmaken van een bestaand ondersteund autorisatiemechanisme.
Billing
Prijsverzoeken kunnen afkomstig zijn van clients die Blob Storage API's gebruiken, hetzij direct via de Blob Storage REST API, hetzij via een Azure Storage-clientbibliotheek. Deze aanvragen maken kosten per transactie. Het transactietype bepaalt hoe de rekening wordt belast. Bijvoorbeeld, leestransacties brengen kosten op in een andere factureringscategorie dan schrijftransacties.
De volgende tabel toont de facturatiecategorie voor Create Session-verzoeken op basis van het type opslagaccount:
| Bewerking | Type opslagaccount | Factureringscategorie |
|---|---|---|
| Sessie maken | Premium blok-blob Standaard voor algemeen gebruik v2 Standaard algemeen gebruik v1 |
Schrijfbewerkingen |
Voor meer informatie over de prijzen voor de gespecificeerde factureringscategorie, zie Azure Blob Storage pricing.