AzureSasCredential Classe

Pacote:

com.azure.core.credential

Artefato Maven:

com.azure:azure-core:1.46.0

• java.lang.Object
• • com.azure.core.credential.AzureSasCredential

public final class AzureSasCredential

Representa uma credencial que usa uma assinatura de acesso compartilhado para autenticar em um Serviço do Azure. Ele é usado para autenticar e autorizar o acesso aos serviços do Azure usando uma assinatura de acesso compartilhado.

Uma assinatura de acesso compartilhado é um token baseado em cadeia de caracteres que concede permissões limitadas e acesso a recursos específicos em um serviço do Azure por um período especificado. Ele permite que você forneça acesso limitado a seus recursos sem compartilhar sua chave de conta ou outras credenciais confidenciais.

O AzureSasCredential permite autenticar e acessar serviços do Azure que dão suporte a assinaturas de acesso compartilhado. Ao criar uma instância da AzureSasCredential classe e fornecer o token SAS como um parâmetro, você pode usar essa credencial para autenticar solicitações nos serviços do Azure.

Para usar a Credencial, você normalmente a passa para o cliente ou construtor de cliente de serviço apropriado do Azure durante a instanciação. A biblioteca manipula internamente o processo de autenticação e inclui o token SAS nas solicitações HTTP feitas ao serviço do Azure, permitindo que você acesse os recursos especificados no token SAS.

O AzureSasCredential é particularmente útil quando você precisa conceder acesso temporário e limitado a recursos específicos, como contêineres do Armazenamento do Azure, blobs, filas ou arquivos, sem expor sua chave de conta.

É importante observar que a disponibilidade e o AzureSasCredential uso do podem depender do serviço específico do Azure e de seu suporte para assinaturas de acesso compartilhado. Além disso, o formato e o conteúdo do token SAS podem variar dependendo do serviço e do recurso que você está direcionando.

Exemplo: Autenticação SAS do Azure

O exemplo de código a seguir demonstra a criação de um AzureSasCredential, usando o token sas para configurá-lo.

AzureSasCredential azureSasCredential =
     new AzureSasCredential("AZURE-SERVICE-SAS-KEY");

Resumo do Construtor

Construtor	Description
AzureSasCredential(String signature)	Cria uma credencial que autoriza a solicitação com a assinatura de acesso compartilhado fornecida.
AzureSasCredential(String signature, Function<String,String> signatureEncoder)	Cria uma credencial que autoriza a solicitação dentro da assinatura de acesso compartilhado fornecida.

Resumo do método

Modificador e tipo	Método e descrição
String	getSignature() Recupera a assinatura de acesso compartilhado associada a essa credencial.
AzureSasCredential	update(String signature) Gira a assinatura de acesso compartilhado associada a essa credencial.

Métodos herdados de java.lang.Object

clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Detalhes do construtor

AzureSasCredential

public AzureSasCredential(String signature)

Cria uma credencial que autoriza a solicitação com a assinatura de acesso compartilhado fornecida.

Supõe-se signature que o passado seja codificado. Esse construtor é efetivamente o mesmo que chamar AzureSasCredential(String signature, Function<String,String> signatureEncoder).

Parameters:

signature - A assinatura de acesso compartilhado usada para autorizar solicitações.

AzureSasCredential

public AzureSasCredential(String signature, Function signatureEncoder)

Cria uma credencial que autoriza a solicitação dentro da assinatura de acesso compartilhado fornecida.

Se signatureEncoder não for nulo, e signaturetodos updated signatures, serão codificados usando a função . signatureEncoder deve ser o mais idempotente possível para reduzir a chance de erros de codificação dupla.

Parameters:

signature - A assinatura de acesso compartilhado usada para autorizar solicitações.

signatureEncoder - Uma função opcional que codifica o signature.

Detalhes do método

getSignature

public String getSignature()

Recupera a assinatura de acesso compartilhado associada a essa credencial.

Returns:

A assinatura de acesso compartilhado que está sendo usada para autorizar solicitações.

update

public AzureSasCredential update(String signature)

Gira a assinatura de acesso compartilhado associada a essa credencial.

Parameters:

signature - A nova assinatura de acesso compartilhado a ser associada a essa credencial.

Returns:

O objeto atualizado AzureSasCredential.