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.
Usługa Azure IoT Hub udostępnia różne punkty końcowe do obsługi urządzeń i usług, które z nią współdziałają.
Uwaga
Niektóre funkcje wymienione w tym artykule, takie jak komunikacja z chmury do urządzenia, bliźniaki cyfrowe urządzeń i zarządzanie urządzeniami, są dostępne tylko w warstwie Standard usługi IoT Hub. Aby uzyskać więcej informacji na temat warstw podstawowej i standardowej/bezpłatnej usługi IoT Hub, zobacz Wybieranie odpowiedniej warstwy i rozmiaru usługi IoT Hub dla rozwiązania.
Nazwy usługi IoT Hub
Nazwę hosta centrum IoT Hub można znaleźć w witrynie Azure Portal w okienku Przegląd centrum IoT Hub. Domyślnie nazwa DNS centrum IoT Wygląda jak w poniższym przykładzie:
{your iot hub name}.azure-devices.net
Punkty końcowe obsługujące TLS 1.3
Azure IoT Hub udostępnia dodatkowe punkty końcowe do obsługi protokołu TLS 1.3 z rozszerzonymi wymaganiami dotyczącymi zabezpieczeń. Dla hubów z klasycznym profilem połączenia te punkty końcowe są dostępne obok istniejącego punktu końcowego, aby umożliwić stopniowe i niezakłócające wdrażanie.
Nie planuje się zmian w istniejącym punkcie końcowym usługi IoT Hub (<hub>.azure-devices.net), powszechnie określanym jako klasyczny punkt końcowy. Ten punkt końcowy pozostaje w pełni obsługiwany, w tym w przypadku scenariuszy Private Link i nadal jest domyślny dla istniejących obciążeń.
Nowe punkty końcowe są dodawane, a nie zastępowane i umożliwiają klientom wdrażanie silniejszych konfiguracji zabezpieczeń we własnym tempie.
Typy punktów końcowych
| Typ punktu końcowego | Hostname | Obsługa protokołów |
|---|---|---|
| Classic | <hub>.azure-devices.net |
TLS 1.2 (istniejące zachowanie) |
| Punkt końcowy urządzenia | <hub>.device.azure-devices.net |
TLS 1.2 (ograniczony) + TLS 1.3 |
| Punkt końcowy usługi | <hub>.service.azure-devices.net |
TLS 1.2 (ograniczony) + TLS 1.3 |
Profile połączeń i wybór punktów końcowych
Profil połączenia opisuje konfigurację łączności huba. Punkt końcowy to nazwa hosta, z którą łączy się urządzenie lub aplikacja usługowa. Zmiana nazwy hosta nie zmienia profilu połączenia ani nie włącza MQTT v5.
- Klasyczny profil połączenia: Klasyczny punkt końcowy oraz punkty końcowe urządzeń i usług obsługujące TLS 1.3 są zazwyczaj dostępne. Klasyczny profil połączenia nie jest ograniczony do klasycznego punktu końcowego.
- Profil połączenia MQTT v5: Urządzenia i punkty końcowe obsługujące TLS 1.3 są w podglądzie. Komunikaty na urządzeniu używają MQTT v5, a nie MQTT v3.1.1, AMQP ani HTTPS. Dostępność TLS 1.3 dla hubów klasycznego profilu nie zmienia statusu podglądu MQTT v5.
Użyj przypisanego punktu końcowego urządzenia dla połączeń urządzeń oraz punktu końcowego usługi dla aplikacji zaplecza. Dla urządzenia provisionowanego użyj punktu końcowego zwracanego przez Device Provisioning Service (DPS), zamiast tworzyć nazwę hosta.
Podczas pobierania service parametry połączenia za pomocą podglądowego interfejsu CLI wybierz --hostname-type service; service parametry połączenia nie jest poświadczeniem rejestracyjnym urządzenia.
Połączenia urządzeń MQTT v5 wymagają uwierzytelniania X.509. Informacje na temat poświadczeń do dołączania, wystawiania i odnawiania certyfikatów za pośrednictwem DPS oraz rozwiązywania problemów z urządzeniami znajdziesz w artykule Skonfiguruj urządzenie.
Kluczowe zagadnienia
- Istniejące aplikacje i urządzenia korzystające z klasycznego punktu końcowego działają bez żadnych zmian.
- Nowe punkty końcowe obsługują protokół TLS 1.3 i ulepszone wymagania dotyczące zabezpieczeń.
- Oba modele punktów końcowych współistnieją, aby obsługiwać stopniowe migracje bez przerw w działaniu usługi.
- Obsługa TLS 1.3 nie oznacza, że TLS 1.3 jest wymagane dla każdego połączenia. Klient i punkt końcowy negocjują wersję protokołu TLS oraz obsługiwany przez obie strony zestaw szyfrów. Wersje TLS i wersje protokołu komunikacyjnego urządzenia są niezależne.
- Punkty końcowe urządzeń i usług wymagają Wskazywania Nazwy Serwera (SNI). Szczegóły pakietów szyfrów i protokołów znajdziesz w obsłudze IoT Hub TLS.
Punkty końcowe usługi IoT Hub na potrzeby programowania i zarządzania
Azure IoT Hub to wielodostępna usługa, która uwidacznia jej funkcjonalność dla różnych podmiotów. Na poniższym diagramie przedstawiono różne punkty końcowe udostępniane przez usługę IoT Hub.
Poniższa lista zawiera opis punktów końcowych:
Uwaga
Protokoły urządzeń i operacje wysyłania wiadomości wymienione w tej sekcji opisują klasyczny profil połączenia. Wsparcie i ograniczenia MQTT v5 znajdziesz w sekcji możliwości MQTT v5.
Dostawca zasobów: interfejs usługi Azure Resource Manager. Ten interfejs umożliwia właścicielom subskrypcji platformy Azure tworzenie i usuwanie centrów IoT oraz aktualizowanie właściwości centrum IoT Hub. Właściwości usługi IoT Hub zarządzają zasadami dostępu współdzielonego na poziomie centrum, w przeciwieństwie do kontroli dostępu na poziomie urządzenia oraz opcjami funkcjonalnymi obsługi komunikatów z chmury do urządzeń i urządzeń do chmury. Dostawca zasobów usługi IoT Hub umożliwia również eksportowanie tożsamości urządzeń.
Zarządzanie tożsamością urządzenia: zestaw punktów końcowych HTTPS REST do zarządzania tożsamościami urządzeń (tworzenie, pobieranie, aktualizacja i usuwanie). Tożsamości urządzeń są używane do uwierzytelniania urządzeń i kontroli dostępu.
Zarządzanie bliźniakami urządzeń: zestaw punktów końcowych HTTPS REST przeznaczonych do wysyłania zapytań i aktualizowania bliźniaków urządzeń (aktualizowanie tagów i właściwości).
Zarządzanie zadaniami: zestaw punktów końcowych HTTPS REST służących do wykonywania zapytań i zarządzania zadaniami.
Punkty końcowe urządzeń: zestaw punktów końcowych dla każdego urządzenia w rejestrze tożsamości. O ile nie wskazano inaczej, te punkty końcowe są udostępniane przy użyciu protokołów MQTT w wersji 3.1.1, HTTPS 1.1 i AMQP 1.0. Protokół AMQP i MQTT jest również dostępny za pośrednictwem WebSockets na porcie 443. Te punkty końcowe urządzeń obejmują:
Wysyłanie komunikatów z urządzenia do chmury
Odbieranie komunikatów z chmury do urządzenia
Inicjowanie przekazywania plików
Pobieranie i aktualizowanie bliźniaczych właściwości urządzenia (protokół HTTPS nie jest obsługiwany)
Odbieranie żądań metod bezpośrednich (protokół HTTPS nie jest obsługiwany)
Punkty końcowe usługi: zestaw punktów końcowych umożliwiających zapleczu rozwiązania komunikację z urządzeniami. Z jednym wyjątkiem te punkty końcowe są widoczne tylko przy użyciu protokołów AMQP i AMQP za pośrednictwem protokołów WebSocket. Punkt końcowy wywołania metody bezpośredniej jest uwidaczniony za pośrednictwem protokołu HTTPS.
Odbieranie wiadomości z urządzenia do chmury: ten punkt końcowy jest wbudowanym punktem końcowym omówionym w koncepcjach routingu wiadomości. Usługa zaplecza może jej używać do odczytywania komunikatów urządzenie-do-chmury wysyłanych przez urządzenia. Oprócz tego wbudowanego punktu końcowego można tworzyć niestandardowe punkty końcowe w centrum IoT Hub.
Wysyłanie komunikatów z chmury do urządzenia i odbieranie potwierdzenia dostarczenia
Otrzymuj powiadomienia o przesyłaniu plików
Wywoływanie metody bezpośredniej
W artykule Zestawy SDK usługi Azure IoT Hub opisano różne sposoby uzyskiwania dostępu do tych punktów końcowych.
Wszystkie punkty końcowe usługi IoT Hub używają protokołu TLS , a żaden punkt końcowy nigdy nie jest uwidaczniany w niezaszyfrowanych lub niezabezpieczonych kanałach.
Niestandardowe punkty końcowe na potrzeby routingu komunikatów
Istniejące usługi platformy Azure w subskrypcjach platformy Azure można połączyć z centrum IoT Hub, aby działać jako punkty końcowe na potrzeby routingu komunikatów. Te punkty końcowe działają jako punkty końcowe usługi i są używane jako ujścia tras komunikatów. Urządzenia nie mogą zapisywać bezpośrednio do tych punktów końcowych. Aby uzyskać więcej informacji na temat routingu komunikatów, zobacz Używanie routingu komunikatów usługi IoT Hub w celu wysyłania komunikatów z urządzenia do chmury do różnych punktów końcowych.
Usługa IoT Hub obsługuje następujące usługi platformy Azure jako niestandardowe punkty końcowe:
- Kontenery magazynu
- Centra zdarzeń
- Kolejki „Service Bus”
- Tematy usługi Service Bus
- Cosmos DB
- Microsoft Fabric Eventstreams
Aby uzyskać limity dotyczące punktów końcowych na koncentrator, zobacz Limity przydziału i ograniczanie przepustowości.
Wbudowany punkt końcowy
Wbudowany punkt końcowy i trasowanie zapasowe nie są dostępne dla profilu połączenia MQTT v5. Skonfiguruj wyraźną trasę do obsługiwanego miejsca docelowego; zobacz Różnice w profilach połączeń routingu.
Można używać standardowej integracji usługi Event Hubs oraz zestawów SDK do odbioru komunikatów z urządzenia do chmury z wbudowanego punktu końcowego (messages/events). Po utworzeniu dowolnej trasy dane przestaną przepływać do wbudowanego punktu końcowego, chyba że zostanie utworzona trasa do tego punktu końcowego. Nawet jeśli nie utworzysz żadnych tras, musisz włączyć trasę rezerwową w celu kierowania komunikatów do wbudowanego punktu końcowego. Mechanizm przełączania awaryjnego jest domyślnie włączony, jeśli tworzysz swoje centrum przy użyciu portalu lub interfejsu wiersza polecenia.
Ładunek komunikatu nie jest zakodowany w formacie base64 we wbudowanym punkcie końcowym.
Usługa Azure Storage jako punkt końcowy routingu
Usługa IoT Hub może kierować komunikaty do dwóch usług magazynu: Azure Blob Storage i Azure Data Lake Storage Gen2 (ADLS Gen2). Obie te usługi używają blobów do przechowywania. Aby korzystać z Azure Data Lake Gen2, konto przechowywania musi mieć włączone hierarchiczne przestrzenie nazw. Aby uzyskać więcej informacji, sprawdź Tworzenie konta magazynu do użycia z usługą Azure Data Lake Storage.
Usługa IoT Hub obsługuje zapisywanie danych w usłudze Azure Storage w formacie Apache Avro i formacie JSON. Domyślny format jest Avro. Aby użyć kodowania JSON, ustaw contentType właściwość na application/json i contentEncoding właściwość na UTF-8 we właściwościach systemu komunikatów. Obie te wartości są traktowane jako nieczułe na wielkość liter.
Jeśli nie ustawisz niezbędnych właściwości systemowych, usługa IoT Hub stosuje kodowanie base64. Aby uniknąć kodowania base64, ustaw zarówno contentType właściwość na application/json , jak i contentEncoding właściwość na UTF-8 we właściwościach systemu komunikatów. Jeśli te właściwości nie są ustawione, usługa IoT Hub zapisuje komunikaty w formacie zakodowanym w formacie base64.
Format kodowania można ustawić tylko podczas konfigurowania punktu końcowego magazynu obiektów blob. Nie można edytować formatu kodowania dla istniejącego punktu końcowego.
Usługa IoT Hub grupuje komunikaty i zapisuje dane w magazynie za każdym razem, gdy partia osiągnie określony rozmiar lub upłynie określony czas. Usługa IoT Hub domyślnie określa następującą konwencję nazewnictwa plików: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}.
Możesz użyć dowolnej konwencji nazewnictwa plików, ale musisz użyć wszystkich wymienionych tokenów. Usługa IoT Hub zapisuje w pustym obiekcie blob, jeśli nie ma do zapisania żadnych danych.
Aby upewnić się, że wszystkie obiekty blob lub pliki są odczytywane bez wprowadzania żadnych założeń dotyczących partycji, wyświetl listę obiektów blob lub plików, a następnie przechodź przez nie kolejno. Zakres partycji może potencjalnie ulec zmianie podczas awaryjnego przełączenia zainicjowanego przez firmę Microsoft lub ręcznego przełączenia IoT Hub. Możesz użyć List Blobs API do wyliczenia listy obiektów blob lub List ADLS Gen2 API dla listy plików. Na przykład:
public void ListBlobsInContainer(string containerName, string iothub)
{
var storageAccount = CloudStorageAccount(Microsoft.Azure.Storage.Auth.StorageCredentials storageCredentials, bool useHttps);
var cloudBlobContainer = storageAccount.CreateCloudBlobClient().GetContainerReference(containerName);
if (cloudBlobContainer.Exists())
{
var results = cloudBlobContainer.ListBlobs(prefix: $"{iothub}/");
foreach (IListBlobItem item in results)
{
Console.WriteLine(item.Uri);
}
}
}
Kolejki usługi Service Bus i tematy usługi Service Bus jako punkt końcowy routingu
Kolejki i tematy usługi Service Bus używane jako punkty końcowe usługi IoT Hub nie mogą mieć włączonych sesji czy wykrywania duplikatów. Jeśli włączysz jedną z tych opcji, punkt końcowy będzie wyświetlany jako Niemożliwy do osiągnięcia w witrynie Azure Portal.
Kodowanie Base64 nigdy nie występuje podczas routingu do kolejek lub tematów usługi Service Bus. Komunikaty są zapisywane w niezmienionej formie do punktu końcowego.
Usługa Event Hubs jako punkt końcowy routingu
Oprócz wbudowanego punktu końcowego zgodnego z usługą Event Hubs można również kierować dane do niestandardowych punktów końcowych typu Event Hubs.
Kodowanie Base64 nigdy nie występuje podczas routingu do niestandardowych punktów końcowych usługi Event Hubs. Komunikaty są zapisywane w niezmienionej formie do punktu końcowego.
Usługa Azure Cosmos DB jako punkt końcowy routingu
Dane można wysyłać bezpośrednio do usługi Azure Cosmos DB z usługi IoT Hub. Usługa IoT Hub obsługuje zapisywanie w usłudze Cosmos DB w formacie JSON (jeśli określono w typie zawartości komunikatu) lub jako plik binarny zakodowany w formacie base64.
Kodowanie Base64 jest stosowane, jeśli wymagane właściwości systemu nie są ustawione. Aby zapisać w formacie JSON, ustaw właściwość contentType na application/json oraz właściwość contentEncoding na UTF-8 we właściwościach systemu komunikatów. Jeśli te właściwości nie są ustawione, dane są zakodowane w formacie base64 podczas zapisywania w usłudze Cosmos DB.
Aby obsługiwać scenariusze o dużej skali, możesz włączyć syntetyczne klucze partycji dla punktu końcowego Cosmos DB. Ponieważ usługa Cosmos DB jest magazynem danych w hiperskali, wszystkie dane/dokumenty zapisywane w nim muszą zawierać pole reprezentujące partycję logiczną. Każda partycja logiczna ma maksymalny rozmiar 20 GB. Nazwę właściwości klucza partycji można określić w polu Nazwa klucza partycji. Nazwa właściwości klucza partycji jest definiowana na poziomie kontenera i nie można jej zaktualizować.
Możesz skonfigurować syntetyczną wartość klucza partycji, określając szablon w szablonie Klucza partycji na podstawie szacowanego woluminu danych. Na przykład w scenariuszach produkcyjnych partycja logiczna może zbliżać się do maksymalnego limitu 20 GB w ciągu miesiąca. W takim przypadku można zdefiniować syntetyczny klucz partycji jako kombinację identyfikatora urządzenia i miesiąca. Wygenerowana wartość klucza partycji jest automatycznie dodawana do właściwości klucza partycji dla każdego nowego rekordu usługi Cosmos DB, zapewniając, że partycje logiczne są tworzone co miesiąc dla każdego urządzenia.
Uwaga
Jeśli używasz przypisanej przez system tożsamości zarządzanej do uwierzytelniania w usłudze Cosmos DB, musisz użyć interfejsu wiersza polecenia platformy Azure lub programu Azure PowerShell, aby przypisać wbudowaną definicję roli współautora danych usługi Cosmos DB do tożsamości. Przypisanie roli dla usługi Cosmos DB nie jest obecnie obsługiwane w witrynie Azure Portal. Aby uzyskać więcej informacji na temat różnych ról, zobacz Konfigurowanie dostępu opartego na rolach dla usługi Azure Cosmos DB. Aby zrozumieć przypisywanie ról za pomocą interfejsu wiersza polecenia, zobacz Zarządzanie zasobami roli SQL usługi Azure Cosmos DB.
Microsoft Fabric Eventstreams jako punkt końcowy routingu
Możesz kierować wiadomości z urządzenia do chmury do strumienia zdarzeń Microsoft Fabric, dodając dedykowany punkt końcowy Fabric Eventstream do swojego IoT Hub. Ta integracja przenosi IoT Hub telemetrię bezpośrednio do Fabric Real-Time Intelligence do dalszego przetwarzania i analityki.
Uwaga
Punkt końcowy routingu Microsoft Fabric Eventstream jest ogólnie dostępny. Obsługuje profile połączenia classic i MQTT v5. Sam profil MQTT v5 pozostaje w podglądzie; dostępność punktów końcowych nie zmienia tego statusu.
Aby kierować wiadomości do strumienia zdarzeń Fabric, utwórz trasę w IoT Hub, dodaj punkt końcowy Fabric Eventstream i połącz go z strumieniem zdarzeń Fabric, który korzysta z niestandardowego źródła końcowego (niestandardowej aplikacji).
W swoim obszarze roboczym Microsoft Fabric wybierz niestandardowy kafelek źródłowy punktu końcowego, do którego chcesz się połączyć w opublikowanym Eventstream. Jeśli kafelek źródła niestandardowego punktu końcowego nie istnieje w Eventstream, utwórz nowy kafelek źródła niestandardowego punktu końcowego. Po wybraniu kafelka źródłowego przejdź do panelu Szczegóły . W polu Protokół wybierz Event Hub. Wybierz Entra ID Authentication i przejdź do szczegółów połączenia. Aby upewnić się, że uwierzytelnianie Entra ID jest poprawnie skonfigurowane dla Twojej przestrzeni roboczej Fabric, zobacz Połącz się ze strumieniem zdarzeń za pomocą uwierzytelniania Microsoft Entra ID.
Uwierzytelnianie
Endpoint Fabric Eventstream obsługuje wyłącznie uwierzytelnianie Microsoft Entra ID. Uwierzytelnianie klucza za pomocą podpisu współdzielonego dostępu (SAS) nie jest obsługiwane. Możesz użyć zarówno tożsamości zarządzanej przypisanej przez system, jak i przez użytkownika, dla IoT Hub. Więcej informacji można znaleźć w artykule Łączność egress z IoT Hub do innych zasobów Azure.
Schemat komunikatu
Wiadomości kierowane do punktu końcowego Fabric Eventstream są dostarczane w trybie binarnej zawartości CloudEvents 1.0 przez AMQP, który różni się od schematu używanego przez inne punkty końcowe routingu, takie jak Event Hubs. Tożsamość urządzenia i metadane zdarzeń są zachowane w kopercie CloudEvents. W hubach IoT korzystających z Azure Device Registry (ADR), ładunek zdarzeń zawiera identyfikatory ADR. Dla porównania z domyślnym schematem routowanych wiadomości, zobacz schemat wiadomości na punktach końcowych routingu.
Po tej zmianie pola metadanych użytkownika nadal są obecne w komunikacie, ale nie będą widoczne, chyba że przed dostarczeniem danych do celu w strumieniu zdarzeń Fabric zostanie dodana transformacja SQL.
SELECT ,
GETMETADATAPROPERTYVALUE(
[<Add name of stream input>],
'[User]'
) AS UserProperties
INTO [<Add name of stream output>]
FROM [<Add name of stream input>];
Ogólnie dostępny status punktu końcowego jest oddzielny od ustawień podglądu schema-reference i message-payload-format. Ich odrębne role i weryfikację konsumentów opisano w Przygotowanie telemetrii dla agentów i analityki.
Ograniczenia dotyczące właściwości wzbogacania
Nazwy właściwości wzbogacania wiadomości dla punktów końcowych Fabric Eventstream mają następujące ograniczenia:
- Nazwy muszą zaczynać się od małej litery.
- Nazwy mogą zawierać tylko małe litery i cyfry.
- Nie wolno używać łączników, podkreślników, kropek i camelCase.
- Nazwy mogą mieć maksymalnie 20 znaków.
Tooling
Możesz utworzyć i skonfigurować endpoint Fabric Eventstream, korzystając z Azure CLI i Bicep.
Uwaga
Jak zacząć korzystać z Fabric? Wykorzystaj Azure IoT Solution Accelerator Workload for Microsoft Fabric Real-Time Intelligence jako przewodnik Szybki start pokazujący, jak dane urządzeń Azure IoT mogą być przekształcane w analitykę w czasie rzeczywistym, monitorowanie operacyjne, zautomatyzowane działania oraz wglądy oparte na sztucznej inteligencji dzięki wykorzystaniu Fabric Real-Time Intelligence.
Kondycja punktu końcowego
Aby uzyskać stan kondycji punktów końcowych, możesz użyć interfejsu API REST Get Endpoint Health . Zalecamy użycie metryk routingu IoT Hub związanych z opóźnieniem wiadomości w celu zidentyfikowania i rozwiązywania problemów, gdy punkt końcowy jest martwy lub niezdrowy, ponieważ spodziewamy się większego opóźnienia, gdy punkt końcowy znajduje się w jednym z tych stanów. Aby dowiedzieć się więcej na temat korzystania z metryk usługi IoT Hub, zobacz Monitorowanie usługi IoT Hub.
| Stan kondycji | Opis |
|---|---|
| w dobrej kondycji | Punkt końcowy akceptuje komunikaty zgodnie z oczekiwaniami. |
| w złej kondycji | Punkt końcowy nie akceptuje komunikatów, a usługa IoT Hub ponowi próbę wysłania komunikatów do tego punktu końcowego. |
| nieznany | Usługa IoT Hub nie próbowała dostarczać komunikatów do tego punktu końcowego. |
| Zdegradowany | Punkt końcowy akceptuje komunikaty wolniej niż oczekiwano lub dochodzi do siebie po awarii. |
| martwy | Usługa IoT Hub nie dostarcza już komunikatów do tego punktu końcowego. Ponowne próby wysyłania komunikatów do tego punktu końcowego nie powiodły się. |
Następne kroki
Dowiedz się więcej o tych tematach: