Crea sessione

Important

L'autenticazione basata su sessione è attualmente in anteprima. Il tuo abbonamento deve essere abilitato per l'anteprima prima che tu possa utilizzare l'operazione Crea Sessione.

Create Session Operation crea una sessione di cinque minuti che viene assegnata a un container. Una sessione fornisce credenziali che possono essere utilizzate per autorizzare richieste successive alle risorse all'interno di quel container.

Le sessioni sono destinate a carichi di lavoro che eseguono più richieste sullo stesso container e possono ridurre l'elaborazione di autenticazione e autorizzazione richiesta per le richieste successive.

Richiesta

È possibile costruire la richiesta di Create Session come indicato di seguito. HTTPS è obbligatorio.

Method URI della richiesta Versione HTTP
POST https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session HTTP/1.1

Sostituisci myaccount con il nome del tuo account storage e mycontainer con il nome del container per cui è stata creata la sessione.

Parametri URI

I seguenti parametri sono richiesti sull'URI della richiesta.

Parametro Description
restype Required. Deve essere un contenitore. Specifica che la richiesta si applica alla risorsa container.
comp Required. Deve essere una sessione. Specifica l'operazione Crea Sessione.

Intestazioni della richiesta

Sono richiesti i seguenti intestamenti di richiesta:

Intestazione della richiesta Description
Authorization Required. Autorizza la richiesta Create Session utilizzando un token di accesso Microsoft Entra.
Date oppure x-ms-date Required. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta.
x-ms-version Required. Specifica la versione dell'operazione da utilizzare per questa richiesta. Create Session è supportata solo in versione 2026-02-06 o successiva. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

Create Session deve essere autorizzata utilizzando un token di accesso Microsoft Entra. L'autorizzazione basata su sessioni non può essere usata per creare una sessione.

Corpo della richiesta

Il corpo della richiesta ha il seguente formato XML:

<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
  <AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>

La tabella seguente descrive gli elementi del corpo della richiesta.

Element Required Description
AuthenticationType Yes Specifica il meccanismo di autenticazione per le richieste che utilizzano la sessione. Il valore attualmente supportato è HMAC. Quando HMAC viene specificato, Create Session restituisce una chiave di sessione che il client utilizza per firmare le richieste successive.

Esempio di richiesta

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>

Risposta

Un'operazione riuscita restituisce il codice di stato 201 (Creato).

Corpo della risposta

Il corpo di risposta contiene informazioni e credenziali per la sessione appena creata.

<?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 risposta include i seguenti elementi:

Element Description
Id Identificatore univoco per la sessione.
Expiration Il momento in cui la sessione scade.
AuthenticationType Il meccanismo di autenticazione associato alla sessione.
Credentials Contiene le credenziali necessarie per autorizzare le richieste utilizzando la sessione.
SessionToken Un token opaco utilizzato per autorizzare le richieste successive della sessione. Considera il token della sessione come una credenziale di sicurezza.
SessionKey Per una sessione HMAC, la chiave simmetrica utilizzata per firmare le richieste utilizzando il protocollo di firma della chiave condivisa. Considera la chiave della sessione come una credenziale di sicurezza.

Authorization

Create Session richiede l'autorizzazione Microsoft Entra ID.

  • Autorizza la richiesta con un token di accesso Microsoft Entra.

La sessione è soggetto al container specificato nell'URI della richiesta e non concede permessi oltre a quelli assegnati al principio di sicurezza Microsoft Entra. Il titolare deve avere il permesso di eseguire Get Blob per la risorsa richiesta.

Usare la sessione con Get Blob

Per una sessione HMAC, usa il SessionToken e il SessionKey restituiti per autorizzare le successive richieste Get Blob.

Il client firma la richiesta usando la chiave di sessione e include la firma risultante e il token di sessione nell'intestazione di autorizzazione:

Authorization: Session {SessionToken}:{Signature}

Ad esempio:

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

La sessione è orientata al contenitore per cui è stata creata.

Durata della sessione e rinnovo

Una sessione scade dopo cinque minuti ma può diventare invalida prima se il token oauth fornito scade prima. I clienti dovrebbero ottenere una nuova sessione quando la sessione attuale sta scadendo o non è più valida.

Stato della sessione

Le risposte alle richieste che utilizzano l'autorizzazione della sessione possono contenere informazioni sullo stato della sessione.

Stato della sessione Description
session_expiring La sessione sta per scadere o diventare invalida. Il client dovrebbe ottenere una nuova sessione prima che quella esistente diventi inutilizzabile.
session_expired La sessione è scaduta, non è stata trovata o è stata revocata. La sessione non può più essere utilizzata. Il cliente dovrebbe creare una nuova sessione.
session_token_invalid Il token di sessione fornito è malformato o altrimenti sintatticamente invalido.

Lo session_expiring stato può essere restituito nell'intestazione x-ms-auth-info della risposta.

Quando l'autorizzazione della sessione fallisce con 401 Unauthorized, il servizio può restituire informazioni di errore di sessione nell'intestazione WWW-Authenticate .

Una richiesta può anche fallire con 403 Forbidden quando la sessione fornita è valida ma non autorizza la risorsa o l'operazione richiesta.

Osservazioni:

Contesto

Quando una sessione viene creata, Archiviazione BLOB di Azure valuta l'identità Microsoft Entra del chiamante e i permessi RBAC e ABAC applicabili. Le richieste successive sono autorizzate utilizzando questo contesto di sessione.

Scope

Una sessione è sfegata al contenitore specificato nella Create Session richiesta e non può essere utilizzata per accedere ad altri container. Non concede permessi oltre a quelli dell'identità che l'ha creato.

Le modifiche ai permessi apportate durante la durata della sessione entrano in vigore quando viene creata una nuova sessione.

Valutazione dei permessi

Create Session valuta l'autorizzazione quando la sessione viene creata. Le modifiche all'account, al contenitore o ai permessi non si riflettono in una sessione esistente. Le modifiche si riflettono quando viene creata una nuova sessione dopo la scadenza della sessione esistente di cinque minuti.

Contesto della rete

Una sessione mantiene il contesto di rete che si applica quando la sessione viene creata. Le richieste successive che utilizzano la sessione devono partire dallo stesso indirizzo IP del client. Le richieste da un indirizzo IP cliente diverso vengono respinte.

Sicurezza

SessionToken e SessionKey sono credenziali di sicurezza e dovrebbero essere protette dalla divulgazione.

Limitations

L'autenticazione basata su sessione attualmente supporta solo l'operazione Get Blob. Non sono supportati gli scenari che seguono:

  • Blob tag con richieste Get Blob che utilizzano le credenziali della sessione.
  • Mandate le richieste di Blob agli account secondari.
  • Microsoft Purview con credenziali di sessione.

Altre operazioni di gestione rete virtuale di Azure devono utilizzare un meccanismo di autorizzazione già supportato.

Billing

Le richieste di prezzo possono partire da client che utilizzano API gestione rete virtuale di Azure, sia direttamente tramite l'API REST di gestione rete virtuale di Azure sia tramite una libreria client di Archiviazione di Azure. Queste richieste accumulano addebiti per transazione. Il tipo di transazione determina come viene addebitato il conto. Ad esempio, le transazioni di lettura accumulano addebiti in una categoria di fatturazione diversa rispetto alle transazioni di scrittura.

La tabella seguente mostra la categoria di fatturazione per le richieste di creazione di sessione in base al tipo di account storage:

Operation Tipo di account di archiviazione Categoria di fatturazione
Crea sessione BLOB blocchi Premium
Standard per utilizzo generale v2
Standard per utilizzo generico v1
Operazioni di scrittura

Per conoscere i prezzi per la categoria di fatturazione specificata, consulta Archiviazione BLOB di Azure pricing.