Conecte-se ao Azurite com SDKs e ferramentas

2025-08-26

Você pode se conectar ao Azurite a partir de SDKs de Armazenamento do Azure ou ferramentas como o Gerenciador de Armazenamento do Azure. A autenticação é necessária e o Azurite suporta autorização com OAuth, Chave Partilhada e assinaturas de acesso partilhado (SAS). O Azurite também suporta acesso anónimo a contentores públicos.

Este artigo descreve como se conectar ao emulador Azurite usando as ferramentas e SDKs de Armazenamento do Azure. Para obter informações sobre como instalar e executar o Azurite, consulte Instalar e executar o Azurite. Para saber mais sobre como usar o Azurite com os SDKs do Azure, consulte SDKs do Azure.

Ligue as suas aplicações ou ferramentas ao Azurite

Para conectar seus aplicativos ou ferramentas ao Azurite, você pode usar os seguintes métodos:

Use uma conta de armazenamento e uma chave bem conhecidas

O Azurite aceita a mesma conta e chave conhecidas usadas pelo Emulador de Armazenamento do Azure herdado.

Nome da conta: devstoreaccount1
Chave da conta: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Usar chaves e contas de armazenamento personalizadas

O Azurite suporta chaves e nomes de conta de armazenamento personalizados definindo a variável de AZURITE_ACCOUNTS ambiente no seguinte formato: account1:key1[:key2];account2:key1[:key2];....

Por exemplo, use uma conta de armazenamento personalizada que tenha uma chave:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Observação

As chaves de conta devem ser uma cadeia de caracteres codificada em base64.

Ou use várias contas de armazenamento com duas chaves cada:

set AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"

export AZURITE_ACCOUNTS="account1:key1:key2;account2:key1:key2"

O Azurite atualiza nomes de conta personalizados e chaves da variável de ambiente a cada minuto por padrão. Com este recurso, você pode girar dinamicamente a chave da conta ou adicionar novas contas de armazenamento sem reiniciar o Azurite.

Observação

A conta de armazenamento padrão devstoreaccount1 é desabilitada quando você define contas de armazenamento personalizadas. Se você quiser continuar usando devstoreaccount1 depois de habilitar contas de armazenamento personalizadas, precisará adicioná-lo à lista de contas e chaves personalizadas na AZURITE_ACCOUNTS variável de ambiente.

As chaves de conta devem ser uma cadeia de caracteres codificada em base64.

Utilizar as cadeias de ligação

A maneira mais fácil de se conectar ao Azurite a partir do seu aplicativo é configurar uma cadeia de conexão no arquivo de configuração do seu aplicativo que faça referência ao atalho UseDevelopmentStorage=true. Aqui está um exemplo de uma cadeia de conexão em um arquivo app.config :

<appSettings>
  <add key="StorageConnectionString" value="UseDevelopmentStorage=true" />
</appSettings>

Cadeias de conexão HTTP

Você pode passar as seguintes cadeias de conexão para os SDKs ou ferramentas do Azure , como a CLI 2.0 do Azure ou o Gerenciador de Armazenamento.

A cadeia de conexão completa é:

DefaultEndpointsProtocol=http;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=http://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=http://127.0.0.1:10001/devstoreaccount1;TableEndpoint=http://127.0.0.1:10002/devstoreaccount1;

Para se conectar a um serviço específico, você pode usar as seguintes cadeias de conexão:

Para se conectar somente ao Armazenamento de Blob, a cadeia de conexão é:

Cadeias de conexão HTTPS

A cadeia de conexão HTTPS completa é:

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;

Para se conectar a um serviço específico, você pode usar as seguintes cadeias de conexão:

Para usar somente o serviço blob, a cadeia de conexão HTTPS é:

Se você usou dotnet dev-certs para gerar seu certificado autoassinado, use a seguinte cadeia de conexão.

DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://localhost:10000/devstoreaccount1;QueueEndpoint=https://localhost:10001/devstoreaccount1;TableEndpoint=https://localhost:10002/devstoreaccount1;

Atualize a cadeia de conexão ao usar chaves e contas de armazenamento personalizadas.

Para obter mais informações, consulte Configurar cadeias de conexão do Armazenamento do Azure.

Conectar-se usando SDKs do Azure

Para se conectar ao Azurite com os SDKs do Azure, siga estas etapas:

Habilite a autenticação OAuth para Azurite através do --oauth switch. Para saber mais, consulte Configuração do OAuth.
Habilite o HTTPS usando um certificado autoassinado por meio das --cert opções e/--key--pwd . Para saber mais sobre como gerar certificados, consulte Configuração de certificado (HTTPS) e Configuração HTTPS.

Depois que os certificados estiverem em vigor, inicie o Azurite com as seguintes opções de linha de comando:

azurite --oauth basic --cert cert-name.pem --key cert-name-key.pem

Substitua cert-name.pem e certname-key.pem pelos nomes do seu certificado e arquivos de chave. Se você estiver usando um certificado PFX, use a --pwd opção em vez da --key opção.

Para interagir com recursos de Armazenamento de Blob, você pode instanciar um BlobContainerClient, BlobServiceClientou BlobClient.

Os exemplos a seguir mostram como autorizar um BlobContainerClient objeto usando três mecanismos de autorização diferentes: DefaultAzureCredential, cadeia de conexão e chave compartilhada. DefaultAzureCredential fornece um mecanismo de autenticação baseado em token de portador e usa uma cadeia de tipos de credenciais usados para autenticação. Uma vez autenticada, essa credencial fornece o token OAuth como parte da instanciação do cliente. Para saber mais, consulte a referência da classe DefaultAzureCredential.

// With container URL and DefaultAzureCredential
var client = new BlobContainerClient(
    new Uri("https://127.0.0.1:10000/devstoreaccount1/container-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new BlobContainerClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;BlobEndpoint=https://127.0.0.1:10000/devstoreaccount1;", "container-name"
  );

// With account name and key
var client = new BlobContainerClient(
    new Uri("https://127.0.0.1:10000/devstoreaccount1/container-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Para interagir com os recursos do Armazenamento em Fila, você pode instanciar um QueueClient ou QueueServiceClient.

Os exemplos a seguir mostram como criar e autorizar um QueueClient objeto usando três mecanismos de autorização diferentes: DefaultAzureCredential, cadeia de conexão e chave compartilhada. DefaultAzureCredential fornece um mecanismo de autenticação baseado em token de portador e usa uma cadeia de tipos de credenciais usados para autenticação. Uma vez autenticada, essa credencial fornece o token OAuth como parte da instanciação do cliente. Para saber mais, consulte a referência da classe DefaultAzureCredential.

// With queue URL and DefaultAzureCredential
var client = new QueueClient(
    new Uri("https://127.0.0.1:10001/devstoreaccount1/queue-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new QueueClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;QueueEndpoint=https://127.0.0.1:10001/devstoreaccount1;", "queue-name"
  );

// With account name and key
var client = new QueueClient(
    new Uri("https://127.0.0.1:10001/devstoreaccount1/queue-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Para interagir com recursos de Armazenamento de Tabela, você pode instanciar um TableClient ou TableServiceClient.

Os exemplos a seguir mostram como criar e autorizar um TableClient objeto usando três mecanismos de autorização diferentes: DefaultAzureCredential, cadeia de conexão e chave compartilhada. DefaultAzureCredential fornece um mecanismo de autenticação baseado em token de portador e usa uma cadeia de tipos de credenciais usados para autenticação. Uma vez autenticada, essa credencial fornece o token OAuth como parte da instanciação do cliente. Para saber mais, consulte a referência da classe DefaultAzureCredential.

// With table URL and DefaultAzureCredential
var client = new Client(
    new Uri("https://127.0.0.1:10002/devstoreaccount1/table-name"), new DefaultAzureCredential()
  );

// With connection string
var client = new TableClient(
    "DefaultEndpointsProtocol=https;AccountName=devstoreaccount1;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==;TableEndpoint=https://127.0.0.1:10002/devstoreaccount1;", "table-name"
  );

// With account name and key
var client = new TableClient(
    new Uri("https://127.0.0.1:10002/devstoreaccount1/table-name"),
    new StorageSharedKeyCredential("devstoreaccount1", "Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==")
  );

Conectar o Gerenciador de Armazenamento do Azure

Você pode usar o Gerenciador de Armazenamento para exibir os dados armazenados no Azurite usando os protocolos HTTP ou HTTPS.

Conectar-se ao Azurite usando HTTP

No Gerenciador de Armazenamento, conecte-se ao Azurite seguindo estas etapas:

Selecione o ícone Gerenciar contas
Selecione Adicionar uma conta
Selecione Anexar a um emulador local
Selecione Seguinte
Editar o campo Nome para exibição para um nome de sua escolha
Selecione Avançar novamente
Selecione Conectar

Conectar-se ao Azurite usando HTTPS

Por padrão, o Gerenciador de Armazenamento não abre um ponto de extremidade HTTPS que usa um certificado autoassinado. Se você estiver executando o Azurite com HTTPS, provavelmente está usando um certificado autoassinado. No Gerenciador de Armazenamento, importe certificados SSL por meio da caixa de diálogo Editar ->Certificados SSL ->Importar Certificados .

Importar certificado para o Storage Explorer

Encontre o certificado na sua máquina local.
No Gerenciador de Armazenamento, vá para Editar ->Certificados SSL ->Importar Certificados e importe seu certificado.

Se você não importar um certificado, receberá um erro:

unable to verify the first certificate ou self signed certificate in chain

Adicionar Azurite via cadeia de conexão HTTPS

Siga estas etapas para adicionar o Azurite HTTPS ao Gerenciador de Armazenamento:

Selecione Alternar Explorer
Selecione Local & Anexado
Clique com o botão direito do mouse em Contas de Armazenamento e selecione Conectar ao Armazenamento do Azure.
Selecione Usar uma cadeia de conexão
Selecione Avançar.
Insira um valor no campo Nome para exibição .
Insira a cadeia de conexão HTTPS da seção anterior deste documento
Selecione Seguinte
Selecione Conectar

Próximos passos

Configurar cadeias de conexão do Armazenamento do Azure explica como montar uma cadeia de conexão válida do Armazenamento do Azure.
Use Azurite to run automated tests descreve como escrever testes automatizados usando o emulador de armazenamento Azurite.
Use o Emulador de Armazenamento do Azure para desenvolver e testar documentos do Emulador de Armazenamento do Azure herdado, que é substituído pelo Azurite.

Comentários

Esta página foi útil?