Criar tokens SAS para contentores de armazenamento

O portal Azure é uma consola web que lhe permite gerir a sua subscrição e recursos do Azure através de uma interface gráfica (GUI).

1. Inicie sessão no portal Azure.

2. Navegue para a sua conta de armazenamento>contentores>o seu contentor.

3. Selecione Gerar SAS no menu perto do topo da página.

4. Selecione método de assinatura → chave de delegação de utilizador.

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

   • Certifique-se de que as permissões de Ler, Escrever, Eliminar e Listar estão selecionadas.

   

   Importante

   • Se receber uma mensagem semelhante à seguinte, também terá de atribuir acesso aos dados do blob na sua conta de armazenamento:

     

   • Azure controlo de acesso baseado em papéis (Azure RBAC) é o sistema de autorização utilizado para gerir o acesso a recursos da Azure. O Azure RBAC ajuda-o a gerir o acesso e as permissões para os seus recursos do Azure.

   • Atribuir uma função Azure para acesso a dados de blob para atribuir uma função que conceda permissões de leitura, escrita e eliminação para o seu Azure contentor de armazenamento. Ver Contribuidor de Dados de Blob de Armazenamento.

6. Especifique os tempos de Início e Expiração da chave assinada.

   • Quando crias um token SAS, a duração padrão é de 48 horas. Após 48 horas, terá de criar um novo token.
   • Considere definir um período de duração mais longo para o tempo em que utiliza a sua conta de armazenamento para operações do Serviço de Inteligência de Documentos.
   • O valor do tempo de expiração é determinado se está a usar uma chave de Conta ou uma chave de delegação de utilizadorMétodo de assinatura:
     • Chave da conta: Sem limite máximo de tempo imposto; No entanto, as melhores práticas recomendam configurar uma política de expiração para limitar o intervalo e minimizar compromissos. Configure uma política de expiração para assinaturas de acesso partilhado.
     • Chave de delegação do utilizador: O valor para o tempo de expiração é um máximo de sete dias a partir da criação do token SAS. O SAS torna-se inválido após expirar a chave de delegação do utilizador, por isso um SAS com tempo de expiração superior a sete dias continuará válido apenas por sete dias. Para mais informações, vejaUtilize credenciais de Microsoft Entra para garantir um SAS.

7. O campo Permitidos endereços IP é opcional e especifica um endereço IP ou um intervalo de endereços IP a partir do qual aceitar pedidos. Se o endereço IP do pedido não corresponder ao endereço IP ou ao intervalo de endereços especificado no token SAS, a autorização falha. O endereço IP ou um intervalo de endereços IP deve ser um IP público, não privado. Para mais informações, veja, Especificar um endereço IP ou intervalo de IP.

8. O campo Protocolos Permitidos é opcional e especifica o protocolo permitido para um pedido feito com o token SAS. O valor padrão é HTTPS.

9. Selecione Gerar token SAS e URL.

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

11. Copie e cole os valores do token SAS do Blob e URL SAS do Blob num local seguro. Os valores são exibidos apenas uma vez e não podem ser recuperados depois de a janela estar fechada.

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

Explorador de Armazenamento do Azure é uma aplicação independente gratuita que lhe permite gerir facilmente os seus recursos de armazenamento na nuvem Azure a partir do seu ambiente de trabalho.

Introdução

• Precisas da aplicação Explorador de Armazenamento do Azure instalada no teu ambiente de desenvolvimento Windows, macOS ou Linux.

• Depois de a aplicação Explorador de Armazenamento do Azure estar instalada, liga-a à conta de armazenamento que estás a usar para o Document Intelligence.

Crie os seus tokens SAS

1. Abra a aplicação Explorador de Armazenamento do Azure na sua máquina local e navegue até às suas Contas de Armazenamento ligadas.

2. Expanda o nó de Contas de Armazenamento e selecione Blob Containers.

3. Expanda o nó Blob Containers e clique com o botão direito num contentor de armazenamento para mostrar as opções.

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

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

   • Selecione a sua política de acesso (o padrão é nenhum).
   • Especifique a data e hora de início e a data de expiração da chave assinada. Recomenda-se uma vida útil curta porque, uma vez gerado, um SAS não pode ser revogado.
   • Selecione o fuso horário para a data e hora de início e expiração (o padrão é Local).
   • Defina as permissões do seu contentor selecionando as caixas de seleção Ler, Escrever, Listar e Eliminar .
   • Selecione a chave1 ou a chave2.
   • Revise e selecione Criar.

6. Aparece uma nova janela com o nome do contentor , URL SAS e string de consulta para o seu contentor.

7. Copie e cole o URL SAS e os valores das cadeias de consulta num local seguro. Só serão exibidos uma vez e não podem ser recuperados depois de fechar a janela.

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

Use o seu URL SAS para conceder acesso

O URL SAS inclui um conjunto especial de parâmetros de consulta. Esses parâmetros indicam como o cliente acede aos recursos.

API REST

Para usar o seu URL SAS com a API REST, adicione o URL SAS ao corpo do pedido:

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

É isso! Aprendeste a criar tokens SAS para autorizar o acesso dos clientes aos teus dados.

Próximo passo