Conectar-se ao Azurite com SDKs e ferramentas

Você pode se conectar ao Azurite por meio de SDKs de Armazenamento do Azure ou ferramentas como o Gerenciador de Armazenamento do Azure. A autenticação é necessária e o Azurite dá suporte à autorização com OAuth, Chave Compartilhada e SAS (assinaturas de acesso compartilhado). O Azurite também dá suporte ao acesso anônimo a contêineres públicos.

Este artigo descreve como se conectar ao emulador do Azurite usando os SDKs e ferramentas do 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 os SDKs do Azure.

Conectar seus aplicativos ou ferramentas ao Azurite

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

Usar uma conta de armazenamento e uma chave 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 dá suporte a nomes e chaves de conta de armazenamento personalizados definindo a AZURITE_ACCOUNTS variável de 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 e chaves de conta personalizadas da variável de ambiente a cada minuto por padrão. Com esse 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á-la à lista de contas e chaves personalizadas na variável de AZURITE_ACCOUNTS ambiente.

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

Usar cadeias de conexão

A maneira mais fácil de se conectar ao Azurite do seu aplicativo é configurar uma cadeia de conexão no arquivo de configuração do aplicativo que faz referência ao atalho UseDevelopmentStorage=true. Aqui está um exemplo de uma cadeia de conexão em um arquivo deapp.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 do Azure 2.0 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 Blobs, 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 de blob, a cadeia de conexão HTTPS é:

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

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 as 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 o Azurite por meio da opção --oauth . Para saber mais, confira a configuração do OAuth.
Habilite o HTTPS usando um certificado autoassinado por meio das opções e do --cert certificado --key/--pwd . Para saber mais sobre como gerar certificados, consulte configuração de certificado (HTTPS) e configuração de 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 dos arquivos de certificado e chave. Se você estiver usando um certificado PFX, use a opção --pwd em vez da opção --key .

Para interagir com os recursos do Armazenamento de Blobs, você pode criar uma instância de 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 credencial usados para autenticação. Depois de autenticada, essa credencial fornece o token OAuth como parte da instanciação do cliente. Para saber mais, confira a referência de 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 de Armazenamento de Filas, você pode criar uma instância de 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 credencial usados para autenticação. Depois de autenticada, essa credencial fornece o token OAuth como parte da instanciação do cliente. Para saber mais, confira a referência de 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 os recursos do Armazenamento de Tabelas, você pode criar uma instância de 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 credencial usados para autenticação. Depois de autenticada, essa credencial fornece o token OAuth como parte da instanciação do cliente. Para saber mais, confira a referência de 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 Avançar
Editar o campo Nome de exibição para um nome de sua escolha
Selecione Avançar novamente
Selecionar 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 estará 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 Gerenciador de Armazenamento

Localize o certificado em seu computador local.
No Gerenciador de Armazenamento, acesse EditarCertificados ->SSL ->Importar Certificados e importar 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 o Azurite por meio da cadeia de conexão HTTPS

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

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

Próximas etapas

Configurar cadeias de conexão do Armazenamento do Azure explica como montar uma cadeia de conexão válida do Armazenamento do Azure.
Usar o Azurite para executar testes automatizados descreve como gravar testes automatizados usando o emulador de armazenamento do Azurite.
Use o Emulador de Armazenamento do Azure para desenvolvimento e teste de documentos do Emulador de Armazenamento do Azure herdado, que é substituído pelo Azurite.

Comentários

Esta página foi útil?

Last updated on 2025-08-26