Sessie maken

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.