Autorizar com a ID do Microsoft Entra

O Armazenamento do Azure fornece integração com microsoft entra ID para autorização baseada em identidade de solicitações para os serviços blob, arquivo, fila e tabela. Com a ID do Microsoft Entra, você pode usar o RBAC (controle de acesso baseado em função) para conceder acesso aos recursos de blob, arquivo, fila e tabela a usuários, grupos ou aplicativos. Você pode conceder permissões com escopo para o nível de um contêiner individual, compartilhamento, fila ou tabela.

Para saber mais sobre a integração do Microsoft Entra ID no Armazenamento do Azure, consulte Autorizar o acesso a blobs e filas do Azure usando a ID do Microsoft Entra.

Para obter mais informações sobre as vantagens de usar a ID do Microsoft Entra em seu aplicativo, consulte Integração com a plataforma de identidade da Microsoft.

Usar tokens de acesso OAuth para autenticação

O Armazenamento do Azure aceita tokens de acesso do OAuth 2.0 do locatário do Microsoft Entra associado à assinatura que contém a conta de armazenamento. O Armazenamento do Azure aceita tokens de acesso para:

• Usuários e grupos
• Entidades de serviço
• Identidades gerenciadas para recursos do Azure
• Aplicativos usando permissões delegadas por usuários

O Armazenamento do Azure expõe um único escopo de delegação chamado user_impersonation que permite que os aplicativos executem qualquer ação permitida pelo usuário.

Para solicitar tokens para o Armazenamento do Azure, especifique o valor https://storage.azure.com/ para a ID do recurso. Para obter mais informações sobre a ID do recurso, consulte escopos, permissões & ede consentimento da plataforma de identidade da Microsoft.

Para obter mais informações sobre como solicitar tokens de acesso da ID do Microsoft Entra para usuários e entidades de serviço, consulte fluxos de autenticação e cenários de aplicativo.

Para obter mais informações sobre como solicitar tokens de acesso para recursos configurados com identidades gerenciadas, consulte Como usar identidades gerenciadas para recursos do Azure em uma VM do Azure para adquirir um token de acesso.

Chamar operações de armazenamento com tokens OAuth

Para chamar operações de serviço blob, arquivo, fila e tabela usando tokens de acesso OAuth, passe o token de acesso no cabeçalho de Autorização usando o esquema de do portador , e especifique uma versão de serviço de 2017-11-09 (2022-11-02 para operações em recurso de de arquivos e recurso de de diretório ou 2024-11-04 para operações no recurso FileService e fileshare) ou superior, conforme mostrado no exemplo a seguir:

Request:
GET /container/file.txt
x-ms-version: 2017-11-09
Authorization: Bearer eyJ0eXAiO...V09ccgQ
User-Agent: PostmanRuntime/7.6.0
Accept: */*
Host: sampleoautheast2.blob.core.windows.net
accept-encoding: gzip, deflate

Response:
HTTP/1.1 200
status: 200
Content-Length: 28
Content-Type: text/plain
Content-MD5: dxG7IgOBzApXPcGHxGg5SA==
Last-Modified: Wed, 30 Jan 2019 07:21:32 GMT
Accept-Ranges: bytes
ETag: "0x8D686838F9E8BA7"
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-request-id: 09f31964-e01e-00a3-8066-d4e6c2000000
x-ms-version: 2017-11-09
x-ms-creation-time: Wed, 29 Aug 2018 04:22:47 GMT
x-ms-lease-status: unlocked
x-ms-lease-state: available
x-ms-blob-type: BlockBlob
x-ms-server-encrypted: true
Date: Wed, 06 Mar 2019 21:50:50 GMT
Welcome to Azure Storage!!

Desafio do portador

O desafio do portador faz parte do protocolo OAuth RFC 6750 e é usado para descoberta de autoridade. Para solicitações anônimas para o serviço Blob ou para solicitações feitas com um token de portador OAuth inválido, o servidor retornará o código de status 401 (Não autorizado) com informações do provedor de identidade e do recurso. Consulte link para saber como usar esses valores durante a autenticação com a ID do Microsoft Entra.

Os serviços de Blob e Fila do Armazenamento do Azure retornam um desafio de portador para a versão 2019-12-12 e mais recente. O serviço Tabela de Armazenamento do Azure retorna um desafio de portador para a versão 2020-12-06 e mais recente. O Azure Data Lake Storage Gen2 retorna um desafio de portador para a versão 2017-11-09 e mais recente. O serviço arquivo do Azure retorna um desafio de portador da versão 2022-11-02 e mais recente.

Respostas a solicitações de leitura anônimas

Quando o Armazenamento de Blobs receber uma solicitação anônima, essa solicitação terá êxito se todas as seguintes condições forem verdadeiras:

• O acesso público anônimo é permitido para a conta de armazenamento.
• O contêiner é configurado para permitir acesso público anônimo.
• A solicitação é para acesso de leitura.

Se qualquer uma dessas condições não for verdadeira, a solicitação falhará. O código de resposta sobre a falha depende se a solicitação anônima foi feita com uma versão do serviço que dá suporte ao desafio de portador. O desafio de portador tem suporte com as versões de serviço 2019-12-12 e mais recentes:

• Se a solicitação anônima foi feita com uma versão de serviço que dá suporte ao desafio de portador, o serviço retorna o código de erro 401 (Não autorizado).
• Se a solicitação anônima foi feita com uma versão de serviço que não dá suporte ao desafio do portador e o acesso público anônimo não é permitido para a conta de armazenamento, o serviço retorna o código de erro 409 (Conflito).
• Se a solicitação anônima foi feita com uma versão de serviço que não dá suporte ao desafio de portador e o acesso público anônimo é permitido para a conta de armazenamento, o serviço retorna o código de erro 404 (Não encontrado).

Para obter mais informações sobre o desafio do portador, consulte desafio portador.

Exemplo de resposta ao desafio do portador

Veja a seguir um exemplo de resposta de desafio de portador quando a solicitação do cliente não inclui o token de portador na solicitação de blob de download anônimo:

Request:
GET /container/file.txt
x-ms-version: 2019-12-12
Host: sampleoautheast2.blob.core.windows.net

Response:
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer authorization_uri=https://login.microsoftonline.com/<tenant_id>/oauth2/authorize resource_id=https://storage.azure.com

<?xml version="1.0" encoding="utf-8"?>
<Error>
    <Code>NoAuthenticationInformation</Code>
    <Message>Server failed to authenticate the request. Please refer to the information in the www-authenticate header.
RequestId:ec4f02d7-1003-0006-21f9-c55bc8000000
Time:2020-01-08T08:01:46.2063459Z</Message>
</Error>

Gerenciar direitos de acesso com RBAC

A ID do Microsoft Entra manipula a autorização de acesso a recursos protegidos por meio do RBAC. Usando o RBAC, você pode atribuir funções a usuários, grupos ou entidades de serviço. Cada função abrange um conjunto de permissões para um recurso. Depois que a função é atribuída ao usuário, grupo ou entidade de serviço, ela tem acesso a esse recurso. Você pode atribuir direitos de acesso usando o portal do Azure, as ferramentas de linha de comando do Azure e as APIs de Gerenciamento do Azure. Para obter mais informações sobre o RBAC, consulte Introdução aode Controle de Acesso Role-Based.

Para o Armazenamento do Azure, você pode conceder acesso aos dados em um contêiner ou fila na conta de armazenamento. O Armazenamento do Azure oferece estas funções RBAC internas para uso com a ID do Microsoft Entra:

• proprietário de dados de blob de armazenamento
• do Colaborador de Dados de Blobs de Armazenamento
• de Leitor de Dados de Blobs de Armazenamento
• de Delegador de Blobs de Armazenamento
• Colaborador de dados da fila de armazenamento
• leitor de dados da fila de armazenamento
• processador de mensagens de dados da fila de armazenamento
• Remetente de Mensagens de Dados da Fila de Armazenamento
• leitor de dados da tabela de armazenamento
• Colaborador de dados da tabela de armazenamento
• Colaborador privilegiado de dados de arquivo de armazenamento
• leitor privilegiado de dados de arquivo de armazenamento

Para obter mais informações sobre como as funções internas são definidas para o Armazenamento do Azure, consulte Noções básicas sobre definições de função para recursos do Azure.

Você também pode definir funções personalizadas para uso com o Armazenamento de Blobs e filas do Azure. Para obter mais informações, consulte Criar funções personalizadas parade Controle de Acesso do Azure Role-Based.

Permissões para chamar operações de dados

As tabelas a seguir descrevem as permissões necessárias para um usuário, grupo, identidade gerenciada ou entidade de serviço do Microsoft Entra chamar operações específicas do Armazenamento do Azure. Para permitir que um cliente chame uma operação específica, verifique se a função RBAC atribuída pelo cliente oferece permissões suficientes para essa operação.

Permissões para operações de serviço blob

Permissões para operações de serviço fila

Permissões para operações de serviço tabela

Permissões para operações de serviço de arquivo

Consulte também

• autorizar solicitações para o Armazenamento do Azure