Autenticazione basata sulla sessione (anteprima)

L'autenticazione basata su sessioni riduce i tempi di autenticazione e autorizzazione per richiesta per agenti e applicazioni AI, mantenendo al contempo i controlli di sicurezza su cui le organizzazioni già fanno affidamento. Con l'autenticazione basata su sessione, un agente o un'applicazione si autentica una sola volta con Microsoft Entra ID, stabilisce una sessione di breve durata per un container e utilizza quella sessione per le letture successive.

L'autenticazione basata su sessioni è particolarmente adatta a carichi di lavoro sensibili alla latenza e a lettura intensa che effettuano molte richieste allo stesso container utilizzando la stessa identità, come agenti IA, addestramento e inferenza AI, analisi e calcolo ad alte prestazioni.

Importante

L'autenticazione basata su sessione è attualmente in anteprima. Consulta i Termini di utilizzo supplementari per le anteprime di Microsoft Azure per i termini che si applicano alle funzionalità di Azure presenti in anteprima.

Benefits

  • Prestazioni migliorate. L'identità e le autorizzazioni vengono verificate una sola volta alla creazione della sessione. Le richieste di lettura successive al contenitore utilizzano quella sessione, riducendo così la latenza di autenticazione e autorizzazione per richiesta.
  • Lo stesso accesso con privilegi minimi, ora di breve durata. Le sessioni utilizzano il modello di autorizzazione esistente della tua organizzazione per l'accesso con privilegi minimi, Azure RBAC e Azure ABAC. Ogni sessione è inoltre limitata a un container, scade dopo cinque minuti, è vincolata al client che l'ha creata e richiede che ogni richiesta sia firmata.
  • Piena tracciabilità. I log diagnostici di Archiviazione di Azure registrano attualmente l'identità Microsoft Entra ID dietro ogni richiesta, e lo stesso vale per le sessioni. Con le sessioni, ogni richiesta rimane legata all'identità Microsoft Entra ID che ha creato la sessione, così i team di sicurezza mantengono visibilità su quale identità, umana o agente, ha avuto accesso a quali dati e quando.
  • Nessuna modifica alla logica applicativa. Utilizzando le librerie client Archiviazione di Azure, abilita l'autenticazione basata sulla sessione con un'unica opzione di configurazione client.

Come funziona l'autenticazione basata sulla sessione

Quando un client chiama l'operazione Create Session, Archiviazione di Azure verifica l'identità Microsoft Entra ID del client, valuta le assegnazioni dei ruoli Azure RBAC e le condizioni Azure ABAC per il container, avvia una sessione di cinque minuti e restituisce le credenziali della sessione. Le credenziali della sessione sono composte da due parti:

  • Token di sessione: identifica la sessione.
  • Chiave della sessione: usata dal client per firmare ogni richiesta effettuata all'interno della sessione.

Per le richieste Get Blob successive allo stesso container, il client invia il token di sessione insieme a una firma calcolata con la chiave di sessione, invece di un token di accesso Microsoft Entra ID. Poiché l'identità e i permessi sono stati verificati quando la sessione è stata creata, i tempi di autenticazione e autorizzazione per richiesta vengono ridotti.

Il flusso della sessione comprende questi passaggi:

  1. Il client ottiene un token di accesso Microsoft Entra ID per Archiviazione di Azure.
  2. Il client chiama l'operazione Create Session per il contenitore di destinazione. Archiviazione di Azure autorizza la richiesta utilizzando il token di accesso Microsoft Entra ID.
  3. Archiviazione di Azure restituisce le credenziali della sessione e l'orario di scadenza della sessione.
  4. Il client utilizza le credenziali della sessione per autorizzare le richieste Get Blob per i blob presenti nello stesso container.
  5. Per continuare a leggere i dati, il client crea una nuova sessione prima che la sessione corrente scada definitivamente.

Note

Quando utilizzi l'Archiviazione di Azure SDK, la libreria client gestisce automaticamente l'intero ciclo di vita della sessione.

Le sessioni sono progettate con i seguenti confini di sicurezza:

  • Limitato a un singolo contenitore. Una sessione può autorizzare richieste solo per blob nel contenitore per cui è stata creata.
  • Legato all'identità originaria. Una sessione non concede mai permessi oltre quelli assegnati all'entità di sicurezza Microsoft Entra ID che l'ha creata. Tutte le richieste effettuate durante la sessione sono attribuite a tale identità.
  • Di breve durata. Una sessione scade dopo cinque minuti. Le credenziali della sessione non possono essere estese o aggiornate; il client deve creare una nuova sessione per continuare.
  • Legato al contesto di rete del client. Una sessione è associata all'indirizzo IP del client che l'ha creata, il che aiuta a impedire che le credenziali della sessione catturate vengano riprodotte da un altro client. La stessa sessione può essere utilizzata su più connessioni dallo stesso indirizzo IP del cliente.
  • Richieste firmate. Ogni richiesta effettuata all'interno di una sessione è firmata con la chiave della sessione.
  • Verifica. Le richieste effettuate all'interno di una sessione vengono registrate nei log diagnostici di Archiviazione di Azure.

Quando utilizzare l'autenticazione basata sulla sessione

Considera l'autenticazione basata sulla sessione quando tutte le seguenti condizioni sono verificate:

  • L'applicazione utilizza Microsoft Entra ID per l'autenticazione e Azure RBAC per l'autorizzazione.
  • L'applicazione esegue ripetute richieste Get Blob contro blob nello stesso contenitore.
  • L'applicazione può gestire in modo sicuro le credenziali temporanee delle sessioni e ricreare le sessioni secondo necessità. L'Archiviazione di Azure SDK gestisce questo automaticamente.

Non utilizzare l'autenticazione basata sulla sessione quando una qualsiasi delle seguenti condizioni è vera:

  • L'agente o l'applicazione utilizza SAS per delega utente, SAS del servizio, SAS dell'account o chiave condivisa per l'autenticazione e l'autorizzazione.
  • L'agente o l'applicazione deve eseguire un'operazione diversa da Get Blob. Queste operazioni devono utilizzare un token di accesso Microsoft Entra ID per l'autenticazione e l'autorizzazione. L'Archiviazione di Azure SDK gestisce questo automaticamente.
  • L'applicazione effettua solo una richiesta Getta Blob occasionale o singola e non beneficia di una richiesta aggiuntiva di creazione di sessione.

Billing

La creazione di una sessione viene fatturata come una transazione standard di scrittura per il tuo account di storage. Richieste Blob effettuate durante una sessione vengono fatturate alle tariffe di transazione standard per il tipo di account di storage. Per saperne di più, consulta prezzi di Archiviazione di Azure.

Get started

Per iniziare, registrati per l'anteprima utilizzando Azure PowerShell o interfaccia della riga di comando di Azure.

  • PowerShell
  • interfaccia della riga di comando di Azure

Esegui i seguenti comandi per registrarti all'anteprima:

Connect-AzAccount -SubscriptionId <subscription-id>
Register-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage

Per verificare lo stato della registrazione, esegui i seguenti comandi:

Connect-AzAccount -SubscriptionId <subscription-id>
Get-AzProviderFeature -FeatureName SessionRequest -ProviderNamespace Microsoft.Storage

Note

Potrebbero volerci alcuni giorni prima che la tua registrazione venga approvata. Dopo che la tua registrazione è stata approvata, lo stato di registrazione appare come Registrato.

Usa le sessioni con l'Archiviazione di Azure SDK

L'Archiviazione di Azure SDK offre il modo più semplice per utilizzare l'autenticazione basata su sessione. Abilita l'autenticazione basata sulla sessione quando inizializzi il client Blob; il resto della logica applicativa rimane invariato.

Quando l'autenticazione basata sulla sessione è abilitata, l'SDK gestisce automaticamente l'intero ciclo di vita della sessione:

  • Crea una sessione e memorizza in cache le sue credenziali.
  • Firma automaticamente ogni richiesta con la chiave della sessione.
  • Utilizza il token di sessione per le operazioni Get Blob e un token di accesso Microsoft Entra ID per altre operazioni.
  • Rinnova la sessione prima della scadenza senza influire sull'accesso ai dati, così la tua app non deve mai tenere traccia della durata della sessione.

Il tuo codice esistente continua a leggere blob utilizzando gli stessi metodi, le credenziali Microsoft Entra ID e le assegnazioni di ruoli RBAC, beneficiando al contempo di letture a minore latenza.

Note

Per utilizzare l'autenticazione basata su sessione con l'Archiviazione di Azure SDK, installa l'ultimo pacchetto di raccolta client Azure Blob per l'accesso ai dati. Ad esempio, per Python, installa il pacchetto versione 12.31.1 o successivo. Per .NET, installa il pacchetto versione 12.31.0-beta.1 o successivo.

I seguenti esempi SDK leggono un blob utilizzando una sessione.

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);

Usa le sessioni con l'API REST

Se chiami direttamente le API REST invece di utilizzare l'Archiviazione di Azure SDK, la tua applicazione deve creare una sessione, firmare le richieste e creare una sessione sostitutiva prima che la sessione corrente scada del ciclo.

  1. Creare una sessione. Chiama l'operazione Crea Sessione sul container e autorizza la richiesta con un token di accesso di Microsoft Entra ID. Una risposta riuscita restituisce il token della sessione, la chiave della sessione e l'orario di scadenza della sessione. Memorizza le credenziali della sessione in modo sicuro e associale al contenitore per cui sono state create.

    Richiesta di esempio

    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 è supportata solo nella versione 2026-02-06 o successiva. Per maggiori dettagli, consulta la documentazione Create Session REST API .

  2. Leggi un blob utilizzando la sessione. Chiama l'operazione Get Blob. L'intestazione Authorization contiene il token di sessione e una firma calcolata con la chiave di sessione. La chiave della sessione stessa non viene mai inviata.

    Richiesta di esempio

    GET https://myaccount.blob.core.windows.net/mycontainer/myblob
    Authorization: Session {SessionToken}:{Signature}
    x-ms-version: {version}
    

    Per maggiori dettagli, consulta la documentazione Create Session REST API .

  3. Rinnova prima della scadenza. Una sessione scade dopo cinque minuti e non può essere prolungata. Le richieste effettuate con una sessione scaduta falliscono. Quando è necessario un accesso ininterrotto, crea una sessione sostitutiva prima che la sessione corrente scada definitivamente.

Considerazioni e limitazioni

  • Per utilizzare questa funzione, devi essere autorizzato a partecipare all'anteprima. Per altre informazioni, vedere Introduzione.
  • L'autenticazione basata su sessione è limitata alle operazioni Get Blob. I token di sessione supportano solo l'operazione Get Blob; tutte le altre operazioni richiedono un token di accesso Microsoft Entra ID. Gli SDK di Archiviazione di Azure gestiscono questo automaticamente scegliendo quale token utilizzare in base all'operazione.
  • L'autenticazione basata su sessione riduce i tempi di autenticazione e autorizzazione per carichi di lavoro di lettura ad alta frequenza. Invece di eseguire la validazione completa dei token OAuth e la valutazione di autorizzazione su ogni richiesta Get Blob, Archiviazione di Azure stabilisce un contesto di sicurezza temporaneo che può essere riutilizzato nelle richieste successive. Questo riduce i tempi di autenticazione e autorizzazione per richiesta e aiuta a offrire una latenza più prevedibile per carichi di lavoro ad alta velocità di throughput e sensibili alla latenza.
  • I maggiori benefici si ottengono quando molte richieste Get Blob vengono eseguite in un breve periodo di tempo. L'autenticazione basata su sessione è pensata per applicazioni che effettuano letture ripetute su larga scala, dove ridurre i tempi di autenticazione e autorizzazione su molte richieste può migliorare l'efficienza complessiva e la coerenza della latenza. Non c'è alcun vantaggio in termini di prestazioni nel creare più sessioni per container, per utente. Pertanto, ogni utente con accesso al contenitore dovrebbe utilizzare una sola sessione alla volta.
  • L'autenticazione basata su sessione richiede Microsoft Entra ID per creare una sessione. Il client autentica la richiesta Create Session con un token di accesso Microsoft Entra ID. Archiviazione di Azure restituisce credenziali temporanee della sessione che possono essere utilizzate per le richieste Get Blob successive durante la durata della sessione. I permessi non vengono elevati né ampliati; la sessione eredita i permessi già concessi all'identità Microsoft Entra ID tramite Azure RBAC e Azure ABAC. L'autenticazione basata sulla sessione non supporta la SAS di delega utente associata all'utente, la SAS di delega utente, la SAS del servizio, la SAS dell'account o l'autorizzazione con chiave condivisa.
  • Alle sessioni viene data autorizzazione a livello di container. Le policy Azure RBAC e Azure ABAC del container vengono valutate a livello di container al momento della creazione della sessione, e tali autorizzazioni vengono utilizzate per tutta la durata della sessione. Questo significa che le policy Azure ABAC a un livello più dettagliato rispetto al contenitore non vengono valutate. Inoltre, se un permesso Azure RBAC o Azure ABAC a livello di container viene modificato entro i cinque minuti della durata della sessione, non viene applicato finché non viene creato un nuovo token di sessione. Segui il principio del minimo privilegio quando assegni ruoli Azure. Concedere accesso alla lettura solo nell'ambito più ristretto richiesto dall'applicazione. Per altre informazioni, vedere Assegnare un ruolo di Azure per l'accesso ai dati BLOB.
  • Le sessioni sono progettate con confini di sicurezza trasparenti. Una sessione è limitata a un singolo contenitore, collegata all'identità che l'ha creata, e scade dopo cinque minuti. Tutte le richieste effettuate durante la sessione sono attribuite all'identità originale del Microsoft Entra ID. Le credenziali della sessione non possono essere riutilizzate indefinitamente e devono essere ricreate dopo la scadenza. Le sessioni sono inoltre associate all'IP del client originario, aiutando a evitare che le credenziali di sessione vengano riutilizzate da un'altra macchina.
  • Non supportato:
    • I tag di indice dei blob per l'operazione Get Blob non sono supportati, il che significa che non puoi vedere alcun tag associato al blob a cui stai accedendo utilizzando un token di sessione.
    • Le operazioni di lettura Get Blob sugli account secondari; puoi chiamare Get Blob con un token di sessione come metodo di autenticazione solo sull'account principale.
    • I blob di pagina e i blob di accodamento non sono supportati; sono supportati solo i blob in blocchi.
    • SAS per delega utente legata all'utente, SAS per delega utente, SAS del servizio, SAS dell'account e autorizzazione per chiave condivisa, solo l'autenticazione Microsoft Entra ID è supportato.
    • Microsoft Purview non è supportato con i token di sessione.

Monitora l'autenticazione basata sulla sessione

Archiviazione di Azure registra le richieste Create Session e le richieste effettuate all'interno di una sessione nei log delle risorse di Monitoraggio di Azure. Per raccogliere questi log, configura un'impostazione diagnostica per gestione rete virtuale di Azure che invia i log StorageRead a un'area di lavoro Log Analytics, a un account di storage o a un hub di eventi. Per altre informazioni, vedere Monitorare Archiviazione BLOB di Azure.

richieste Create Session

Le richieste Create Session appaiono con il nome operativo CreateSession nella categoria StorageRead , con un tipo di autenticazione OAuth. Ogni voce include:

  • Identità del chiamante: il principale di sicurezza Microsoft Entra ID che ha creato la sessione, inclusi il suo ID dell'oggetto, l'ID del tenant, il nome del principale utente e l'ID dell'applicazione client.
  • Decisione di autorizzazione: l'azione valutata, l'assegnazione del ruolo Azure e la definizione del ruolo che hanno concesso l'accesso, e il risultato.
  • ID sessione: un identificatore univoco per la sessione.
  • Contenitore target: l'account di archiviazione e il contenitore a cui si applica la sessione.
  • Dettagli di rete e richiesta: indirizzo IP del chiamante, protocollo, versione TLS, codice di stato, latenza, ID della richiesta client e agente utente.

Richieste effettuate all'interno di una sessione

Le richieste Get Blob autorizzate da una sessione appaiono con il nome operativo GetBlob nella categoria StorageRead, con il tipo di autenticazione Session. Invece dell'identità del chiamante e dei dettagli di autorizzazione, ogni voce include l'ID della sessione utilizzata per autorizzare la richiesta, insieme al blob letto, all'indirizzo IP del chiamante e ai dettagli standard della richiesta.

Per trovare l'identità Microsoft Entra ID dietro una richiesta effettuata all'interno di una sessione, abbina l'ID della sessione nell'operazione GetBlob all'ID della sessione nella corrispondente operazione CreateSession. La voce Crea sessione registra l'identità Microsoft Entra e l'assegnazione del ruolo di Azure che ha autorizzato la sessione.

Troubleshooting

Quando una richiesta di sessione fallisce, controlla l'header della risposta per informazioni specifiche sull'errore.

Sintomo Azione consigliata
Fallisce la richiesta di creazione di sessione Verifica che la richiesta utilizzi un token di accesso Microsoft Entra ID valido, che prenda di mira il contenitore previsto, che utilizzi HTTPS e che il principale di sicurezza disponga dei permessi necessari.
Richiesta Get Blob restituisce un errore di autorizzazione Verifica che la sessione sia stata creata per lo stesso contenitore e che il principale di sicurezza Microsoft Entra ID abbia accesso di lettura al blob richiesto.
La sessione è scaduta o non è stata trovata Crea una nuova sessione e riprova la richiesta Get Blob con le nuove credenziali di sessione.
Il token della sessione è invalido Scarta le credenziali della sessione corrente, crea una nuova sessione e assicurati che i valori delle credenziali non vengano modificati.
Un'altra operazione fallisce con l'autorizzazione della sessione Usa l'autenticazione basata sulla sessione solo per l'operazione Get Blob. Utilizza un token di accesso Microsoft Entra ID per altre operazioni.

Passaggi successivi