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.
Sessiegebaseerde authenticatie verkort de authenticatie- en autorisatietijd per verzoek voor AI-agents en applicaties, terwijl de beveiligingsmaatregelen behouden blijven waarop organisaties al vertrouwen. Bij sessiegebaseerde authenticatie authenticeert een agent of applicatie zich eenmaal met Microsoft Entra ID, stelt een kortstondige sessie voor een container op en gebruikt die sessie voor latere leesbeurten.
Sessiegebaseerde authenticatie is goed geschikt voor leesintense, latentiegevoelige workloads die veel verzoeken naar dezelfde container doen met behulp van dezelfde identiteit, zoals AI-agenten, AI-training en inferentie, analyses en high-performance computing.
Belangrijk
Sessiegebaseerde authenticatie bevindt zich momenteel in preview. Zie de aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor termen die van toepassing zijn op Azure-functies die in preview zijn.
Benefits
- Verbeterde prestaties. Identiteit en machtigingen worden eenmaal geverifieerd wanneer de sessie wordt aangemaakt. Vervolgleesverzoeken aan de container gebruiken die sessie, wat de verificatie per verzoek en autorisatielatentie vermindert.
- Dezelfde minst bevoorrechte toegang, nu van korte duur. Sessies gebruiken het bestaande machtigingsmodel van uw organisatie voor least privileged access, Azure RBAC en Azure ABAC. Elke sessie is ook beperkt tot één container, verloopt na vijf minuten, is gekoppeld aan de client die deze heeft aangemaakt en vereist dat elk verzoek wordt ondertekend.
- Volledige traceerbaarheid. Azure Storage diagnostische logboeken registreren momenteel de Microsoft Entra ID-identiteit achter elk verzoek, en hetzelfde geldt voor sessies. Bij sessies blijft elk verzoek gekoppeld aan de Microsoft Entra ID-identiteit die de sessie heeft aangemaakt, zodat beveiligingsteams inzicht hebben in welke identiteit, mens of agent, welke data heeft benaderd en wanneer.
- Geen wijzigingen in de applicatielogica. Door gebruik te maken van de Azure Storage-clientbibliotheken maakt u sessiegebaseerde authenticatie mogelijk met één enkele clientconfiguratie-optie.
Hoe sessiegebaseerde authenticatie werkt
Wanneer een client de Create Session-operatie aanroept, verifieert Azure Storage de Microsoft Entra ID-identiteit van de client, evalueert Azure RBAC-roltoewijzingen en Azure ABAC-voorwaarden voor de container, start een sessie van vijf minuten en retourneert sessiegegevens. De sessie-inloggegevens bestaan uit twee delen:
- Sessietoken: identificeert de sessie.
- Sessiesleutel: wordt door de client gebruikt om elk verzoek dat binnen de sessie is ingediend te ondertekenen.
Voor latere Get Blob-verzoeken naar dezelfde container stuurt de client het sessietoken samen met een handtekening die is berekend met de sessiesleutel, in plaats van een Microsoft Entra ID-toegangstoken. Omdat de identiteit en machtigingen werden geverifieerd toen de sessie werd aangemaakt, wordt de authenticatie- en autorisatietijd per verzoek verminderd.
De sessieflow heeft de volgende stappen:
- De client verkrijgt een Microsoft Entra ID-toegangstoken voor Azure Storage.
- De client roept de bewerking Sessie aanmaken voor de doelcontainer. Azure Storage autoriseert het verzoek met behulp van het Microsoft Entra ID-toegangstoken.
- Azure Storage geeft de sessiereferenties en het vervaltijdstip van de sessie terug.
- De client gebruikt de sessie-inloggegevens om Get Blob-verzoeken voor blobs in dezelfde container te autoriseren.
- Om data verder te lezen, maakt de client een nieuwe sessie aan voordat de huidige sessie afloopt.
Note
Wanneer u de Azure Storage SDK gebruikt, beheert de clientbibliotheek automatisch de volledige sessielevenscyclus.
Sessies zijn ontworpen met de volgende beveiligingsgrenzen:
- Afgeschermd op één enkele container. Een sessie kan verzoeken alleen autoriseren voor blobs in de container waarvoor deze is aangemaakt.
- Gelinkt aan de oorspronkelijke identiteit. Een sessie verleent nooit machtigingen buiten die welke zijn toegewezen aan de Microsoft Entra ID-beveiligingsprincipal die deze heeft aangemaakt. Alle verzoeken die via de sessie worden gedaan, worden aan die identiteit toegeschreven.
- Van korte duur. Een sessie loopt af na vijf minuten. Sessiereferenties kunnen niet worden verlengd of ververst; de client moet een nieuwe sessie aanmaken om verder te gaan.
- Gekoppeld aan de netwerkcontext van de client. Een sessie is gekoppeld aan het client-IP-adres dat deze heeft aangemaakt, wat helpt voorkomen dat vastgelegde sessie-inloggegevens door een andere client worden herhaald. Dezelfde sessie kan worden gebruikt over meerdere verbindingen vanaf hetzelfde client-IP-adres.
- Ondertekende aanvragen. Elk verzoek dat binnen een sessie wordt gedaan, wordt ondertekend met de sessiesleutel.
- Auditing. Verzoeken die binnen een sessie worden ingediend, worden geregistreerd in de Azure Storage-diagnoselogboeken.
Wanneer sessiegebaseerde authenticatie te gebruiken
Overweeg sessiegebaseerde authenticatie wanneer alle volgende voorwaarden gelden:
- De applicatie gebruikt Microsoft Entra ID voor authenticatie en Azure RBAC voor autorisatie.
- De applicatie voert herhaalde Get Blob-verzoeken uit tegen blobs in dezelfde container.
- De applicatie kan tijdelijke sessie-inloggegevens veilig beheren en sessies opnieuw aanmaken indien nodig. De Azure Storage SDK regelt dit automatisch.
Gebruik geen sessiegebaseerde authenticatie wanneer een van de volgende voorwaarden geldt:
- De agent of applicatie gebruikt gebruikersdelegatie-SAS, service-SAS, account-SAS of Shared Key voor authenticatie en autorisatie.
- De agent of applicatie moet een andere handeling uitvoeren dan Get Blob. Deze bewerkingen moeten een Microsoft Entra ID-toegangstoken gebruiken voor authenticatie en autorisatie. De Azure Storage SDK regelt dit automatisch.
- De applicatie doet slechts af en toe of één Get Blob-verzoek en profiteert niet van een extra verzoek voor het aanmaken van sessies.
Billing
Het aanmaken van een sessie wordt gefactureerd als een standaard schrijftransactie voor uw opslagaccount. Download-verzoeken die met een sessie worden gedaan, worden gefactureerd tegen de standaard transactietarieven voor uw opslagaccounttype. Voor meer informatie, zie Azure Storage pricing.
Get started
Om te beginnen, registreer u voor de preview met behulp van Azure PowerShell of Azure CLI.
Voer de volgende commando's uit om je voor de preview te registreren:
Connect-AzAccount -SubscriptionId <subscription-id>
Register-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage
Om uw registratiestatus te controleren, voert u de volgende commando's uit:
Connect-AzAccount -SubscriptionId <subscription-id>
Get-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage
Note
Het kan een paar dagen duren voordat je registratie is goedgekeurd. Nadat uw registratie is goedgekeurd, wordt de registratiestatus weergegeven als Geregistreerd.
Gebruik sessies met de Azure Storage SDK
De Azure Storage SDK biedt de eenvoudigste manier om sessiegebaseerde authenticatie te gebruiken. Schakel sessiegebaseerde authenticatie in wanneer u uw Blob-client initialiseert; de rest van uw applicatielogica blijft hetzelfde.
Wanneer sessiegebaseerde authenticatie is ingeschakeld, beheert de SDK automatisch de volledige sessielevenscyclus:
- Maakt een sessie aan en cachet de inloggegevens ervan.
- Ondertekent elk verzoek automatisch met de sessiesleutel.
- Gebruikt het sessietoken voor Get Blob-operaties en een Microsoft Entra ID-toegangstoken voor andere bewerkingen.
- Vernieuw de sessie vóór het verlopen zonder de gegevenstoegang te beïnvloeden, zodat je app nooit de levensduur van sessies hoeft bij te houden.
Uw bestaande code blijft blobs lezen met dezelfde methoden, Microsoft Entra ID-inloggegevens en RBAC-roltoewijzingen, terwijl het profiteert van leesacties met lagere latentie.
Note
Om sessiegebaseerde authenticatie met de Azure Storage SDK te gebruiken, installeert u het nieuwste Azure Blob clientbibliotheekpakket voor gegevenstoegang. Installeer bijvoorbeeld voor Python pakket versie 12.31.1 of later. Installeer voor .NET pakketversie 12.31.0-beta.1 of later.
De volgende SDK-voorbeelden lezen een blob met behulp van een sessie.
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);
Gebruik sessies met de REST API
Als u de REST-API's direct aanroept in plaats van de Azure Storage SDK te gebruiken, moet uw applicatie een sessie aanmaken, verzoeken ondertekenen en een vervangende sessie aanmaken voordat de huidige sessie verloopt.
Maak een sessie. Roep de bewerking Sessie aanmaken op de container en autoriseer het verzoek met een Microsoft Entra ID-toegangstoken. Een succesvolle reactie geeft het sessietoken, de sessiesleutel en de vervaltijd van de sessie terug. Sla de sessie-inloggegevens veilig op en koppel ze aan de container waarvoor ze zijn aangemaakt.
Voorbeeldaanvraag
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>Sessie aanmaken wordt alleen ondersteund in versie 2026-02-06 of later. Zie voor meer details de documentatie van de Create Session REST API .
Lees een blob door de sessie te gebruiken. Roep de Get Blob-operatie aan. De Authorization-header bevat het sessietoken en een handtekening die is berekend met de sessiesleutel. De sessiesleutel zelf wordt nooit verzonden.
Voorbeeldaanvraag
GET https://myaccount.blob.core.windows.net/mycontainer/myblob Authorization: Session {SessionToken}:{Signature} x-ms-version: {version}Zie voor meer details de documentatie van de Create Session REST API .
Verleng vóór de vervaldatum. Een sessie verloopt na vijf minuten en kan niet worden verlengd. Verzoeken die met een verlopen sessie worden gedaan, mislukken. Wanneer ononderbroken toegang vereist is, maak dan een vervangende sessie aan voordat de huidige sessie afloopt.
Overwegingen en beperkingen
- Om deze functie te gebruiken, moet u goedkeuring hebben om deel te nemen aan de preview. Zie Aan de slagvoor meer informatie.
- Sessiegebaseerde authenticatie is beperkt tot Get Blob-operaties. Sessietokens ondersteunen alleen de Get Blob-operatie; alle andere bewerkingen vereisen een Microsoft Entra ID-toegangstoken. De Azure Storage SDK's regelen dit automatisch door te kiezen welk token gebruikt wordt op basis van de operatie.
- Sessiegebaseerde authenticatie vermindert de authenticatie- en autorisatietijd voor hoogfrequente leesbelastingen. In plaats van volledige OAuth-tokenvalidatie en autorisatie-evaluatie uit te voeren bij elk Get Blob-verzoek, stelt Azure Storage een tijdelijke beveiligingscontext vast die hergebruikt kan worden voor latere verzoeken. Dit vermindert de authenticatie- en autorisatietijd per verzoek en helpt om meer voorspelbare latentie te realiseren voor doorvoerintensieve en latentiegevoelige workloads.
- De grootste voordelen worden gerealiseerd wanneer veel Get Blob-verzoeken binnen korte tijd worden uitgevoerd. Sessiegebaseerde authenticatie is bedoeld voor applicaties die herhaalde leesbewerkingen op grote schaal uitvoeren, waarbij het verkorten van authenticatie- en autorisatietijd over veel verzoeken de algehele efficiëntie en consistentie van latentie kan verbeteren. Er is geen prestatievoordeel aan het maken van meerdere sessies per container per gebruiker. Daarom zou elke gebruiker met toegang tot de container slechts één sessie tegelijk moeten gebruiken.
- Sessiegebaseerde authenticatie vereist Microsoft Entra ID om een sessie te maken. De client authenticeert het Create Session-verzoek met een Microsoft Entra ID-toegangstoken. Azure Storage retourneert tijdelijke sessiereferenties die kunnen worden gebruikt voor latere Get Blob-verzoeken gedurende de sessielevensduur. Machtigingen worden niet verhoogd of uitgebreid; de sessie erft de reeds toegekende machtigingen aan de Microsoft Entra ID-identiteit via Azure RBAC en Azure ABAC. Sessiegebaseerde authenticatie ondersteunt geen gebruikersdelegatie-SAS, gebruikersdelegatie-SAS, service-SAS, account-SAS of Shared Key-autorisatie.
- Sessies krijgen autorisatie op containerniveau. De Azure RBAC- en Azure ABAC-beleidsregels van de container worden op containerniveau geëvalueerd bij het aanmaken van de sessie, en die machtigingen worden gedurende de hele sessieduur gebruikt. Dit betekent dat Azure ABAC-beleidslijnen op een meer gedetailleerd niveau dan de container niet worden geëvalueerd. Daarnaast, als een Azure RBAC of Azure ABAC-machtiging op containerniveau binnen vijf minuten van de sessielevensduur wordt gewijzigd, wordt deze pas toegepast wanneer er een nieuw sessietoken is aangemaakt. Volg het principe van de minste privilege wanneer u Azure-rollen toewijst. Verleen leestoegang alleen binnen de meest beperkte reikwijdte die de toepassing vereist. Zie Een Azure-rol toewijzen voor toegang tot blobgegevens voor meer informatie.
- Sessies zijn ontworpen met transparante beveiligingsgrenzen. Een sessie is beperkt tot één container, gekoppeld aan de identiteit die deze heeft aangemaakt, en verloopt na vijf minuten. Alle verzoeken die via de sessie worden gedaan, worden toegeschreven aan de oorspronkelijke Microsoft Entra ID-identiteit. Sessie-inloggegevens kunnen niet eindeloos worden hergebruikt en moeten na verloop opnieuw worden aangemaakt. Sessies zijn ook gekoppeld aan het oorspronkelijke client-IP, wat helpt te voorkomen dat sessie-inloggegevens door een andere machine worden hergebruikt.
-
Niet ondersteund:
- Blob-indextags voor de bewerking Get Blob, wat betekent dat je geen tags kunt zien die gekoppeld zijn aan de blob die je opent terwijl je een sessietoken gebruikt.
- Get Blob-reads op secundaire accounts; je kunt Get Blob aanroepen met een sessietoken als authenticatiemethode alleen op het primaire account.
- Page blobs en Append blobs, alleen Block blobs worden ondersteund.
- Voor gebruikersgebonden gebruikersdelegatie-SAS, gebruikersdelegatie-SAS, service-SAS, account-SAS en Shared Key-autorisatie wordt alleen Microsoft Entra ID ondersteund voor authenticatie.
- Microsoft Purview wordt niet ondersteund met sessietokens.
Bewaking van sessiegebaseerde authenticatie
Azure Storage-logboeken registreren Create Session-aanvragen en aanvragen die binnen een sessie worden gedaan in Azure Monitor-resourcelogs. Om deze logs te verzamelen, configureer een diagnostische instelling voor Blob Storage die StorageRead-logboeken naar een Log Analytics-werkruimte, opslagaccount of gebeurtenishub stuurt. Zie Azure Blob Storage bewaken voor meer informatie.
Aanvragen voor sessies maken
Aanvragen voor Create Session verschijnen met de bewerkingsnaam CreateSession in de StorageRead-categorie, met het authenticatietype OAuth. Elke vermelding omvat:
- Caller-identiteit: de Microsoft Entra ID-beveiligingsprincipal die de sessie heeft aangemaakt, inclusief object-ID, tenant-ID, gebruikersnaam en clientapplicatie-ID.
- Autorisatiebeslissing: de geëvalueerde actie, de Azure-roltoewijzing en roldefinitie die toegang verleende, en het resultaat.
- Sessie-ID: een unieke identificatie voor de sessie.
- Doelcontainer: het opslagaccount en de container waarop de sessie is gescoped.
- Netwerk- en verzoekgegevens: IP-adres van de aanroeper, protocol, TLS-versie, statuscode, latentie, client request ID en user agent.
Verzoeken die binnen een sessie worden gedaan
Get Blob-verzoeken die door een sessie zijn geautoriseerd, verschijnen met de operatienaam GetBlob in de categorie StorageRead , met het authenticatietype Session. In plaats van de identiteit en autorisatiegegevens van de aanroeper bevat elke vermelding de sessie-ID van de sessie die is gebruikt om het verzoek te autoriseren, samen met de gelezen blob, het IP-adres van de aanroeper en de details van het standaardverzoek.
Om de Microsoft Entra ID-identiteit achter een verzoek binnen een sessie te vinden, koppelt u de sessie-ID in de GetBlob-operatie aan de sessie-ID in de bijbehorende CreateSession-operatie. De vermelding Sessie aanmaken registreert de Microsoft Entra-identiteit en de Azure-roltoewijzing die de sessie heeft gemachtigd.
Troubleshooting
Wanneer een sessieverzoek mislukt, controleer dan de responsheader op specifieke informatie over de fout.
| Symptom | Aanbevolen actie |
|---|---|
| Sessieverzoek aanmaken mislukt | Controleer of het verzoek een geldig Microsoft Entra ID-toegangstoken gebruikt, zich richt op de beoogde container, HTTPS gebruikt en dat de beveiligingsprincipal over de benodigde machtigingen beschikt. |
| Get Blob-request geeft een autorisatiefout terug | Controleer of de sessie voor dezelfde container is aangemaakt en dat de Microsoft Entra ID-beveiligingsprincipal leestoegang heeft tot de gevraagde blob. |
| De sessie is verlopen of niet gevonden | Maak een nieuwe sessie aan en probeer het verzoek Get Blob opnieuw met de nieuwe sessiereferenties. |
| Het sessietoken is ongeldig | Verwijder de huidige sessiegegevens, maak een nieuwe sessie aan en zorg ervoor dat de waarden van de sessiegegevens niet worden gewijzigd. |
| Een andere bewerking mislukt bij sessieautorisatie | Gebruik sessiegebaseerde authenticatie alleen voor de bewerking Get Blob. Gebruik een Microsoft Entra ID-toegangstoken voor andere operaties. |