Rozpocznij pracę z Azure Device Registry dla Azure IoT Hub (podgląd)

Skonfiguruj przestrzeń nazw usługi Azure Device Registry (ADR) z Azure IoT Hub i Device Provisioning Service (DPS). Użyj konfiguracji prowadzonej z nowymi lub istniejącymi instancjami IoT Hub i DPS, albo połącz instancje osobno, aby mieć większą kontrolę. Możesz także włączyć zarządzanie certyfikatami oraz funkcję aktualizacji oprogramowania, jeśli jest to obsługiwane.

Ten artykuł omawia przestrzeń nazw i konfigurację usług, czyli pierwszy etap podłączania urządzenia. Cały proces wygląda następująco:

Schemat czterech etapów: tworzenie i łączenie usług w tym artykule; opcjonalnie konfiguracja certyfikatów; konfiguracja udostępniania; oraz łączenie urządzeń.

  1. Ustaw swoją przestrzeń nazw i powiąż nowe lub istniejące instancje IoT Hub oraz DPS, podążając za tym artykułem.
  2. Jeśli korzystasz z zarządzania certyfikatami, stwórz pośredni urząd certyfikacyjny (CA) i opracuj politykę certyfikatów.
  3. Konfiguruj provisioning w DPS. Jeśli korzystasz z zarządzania certyfikatami, wybierz politykę certyfikatów do provisioningu.
  4. Przygotuj i połącz swoje urządzenie za pomocą ujednoliconych zestawów SDK Azure IoT.

Po ukończeniu którejkolwiek z tych metod konfiguracji wykonaj Następne kroki, aby kontynuować pozostałe etapy.

Important

Integracja Azure Device Registry z Azure IoT Hub jest w podglądzie publicznym i nie jest zalecana dla obciążeń produkcyjnych. Zobacz dodatkowe warunki użytkowania dla wersji zapoznawczych platformy Microsoft Azure, aby zapoznać się z postanowieniami prawnymi dotyczącymi funkcji platformy Azure, które są w wersji beta, wersji zapoznawczej lub w inny sposób nie zostały jeszcze wydane w wersji ogólnodostępnej.

Important

Azure Device Registry, w tym zarządzanie certyfikatami, jest darmowe podczas podglądu. Instancje usługi IoT Hub i Device Provisioning Service (DPS), których używasz z nim, są rozliczane według standardowych stawek. Szczegóły można znaleźć w Azure IoT Hub pricing.

Prerequisites

  • Aktywna subskrypcja platformy Azure. Jeśli nie masz subskrypcji platformy Azure, utwórz bezpłatne konto.
  • Dostawcy zasobów Microsoft.DeviceRegistry i Microsoft.Devices są zarejestrowani w ramach Twojej subskrypcji. Jeśli planujesz korzystać z aktualizacji oprogramowania, również zarejestruj Microsoft.DeviceUpdate. Jeśli sam je rejestrujesz, potrzebujesz uprawnień na poziomie subskrypcji. Aby uzyskać instrukcje, zobacz Rejestrowanie dostawcy zasobów.
  • Istniejąca grupa zasobów lub uprawnienia do jej utworzenia w Twojej subskrypcji.
  • Uprawnienia do tworzenia i konfiguracji przestrzeni nazw Azure Device Registry, instancji IoT Hub, instancji DPS oraz zarządzanych tożsamości w każdej grupie zasobów, której używasz, a także instancje aktualizacji oprogramowania, jeśli włączysz aktualizacje oprogramowania. Na przykład rola Contributor w każdej grupie zasobów przyznaje te uprawnienia do zarządzania zasobami. Rola Właściciela również je przyznaje.
  • Przywilej wykonywania przydziałów ról w ramach docelowego zakresu. Wykonywanie przypisań ról w Azure wymaga uprzywilejowanej roli, takiej jak Owner lub User Access Administrator w odpowiednim zakresie.
  • Obsługiwany region dla Azure Device Registry z IoT Hub. Nowe usługi wykorzystują region przestrzeni nazw.

Warning

Połączenie istniejącej instancji IoT Hub lub DPS z przestrzenią nazw Azure Device Registry jest trwałe i nie można tego odwrócić. Należy potwierdzić ten efekt przy wyborze istniejącego zasobu.

Jak zacząć

Możesz skonfigurować Azure Device Registry na dwa sposoby:

Obie metody konfiguracji łączą instancje DPS i IoT Hub z przestrzenią nazw ADR.

Konfiguracja z przewodnikiem jest dostępna tylko w portalu Azure. Gdy łączysz usługi indywidualnie, możesz użyć portalu Azure lub Azure CLI.

Nowe instancje IoT Hub utworzone za pomocą którejkolwiek z metod konfiguracji portalu mają włączony dostęp do sieci publicznej. Uwierzytelnianie za pomocą kluczy współdzielonego dostępu na poziomie IoT Hub jest wyłączone.

Wykorzystaj istniejące instancje IoT Hub i DPS

Używaj instancji IoT Hub i DPS w regionie przestrzeni nazw i czekaj, aż skończą provisioning, zanim je połączysz.

Włącz zarządzaną tożsamość zarówno na instancji DPS, jak i na każdej instancji IoT Hub przed ich połączeniem. Instrukcje można znaleźć w artykule Włącz zarządzaną tożsamość dla DPS oraz Użyj zarządzanych tożsamości w IoT Hub. Przykłady CLI w tym artykule wykorzystują tożsamości przypisane systemowo.

Instancje IoT Hub muszą mieć również włączony dostęp do sieci publicznej.

Aby wybrać Existing IoT Hub instances, użyj hubów, które nie są już powiązane z przestrzenią nazw lub instancją DPS. Ich profil połączenia musi odpowiadać profilu wybranemu dla przestrzeni nazw.

Aby wybrać istniejące instancje DPS powiązane z IoT Hub, użyj instancji DPS, która nie jest już powiązana z przestrzenią nazw i ma przynajmniej jeden powiązany hub. Instancja DPS i wszystkie powiązane huby muszą znajdować się w wybranej subskrypcji i regionie. Jego huby muszą używać tego samego profilu połączeń, nie mogą należeć do innej przestrzeni nazw i muszą mieścić się w pozostałej pojemności przestrzeni nazw dla hubów.

Powiązane huby określają profil połączenia dla istniejącej konfiguracji DPS.

W portalu otwórz wymagania IoT Hub lub wymagania konfiguracji DPS obok selektora, aby uzyskać szczegóły. Nie można wybrać niedostępnych wpisów.

Użyj konfiguracji z przewodnikiem

Możesz rozpocząć konfigurację z przewodnikiem z dowolnego z tych miejsc w portalu Azure:

  • Wyszukaj Azure Device Registry w portalu Azure. Otwórz stronę usługi, a na karcie Rozpocznij wybierz Rozpocznij.
  • Z istniejącej przestrzeni nazw, na karcie Rozpocznij, wybierz Skonfiguruj w obszarze Skonfiguruj swoje rozwiązanie. Kwalifikują się tylko przestrzenie nazw, które jeszcze wymagają konfiguracji. Aby dodać usługi do przestrzeni nazw, która ma już powiązaną instancję DPS, przypisz usługi pojedynczo.

Zrzut ekranu karty Azure Device Registry „Get started” z akcją „Get started”.

Konfiguracja krok po kroku prowadzi przez cztery kroki: przestrzeń nazw ADR, Łączność, Możliwości oraz Przegląd + tworzenie.

1. Przestrzeń nazw ADR

Na stronie przestrzeni nazw ADR :

  1. Wybierz, czy chcesz utworzyć przestrzeń nazw, czy użyć istniejącej przestrzeni nazw.
  2. Wybierz subskrypcję platformy Azure i grupę zasobów.
  3. Jeśli tworzysz przestrzeń nazw, wpisz nazwę przestrzeni nazw składającą się z 3–60 małych liter, cyfr lub łączników i wybierz region. Konfiguracja używa nazwy do proponowania nazw nowych usług.
  4. Jeśli korzystasz z istniejącej przestrzeni nazw, wybierz ją spośród dostępnych przestrzeni nazw. Jego region określa, gdzie są tworzone instancje DPS i IoT Hub oraz które istniejące instancje możesz wybrać. Przestrzeń nazw musi mieć włączoną tożsamość zarządzaną. Jeśli nie ma przypisanej tożsamości zarządzanej, przed przejściem dalej wykonaj kroki konfiguracji tożsamości na karcie Azure CLI w obszarze Tworzenie lub otwieranie przestrzeni nazw.

Aby korzystać z istniejących instancji DPS lub IoT Hub, wybierz ich subskrypcję i region.

Zrzut ekranu z kroku przestrzeni nazw ADR z opcjami utworzenia lub używania istniejącej przestrzeni oraz polami dla subskrypcji, grupy zasobów, nazwy przestrzeni nazw i regionu.

2. Łączność

Na stronie Łączność wybierz sposób połączenia urządzeń. W zależności od Twojego wyboru, Azure używa lub tworzy instancję DPS oraz jedną lub więcej instancji IoT Hub.

Wybierz jedną z tych ścieżek:

  • Utwórz nowe instancje DPS i IoT Hub: Wybierz profil połączenia i preset floty. Azure tworzy jedną instancję IoT Hub oraz instancję DPS.
  • Wykorzystaj istniejące instancje IoT Hub: Wybierz istniejący DPS powiązany z instancjami IoT Hub, aby użyć istniejącego zestawu DPS, lub istniejące instancje IoT Hub, aby wybrać huby i utworzyć nową instancję DPS.

Konfiguracja prowadzona umożliwia przypisanie systemowej tożsamości zarządzanej dla każdej nowej przestrzeni nazw ADR, instancji DPS oraz instancji IoT Hub. Aby utworzyć tożsamość przypisaną przez użytkownika dla nowej instancji DPS lub IoT Hub, użyj zaawansowanych ustawień tej instancji.

Setup przypisuje role Azure potrzebne do połączenia przestrzeni nazw, instancji DPS oraz instancji IoT Hub.

Jeśli korzystasz z istniejących instancji IoT Hub lub DPS, przed ich wybraniem zapoznaj się z wymaganiami dotyczącymi istniejących instancji IoT Hub i DPS i spełnij je.

Gdy tworzysz instancje IoT Hub lub używasz istniejących instancji IoT Hub, które nie są powiązane z DPS, wybierz profil połączenia Classic dla MQTT 3.1.1, AMQP lub HTTPS albo profil połączenia MQTT v5 (podgląd) dla MQTT 5. W istniejącym zestawie DPS profil połączenia określają powiązane huby. Profil połączenia MQTT v5 (podgląd ) jest dostępny tylko w obsługiwanych regionach i nie obsługuje zarządzania certyfikatami ani aktualizacji oprogramowania.

Każdy preset tworzy jedną instancję IoT Hub o następującej domyślnej pojemności. Możesz skonfigurować go przed kontynuacją i później dodać kolejne huby.

Preset Klasyczny profil połączenia Profil połączenia MQTT v5 (podgląd)
Mała, połączona flota S1, 1 jednostka 1 jednostka
Rosnąca flota S2, 2 sztuki 10 jednostek
Flota wielkoskalowa S3, 3 jednostki 25 jednostek

Zrzut ekranu z etapu łączności z nowymi instancjami DPS i IoT Hub, profilem połączenia Classic oraz trzema presetami floty.

Możesz wybrać do 10 instancji IoT Hub. Łączenie istniejących instancji IoT Hub i DPS jest trwałe.

3. Możliwości

Na stronie Capabilities wybierz, które możliwości chcesz włączyć. Azure konfiguruje wymagane zasoby na podstawie Twojego wyboru.

  • Zarządzanie certyfikatami jest domyślnie wybierane dla obsługiwanych hubów. Tworzy root CA wydany przez Microsoft lub korzysta z istniejącego root CA w przestrzeni nazw. Utworzenie pośredniej CA i polityki certyfikatów to osobny etap.
  • Aktualizacja oprogramowania (podgląd) jest opcjonalna. Azure tworzy instancję aktualizacji z domyślną konfiguracją. Wybierz ikonę edycji na karcie, aby zmienić ustawienia przed kontynuacją. Ta opcja jest niedostępna, jeśli wybrany hub ma już skonfigurowaną Azure Device Update.

Note

Konfiguracja funkcji aktualizacji oprogramowania może zająć nawet do 30 minut.

W profilu połączenia MQTT v5 (podgląd) obie funkcje są niedostępne.

Zrzut ekranu z kroku Możliwości z wybranym zarządzaniem certyfikatem i aktualizacją oprogramowania.

4. Przegląd i stwórz

Na stronie Przegląd + utwórz zapoznaj się z podsumowaniem wpływu, szczegółami przestrzeni nazw, konfiguracją łączności oraz włączonymi możliwościami przed przesłaniem:

  • Podsumowanie wpływu zawiera listę usług dodanych do subskrypcji i grupy zasobów.
  • Sprawdź przestrzeń nazw, istniejące instancje DPS i IoT Hub, które wybrałeś, instancje do utworzenia oraz wybrane możliwości. Wróć do odpowiedniego kroku, aby zmienić wybór lub konfigurację.
  • Ostrzeżenie informuje, że połączenie tych usług jest nieodwracalnym działaniem, które może powodować przestoje istniejących usług zarządzania.

Przejrzyj szacunkowe koszty pokazane podczas konfiguracji. Dostępność i ilość zależą od wybranych zasobów i informacji cenowych.

Prześlij konfigurację i śledź postępy wdrożenia w portalu Azure. Jeśli konfiguracja lub wdrożenie się nie powiedzie, sprawdź szczegóły błędu przed kolejną próbą.

Po pomyślnym wdrożeniu otwórz przestrzeń nazw ADR i wybierz Linked services. Przed kontynuacją potwierdzij, że instancja DPS i wybrane przez Ciebie IoT Hub są powiązane.

Kontynuuj, korzystając z kolejnych kroków, aby przygotować i podłączyć swoje pierwsze urządzenie.

Połącz usługi osobno

Użyj tej ścieżki, aby wybierać zasoby indywidualnie lub dodawać usługi do istniejącej przestrzeni nazw. Najpierw połącz instancję DPS, potem jedną lub więcej instancji IoT Hub. Ustaw root CA, jeśli chcesz zarządzać certyfikatami, i opcjonalnie połącz instancję aktualizacji oprogramowania.

Instrukcja CLI tworzy instancję S1 IoT Hub z profilem połączenia Classic i używa systemowo przypisanych zarządzanych tożsamości. Ten profil obsługuje opcjonalne kroki zarządzania certyfikatami i aktualizacji oprogramowania.

Note

Dla profilu połączenia MQTT v5 (podgląd) użyj konfiguracji prowadzonej lub opcji portalu Azure w sekcji Connect an IoT Hub instance. Stwórz nowy hub lub wybierz istniejące huby z tym profilem; wszystkie huby w przestrzeni nazw muszą używać tego samego profilu. Po podlinkowaniu przejdź do Verify linked resources. Kroki dotyczące głównego urzędu certyfikacji i aktualizacji oprogramowania dotyczą profilu połączenia Classic.

Przykłady wykorzystują jedną grupę zasobów. Jeśli używasz istniejących instancji DPS lub IoT Hub w innych grupach zasobów, użyj grupy zasobów każdej instancji w poleceniu wyszukiwania oraz grupy zasobów przestrzeni nazw w poleceniach link.

Konfiguracja interfejsu wiersza polecenia Azure

Jeśli korzystasz z kart CLI, zainstaluj Azure CLI i wybierz jedną wersję rozszerzenia azure-iot.

Użyj wersji 1.1.0b1 podglądowej, aby wykonać wszystkie kroki, w tym opcjonalne funkcje podglądowe. Rozszerzenie podglądowe obsługuje zarówno funkcje ogólnie dostępne, jak i podglądowe:

az login
az extension add --name azure-iot --version 1.1.0b1 --allow-preview true --upgrade

Jeśli korzystasz tylko z ogólnie dostępnych funkcji, zainstaluj wersję 1.0.0 stabilną:

az login
az extension add --name azure-iot --version 1.0.0 --upgrade

Potwierdź zainstalowaną wersję:

az extension show --name azure-iot --query version -o tsv

Łączenie może zająć kilka minut, podczas gdy uprawnienia do tożsamości zarządzanej się propagują. Pozwól, by każde polecenie się dokończyło, zanim przejdziesz dalej.

1. Utworzenie lub otwarcie przestrzeni nazw

Stwórz przestrzeń nazw Azure Device Registry lub otwórz istniejącą przestrzeń nazw. Przestrzeń nazw to granica organizacyjna i flotowa dla urządzeń w Twoim rozwiązaniu. Gdy tworzysz przestrzeń nazw, portal automatycznie włącza przypisaną do niej systemowo tożsamość zarządzaną.

Jeśli używasz istniejącej przestrzeni nazw, sprawdź, czy ma ona włączoną tożsamość zarządzaną przed podłączeniem instancji DPS lub instancji IoT Hub. Jeśli przestrzeń nazw nie posiada zarządzanej tożsamości, wybierz zakładkę Azure CLI w tej sekcji i postępuj zgodnie z krokami konfiguracji tożsamości.

Otwórz przestrzeń nazw i wybierz zakładkę Linked services. Użyj Connect, aby najpierw dodać instancję DPS. Poczekaj, aż łączenie się zakończy, zanim podłączysz instancje IoT Hub.

Zrzut ekranu menu Linked services Connect z IoT Hub niedostępnym przed powiązaniem instancji DPS.

2. Podłącz instancję Device Provisioning Service

Jeśli używasz istniejącej instancji DPS, postępuj zgodnie z wymaganiami dotyczącymi istniejących instancji IoT Hub i DPS przed podłączeniem jej.

Wybierz Connect>Device Provisioning Service (DPS) i wybierz sposób połączenia instancji DPS:

  • Użyj istniejącego: Wybierz instancję DPS, która nie jest jeszcze powiązana z przestrzenią nazw ADR. Powiązane instancje IoT Hub są uwzględnione.
  • Utwórz nowy: Wybierz subskrypcję i grupę zasobów oraz wpisz nazwę. Portal tworzy instancję DPS w regionie przestrzeni nazw z tożsamością zarządzaną przypisaną przez system. Aby utworzyć tożsamość przypisaną przez użytkownika, rozwiń Zaawansowane.

Wybierz Zapisz i poczekaj, aż portal zakończy łączenie instancji DPS, zanim połączysz kolejne instancje IoT Hub.

3. Podłącz instancję IoT Hub

Jeśli korzystasz z istniejących instancji IoT Hub, postępuj zgodnie z wymaganiami istniejących instancji IoT Hub i DPS przed ich połączeniem.

Wybierz Connect>, a następnie przejrzyj profil połączenia. Wybierz Classic lub MQTT v5 (podgląd), jeśli profil nie jest już ustawiony przez powiązany IoT Hub lub instancje aktualizacji oprogramowania w danym obszarze nazw. Wszystkie instancje IoT Hub, które dodasz, muszą odpowiadać temu profilowi.

Wybierz sposób połączenia instancji IoT Hub:

  • Użyj istniejących: Wybierz instancje IoT Hub do połączenia.
  • Stwórz nowe: Wybierz subskrypcję i grupę zasobów oraz skonfiguruj nazwę i pojemność instancji IoT Hub. Portal tworzy instancję IoT Hub w regionie przestrzeni nazw z przypisaną przez system tożsamością zarządzaną. Aby zamiast tego utworzyć tożsamość przypisaną przez użytkownika, rozwiń sekcję Zaawansowane.

Gdy łączysz istniejące instancje IoT Hub, pamiętaj, że połączenie ich z przestrzenią nazw jest trwałe.

Wybierz Zapisz i poczekaj na zakończenie linkowania. Następnie zweryfikuj powiązane instancje DPS i IoT Hub.

4. Utworzenie głównego urzędu certyfikacyjnego (opcjonalnie)

Aby dopasować konfigurację prowadzoną do wybranego zarządzania certyfikatami, stwórz główny urząd certyfikacji wydany przez Microsoft. Pomiń tworzenie, jeśli przestrzeń nazw już ją ma. Zarządzanie certyfikatami nie jest obsługiwane dla profilu połączenia MQTT v5 (podgląd ).

  1. W przestrzeni nazw, w sekcji Bezpieczeństwo, wybierz Urzędy certyfikacji.
  2. Wybierz Utwórz>root certificate authority.
  3. Wpisz nazwę składającą się z 3-63 liter, cyfr lub łączników, zaczynając od litery lub cyfry, i wybierz Create.
  4. Poczekaj, aż provisioning się zakończy, i potwierdź, że główny urząd certyfikacji jest widoczny.

Aby wydawać certyfikaty urządzeń, nadal potrzebujesz pośredniego CA i polityki certyfikatów. Kontynuuj konfigurację zarządzanego głównego i pośredniego urzędu CA po połączeniu usług.

5. Podłącz instancję aktualizacji oprogramowania (opcjonalnie)

Note

Konfiguracja funkcji aktualizacji oprogramowania może zająć nawet do 30 minut.

Funkcja aktualizacji oprogramowania nie jest obsługiwana dla profilu połączenia MQTT v5 (podgląd ). Jeśli hub ma już skonfigurowaną usługę Azure Device Update, usuń tę konfigurację przed skonfigurowaniem aktualizacji oprogramowania dla przestrzeni nazw.

Wybierz Connect>Software Update (podgląd) i skonfiguruj nową instancję aktualizacji. Jego subskrypcja, grupa zasobów i region są zgodne z przestrzenią nazw.

Wybierz Zapisz.

6. Weryfikacja powiązanych zasobów

Na karcie Linked services przestrzeni nazw potwierdź, że zasoby mają stan KondycjaDostępny oraz stan PołączeniePołączono. Jeśli włączyłeś zarządzanie certyfikatami, potwierdź też, że główny urząd certyfikacji zakończył aprowizację w obszarze Security>Certificate authorities.

Zrzut ekranu usług Połączone pokazujący instancję aktualizacji oprogramowania, IoT Hub oraz DPS z dostępnym stanem kondycji i statusem Połączone.

Kontynuuj, wybierając Kolejne kroki, aby przygotować i podłączyć swoje pierwsze urządzenie.

Nazewnictwo zasobów

Konfiguracja prowadzona sugeruje nazwy zasobów oparte na nazwie przestrzeni nazw. Możesz zmienić proponowane nazwy przed ich przesłaniem.

Na przykład, jeśli nazwa przestrzeni nazw to contoso-devices, konfiguracja prowadzona sugeruje następujące nazwy:

Resource Proponowany wzór nazwy Example
przestrzeń nazw usługi Azure Device Registry <namespace-name> contoso-devices
Instancja IoT Hub <namespace-name>-hub-<number> contoso-devices-hub-1
Usługa Przygotowania Urządzeń <namespace-name>-provisioning contoso-devices-provisioning
Główny urząd certyfikacyjny <namespace-name>-root-ca contoso-devices-root-ca
Instancja aktualizacji oprogramowania <namespace-name>-su contoso-devices-su

Zarządzaj powiązanymi zasobami

Łączenie usług z przestrzenią nazw nie zastępuje ich indywidualnych sposobów zarządzania. Aby zmienić ustawienia instancji IoT Hub, otwórz ją w portalu Azure. Aby zmienić ustawienia DPS, otwórz instancję DPS w portalu Azure.

Następne kroki

Twoja przestrzeń nazw i wybrane usługi są skonfigurowane. Jeśli włączyłeś zarządzanie certyfikatami, postępuj zgodnie z tymi krokami po kolei. Urządzenie korzysta z oddzielnych poświadczeń wdrożeniowych i operacyjnych.

  1. Utwórz pośredni urząd certyfikacji (CA), który korzysta z istniejącego głównego urzędu certyfikacji (CA) twojej przestrzeni nazw, a następnie utwórz zasady certyfikatów.
  2. Konfiguruj provisioning w DPS w instancji już powiązanej z twoją przestrzenią nazw. Utwórz indywidualną grupę rejestracji lub rejestracji dla poświadczenia onboardingowego, którego urządzenie będzie używać.
  3. Wybierz swój pośredni urząd certyfikacji i zasady certyfikatów na potrzeby aprowizacji.
  4. Użyj zunifikowanych SDK Azure IoT, aby wysłać żądanie podpisu certyfikatu podczas provisioningu DPS i połączyć się z przydzielonym IoT Hub z wydanym certyfikatem.

Inne ścieżki połączeń

  • Dla profilu połączenia Classic spróbuj przeprowadzić aprowizację bez zarządzanego wydawania certyfikatów, postępując zgodnie z Aprowizowanie symulowanego urządzenia z kluczem symetrycznym. Użyj DPS i hubów, które tu podlinkowałeś, zamiast powtarzać wymagania dotyczące konfiguracji usług.
  • W przypadku profilu połączenia MQTT v5 (podgląd) przed wyborem klienta urządzenia zapoznaj się z dokumentacją SDK i przykładami dotyczącymi obsługi protokołu specyficznej dla wersji.