Partilhar via


SDKs Microsoft para o Serviço de Provisionamento de Dispositivos Hub IoT

Os SDKs da Microsoft para Hub IoT Device Provisioning Service (DPS) ajudam-no a construir aplicações de dispositivos e backend que fornecem dispositivos IoT a um ou mais hubs IoT. Os SDKs tratam do transporte subjacente e protocolos de segurança entre os seus dispositivos ou aplicações backend e DPS, libertando-o para se concentrar no desenvolvimento de aplicações. Ao usar os SDKs, obtém suporte para futuras atualizações do DPS, incluindo atualizações de segurança. Este artigo descreve as três categorias de SDKs, lista os SDKs DPS publicados em linguagens populares e fornece links para referências SDK, exemplos e quickstarts.

Importante

A gestão de certificados em Hub IoT está em prévia e é suportada apenas nos seguintes SDKs de Dispositivos DPS: C embutido (bare metal, Free RTOS), C e Python. Os SDKs do Hub IoT não o suportam. Para mais informações, consulte O que é a Gestão de Certificados?

Categorias SDK

Três categorias de kits de desenvolvimento de software (SDKs) funcionam com o DPS:

  • Os SDKs de dispositivo DPS fornecem operações de plano de dados para dispositivos. Usa o SDK do dispositivo para provisionar um dispositivo através do DPS.

  • Os SDKs de serviço DPS fornecem operações de plano de dados para aplicativos de back-end. Use os SDKs de serviço para criar e gerir inscrições individuais e grupos de inscrição, bem como para consultar e gerir registos de dispositivos.

  • Os SDKs de gerenciamento DPS fornecem operações de plano de controle para aplicativos de back-end. Use os SDKs de gestão para criar e gerir instâncias e metadados de DPS. Por exemplo, use-as para criar e gerir instâncias DPS na sua subscrição, para carregar e verificar certificados com uma instância DPS, ou para criar e gerir políticas de autorização ou alocação numa instância DPS.

Os SDKs do DPS ajudam a provisionar dispositivos para seus hubs IoT. A Microsoft também disponibiliza um conjunto de SDKs para ajudar a construir aplicações de dispositivo e aplicações backend que comunicam diretamente com o Hub IoT do Azure. Por exemplo, para ajudar seus dispositivos provisionados a enviar telemetria para seu hub IoT e, opcionalmente, para receber mensagens e atualizações de trabalho, método ou gêmeas do seu hub IoT. Para saber mais, consulte Hub IoT do Azure SDKs.

SDKs de dispositivo

Os SDKs dos dispositivos DPS permitem que os seus dispositivos se registrem com o DPS e recebam a atribuição do hub IoT. Use os SDKs do dispositivo para implementar o provisionamento do lado do dispositivo com chave simétrica, certificado X.509 ou atestação TPM. SDKs de dispositivos de plataforma estão disponíveis para dispositivos que executam um sistema operativo completo, e SDKs de dispositivos embutidos estão disponíveis para dispositivos com recursos limitados e baseados em microcontroladores.

SDKs de dispositivos de plataforma

Os SDKs de dispositivo DPS fornecem implementações da API de registro e outras que os dispositivos chamam para provisionar por meio do DPS. Os SDKs de dispositivo podem ser executados em dispositivos de computação baseados em MPU em geral, como um PC, tablet, smartphone ou Raspberry Pi. Os SDKs suportam o desenvolvimento em C e em linguagens geridas modernas, incluindo C#, Node.js, Python e Java.

A tabela seguinte lista os SDKs de dispositivos disponíveis para cada linguagem suportada.

Plataforma Pacote Repositório de código Exemplos Início Rápido Referência
.NET NuGet GitHub Samples Início rápido Referência
C apt-get, MBED, Arduino IDE ou iOS GitHub Samples Início rápido Referência
Java Maven GitHub Samples Início rápido Referência
Node.js npm GitHub Samples Início rápido Referência
Python pip GitHub Samples Início rápido Referência

Aviso

O C SDK listado acima não é adequado para aplicativos incorporados devido ao seu modelo de gerenciamento de memória e threading. Para dispositivos incorporados, consulte os SDKs de dispositivo incorporado.

SDKs de dispositivos de gestão de certificados (pré-visualização)

A tabela seguinte lista os SDKs da plataforma que atualmente suportam a gestão de certificados X.509 apoiada pela Microsoft em pré-visualização.

Linguagem Pacote Fonte/Ramo Exemplos
.NET NuGet Azure/azure-iot-sdk-csharp em feature/iot-csr-preview ExemploPedidoDeAssinatura de Certificado
Python pip Azure/azure-iot-sdk-python em feature/iot-csr-preview cert-mgmt samples
Node.js npm Não disponível Não disponível
Java Maven Azure/azure-iot-sdk-java em feature/csr amostra-assinatura de certificados
C pacotes Azure/azure-iot-sdk-c em feature/dps-csr-preview iothub_ll_client_sample_certificate_signing_request

SDKs de dispositivos incorporados

Esses SDKs foram projetados e criados para serem executados em dispositivos com recursos limitados de computação e memória e são implementados usando a linguagem C.

RTOS SDK Origem Exemplos Referência
Eclipse ThreadX Azure RTOS Middleware GitHub Inícios rápidos Referência
FreeRTOS FreeRTOS Middleware GitHub Samples Referência
Metal nu SDK do Azure for Embedded C GitHub Samples Referência

Saiba mais sobre os SDKs de dispositivo e dispositivo incorporado em SDKs de IoT.

SDKs de dispositivos embutidos de gestão de certificados (pré-visualização)

A tabela seguinte lista os SDKs embutidos que atualmente suportam a gestão de certificados X.509 apoiada pela Microsoft em pré-visualização.

RTOS SDK Origem Exemplos
FreeRTOS FreeRTOS Middleware Azure/azure-iot-middleware-freertos em feature/dps-csr-preview Não disponível
Metal nu SDK do Azure for Embedded C Azure/azure-sdk-for-c em feature/dps-csr-preview paho_iot_hub_csr_sample.c

SDKs de Serviço

Os SDKs de serviço DPS ajudam a criar aplicativos de back-end para gerenciar registros e registros de registro em instâncias DPS.

Plataforma Pacote Repositório de código Exemplos Início Rápido Referência
.NET NuGet GitHub Samples Início rápido Referência
Java Maven GitHub Samples Início rápido Referência
Node.js npm GitHub Samples Início rápido Referência

SDKs de gerenciamento

Os SDKs de gestão DPS ajudam-no a construir aplicações backend que gerem as instâncias DPS e os seus metadados na sua subscrição do Azure.

Plataforma Pacote Repositório de código Referência
.NET NuGet GitHub Referência
Java Maven GitHub Referência
Node.js npm GitHub Referência
Python pip GitHub Referência

Próximos passos

A documentação do Serviço de Provisionamento de Dispositivos fornece tutoriais e exemplos adicionais que você pode usar para experimentar os SDKs e bibliotecas.