Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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.