Udostępnij za pośrednictwem


ProvisioningDeviceClient Klasa

Klient, który może służyć do uruchamiania rejestracji urządzenia z usługą aprowizacji przy użyciu klucza symetrycznego lub uwierzytelniania X509.

Inicjuje klienta aprowizacji.

UWAGA: Ten inicjator nie powinien być wywoływany bezpośrednio. Zamiast tego metody klasy rozpoczynające się od create_from_ należy użyć do utworzenia obiektu klienta.

Dziedziczenie
azure.iot.device.provisioning.abstract_provisioning_device_client.AbstractProvisioningDeviceClient
ProvisioningDeviceClient

Konstruktor

ProvisioningDeviceClient(pipeline)

Parametry

Nazwa Opis
pipeline
Wymagane
<xref:azure.iot.device.provisioning.pipeline.MQTTPipeline>

Wystąpienie obiektu potoku aprowizacji.

Metody

create_from_symmetric_key

Utwórz klienta, który może służyć do uruchamiania rejestracji urządzenia z usługą aprowizacji przy użyciu uwierzytelniania klucza symetrycznego.

create_from_x509_certificate

Utwórz klienta, który może służyć do uruchamiania rejestracji urządzenia z usługą aprowizacji przy użyciu uwierzytelniania certyfikatu X509.

register

Zarejestruj urządzenie w usłudze aprowizacji.

Przed zwróceniem klienta odłączy się również od usługi aprowizacji. Jeśli próba rejestracji zostanie podjęta, gdy poprzednia rejestracja jest w toku, może zgłosić błąd.

Po pomyślnym zarejestrowaniu urządzenia klient nie będzie już działać.

create_from_symmetric_key

Utwórz klienta, który może służyć do uruchamiania rejestracji urządzenia z usługą aprowizacji przy użyciu uwierzytelniania klucza symetrycznego.

create_from_symmetric_key(provisioning_host, registration_id, id_scope, symmetric_key, **kwargs)

Parametry

Nazwa Opis
provisioning_host
Wymagane
str

Host z uruchomioną usługą Device Provisioning Service. Można go znaleźć w Azure Portal na karcie Przegląd jako ciąg Globalny punkt końcowy urządzenia.

registration_id
Wymagane
str

Identyfikator rejestracji używany do unikatowego identyfikowania urządzenia w usłudze Device Provisioning Service. Identyfikator rejestracji to alfanumeryczne, małe litery ciąg i może zawierać łączniki.

id_scope
Wymagane
str

Zakres identyfikatorów używany do unikatowego identyfikowania określonej usługi aprowizacji, za pomocą którego urządzenie zostanie zarejestrowane. Zakres identyfikatora jest przypisywany do usługi Device Provisioning Service po jej utworzeniu przez użytkownika i jest generowany przez usługę i jest niezmienny, co gwarantuje unikatowość.

symmetric_key
Wymagane
str

Klucz, który zostanie użyty do utworzenia tokenu sygnatury dostępu współdzielonego w celu uwierzytelnienia urządzenia w usłudze Device Provisioning Service. Domyślnie usługa Device Provisioning Service tworzy nowe klucze symetryczne o domyślnej długości 32 bajtów po zapisaniu nowych rejestracji z włączoną opcją Automatyczne generowanie kluczy. Użytkownicy mogą udostępniać własne klucze symetryczne dla rejestracji, wyłączając tę opcję w ciągu 16 bajtów i 64 bajtów oraz w prawidłowym formacie Base64.

server_verification_cert
Wymagane
str

Opcja konfiguracji. Łańcuch zaufanych certyfikatów. Konieczne w przypadku nawiązywania połączenia z punktem końcowym, który ma niestandardowy katalog główny zaufania, taki jak brama protokołu.

gateway_hostname
Wymagane
str

Opcja konfiguracji. Nazwa hosta bramy dla urządzenia bramy.

websockets
Wymagane

Opcja konfiguracji. Wartość domyślna to False. Ustaw wartość true w przypadku używania protokołu MQTT za pośrednictwem obiektów websocket.

cipher
Wymagane
str lub list(str)

Opcja konfiguracji. Zestawy szyfrowania dla protokołu TLS/SSL jako ciąg w formacie "Format listy szyfrowania OpenSSL" lub jako lista ciągów zestawu szyfrowania.

proxy_options
Wymagane

Opcje wysyłania ruchu przez serwery proxy.

keepalive
Wymagane
int

Maksymalny okres w sekundach między komunikacją z brokerem. Jeśli żadne inne komunikaty nie są wymieniane, steruje to szybkością wysyłania komunikatów ping do brokera. Jeśli wartość domyślna nie zostanie podana, zostanie użyta wartość 60 s.

Zwraca

Typ Opis

Wystąpienie ProvisioningDeviceClient, które można zarejestrować za pomocą klucza symetrycznego.

Wyjątki

Typ Opis
TypeError if given an unrecognized parameter.

create_from_x509_certificate

Utwórz klienta, który może służyć do uruchamiania rejestracji urządzenia z usługą aprowizacji przy użyciu uwierzytelniania certyfikatu X509.

create_from_x509_certificate(provisioning_host, registration_id, id_scope, x509, **kwargs)

Parametry

Nazwa Opis
provisioning_host
Wymagane
str

Host z uruchomioną usługą Device Provisioning Service. Można go znaleźć w Azure Portal na karcie Przegląd jako ciąg Globalny punkt końcowy urządzenia.

registration_id
Wymagane
str

Identyfikator rejestracji używany do unikatowego identyfikowania urządzenia w usłudze Device Provisioning Service. Identyfikator rejestracji to alfanumeryczne, małe litery ciąg i może zawierać łączniki.

id_scope
Wymagane
str

Zakres identyfikatora służy do unikatowego identyfikowania określonej usługi aprowizacji, za pomocą którego urządzenie zostanie zarejestrowane. Zakres identyfikatora jest przypisywany do usługi Device Provisioning Service po jej utworzeniu przez użytkownika i jest generowany przez usługę i jest niezmienny, co gwarantuje unikatowość.

x509
Wymagane

Certyfikat x509, aby użyć certyfikatu, obiekt rejestracji musi zawierać certyfikat (certyfikat główny lub jeden z certyfikatów pośredniego urzędu certyfikacji). Jeśli certyfikat pochodzi z pliku CER, musi być zakodowany w formacie Base64.

server_verification_cert
Wymagane
str

Opcja konfiguracji. Łańcuch zaufanych certyfikatów. Konieczne w przypadku nawiązywania połączenia z punktem końcowym, który ma niestandardowy katalog główny zaufania, taki jak brama protokołu.

gateway_hostname
Wymagane
str

Opcja konfiguracji. Nazwa hosta bramy dla urządzenia bramy.

websockets
Wymagane

Opcja konfiguracji. Wartość domyślna to False. Ustaw wartość true w przypadku używania protokołu MQTT za pośrednictwem obiektów websocket.

cipher
Wymagane
str lub list(str)

Opcja konfiguracji. Zestawy szyfrowania dla protokołu TLS/SSL jako ciąg w formacie "Format listy szyfrowania OpenSSL" lub jako lista ciągów zestawu szyfrowania.

proxy_options
Wymagane

Opcje wysyłania ruchu przez serwery proxy.

keepalive
Wymagane
int

Maksymalny okres w sekundach między komunikacją z brokerem. Jeśli żadne inne komunikaty nie są wymieniane, steruje to szybkością wysyłania komunikatów ping do brokera. Jeśli wartość domyślna nie zostanie podana, zostanie użyta wartość 60 s.

Zwraca

Typ Opis

Element ProvisioningDeviceClient, który może rejestrować się za pośrednictwem certyfikatów klienta X509.

Wyjątki

Typ Opis
TypeError if given an unrecognized parameter.

register

Zarejestruj urządzenie w usłudze aprowizacji.

Przed zwróceniem klienta odłączy się również od usługi aprowizacji. Jeśli próba rejestracji zostanie podjęta, gdy poprzednia rejestracja jest w toku, może zgłosić błąd.

Po pomyślnym zarejestrowaniu urządzenia klient nie będzie już działać.

async register()

Zwraca

Typ Opis

RegistrationResult wskazujący wynik rejestracji.

Wyjątki

Typ Opis

jeśli poświadczenia są nieprawidłowe i nie można ustanowić połączenia.

jeśli nawiązanie połączenia spowoduje niepowodzenie.

jeśli połączenie zostanie utracone podczas wykonywania.

jeśli podczas wykonywania wystąpi nieoczekiwany błąd.

Atrybuty

provisioning_payload