Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Utwórz tożsamość urządzenia, aby połączyć się z usługą Azure IoT Hub. W tym artykule przedstawiono kluczowe zadania zarządzania tożsamością urządzenia, w tym rejestrowanie urządzenia, zbieranie informacji o połączeniu, a następnie usuwanie lub wyłączanie urządzenia na końcu jego cyklu życia.
Wymagania wstępne
Centrum IoT w ramach subskrypcji platformy Azure. Jeśli nie masz jeszcze centrum, możesz wykonać kroki opisane w temacie Tworzenie centrum IoT Hub.
W zależności od używanego narzędzia uzyskaj dostęp do portalu Azure lub zainstaluj interfejs wiersza polecenia platformy Azure (Azure CLI).
Jeśli centrum IoT jest zarządzane za pomocą kontroli dostępu opartej na rolach (RBAC), musisz mieć uprawnienia odczyt/zapis/usuwanie urządzenia/modułu , aby wykonać kroki opisane w tym artykule. Te uprawnienia są uwzględniane w roli Współautor rejestru usługi IoT Hub .
Przygotowywanie certyfikatów
Urządzenia używają dwóch różnych typów certyfikatów do nawiązywania połączenia z usługą IoT Hub. Podczas przygotowywania urządzenia przed nawiązaniem połączenia upewnij się, że masz wszystkie odpowiednie certyfikaty utworzone i dodane do urządzenia.
- Publiczne certyfikaty główne: wszystkie urządzenia muszą mieć kopię publicznych certyfikatów głównych używanych przez usługę IoT Hub, IoT Central i Device Provisioning Service do autoryzowania połączeń.
- Certyfikaty uwierzytelniania: certyfikaty X.509 są zalecaną metodą uwierzytelniania tożsamości urządzenia.
Wymagane publiczne certyfikaty główne
Urządzenia usługi Azure IoT używają protokołu TLS do weryfikowania autentyczności punktu końcowego usługi IoT Hub lub DPS, z którymi się łączą. Każde urządzenie wymaga kopii certyfikatu głównego używanego przez usługę IoT Hub i usługę DPS. Zalecamy, aby wszystkie urządzenia zawierały następujące główne urzędy certyfikacji w ich zaufanym magazynie certyfikatów:
- Globalny urząd certyfikacji G2 firmy DigiCert
- Główny urząd certyfikacji RSA firmy Microsoft 2017
pl-PL: Aby uzyskać więcej informacji na temat zalecanych praktyk dotyczących certyfikatów usługi IoT Hub, zobacz Obsługa protokołu TLS (Transport Layer Security) w usłudze IoT Hub.
Certyfikaty uwierzytelniania
Jeśli używasz uwierzytelniania certyfikatu X.509 dla urządzeń, upewnij się, że certyfikaty są gotowe przed zarejestrowaniem urządzenia:
W przypadku certyfikatów podpisanych przez urząd certyfikacji samouczek Tworzenie i przekazywanie certyfikatów na potrzeby testowania zawiera dobre wprowadzenie do tworzenia certyfikatów podpisanych przez urząd certyfikacji i przekazywania ich do usługi IoT Hub. Po ukończeniu tego samouczka możesz zarejestrować urządzenie przy użyciu uwierzytelniania za pomocą certyfikatu podpisanego przez urząd certyfikacji X.509.
W przypadku certyfikatów samopodpisanych na urządzeniu potrzebne są dwa certyfikaty urządzenia (certyfikat podstawowy i certyfikat pomocniczy) oraz odciski palca obu certyfikatów, aby przekazać je do usługi IoT Hub. Jednym ze sposobów pobrania odcisku palca z certyfikatu jest następujące polecenie OpenSSL:
openssl x509 -in <certificate filename>.pem -text -fingerprint
Rejestrowanie urządzenia
W tej części utworzysz tożsamość urządzenia w rejestrze tożsamości w centrum IoT. Urządzenie nie może nawiązać połączenia z centrum, chyba że ma tożsamość urządzenia.
Rejestr tożsamości usługi IoT Hub przechowuje tożsamości urządzenia tylko po to, aby umożliwić bezpieczny dostęp do centrum IoT. Przechowuje identyfikatory urządzeń i klucze, które będą używane jako poświadczenia zabezpieczeń, oraz flagę włączone/wyłączone, która umożliwia wyłączenie dostępu do poszczególnych urządzeń.
Podczas rejestrowania urządzenia należy wybrać jego metodę uwierzytelniania. Usługa IoT Hub obsługuje trzy metody uwierzytelniania urządzeń:
Klucz symetryczny - Ta opcja jest najłatwiejsza w scenariuszach szybkiego uruchamiania.
Podczas rejestrowania urządzenia możesz podać klucze lub usługa IoT Hub generuje klucze. Zarówno urządzenie, jak i centrum IoT mają kopię klucza symetrycznego, który można porównać podczas nawiązywania połączenia z urządzeniem.
Podpis własny X.509
Jeśli urządzenie ma certyfikat X.509 z podpisem własnym, musisz nadać usłudze IoT Hub wersję certyfikatu na potrzeby uwierzytelniania. Podczas rejestrowania urządzenia przesyłasz odcisk certyfikatu, który jest skrótem certyfikatu X.509 tego urządzenia. Po nawiązaniu połączenia urządzenie prezentuje certyfikat, a centrum IoT może zweryfikować go względem skrótu, który zna. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie tożsamości przy użyciu certyfikatów X.509.
Podpisane przez urząd certyfikacji X.509 - Ta opcja jest zalecana w środowiskach produkcyjnych.
Jeśli urządzenie ma certyfikat X.509 podpisany przez urząd certyfikacji (CA), przed zarejestrowaniem urządzenia należy przekazać do usługi IoT Hub certyfikat głównego lub pośredniego urzędu certyfikacji z łańcucha podpisywania. Urządzenie ma certyfikat X.509 ze zweryfikowanym urzędem certyfikacji X.509 w swoim łańcuchu zaufania certyfikatów. Po nawiązaniu połączenia urządzenie prezentuje pełny łańcuch certyfikatów, a centrum IoT może go zweryfikować, ponieważ zna urząd certyfikacji X.509. Wiele urządzeń może uwierzytelniać się za pomocą tego samego zweryfikowanego urzędu certyfikacji X.509. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie tożsamości przy użyciu certyfikatów X.509.
Dodawanie urządzenia
Utworzenie tożsamości urządzenia w centrum IoT.
W portalu Azure portal przejdź do centrum IoT.
Wybierz pozycję Zarządzanie urządzeniami>Urządzenia.
Wybierz pozycję Dodaj urządzenie , aby dodać urządzenie w centrum IoT Hub.
W obszarze Tworzenie urządzenia podaj informacje dotyczące nowej tożsamości urządzenia:
Parametr Parametr zależny Wartość Identyfikator urządzenia Podaj nazwę nowego urządzenia. Authentication type (Typ uwierzytelniania) Wybierz opcję Klucz symetryczny, Certyfikat X.509 z podpisem własnym lub Certyfikat X.509 podpisany przez urząd certyfikacji (CA). Automatyczne generowanie kluczy W przypadku uwierzytelniania klucza symetrycznego zaznacz to pole wyboru, aby usługa IoT Hub wygenerowała klucze dla urządzenia. Możesz też usunąć zaznaczenie tego pola i podać klucze podstawowe i pomocnicze dla urządzenia. Podstawowy odcisk palca i pomocniczy odcisk palca W przypadku uwierzytelniania X.509 z podpisem własnym podaj wartość skrótu odcisku głównego i pomocniczego certyfikatu urządzenia. Ważne
Identyfikator urządzenia może być widoczny w dziennikach zbieranych na potrzeby obsługi klienta i rozwiązywania problemów, dlatego upewnij się, żeby unikać poufnych informacji podczas nadawania mu nazwy.
Wybierz pozycję Zapisz. Po utworzeniu urządzenia otwiera się jego strona z szczegółami.
W przypadku urządzeń z kluczem symetrycznym można skopiować informacje o połączeniu z tej strony do natychmiastowego wykorzystania w próbkach i scenariuszach testowych. Przechowuj klucze i łańcuchy połączeń bezpiecznie.
Note
Domyślna lista urządzeń wyświetla do 15 urządzeń, a nie cały inwentarz urządzeń. Aby znaleźć inne urządzenie, wyszukaj według identyfikatora urządzenia, zastosuj filtr lub użyj Zapytań w sekcji Zarządzanie urządzeniami. Wyniki wyszukiwania, filtrowania i zapytań są ostatecznie spójne, więc nowo utworzone urządzenie może nie pojawić się od razu. Brak wyniku nie oznacza koniecznie, że rejestracja się nie powiodła.
Aby sprawdzić rejestrację znanego identyfikatora urządzenia, użyj opcji Pobierz tożsamość. Nowo utworzone tożsamości mogą również potrzebować kilku sekund, zanim staną się dostępne w bezpośrednim odczycie. Więcej informacji można znaleźć w artykule Operacje rejestru tożsamości oraz ograniczenia zapytań bliźniaków.
Pobieranie parametrów połączenia urządzenia
W przypadku przykładów i scenariuszy testowych najczęstszą metodą połączenia jest użycie uwierzytelniania za pomocą klucza symetrycznego i połączenie przy użyciu parametrów połączenia urządzenia. Parametry połączenia urządzenia zawierają nazwę centrum IoT, nazwę urządzenia oraz informacje uwierzytelniające urządzenia.
Aby uzyskać informacje o innych metodach łączenia urządzeń, szczególnie w przypadku uwierzytelniania X.509, zapoznaj się z zestawami SDK urządzeń usługi Azure IoT Hub.
Wykonaj poniższe kroki, aby pobrać parametry połączenia urządzenia.
Witryna Azure Portal udostępnia parametry połączenia urządzeń tylko dla urządzeń korzystających z uwierzytelniania klucza symetrycznego.
W portalu Azure portal przejdź do centrum IoT.
Wybierz pozycję Zarządzanie urządzeniami>Urządzenia.
Znajdź swoje urządzenie w panelu Urządzenia i wybierz jego identyfikator urządzenia. Jeśli nie jest wyświetlany, wpisz jego identyfikator urządzenia w polu wyszukiwania.
Domyślna lista nie jest kompletnym inwentarzem, a wyniki wyszukiwania mogą opóźniać ostatnie zmiany. Aby uzyskać więcej informacji na temat znajdowania urządzeń i wyświetlania ich bliźniaczych reprezentacji, zobacz Wyświetlanie i aktualizowanie bliźniaczych reprezentacji urządzeń.
Skopiuj wartość podstawowych parametrów połączenia.
Domyślnie klucze i parametry połączenia są maskowane, ponieważ są to informacje poufne. Jeśli wybierzesz ikonę oka, zostaną one ujawnione. Nie trzeba ich wyświetlać, aby skopiować je przyciskiem kopiowania.
Urządzenia z uwierzytelnianiem przy użyciu klucza symetrycznego mają parametry połączenia urządzenia w następującym formacie:
HostName=<IOT_HUB_NAME>;DeviceId=<DEVICE_NAME>;SharedAccessKey=<PRIMARY_OR_SECONDARY_KEY>
Urządzenia korzystające z uwierzytelniania X.509, czy to samopodpisanego, czy podpisanego przez urząd certyfikacji, zwykle nie używają do uwierzytelniania ciągów połączenia urządzenia. Gdy to nastąpi, ich parametry połączenia mają następujący format:
HostName=<IOT_HUB_NAME>;DeviceId=<DEVICE_NAME>;x509=true
Wyłączanie lub usuwanie urządzenia
Jeśli chcesz zachować urządzenie w rejestrze tożsamości centrum IoT Hub, ale chcesz uniemożliwić mu nawiązanie połączenia, możesz zmienić jego stan na wyłączony.
W portalu Azure portal przejdź do centrum IoT.
Wybierz pozycję Zarządzanie urządzeniami>Urządzenia.
Znajdź swoje urządzenie w panelu Urządzenia i wybierz jego identyfikator urządzenia. Jeśli nie jest wyświetlany, wpisz jego identyfikator urządzenia w polu wyszukiwania.
Domyślna lista nie jest kompletnym inwentarzem, a wyniki wyszukiwania mogą opóźniać ostatnie zmiany. Więcej informacji o wyszukiwaniu urządzeń i przeglądaniu ich bliźniaków można znaleźć w sekcji Zobacz i aktualizuj bliźniaki urządzeń.
Na stronie szczegółów urządzenia można wyłączyć lub usunąć rejestrację urządzenia.
Aby uniemożliwić nawiązywanie połączenia z urządzeniem, ustaw parametr Włącz połączenie z usługą IoT Hub na wartość Wyłącz.
Aby całkowicie usunąć urządzenie z rejestru tożsamości centrum IoT Hub, wybierz pozycję Usuń.
Inne narzędzia do zarządzania tożsamościami urządzeń
Do zarządzania rejestrem tożsamości usługi IoT Hub można użyć innych narzędzi lub interfejsów, w tym:
Polecenia programu PowerShell: zapoznaj się z zestawem poleceń Az.IotHub , aby dowiedzieć się, jak zarządzać tożsamościami urządzeń.
Visual Studio Code: rozszerzenie usługi Azure IoT Hub dla programu Visual Studio Code obejmuje funkcje rejestru tożsamości.
Interfejs API REST: zapoznaj się z interfejsami API usługi IoT Hub, aby dowiedzieć się, jak zarządzać tożsamościami urządzeń.