Создание удостоверений устройств и управление ими

Создайте удостоверение устройства для подключения к Центр Интернета вещей Azure. В этой статье приводятся основные задачи по управлению удостоверением устройства, включая регистрацию устройства, сбор сведений о подключении, а затем удаление или отключение устройства в конце жизненного цикла.

Необходимые компоненты

• Центр Интернета вещей в подписке Azure. Если у вас еще нет центра, выполните действия, описанные в разделе Создание центра Интернета вещей.

• В зависимости от того, какое средство вы используете, имеете доступ к портал Azure или установите Azure CLI.

• Если центр Интернета вещей управляется с помощью управления доступом на основе ролей (RBAC), вам потребуется разрешение на чтение, запись и удаление устройства или модуля для действий, описанных в этой статье. Эти разрешения включены в роль участника реестра Центр Интернета вещей.

Регистрация устройства

В этом разделе описано, как создать удостоверение устройства в реестре удостоверений в Центре Интернета вещей. Устройство не может подключиться к концентратору, если он не имеет удостоверения устройства.

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

При регистрации устройства вы выбираете его метод проверки подлинности. Центр Интернета вещей поддерживает три метода проверки подлинности устройства:

• Симметричный ключ - Этот параметр проще всего подходит для сценариев быстрого запуска.

  При регистрации устройства можно указать ключи или Центр Интернета вещей создаст ключи для вас. Устройство и Центр Интернета вещей имеют копию симметричного ключа, который можно сравнить при подключении устройства.

• Самозаверяющий X.509

  Если у устройства есть самозаверяющий сертификат X.509, необходимо предоставить Центр Интернета вещей версию сертификата для проверки подлинности. При регистрации устройства вы отправляете отпечаток сертификата, который является хэшом сертификата X.509 устройства. Когда устройство подключается, он представляет свой сертификат, а Центр Интернета вещей может проверить его в соответствии с хэшом, который он знает. Дополнительные сведения см. в разделе "Проверка подлинности удостоверений с помощью сертификатов X.509".

• ЦС X.509, подписанный - этим параметром, рекомендуется для рабочих сценариев.

  Если у устройства есть сертификат ЦС, подписанный ЦС X.509, перед регистрацией устройства вы отправляете корневой или промежуточный сертификат центра сертификации (ЦС) в цепочку подписывания, чтобы Центр Интернета вещей перед регистрацией устройства. Устройство имеет сертификат X.509 с проверенным ЦС X.509 в цепочке сертификатов доверия. Когда устройство подключается, оно представляет полную цепочку сертификатов, а Центр Интернета вещей может проверить его, так как он знает ЦС X.509. Несколько устройств могут проходить проверку подлинности в одном проверенной ЦС X.509. Дополнительные сведения см. в разделе "Проверка подлинности удостоверений с помощью сертификатов X.509".

Подготовка сертификатов

Если вы используете любой из методов проверки подлинности сертификата X.509, убедитесь, что сертификаты готовы перед регистрацией устройства:

• Для сертификатов, подписанных ЦС, руководство по созданию и отправке сертификатов для тестирования предоставляет хорошее введение в создание подписанных ЦС сертификатов и их отправку в Центр Интернета вещей. После выполнения этого руководства вы можете зарегистрировать устройство с подписанным ЦС X.509.

• Для самозаверяющего сертификата необходимо два сертификата устройства (первичный и вторичный сертификат) на устройстве и отпечатки для отправки в Центр Интернета вещей. Одним из способов получения отпечатка из сертификата является следующая команда OpenSSL:

  openssl x509 -in <certificate filename>.pem -text -fingerprint
  

Добавить устройство

Создание удостоверения устройства в центре IoT.

Портал Azure

1. Найдите нужный Центр Интернета вещей на портале Azure.

2. Выберите устройства управления устройствами>.

3. Выберите " Добавить устройство", чтобы добавить устройство в Центр Интернета вещей.

   

4. В разделе "Создание устройства" укажите сведения для нового удостоверения устройства:

   Параметр	Зависимый параметр	Значение
   Идентификатор устройства		Укажите имя нового устройства.
   Тип проверки подлинности		Выберите симметричный ключ, самозаверяющий X.509 или подписанный ЦС X.509.
   	Автоматическое создание ключей	Для проверки подлинности симметричного ключа установите этот флажок, чтобы Центр Интернета вещей создавать ключи для устройства. Также снимите этот флажок и укажите первичные и вторичные ключи для устройства.
   	Первичный отпечаток и вторичный отпечаток	Для самозаверяющей проверки подлинности X.509 укажите хэш отпечатка из первичных и вторичных сертификатов устройства.

   Внимание

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

5. Выберите Сохранить.

Azure CLI

Используйте команду az iot hub device-identity create для регистрации устройства.

В следующей таблице описываются общие параметры, используемые с этой командой.

Параметр	Зависимый параметр	Значение
--device-id, -d		Укажите имя нового устройства.
--hub-name, -h		Имя центра Интернета вещей или имя узла.
--auth-method, --am		Либо shared_private_key, x509_caлибо x509_thumbprint
	--primary-key, --pk и --secondary-key, --sk	Используйте проверку подлинности, shared_private_key если вы хотите предоставить первичные и вторичные ключи для устройства. Опустить, если вы хотите, чтобы Центр Интернета вещей создать ключи.
	--primary-thumbprint, --ptp и --secondary-thumbprint, --stp	Используйте проверку подлинности для x509_thumbprint предоставления отпечатков первичного и дополнительного сертификатов для устройства. Опустить, если вы хотите, чтобы Центр Интернета вещей создать самозаверяющий сертификат и использовать его отпечаток.

Внимание

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

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

Для примеров и тестов наиболее распространенный метод подключения — использовать проверку подлинности симметричного ключа и подключаться к устройству строка подключения. Устройство строка подключения содержит имя Центра Интернета вещей, имя устройства и сведения о проверке подлинности устройства.

Сведения о других методах подключения устройств, особенно для проверки подлинности X.509, см. в Центр Интернета вещей Azure пакетах SDK для устройств.

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

Портал Azure

Портал Azure предоставляет строка подключения устройства только для устройств, использующих проверку подлинности симметричного ключа.

1. Найдите нужный Центр Интернета вещей на портале Azure.

2. Выберите устройства управления устройствами>.

3. Выберите устройство в списке на панели "Устройства ".

4. Скопируйте значение первичного строка подключения.

   

   По умолчанию ключи и строка подключения маскируются, так как они являются конфиденциальными. Если щелкнуть значок глаза, они будут отображаться. Чтобы скопировать их с помощью кнопки копирования, отображать их необязательно.

Azure CLI

Используйте команду az iot hub device-identity-identity-string show, чтобы получить строка подключения устройства. Например:

az iot hub device-identity connection-string show --device-id <DEVICE_NAME> --hub-name <IOT_HUB_NAME>

Устройства с проверкой подлинности с симметричным ключом имеют строка подключения устройства со следующим шаблоном:

HostName=<IOT_HUB_NAME>;DeviceId=<DEVICE_NAME>;SharedAccessKey=<PRIMARY_OR_SECONDARY_KEY>

Устройства с проверкой подлинности X.509, самозаверяющий или ЦС, обычно не используют устройства строка подключения для проверки подлинности. Когда они делают, их строка подключения принимают следующий шаблон:

HostName=<IOT_HUB_NAME>;DeviceId=<DEVICE_NAME>;x509=true

Отключение или удаление устройства

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

Портал Azure

1. Найдите нужный Центр Интернета вещей на портале Azure.

2. Выберите устройства управления устройствами>.

3. Выберите устройство в списке на панели "Устройства ".

4. На странице сведений об устройстве можно отключить или удалить регистрацию устройства.

   • Чтобы предотвратить подключение устройства, установите для параметра Enable connection значение Центр Интернета вещей значение Disable.

     

   • Чтобы полностью удалить устройство из реестра удостоверений Центра Интернета вещей, нажмите кнопку "Удалить".

     

Azure CLI

Чтобы отключить устройство, используйте команду az iot hub device-identity update и измените status устройство. Например:

az iot hub device-identity update --device-id <DEVICE_NAME> --hub-name <IOT_HUB_NAME> --set status=disabled

Чтобы удалить устройство, используйте команду az iot hub device-identity delete . Например:

az iot hub device-identity delete --device-id <DEVICE_NAME> --hub-name <IOT_HUB_NAME>

Другие средства для управления удостоверениями устройств

Вы можете использовать другие средства или интерфейсы для управления реестром удостоверений Центр Интернета вещей, в том числе:

• Команды PowerShell. Ознакомьтесь с командой Az.IotHub , чтобы узнать, как управлять удостоверениями устройств.

• Visual Studio Code: расширение Центр Интернета вещей Azure для Visual Studio Code включает возможности реестра удостоверений.

• REST API: ознакомьтесь с API-интерфейсами службы Центр Интернета вещей, чтобы узнать, как управлять удостоверениями устройств.