Autorizar com o Microsoft Entra ID

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

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 o Microsoft Entra ID.

Para obter mais informações sobre as vantagens de usar o Microsoft Entra ID 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 de 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:

• Utilizadores e grupos
• Entidades de serviço
• Identidades gerenciadas para recursos do Azure
• Aplicativos que usam permissões delegadas pelos 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 de consentimento, permissões & consentimento da plataforma de identidade da Microsoft.

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

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.

Operações de armazenamento de chamadas com tokens OAuth

Para chamar operações de serviço Blob, File, Queue e Table usando tokens de acesso OAuth, passe o token de acesso no cabeçalho Authorization usando o esquema Bearer e especifique uma versão de serviço de 2017-11-09 (2022-11-02 para operações em recurso File e Directory resource ou 2024-11-04 para operações em FileService recurso e FileShare recurso) ou superior, como 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 ao Portador

O desafio ao 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 de provedor de identidade e recurso. Consulte de link para saber como usar esses valores durante a autenticação com o Microsoft Entra ID.

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

Respostas a pedidos de leitura anónimos

Quando o Armazenamento de Blob recebe uma solicitação anônima, essa solicitação terá êxito se todas as condições a seguir 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 em caso de falha depende se a solicitação anônima foi feita com uma versão do serviço que suporta o desafio do portador. O desafio do portador é suportado 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 suporta o desafio do 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 suporta o 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 suporta o desafio do 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 ao portador, consulte Desafio ao portador.

Amostra de resposta ao desafio do portador

A seguir está um exemplo de uma resposta de desafio ao portador quando a solicitação do cliente não inclui o token do 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

O Microsoft Entra ID lida com a autorização de acesso a recursos protegidos através do RBAC. Usando o RBAC, você pode atribuir funções a usuários, grupos ou entidades de serviço. Cada função engloba um conjunto de permissões para um recurso. Depois que a função é atribuída ao usuário, grupo ou entidade de serviço, eles têm 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 incorporadas para utilização com o Microsoft Entra ID:

• do proprietário de dados de Blob de armazenamento
• do Contribuidor de Dados de Blob de Armazenamento
• Leitor de dados de Blob de armazenamento
• do Delegador de Blob de Armazenamento
• de Colaborador de Dados da Fila de Armazenamento
• Leitor de dados da fila de armazenamento
• processador de mensagens de dados da fila de armazenamento
• do remetente da mensagem de dados da fila de armazenamento
• Leitor de dados da tabela de armazenamento
• de Colaborador de Dados da Tabela de Armazenamento
• de 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 Compreender as definições de função para recursos do Azure.

Você também pode definir funções personalizadas para uso com o armazenamento de Blob e as Filas do Azure. Para obter mais informações, consulte Criar funções personalizadas para o Azure Role-Based Access Control.

Permissões para operações de chamada de dados

As tabelas a seguir descrevem as permissões necessárias para que um usuário, grupo, identidade gerenciada ou entidade de serviço do Microsoft Entra chame 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 ao cliente oferece permissões suficientes para essa operação.

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

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

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

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

Ver também

• Autorizar solicitações ao de Armazenamento do Azure