Een account-SAS maken
Belangrijk
Voor optimale beveiliging raadt Microsoft aan om Microsoft Entra ID met beheerde identiteiten te gebruiken om aanvragen te autoriseren voor blob-, wachtrij- en tabelgegevens, indien mogelijk. Autorisatie met Microsoft Entra ID en beheerde identiteiten biedt superieure beveiliging en gebruiksgemak ten opzichte van autorisatie van gedeelde sleutels. Zie Autoriseren met Microsoft Entra IDvoor meer informatie. Zie Wat zijn beheerde identiteiten voor Azure-resourcesvoor meer informatie over beheerde identiteiten.
Voor resources die buiten Azure worden gehost, zoals on-premises toepassingen, kunt u beheerde identiteiten gebruiken via Azure Arc. Apps die worden uitgevoerd op servers met Azure Arc kunnen bijvoorbeeld beheerde identiteiten gebruiken om verbinding te maken met Azure-services. Zie Verifiëren bij Azure-resources met servers met Azure Arcvoor meer informatie.
Voor scenario's waarin SHARED Access Signatures (SAS) worden gebruikt, raadt Microsoft aan een SAS voor gebruikersdelegering te gebruiken. Een SAS voor gebruikersdelegering wordt beveiligd met Microsoft Entra-referenties in plaats van de accountsleutel. Zie Sas-voor gebruikersdelegering maken voor meer informatie over handtekeningen voor gedeelde toegang.
Vanaf versie 2015-04-05 ondersteunt Azure Storage het maken van een nieuw type Shared Access Signature (SAS) op het niveau van het opslagaccount. Door een account-SAS te maken, kunt u het volgende doen:
Gedelegeerdentoegang tot bewerkingen op serviceniveau die momenteel niet beschikbaar zijn met een servicespecifieke SAS, zoals de
Get/Set Service Properties
- enGet Service Stats
-bewerkingen.Gedelegeerdentoegang tot meer dan één service in een opslagaccount tegelijk. U kunt bijvoorbeeld toegang tot resources delegeren in zowel Azure Blob Storage als Azure Files met behulp van een account-SAS.
Gedelegeerdentoegang tot schrijf- en verwijderbewerkingen voor containers, wachtrijen, tabellen en bestandsshares, die niet beschikbaar zijn met een objectspecifieke SAS.
Geef een IP-adres of een bereik van IP-adressen op waaruit aanvragen moeten worden geaccepteerd.
Geef het HTTP-protocol op van waaruit aanvragen moeten worden geaccepteerd (HTTPS of HTTP/HTTPS).
Opgeslagen toegangsbeleid wordt momenteel niet ondersteund voor een account-SAS.
Waarschuwing
Handtekeningen voor gedeelde toegang zijn sleutels die machtigingen verlenen voor opslagbronnen en u moet deze beveiligen net zoals u een accountsleutel zou beveiligen. Het is belangrijk om een SAS te beschermen tegen schadelijk of onbedoeld gebruik. Gebruik discretie bij het distribueren van een SAS en een plan voor het intrekken van een gecompromitteerde SAS. Bewerkingen die gebruikmaken van handtekeningen voor gedeelde toegang moeten alleen worden uitgevoerd via een HTTPS-verbinding en SAS-URI's moeten alleen worden gedistribueerd op een beveiligde verbinding, zoals HTTPS.
Een account-SAS autoriseren
U beveiligt een account-SAS met behulp van een opslagaccountsleutel. Wanneer u een account-SAS maakt, moet uw clienttoepassing beschikken over de accountsleutel.
Als u Microsoft Entra-referenties wilt gebruiken om een SAS voor een container of blob te beveiligen, u een SAS-gebruikersdelegatie-maken.
Een SAS-URI voor het account maken
De SAS-URI van het account bestaat uit de URI voor de resource waarvoor de SAS toegang delegeert, gevolgd door een SAS-token. Het SAS-token is de queryreeks die alle informatie bevat die nodig is om een aanvraag voor de resource te autoriseren. Hiermee geeft u de service, resource en machtigingen op die beschikbaar zijn voor toegang en de periode waarin de handtekening geldig is.
De SAS-parameters voor het account opgeven
De vereiste en optionele parameters voor het SAS-token worden beschreven in de volgende tabel:
SAS-queryparameter | Beschrijving |
---|---|
api-version |
Optioneel. Hiermee geeft u de versie van de opslagservice op die moet worden gebruikt om de aanvraag uit te voeren die is gedaan met behulp van de SAS-URI van het account. Zie Aanvragen autoriseren met behulp van een shared access signaturevoor meer informatie. |
SignedVersion (sv) |
Vereist. Hiermee geeft u de ondertekende opslagserviceversie op die moet worden gebruikt om aanvragen te autoriseren die zijn gedaan met deze account-SAS. Deze moet zijn ingesteld op versie 2015-04-05 of hoger. Zie Aanvragen autoriseren met behulp van een shared access signaturevoor meer informatie. |
SignedServices (ss) |
Vereist. Hiermee geeft u de ondertekende services die toegankelijk zijn met de account-SAS. Mogelijke waarden zijn: - Blob ( b )- Wachtrij ( q )- Tabel ( t )- Bestand ( f )U kunt waarden combineren om toegang te bieden tot meer dan één service. ss=bf geeft bijvoorbeeld de toegang tot de Blob Storage- en Azure Files-eindpunten op. |
SignedResourceTypes (srt) |
Vereist. Hiermee geeft u de ondertekende resourcetypen op die toegankelijk zijn met de account-SAS. - Service ( s ): Toegang tot API's op serviceniveau (bijvoorbeeld Service-eigenschappen ophalen/instellen, Servicestatistieken ophalen, Containers/Wachtrijen/Tabellen/Shares weergeven).- Container ( c ): Toegang tot API's op containerniveau (bijvoorbeeld Container maken/verwijderen, Wachtrij maken/verwijderen, Tabel maken/verwijderen, Share maken/verwijderen, lijstblobs/bestanden en mappen).- Object ( o ): Toegang tot API's op objectniveau voor blobs, wachtrijberichten, tabelentiteiten en bestanden (bijvoorbeeld Put Blob, Query Entity, Get Messages, Create File).U kunt waarden combineren om toegang te bieden tot meer dan één resourcetype. srt=sc geeft bijvoorbeeld de toegang tot service- en containerbronnen op. |
SignedPermissions (sp) |
Vereist. Hiermee geeft u de ondertekende machtigingen voor de account-SAS. Machtigingen zijn alleen geldig als ze overeenkomen met het opgegeven ondertekende resourcetype. Als ze niet overeenkomen, worden ze genegeerd. - Lezen ( r ): Geldig voor alle ondertekende resourcetypen (Service, Container en Object). Hiermee staat u leesmachtigingen toe voor het opgegeven resourcetype.- Schrijven ( w ): Geldig voor alle ondertekende resourcetypen (Service, Container en Object). Hiermee staat u schrijftoegang toe voor het opgegeven resourcetype, zodat een gebruiker resources kan maken en bijwerken.- Verwijderen ( d ): geldig voor resourcetypen container en object, met uitzondering van wachtrijberichten.- Verwijder versie ( x ): alleen geldig voor objectresourcetype blob.- Permanent verwijderen ( y ): alleen geldig voor objectresourcetype blob.- Lijst ( l ): alleen geldig voor service- en containerresourcetypen.- Toevoegen ( a ): alleen geldig voor de volgende objectresourcetypen: wachtrijberichten, tabelentiteiten en toevoeg-blobs.- Maken ( c ): Geldig voor containerresourcetypen en de volgende objectresourcetypen: blobs en bestanden. Gebruikers kunnen nieuwe resources maken, maar kunnen bestaande resources mogelijk niet overschrijven.- Bijwerken ( u ): alleen geldig voor de volgende objectresourcetypen: wachtrijberichten en tabelentiteiten.- Proces ( p ): Alleen geldig voor het volgende objectresourcetype: wachtrijberichten.- Tag ( t ): Alleen geldig voor het volgende objectresourcetype: blobs. Staat bewerkingen voor blobtags toe.- Filter ( f ): alleen geldig voor het volgende objectresourcetype: blob. Hiermee kunt u filteren op blobtag.- Stel beleid voor onveranderbaarheid ( i ): alleen geldig voor het volgende objectresourcetype: blob. Hiermee kunt u beleid voor onveranderbaarheid en juridische bewaring voor een blob instellen/verwijderen. |
SignedStart (st) |
Optioneel. Het tijdstip waarop de SAS geldig wordt, uitgedrukt in een van de geaccepteerde ISO 8601 UTC-indelingen. Als dit wordt weggelaten, wordt ervan uitgegaan dat de begintijd de tijd is waarop de opslagservice de aanvraag ontvangt. Zie Datum/tijd-waarden opmakenvoor meer informatie over geaccepteerde UTC-indelingen. |
SignedExpiry (se) |
Vereist. Het tijdstip waarop de handtekening voor gedeelde toegang ongeldig wordt, uitgedrukt in een van de geaccepteerde ISO 8601 UTC-indelingen. Zie Datum/tijd-waarden opmakenvoor meer informatie over geaccepteerde UTC-indelingen. |
SignedIP (sip) |
Optioneel. Hiermee geeft u een IP-adres of een bereik van IP-adressen waaruit aanvragen moeten worden geaccepteerd. Wanneer u een bereik opgeeft, moet u er rekening mee houden dat het bereik inclusief is. Alleen IPv4-adressen ondersteund. Bijvoorbeeld sip=198.51.100.0 of sip=198.51.100.10-198.51.100.20 . |
SignedProtocol (spr) |
Optioneel. Hiermee geeft u het protocol op dat is toegestaan voor een aanvraag die is gedaan met de account-SAS. Mogelijke waarden zijn zowel HTTPS als HTTP (alleenhttps,http ) of HTTPS (https ). De standaardwaarde is https,http .Http is alleen geen toegestane waarde. |
SignedEncryptionScope (ses) |
Optioneel. Geeft het versleutelingsbereik aan dat moet worden gebruikt om de inhoud van de aanvraag te versleutelen. Dit veld wordt ondersteund met versie 2020-12-06 en hoger. |
Signature (sig) |
Vereist. Het handtekeninggedeelte van de URI wordt gebruikt om de aanvraag te autoriseren die is gedaan met de handtekening voor gedeelde toegang. Het tekenreeks-naar-teken is een unieke tekenreeks die is samengesteld uit de velden die moeten worden geverifieerd om de aanvraag te autoriseren. De handtekening is een HMAC (hash-based message authentication code) die wordt berekend via de tekenreeks-naar-teken en sleutel met behulp van het SHA256-algoritme en vervolgens gecodeerd met base64-codering. |
Geef het signedVersion
veld op
Het veld signedVersion
(sv
) bevat de serviceversie van de handtekening voor gedeelde toegang. Met deze waarde geeft u de versie op van de autorisatie van gedeelde sleutels die wordt gebruikt door deze Shared Access Signature (in het veld signature
). De waarde geeft ook de serviceversie op voor aanvragen die worden gedaan met deze handtekening voor gedeelde toegang.
Zie Versiebeheer voor Azure Storage-servicesvoor informatie over welke versie wordt gebruikt wanneer u aanvragen uitvoert via een handtekening voor gedeelde toegang.
Zie Toegang delegeren met een handtekening voor gedeelde toegangvoor informatie over hoe deze parameter van invloed is op de autorisatie van aanvragen die zijn gedaan met een handtekening voor gedeelde toegang.
Veldnaam | Queryparameter | Beschrijving |
---|---|---|
signedVersion |
sv |
Vereist. Ondersteund in versie 2015-04-05 en hoger. De versie van de opslagservice die moet worden gebruikt voor het autoriseren en verwerken van aanvragen die u met deze handtekening voor gedeelde toegang doet. Zie Versiebeheer voor Azure Storage-servicesvoor meer informatie. |
Een IP-adres of IP-bereik opgeven
Vanaf versie 2015-04-05 geeft het optionele signedIp
(sip
) een openbaar IP-adres of een bereik van openbare IP-adressen op waaruit aanvragen moeten worden geaccepteerd. Als het IP-adres van waaruit de aanvraag afkomstig is niet overeenkomt met het IP-adres of het adresbereik dat is opgegeven op het SAS-token, wordt de aanvraag niet geautoriseerd. Alleen IPv4-adressen ondersteund.
Wanneer u een bereik met IP-adressen opgeeft, moet u er rekening mee houden dat het bereik inclusief is. Als u bijvoorbeeld sip=198.51.100.0
of sip=198.51.100.10-198.51.100.20
opgeeft in de SAS, wordt de aanvraag beperkt tot deze IP-adressen.
In de volgende tabel wordt beschreven of het veld signedIp
moet worden opgenomen in een SAS-token voor een opgegeven scenario, op basis van de clientomgeving en de locatie van het opslagaccount.
Clientomgeving | Locatie van opslagaccount | Aanbeveling |
---|---|---|
Client die wordt uitgevoerd in Azure | In dezelfde regio als de client | Een SAS die in dit scenario aan de client wordt verstrekt, mag geen uitgaand IP-adres voor het veld signedIp bevatten. Aanvragen die worden gedaan vanuit dezelfde regio die gebruikmaken van een SAS met een opgegeven uitgaande IP-adres, mislukken.Gebruik in plaats daarvan een virtueel Azure-netwerk om netwerkbeveiligingsbeperkingen te beheren. Aanvragen naar Azure Storage vanuit dezelfde regio vinden altijd plaats via een privé-IP-adres. Raadpleeg Firewalls en virtuele netwerken voor Azure Storage configureren voor meer informatie. |
Client die wordt uitgevoerd in Azure | In een andere regio dan de client | Een SAS die in dit scenario aan de client wordt verstrekt, kan een openbaar IP-adres of een bereik van adressen voor het signedIp veld bevatten. Een aanvraag met de SAS moet afkomstig zijn van het opgegeven IP-adres of het opgegeven ip-adresbereik. |
Client die on-premises of in een andere cloudomgeving wordt uitgevoerd | In elke Azure-regio | Een SAS die in dit scenario aan de client wordt verstrekt, kan een openbaar IP-adres of een bereik van adressen voor het signedIp veld bevatten. Een aanvraag met de SAS moet afkomstig zijn van het opgegeven IP-adres of het opgegeven ip-adresbereik.Als de aanvraag via een proxy of gateway wordt doorgegeven, geeft u het openbare uitgaande IP-adres van die proxy of gateway op voor het veld signedIp . |
Het HTTP-protocol opgeven
Vanaf versie 2015-04-05 geeft het optionele signedProtocol
(spr
) het protocol op dat is toegestaan voor een aanvraag die is gedaan met de SAS. Mogelijke waarden zijn zowel HTTPS als HTTP (alleenhttps,http
) of HTTPS (https
). De standaardwaarde is https,http
. HTTP is alleen geen toegestane waarde.
Het versleutelingsbereik opgeven
Met behulp van het veld signedEncryptionScope
op de URI kunt u het versleutelingsbereik opgeven dat de clienttoepassing kan gebruiken. Hiermee wordt de versleuteling aan de serverzijde afgedwongen met het opgegeven versleutelingsbereik wanneer u blobs (PUT) uploadt met het SAS-token. De GET en HEAD worden niet beperkt en uitgevoerd zoals voorheen.
In de volgende tabel wordt beschreven hoe u naar een ondertekend versleutelingsbereik op de URI verwijst:
Veldnaam | Queryparameter | Beschrijving |
---|---|---|
signedEncryptionScope |
ses |
Optioneel. Geeft het versleutelingsbereik aan dat moet worden gebruikt om de inhoud van de aanvraag te versleutelen. |
Dit veld wordt ondersteund met versie 2020-12-06 of hoger. Als u de ses
toevoegt vóór de ondersteunde versie, retourneert de service foutcode 403 (Verboden).
Als u het standaardversleutelingsbereik voor de container of het bestandssysteem instelt, respecteert de ses
queryparameter het containerversleutelingsbeleid. Als de ses
queryparameter en x-ms-default-encryption-scope
header niet overeenkomen en de x-ms-deny-encryption-scope-override
-header is ingesteld op true
, retourneert de service foutcode 403 (Verboden).
Wanneer u de x-ms-encryption-scope
header en de ses
queryparameter in de PUT-aanvraag opgeeft, retourneert de service foutcode 400 (Ongeldige aanvraag) als er een onjuiste overeenkomst is.
De tekenreeks voor de handtekening maken
Als u de handtekeningtekenreeks voor een account-SAS wilt maken, moet u eerst de tekenreeks maken op basis van de velden die de aanvraag opstellen en vervolgens de tekenreeks coderen als UTF-8 en de handtekening berekenen met behulp van het algoritme HMAC-SHA256.
Notitie
De velden die zijn opgenomen in het tekenreeks-naar-teken, moeten url-decoderen.
Gebruik de volgende indeling om de tekenreeks-naar-teken voor een account-SAS samen te stellen:
StringToSign = accountname + "\n" +
signedpermissions + "\n" +
signedservice + "\n" +
signedresourcetype + "\n" +
signedstart + "\n" +
signedexpiry + "\n" +
signedIP + "\n" +
signedProtocol + "\n" +
signedversion + "\n"
Versie 2020-12-06 voegt ondersteuning toe voor het veld ondertekend versleutelingsbereik. Gebruik de volgende indeling om de tekenreeks-naar-teken voor een account-SAS samen te stellen:
StringToSign = accountname + "\n" +
signedpermissions + "\n" +
signedservice + "\n" +
signedresourcetype + "\n" +
signedstart + "\n" +
signedexpiry + "\n" +
signedIP + "\n" +
signedProtocol + "\n" +
signedversion + "\n" +
signedEncryptionScope + "\n"
SAS-machtigingen voor accounts per bewerking
De tabellen in de volgende secties bevatten verschillende API's voor elke service en de ondertekende resourcetypen en ondertekende machtigingen die voor elke bewerking worden ondersteund.
Blob-service
De volgende tabel bevat bewerkingen van de Blob-service en geeft aan welk ondertekend resourcetype en ondertekende machtigingen moeten worden opgegeven wanneer u toegang tot deze bewerkingen delegeert.
Operation | Ondertekende service | Ondertekend resourcetype | Ondertekende machtiging |
---|---|---|---|
Containers vermelden | Blob (b) | Service (s) | Lijst (l) |
Eigenschappen van blobservice ophalen | Blob (b) | Service (s) | Lezen (r) |
Eigenschappen van blobservice instellen | Blob (b) | Service (s) | Schrijven (w) |
Blob-servicestatistieken ophalen | Blob (b) | Service (s) | Lezen (r) |
Container maken | Blob (b) | Container (c) | Create(c) of Write (w) |
Containereigenschappen ophalen | Blob (b) | Container (c) | Lezen (r) |
Containermetagegevens ophalen | Blob (b) | Container (c) | Lezen (r) |
Containermetagegevens instellen | Blob (b) | Container (c) | Schrijven (w) |
Leasecontainer | Blob (b) | Container (c) | Schrijven (w) of verwijderen (d)1 |
Container verwijderen | Blob (b) | Container (c) | Verwijderen (d)1 |
Blobs zoeken op tags in container | Blob (b) | Container (c) | Filter (f) |
Lijst met blobs | Blob (b) | Container (c) | Lijst (l) |
Blob plaatsen (nieuwe blok-blob maken) | Blob (b) | Object (o) | Maken (c) of schrijven (w) |
Blob plaatsen (bestaande blok-blob overschrijven) | Blob (b) | Object (o) | Schrijven (w) |
Blob plaatsen (nieuwe pagina-blob maken) | Blob (b) | Object (o) | Maken (c) of schrijven (w) |
Blob plaatsen (bestaande pagina-blob overschrijven) | Blob (b) | Object (o) | Schrijven (w) |
Blob ophalen | Blob (b) | Object (o) | Lezen (r) |
Blobeigenschappen ophalen | Blob (b) | Object (o) | Lezen (r) |
Blobeigenschappen instellen | Blob (b) | Object (o) | Schrijven (w) |
Blobmetagegevens ophalen | Blob (b) | Object (o) | Lezen (r) |
Blobmetagegevens instellen | Blob (b) | Object (o) | Schrijven (w) |
Blobtags ophalen | Blob (b) | Object (o) | Tags (t) |
Blobtags instellen | Blob (b) | Object (o) | Tags (t) |
Blobs zoeken op tags | Blob (b) | Object (o) | Filter (f) |
Blob verwijderen | Blob (b) | Object (o) | Verwijderen (d)1 |
Blobversie verwijderen | Blob (b) | Object (o) | Versie (x) verwijderen2 |
Momentopname/versie definitief verwijderen | Blob (b) | Object (o) | Permanent verwijderen (y)3 |
Lease-blob | Blob (b) | Object (o) | Schrijven (w) of verwijderen (d)1 |
Momentopnameblob | Blob (b) | Object (o) | Maken (c) of schrijven (w) |
Blob kopiëren (doel is nieuwe blob) | Blob (b) | Object (o) | Maken (c) of schrijven (w) |
Blob kopiëren (doel is een bestaande blob) | Blob (b) | Object (o) | Schrijven (w) |
Incrementeel kopiëren | Blob (b) | Object (o) | Maken (c) of schrijven (w) |
Blob kopiëren afbreken | Blob (b) | Object (o) | Schrijven (w) |
Blok plaatsen | Blob (b) | Object (o) | Schrijven (w) |
Bloklijst plaatsen (nieuwe blob maken) | Blob (b) | Object (o) | Schrijven (w) |
Bloklijst plaatsen (bestaande blob bijwerken) | Blob (b) | Object (o) | Schrijven (w) |
Bloklijst ophalen | Blob (b) | Object (o) | Lezen (r) |
Pagina plaatsen | Blob (b) | Object (o) | Schrijven (w) |
Paginabereiken ophalen | Blob (b) | Object (o) | Lezen (r) |
Toevoegblok | Blob (b) | Object (o) | Toevoegen (a) of schrijven (w) |
Pagina wissen | Blob (b) | Object (o) | Schrijven (w) |
1 Met de machtiging Delete
kunt u een lease op een blob of container verbreken met versie 2017-07-29 en hoger.
2 Met de machtiging Delete Version
kunt u blobversies verwijderen met versie 2019-12-12 en hoger.
3 Met de machtiging Permanent Delete
kunt u een blob-momentopname of -versie permanent verwijderen met versie 2020-02-10 en hoger.
Queue-service
De volgende tabel bevat wachtrijservicebewerkingen en geeft aan welk ondertekend resourcetype en ondertekende machtigingen moeten worden opgegeven wanneer u toegang tot deze bewerkingen delegeert.
Operation | Ondertekende service | Ondertekend resourcetype | Ondertekende machtiging |
---|---|---|---|
Eigenschappen van wachtrijservice ophalen | Wachtrij (q) | Service (s) | Lezen (r) |
Eigenschappen van wachtrijservice instellen | Wachtrij (q) | Service (s) | Schrijven (w) |
Wachtrijen weergeven | Wachtrij (q) | Service (s) | Lijst (l) |
Wachtrijservicestatistieken ophalen | Wachtrij (q) | Service (s) | Lezen (r) |
Wachtrij maken | Wachtrij (q) | Container (c) | Create(c) of Write (w) |
Wachtrij verwijderen | Wachtrij (q) | Container (c) | Verwijderen (d) |
Wachtrijmetagegevens ophalen | Wachtrij (q) | Container (c) | Lezen (r) |
Wachtrijmetagegevens instellen | Wachtrij (q) | Container (c) | Schrijven (w) |
Bericht plaatsen | Wachtrij (q) | Object (o) | Toevoegen (a) |
Berichten ophalen | Wachtrij (q) | Object (o) | Proces (p) |
Berichten bekijken | Wachtrij (q) | Object (o) | Lezen (r) |
Bericht verwijderen | Wachtrij (q) | Object (o) | Proces (p) |
Berichten wissen | Wachtrij (q) | Object (o) | Verwijderen (d) |
Bericht bijwerken | Wachtrij (q) | Object (o) | Bijwerken (u) |
Tabelservice
De volgende tabel bevat tabelservicebewerkingen en geeft aan welk ondertekend resourcetype en ondertekende machtigingen moeten worden opgegeven wanneer u toegang tot deze bewerkingen delegeert.
Operation | Ondertekende service | Ondertekend resourcetype | Ondertekende machtiging |
---|---|---|---|
Tabelservice-eigenschappen ophalen | Tabel (t) | Service (s) | Lezen (r) |
Eigenschappen van tabelservice instellen | Tabel (t) | Service (s) | Schrijven (w) |
Tabelservicestatistieken ophalen | Tabel (t) | Service (s) | Lezen (r) |
Querytabellen | Tabel (t) | Container (c) | Lijst (l) |
Tabel aanmaken | Tabel (t) | Container (c) | Maken (c) of schrijven (w) |
Tabel verwijderen | Tabel (t) | Container (c) | Verwijderen (d) |
Query-entiteiten | Tabel (t) | Object (o) | Lezen (r) |
Entiteit invoegen | Tabel (t) | Object (o) | Toevoegen (a) |
Entiteit invoegen of samenvoegen | Tabel (t) | Object (o) | Toevoegen (a) en bijwerken (u)1 |
Entiteit invoegen of vervangen | Tabel (t) | Object (o) | Toevoegen (a) en bijwerken (u)1 |
Entiteit bijwerken | Tabel (t) | Object (o) | Bijwerken (u) |
Entiteit samenvoegen | Tabel (t) | Object (o) | Bijwerken (u) |
Entiteit verwijderen | Tabel (t) | Object (o) | Verwijderen (d) |
1 machtigingen voor toevoegen en bijwerken zijn vereist voor upsert-bewerkingen in de Tabelservice.
Bestandsservice
De volgende tabel bevat bestandsservicebewerkingen en geeft aan welk ondertekend resourcetype en ondertekende machtigingen moeten worden opgegeven wanneer u toegang tot deze bewerkingen delegeert.
Operation | Ondertekende service | Ondertekend resourcetype | Ondertekende machtiging |
---|---|---|---|
Lijstshares | Bestand (f) | Service (s) | Lijst (l) |
Eigenschappen van bestandsservice ophalen | Bestand (f) | Service (s) | Lezen (r) |
Eigenschappen van bestandsservice instellen | Bestand (f) | Service (s) | Schrijven (w) |
Statistieken voor delen ophalen | Bestand (f) | Container (c) | Lezen (r) |
Share maken | Bestand (f) | Container (c) | Maken (c) of schrijven (w) |
Momentopnameshare | Bestand (f) | Container (c) | Maken (c) of schrijven (w) |
Eigenschappen van delen ophalen | Bestand (f) | Container (c) | Lezen (r) |
Eigenschappen van delen instellen | Bestand (f) | Container (c) | Schrijven (w) |
Metagegevens van share ophalen | Bestand (f) | Container (c) | Lezen (r) |
Metagegevens van share instellen | Bestand (f) | Container (c) | Schrijven (w) |
Share verwijderen | Bestand (f) | Container (c) | Verwijderen (d) |
Mappen en bestanden weergeven | Bestand (f) | Container (c) | Lijst (l) |
Map maken | Bestand (f) | Object (o) | Maken (c) of schrijven (w) |
Mapeigenschappen ophalen | Bestand (f) | Object (o) | Lezen (r) |
Mapmetagegevens ophalen | Bestand (f) | Object (o) | Lezen (r) |
Mapmetagegevens instellen | Bestand (f) | Object (o) | Schrijven (w) |
Map verwijderen | Bestand (f) | Object (o) | Verwijderen (d) |
Bestand maken (nieuw maken) | Bestand (f) | Object (o) | Maken (c) of schrijven (w) |
Bestand maken (bestaande overschrijven) | Bestand (f) | Object (o) | Schrijven (w) |
Bestand ophalen | Bestand (f) | Object (o) | Lezen (r) |
Bestandseigenschappen ophalen | Bestand (f) | Object (o) | Lezen (r) |
Bestandsmetagegevens ophalen | Bestand (f) | Object (o) | Lezen (r) |
Bestandsmetagegevens instellen | Bestand (f) | Object (o) | Schrijven (w) |
Bestand verwijderen | Bestand (f) | Object (o) | Verwijderen (d) |
Naam van bestand wijzigen | Bestand (f) | Object (o) | Verwijderen (d) of schrijven (w) |
Bereik plaatsen | Bestand (f) | Object (o) | Schrijven (w) |
Lijstbereiken | Bestand (f) | Object (o) | Lezen (r) |
Kopieerbestand afbreken | Bestand (f) | Object (o) | Schrijven (w) |
Bestand kopiëren | Bestand (f) | Object (o) | Schrijven (w) |
Bereik wissen | Bestand (f) | Object (o) | Schrijven (w) |
Voorbeeld van SAS-URI van account
In het volgende voorbeeld ziet u een Blob-service-URI met een SAS-accounttoken dat eraan is toegevoegd. Het SAS-token van het account biedt machtigingen voor de service, container en objecten. De tabel bevat elk deel van de URI:
https://blobsamples.blob.core.windows.net/?sv=2022-11-02&ss=b&srt=sco&sp=rwlc&se=2023-05-24T09:51:36Z&st=2023-05-24T01:51:36Z&spr=https&sig=<signature>
Naam | SAS-gedeelte | Beschrijving |
---|---|---|
Resource-URI | https://myaccount.blob.core.windows.net/?restype=service&comp=properties |
Het service-eindpunt, met parameters voor het ophalen van service-eigenschappen (wanneer aangeroepen met GET) of het instellen van service-eigenschappen (wanneer deze worden aangeroepen met SET). Op basis van de waarde van het veld ondertekende services (ss ), kan deze SAS worden gebruikt met Blob Storage of Azure Files. |
Scheidingsteken | ? |
Het scheidingsteken dat voorafgaat aan de querytekenreeks. Het scheidingsteken maakt geen deel uit van het SAS-token. |
Versie van Opslagservices | sv=2022-11-02 |
Voor Azure Storage-services versie 2012-02-12 en hoger geeft deze parameter aan welke versie moet worden gebruikt. |
Services | ss=b |
De SAS is van toepassing op de Blob-services. |
Resourcetypen | srt=sco |
De SAS is van toepassing op bewerkingen op serviceniveau, containerniveau en objectniveau. |
Machtigingen | sp=rwlc |
De machtigingen verlenen toegang tot lees-, schrijf-, lijst- en maakbewerkingen. |
Begintijd | st=2019-08-01T22%3A18%3A26Z |
Opgegeven in UTC-tijd. Als u wilt dat de SAS onmiddellijk geldig is, laat u de begintijd weg. |
Verlooptijd | se=2019-08-10T02%3A23%3A26Z |
Opgegeven in UTC-tijd. |
Protocol | spr=https |
Alleen aanvragen die HTTPS gebruiken, zijn toegestaan. |
Handtekening | sig=<signature> |
Wordt gebruikt om toegang tot de blob te autoriseren. De handtekening is een HMAC die wordt berekend via een tekenreeks-naar-teken en sleutel met behulp van het SHA256-algoritme en vervolgens gecodeerd met base64-codering. |
Omdat machtigingen zijn beperkt tot het serviceniveau, worden toegankelijke bewerkingen met deze SAS Eigenschappen van blobservice ophalen (lezen) en Eigenschappen van blobservice instellen (schrijven). Met een andere resource-URI kan hetzelfde SAS-token echter ook worden gebruikt voor het delegeren van toegang tot Blob Service Stats (lezen).