Criar tokens SAS para contêineres de armazenamento

O portal Azure é um console baseado na Web que permite que você gerencie sua assinatura de Azure e recursos usando uma GUI (interface gráfica do usuário).

1. Entre no portal Azure.

2. Navegue até sua conta de armazenamento>contêineres>seu contêiner.

3. Selecione Gerar SAS no menu próximo à parte superior da página.

4. Selecione método de assinatura → chave de delegação do usuário.

5. Defina permissões selecionando ou desmarcando a caixa de seleção apropriada.
   

   • Verifique se as permissões Leitura, Gravação, Exclusão e Lista estão selecionadas.

   

   Importante

   • Se você receber uma mensagem semelhante à seguinte, precisará atribuir acesso aos dados de blob na conta de armazenamento:

     

   • O controle de acesso baseado em função do Azure (Azure RBAC) é o sistema de autorização usado para gerenciar o acesso aos recursos do Azure. Azure RBAC ajuda você a gerenciar o acesso e as permissões para seus recursos de Azure.

   • Atribuir uma função de Azure para acesso aos dados de blob atribuir uma função que permita permissões de leitura, gravação e exclusão para seu contêiner de armazenamento Azure. Consulteo Colaborador de Dados do Blob de Armazenamento.

6. Especifique os horários de início e expiração da chave assinada.

   • Quando você cria um token SAS, a duração padrão é de 48 horas. Após 48 horas, você precisará criar um novo token.
   • Considere definir um período de duração mais longo para o tempo que você está usando sua conta de armazenamento para operações do Serviço de Inteligência de Documento.
   • O valor do tempo de expiração é determinado se você está usando uma chave de conta ou uma chave de delegação do usuáriométodo de assinatura:
     • Chave da conta: sem limite de tempo máximo imposto; no entanto, as práticas recomendadas recomendaram que você configure uma política de expiração para limitar o intervalo e minimizar o comprometimento. Configure uma política de expiração para assinaturas de acesso compartilhado.
     • Chave de delegação do usuário: o valor para o tempo de expiração é um máximo de sete dias a partir da criação do token SAS. A SAS é inválida após a expiração da chave de delegação do usuário, portanto, uma SAS com um tempo de expiração maior que sete dias ainda será válida apenas por sete dias. Para mais informações, consulteUsar credenciais do Microsoft Entra para proteger um SAS.

7. O campo Endereços IP permitidos é opcional e especifica um endereço IP ou um intervalo de endereços IP dos quais aceitar solicitações. Se o endereço IP da solicitação não corresponder ao endereço IP ou ao intervalo de endereços especificado no token SAS, a autorização falhará. O endereço IP ou um intervalo de endereços IP devem ser IPs públicos, não privados. Para obter mais informações, consulte especifique um endereço IP ou intervalo de IP.

8. O campo Protocolos permitidos é opcional e especifica o protocolo permitido para uma solicitação feita com o token SAS. O valor padrão é HTTPS.

9. Selecione Gerar token SAS e URL.

10. A cadeia de consulta de token SAS do Blob e a URL SAS do Blob aparecem na área inferior da janela. Para usar o token SAS do Blob, acrescente-o a um URI do serviço de armazenamento.

11. Copie e cole o token SAS do Blob e os valores de URL SAS do Blob em um local seguro. Os valores são exibidos apenas uma vez e não podem ser recuperados após o fechamento da janela.

12. Para construir uma URL SAS, acrescente o URI (token SAS) à URL de um serviço de armazenamento.

Gerenciador de Armazenamento do Azure é um aplicativo autônomo gratuito que permite gerenciar facilmente seus recursos de armazenamento em nuvem Azure da área de trabalho.

Introdução

• Você precisa do aplicativo Gerenciador de Armazenamento do Azure instalado em seu ambiente de desenvolvimento Windows, macOS ou Linux.

• Depois que o aplicativo Gerenciador de Armazenamento do Azure for instalado, conecte-se à conta de armazenamento que você está usando para o Document Intelligence.

Criar os tokens SAS

1. Abra o aplicativo Gerenciador de Armazenamento do Azure em seu computador local e navegue até suas contas Storage conectadas.

2. Expanda o nó Contas de Armazenamento e selecione Contêineres de Blob.

3. Expanda o nó Contêineres de Blob e clique com o botão direito do mouse em um nó de contêiner de armazenamento para exibir o menu de opções.

4. Selecione Obter Assinatura de Acesso Compartilhado no menu de opções.

5. Na janela Assinatura de Acesso Compartilhado , faça as seguintes seleções:

   • Selecione sua política de Acesso (o padrão não é nenhum).
   • Especifique a data e hora de início e de expiração da chave assinada. Um tempo de vida curto é recomendado porque, uma vez gerado, uma SAS não pode ser revogada.
   • Selecione o fuso horário para a data e hora de início e expiração (o padrão é Local).
   • Defina suas permissões de contêiner selecionando as caixas de seleção Ler, Gravar, Listar e Excluir .
   • Selecione key1 ou key2.
   • Examine e selecione Criar.

6. Uma nova janela é exibida com o nome do contêiner, URL SAS e string de consulta do contêiner.

7. Copie e cole a URL sas e os valores da cadeia de caracteres de consulta em um local seguro. Eles só serão exibidos uma vez e não poderão ser recuperados quando a janela for fechada.

8. Para construir uma URL SAS, acrescente o URI (token SAS) à URL de um serviço de armazenamento.

Usar a URL SAS para permitir acesso

A URL sas inclui um conjunto especial de parâmetros de consulta. Esses parâmetros indicam como o cliente acessa os recursos.

API REST

Para usar sua URL SAS com a API REST, adicione a URL SAS ao corpo da solicitação:

{
    "source":"<BLOB SAS URL>"
}

É isso! Você aprendeu a criar tokens SAS para autorizar como os clientes acessam seus dados.

Próxima etapa