Conexión a Azurite con SDK y herramientas

Puede conectarse a Azurite desde sdk de Azure Storage o herramientas como el Explorador de Azure Storage. La autenticación es necesaria y Azurite admite la autorización con OAuth, clave compartida y firmas de acceso compartido (SAS). Azurite también admite el acceso anónimo a contenedores públicos.

En este artículo se describe cómo conectarse al emulador de Azurite mediante los SDK y las herramientas de Azure Storage. Para obtener información sobre cómo instalar y ejecutar Azurite, consulte Instalación y ejecución de Azurite. Para más información sobre el uso de Azurite con los SDK de Azure, consulte SDK de Azure.

Conexión de aplicaciones o herramientas a Azurite

Para conectar las aplicaciones o herramientas a Azurite, puede usar los métodos siguientes:

Uso de una cuenta de almacenamiento y una clave conocidas

Azurite acepta la misma cuenta y clave conocidas que usa el emulador de Azure Storage heredado.

Nombre de cuenta: devstoreaccount1
Clave de cuenta: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Uso de claves y cuentas de almacenamiento personalizadas

Azurite admite nombres y claves de cuenta de almacenamiento personalizados estableciendo la AZURITE_ACCOUNTS variable de entorno en el formato siguiente: account1:key1[:key2];account2:key1[:key2];....

Por ejemplo, use una cuenta de almacenamiento personalizada que tenga una clave:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Nota:

Las claves de cuenta deben ser una cadena codificada en base64.

O bien, use varias cuentas de almacenamiento con dos claves cada una:

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

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

Azurite actualiza los nombres y claves de cuenta personalizados de la variable de entorno cada minuto de forma predeterminada. Con esta característica, puede rotar dinámicamente la clave de cuenta o agregar nuevas cuentas de almacenamiento sin reiniciar Azurite.

Nota:

La cuenta de almacenamiento predeterminada devstoreaccount1 está deshabilitada al establecer cuentas de almacenamiento personalizadas. Si quiere seguir usando devstoreaccount1 después de habilitar cuentas de almacenamiento personalizadas, debe agregarla a la lista de cuentas y claves personalizadas en la AZURITE_ACCOUNTS variable de entorno.

Las claves de cuenta deben ser una cadena codificada en base64.

Uso de cadenas de conexión

La manera más fácil de conectarse a Azurite desde la aplicación es configurar una cadena de conexión en el archivo de configuración de la aplicación que hace referencia al acceso directo UseDevelopmentStorage=true. Este es un ejemplo de una cadena de conexión en un archivo app.config :

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

Cadenas de conexión HTTP

Puede pasar las siguientes cadenas de conexión a los SDK o herramientas de Azure , como la CLI de Azure 2.0 o el Explorador de Storage.

La cadena de conexión completa es:

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 conectarse a un servicio específico, puede usar las siguientes cadenas de conexión:

Para conectarse solo a Blob Storage, la cadena de conexión es:

Cadenas de conexión HTTPS

La cadena de conexión HTTPS completa es:

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 conectarse a un servicio específico, puede usar las siguientes cadenas de conexión:

Para usar blob service solo, la cadena de conexión HTTPS es:

Si usó dotnet dev-certs para generar el certificado autofirmado, use la siguiente cadena de conexión.

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

Actualice la cadena de conexión al usar claves y cuentas de almacenamiento personalizadas.

Para más información, consulte Configuración de cadenas de conexión de Azure Storage.

Conexión mediante SDK de Azure

Para conectarse a Azurite con los SDK de Azure, siga estos pasos:

Habilite la autenticación de OAuth para Azurite mediante el --oauth modificador . Para más información, consulte Configuración de OAuth.
Habilite HTTPS mediante un certificado autofirmado a través de las --cert opciones y/--key--pwd . Para obtener más información sobre la generación de certificados, consulte Configuración de certificados (HTTPS) y configuración de HTTPS.

Una vez implementados los certificados, inicie Azurite con las siguientes opciones de línea de comandos:

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

Reemplace cert-name.pem y certname-key.pem por los nombres de los archivos de clave y certificado. Si usa un certificado PFX, use la --pwd opción en lugar de la --key opción .

Para interactuar con los recursos de Blob Storage, puede crear instancias de , BlobContainerClientBlobServiceCliento BlobClient.

En los ejemplos siguientes se muestra cómo autorizar un BlobContainerClient objeto mediante tres mecanismos de autorización diferentes: DefaultAzureCredential, cadena de conexión y clave compartida. DefaultAzureCredential proporciona un mecanismo de autenticación basado en tokens de portador y usa una cadena de tipos de credenciales usados para la autenticación. Una vez autenticada, esta credencial proporciona el token de OAuth como parte de la creación de instancias de cliente. Para más información, consulte la referencia de la clase 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 interactuar con los recursos de Queue Storage, puede crear instancias de o QueueClientQueueServiceClient.

En los ejemplos siguientes se muestra cómo crear y autorizar un QueueClient objeto mediante tres mecanismos de autorización diferentes: DefaultAzureCredential, cadena de conexión y clave compartida. DefaultAzureCredential proporciona un mecanismo de autenticación basado en tokens de portador y usa una cadena de tipos de credenciales usados para la autenticación. Una vez autenticada, esta credencial proporciona el token de OAuth como parte de la creación de instancias de cliente. Para más información, consulte la referencia de la clase 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 interactuar con los recursos de Table Storage, puede crear instancias de o TableClientTableServiceClient.

En los ejemplos siguientes se muestra cómo crear y autorizar un TableClient objeto mediante tres mecanismos de autorización diferentes: DefaultAzureCredential, cadena de conexión y clave compartida. DefaultAzureCredential proporciona un mecanismo de autenticación basado en tokens de portador y usa una cadena de tipos de credenciales usados para la autenticación. Una vez autenticada, esta credencial proporciona el token de OAuth como parte de la creación de instancias de cliente. Para más información, consulte la referencia de la clase 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==")
  );

Conexión del Explorador de Azure Storage

Puede usar el Explorador de Storage para ver los datos almacenados en Azurite mediante los protocolos HTTP o HTTPS.

Conexión a Azurite mediante HTTP

En el Explorador de Storage, conéctese a Azurite siguiendo estos pasos:

Seleccione el icono Administrar cuentas .
Seleccione Agregar una cuenta.
Seleccione Asociar a un emulador local.
Seleccione Siguiente.
Edite el campo Nombre para mostrar a un nombre de su elección
Vuelva a seleccionar Siguiente .
Seleccione Conectar.

Conexión a Azurite mediante HTTPS

De forma predeterminada, el Explorador de Storage no abre un punto de conexión HTTPS que usa un certificado autofirmado. Si ejecuta Azurite con HTTPS, es probable que use un certificado autofirmado. En el Explorador de Storage, importe certificados SSL mediante el cuadro de diálogo Editar certificados ->SSL ->Importar certificados .

Importar certificado al Explorador de Storage

Busque el certificado en el equipo local.
En el Explorador de Storage, vaya a Editar -Certificados SSL ->>Importar certificados e importar el certificado.

Si no importa un certificado, recibirá un error:

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

Adición de Azurite a través de la cadena de conexión HTTPS

Siga estos pasos para agregar Azurite HTTPS al Explorador de Storage:

Selección del Explorador de alternancias
Seleccione Local & Attached (Local & Attached)
Haga clic con el botón derecho en Cuentas de almacenamiento y seleccione Conectar a Azure Storage.
Seleccione Usar una cadena de conexión.
Seleccione Siguiente.
Escriba un valor en el campo Nombre para mostrar .
Escriba la cadena de conexión HTTPS de la sección anterior de este documento.
Seleccione Siguiente.
Seleccione Conectar.

Pasos siguientes

La configuración de cadenas de conexión de Azure Storage explica cómo ensamblar una cadena de conexión válida de Azure Storage.
El uso de Azurite para ejecutar pruebas automatizadas describe cómo escribir pruebas automatizadas mediante el emulador de almacenamiento de Azurite.
Use el emulador de Azure Storage para el desarrollo y las pruebas de documentos del emulador de Azure Storage heredado, que se sustituye por Azurite.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-08-26