Подключение к Azurite с помощью пакетов SDK и средств

Вы можете подключиться к Azurite из пакетов SDK службы хранилища Azure или таких средств, как Обозреватель службы хранилища Azure. Требуется проверка подлинности, а Azurite поддерживает авторизацию с помощью OAuth, общего ключа и подписанных URL-адресов (SAS). Azurite также поддерживает анонимный доступ к общедоступным контейнерам.

В этой статье описывается, как подключиться к эмулятору Azurite с помощью пакетов SDK и средств службы хранилища Azure. Сведения об установке и запуске Azurite см. в разделе "Установка и запуск Azurite". Дополнительные сведения об использовании Azurite с пакетами SDK Azure см. в статье о пакетах SDK Azure.

Подключение приложений или инструментов к Azurite

Чтобы подключить приложения или инструменты к Azurite, можно использовать следующие методы:

Использование известной учетной записи хранения и ключа

Azurite принимает ту же известную учетную запись и ключ, который используется устаревшим эмулятором службы хранилища Azure.

Имя учетной записи: devstoreaccount1
Ключ учетной записи: Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==

Использование пользовательских учетных записей хранения и ключей

Azurite поддерживает пользовательские имена и ключи учетных записей хранения, задав AZURITE_ACCOUNTS переменную среды в следующем формате: account1:key1[:key2];account2:key1[:key2];...

Например, используйте пользовательскую учетную запись хранения с одним ключом:

set AZURITE_ACCOUNTS="account1:key1"

export AZURITE_ACCOUNTS="account1:key1"

Замечание

Ключи учетной записи должны быть строкой в кодировке Base64.

Или используйте несколько учетных записей хранения с двумя ключами.

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

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

Azurite обновляет имена и ключи пользовательских учетных записей из переменной среды каждую минуту по умолчанию. С помощью этой функции можно динамически повернуть ключ учетной записи или добавить новые учетные записи хранения без перезапуска Azurite.

Замечание

Учетная запись хранения по умолчанию devstoreaccount1 отключена при настройке пользовательских учетных записей хранения. Если вы хотите продолжить использование devstoreaccount1 после включения пользовательских учетных записей хранения, необходимо добавить его в список пользовательских учетных записей и ключей в переменной AZURITE_ACCOUNTS среды.

Ключи учетной записи должны быть строкой в кодировке Base64.

Использование строк подключения

Самый простой способ подключения к Azurite из приложения — настроить строку подключения в файле конфигурации приложения, который ссылается на ярлык UseDevelopmentStorage=true. Ниже приведен пример строки подключения в файлеapp.config :

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

Строки http-подключения

Следующие строки подключения можно передать в пакеты SDK или средства Azure, такие как Azure CLI 2.0 или обозреватель службы хранилища.

Полная строка подключения:

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;

Чтобы подключиться к определенной службе, можно использовать следующие строки подключения:

Чтобы подключиться только к хранилищу BLOB-объектов, строка подключения :

Строки подключения HTTPS

Полная строка подключения HTTPS:

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;

Чтобы подключиться к определенной службе, можно использовать следующие строки подключения:

Чтобы использовать только службу BLOB-объектов, строка подключения HTTPS:

Если вы использовали dotnet dev-certs для создания самозаверяющего сертификата, используйте следующую строку подключения.

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

Обновите строку подключения при использовании пользовательских учетных записей хранения и ключей.

Дополнительные сведения см. в разделе "Настройка строк подключения службы хранилища Azure".

Подключение с помощью пакетов SDK Azure

Чтобы подключиться к Azurite с помощью пакетов SDK Azure, выполните следующие действия.

Включите проверку подлинности OAuth для Azurite с помощью коммутатора --oauth . Дополнительные сведения см. в разделе конфигурации OAuth.
Включите ПРОТОКОЛ HTTPS с помощью самозаверяющего сертификата с помощью --cert параметров и --key/--pwd параметров. Дополнительные сведения о создании сертификатов см. в статье о настройке сертификата (HTTPS) и настройке HTTPS.

После размещения сертификатов запустите Azurite со следующими параметрами командной строки:

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

Замените и certname-key.pem на имена cert-name.pem файлов сертификатов и ключей. Если вы используете PFX-сертификат, используйте --pwd этот параметр вместо --key параметра.

Для взаимодействия с ресурсами хранилища BLOB-объектов можно создать экземпляр или BlobContainerClientBlobServiceClientBlobClient.

В следующих примерах показано, как авторизовать BlobContainerClient объект с помощью трех различных механизмов авторизации: DefaultAzureCredential, строки подключения и общего ключа. DefaultAzureCredential предоставляет механизм проверки подлинности на основе маркеров носителя и использует цепочку типов учетных данных, используемых для проверки подлинности. После проверки подлинности эти учетные данные предоставляют маркер OAuth в рамках создания экземпляра клиента. Дополнительные сведения см. в справочнике по классу 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==")
  );

Для взаимодействия с ресурсами хранилища очередей можно создать экземпляр или QueueClientQueueServiceClient.

В следующих примерах показано, как создать и авторизовать QueueClient объект с помощью трех различных механизмов авторизации: DefaultAzureCredential, строки подключения и общего ключа. DefaultAzureCredential предоставляет механизм проверки подлинности на основе маркеров носителя и использует цепочку типов учетных данных, используемых для проверки подлинности. После проверки подлинности эти учетные данные предоставляют маркер OAuth в рамках создания экземпляра клиента. Дополнительные сведения см. в справочнике по классу 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==")
  );

Для взаимодействия с ресурсами хранилища таблиц можно создать экземпляр или TableClientTableServiceClient.

В следующих примерах показано, как создать и авторизовать TableClient объект с помощью трех различных механизмов авторизации: DefaultAzureCredential, строки подключения и общего ключа. DefaultAzureCredential предоставляет механизм проверки подлинности на основе маркеров носителя и использует цепочку типов учетных данных, используемых для проверки подлинности. После проверки подлинности эти учетные данные предоставляют маркер OAuth в рамках создания экземпляра клиента. Дополнительные сведения см. в справочнике по классу 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==")
  );

Подключение обозревателя службы хранилища Azure

Обозреватель службы хранилища можно использовать для просмотра данных, хранящихся в Azurite, с помощью протоколов HTTP или HTTPS.

Подключение к Azurite с помощью HTTP

В обозревателе службы хранилища подключитесь к Azurite, выполнив следующие действия.

Щелкните значок "Управление учетными записями"
Выберите "Добавить учетную запись"
Выберите "Подключиться к локальному эмулятору"
Выберите "Далее"
Измените поле отображаемого имени в нужное имя.
Снова нажмите кнопку "Далее"
Выберите "Подключиться"

Подключение к Azurite с помощью HTTPS

По умолчанию обозреватель службы хранилища не открывает конечную точку HTTPS, использующую самозаверяющий сертификат. Если вы используете Azurite с HTTPS, скорее всего, вы используете самозаверяющий сертификат. В обозревателе службы хранилища импортируйте SSL-сертификаты с помощью диалогового окна "Изменить>SSL-сертификаты ->импорт сертификатов".

Импорт сертификата в обозреватель службы хранилища

Найдите сертификат на локальном компьютере.
В обозревателе службы хранилища перейдите к разделу "Изменить>SSL-сертификаты ->импорт сертификатов" и импортируйте сертификат.

Если сертификат не импортирован, вы получите сообщение об ошибке:

unable to verify the first certificate или self signed certificate in chain

Добавление Azurite через строку подключения HTTPS

Выполните следующие действия, чтобы добавить Azurite HTTPS в обозреватель службы хранилища:

Выбор переключателя обозревателя
Выбор "Локальный" и "Присоединено"
Щелкните правой кнопкой мыши учетные записи хранения и выберите "Подключиться к службе хранилища Azure".
Выберите "Использовать строку подключения"
Нажмите кнопку Далее.
Введите значение в поле отображаемого имени .
Введите строку подключения HTTPS из предыдущего раздела этого документа
Выберите "Далее"
Выберите "Подключиться"

Дальнейшие шаги

Настройка строк подключения службы хранилища Azure объясняет, как собрать допустимую строку подключения службы хранилища Azure.
Использование Azurite для запуска автоматических тестов описывает, как создавать автоматические тесты с помощью эмулятора хранилища Azurite.
Используйте эмулятор службы хранилища Azure для разработки и тестирования документов устаревшего эмулятора службы хранилища Azure, который заменен Azurite.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2025-08-26