IoT Platform:Gerenciar endpoints de instância

Pré-requisitos

• Para guias de desenvolvimento de SDK, consulte SDKs do lado do dispositivo, SDK do IoT Platform e Conectar um cliente AMQP.

• Para comparar tipos de instância, consulte Visão geral da instância.

  Instância	Região	Descrição	Como visualizar
  Instância pública legada	China (Shanghai), Japão (Tokyo), Singapura, Alemanha (Frankfurt), EUA (Silicon Valley) e EUA (Virginia)	Na página Overview do console do IoT Platform, o campo ID da instância não exibe nenhum valor.	O painel Development Configurations não está disponível no console do IoT Platform. Para detalhes sobre o endpoint, consulte Visualizar endpoints para instâncias públicas legadas.
  Instância pública		Na página Overview do console do IoT Platform, o campo ID da instância exibe um valor e a página Instance Details está disponível. O sistema cria uma instância pública por padrão ao ativar o IoT Platform.	O painel Development Configurations está disponível no console. Visualizar endpoints para instâncias públicas e Enterprise Edition.
  Instância Enterprise Edition	China (Shanghai), China (Beijing), China (Shenzhen), Japão (Tokyo), Singapura, Alemanha (Frankfurt), EUA (Silicon Valley) e EUA (Virginia)

Contexto

• Tipos de endpoint

  • Os endpoints dividem-se em endpoints públicos e endpoints VPC. Os endpoints VPC reduzem a latência de rede e os custos de largura de banda pública, além de melhorar a segurança e a estabilidade da conexão.

  • Dispositivos podem se conectar ao IoT Platform via MQTT, CoAP ou HTTP. Instâncias Premium Enterprise Edition também suportam conexões VPC, permitindo que dispositivos utilizem o endpoint MQTT VPC.

  • Para acessar o IoT Platform a partir de uma instância ECS em uma VPC, configure endpoints VPC para assinaturas do lado do servidor AMQP e chamadas à API do IoT Platform.

• Tipos de instância

  • Instâncias Standard e Premium Enterprise Edition nas regiões China (Shanghai), China (Beijing) e China (Shenzhen) permitem vincular um IP fixo ao endpoint MQTT.

  • Instâncias Premium Enterprise Edition exigem criação manual de um endpoint MQTT dedicado. Também é possível personalizar o número da porta e o certificado.

Visualizar endpoints para instâncias públicas legadas

Substitua os seguintes parâmetros nas URLs dos endpoints.

Visualizar endpoints para instâncias públicas e Enterprise Edition

1. Acesse o console do IoT Platform. No canto superior esquerdo da página, selecione a região onde a instância está localizada.

2. Na página Overview, clique em o alias da instância ou no ID.

3. No canto superior direito da página Instance Details, clique em View Development Configurations.

4. No painel Development Configurations, clique em nas abas MQTT, CoAP, AMQP ou de outros protocolos para visualizar as informações do endpoint. Clique em Copy ao lado do nome de domínio para copiar o endereço do endpoint. Clique em no ícone de ajuda para visualizar a porta. Para detalhes sobre portas, consulte Visualizar endpoints para instâncias públicas legadas.

   Importante

   • Para instâncias Premium Enterprise Edition, crie o endpoint MQTT manualmente. Criar um endpoint MQTT dedicado para uma instância Premium Enterprise Edition.

   • Conexões de dispositivo via HTTPS suportam apenas os métodos de certificado único por dispositivo e certificado único por produto baseado em pré-registro. Esses métodos utilizam endpoints diferentes:

     • Ao usar o método de certificado único por dispositivo, o endpoint aparece na aba HTTP.

     • O método de certificado único por produto baseado em pré-registro tem suporte apenas na região China (Shanghai). O endpoint é iot-auth.cn-shanghai.aliyuncs.com.

   • Se você ativou a autenticação ID² para sua instância Enterprise Edition, o ID² Authentication Address na aba Gerencie ID² do painel Development Configurations não aparece. Para o formato do endereço, consulte Visualizar endpoints para instâncias públicas legadas.

   O painel Development Configurations possui duas seções: Public Endpoint e VPC Network Endpoint. Cada seção contém abas para os protocolos suportados (MQTT, CoAP, HTTP, AMQP). Nessas abas, encontram-se endereços de endpoint, portas de conexão e configurações relacionadas. Por exemplo, a aba MQTT mostra o endereço do endpoint, a porta de conexão e o status de vinculação do Fixed IP.

Vincular um IP fixo a um endpoint

Um IP fixo garante que a resolução DNS permaneça estável quando o IoT Platform dimensionar seus endereços IP. Se você utilizar cartões SIM IoT com planos de dados restritos a endereços IP específicos e sua operadora não suportar configuração de nome de domínio, adicione o IP fixo à lista de permissões de IP da operadora.

Para vincular um IP fixo ao endpoint MQTT público de uma instância:

• Instâncias públicas permitem atribuir dois IPs fixos para conexões MQTT.

  1. No canto superior direito da página Instance Details da instância pública, clique em View Development Configurations.

  2. No painel Development Configurations, na aba MQTT, clique em Set ao lado de Fixed IP.

  3. Na caixa de diálogo exibida, clique em OK para obter dois IPs fixos.

  Se os IPs fixos não forem mais necessários para conexões MQTT, clique em Unbind.

• Para instâncias Premium Enterprise Edition, o sistema atribui automaticamente um IP fixo ao criar manualmente um endpoint MQTT público. Não é possível desvincular.

Criar um endpoint MQTT dedicado para instâncias Premium Enterprise Edition

Para criar um endpoint MQTT para uma instância Premium Enterprise Edition:

1. No canto superior direito da página Instance Details da instância Premium Enterprise Edition, clique em View Development Configurations.

2. No painel Development Configurations, na aba MQTT, clique em Create.

3. Na caixa de diálogo Create Endpoint, configure as informações do endpoint.

   Parâmetro	Descrição
   Porta personalizada	Número da porta para conexões MQTT. A porta padrão é 1883.
   Ativar VPC	Yes: Ativa conexões VPC. Configure a VPC, vSwitch Zone, vSwitch e grupo de segurança. Esta opção cria endpoints MQTT públicos e VPC. Importante Para ativar um endpoint MQTT sobre uma VPC, ative o serviço PrivateLink. Se o PrivateLink não estiver ativado, clique em Enable para acessar o console VPC e ativá-lo. No (Padrão): Desativa conexões VPC. Esta opção cria apenas um endpoint MQTT público. Importante Se selecionar No, não será possível ativar conexões VPC para este endpoint posteriormente.
   Autorização	Se ativar conexões VPC, conceda autorização. Clique em Authorize. O sistema cria uma função e uma política de autorização para permitir que dispositivos se conectem ao IoT Platform pela VPC. Funções vinculadas ao serviço.
   VPC	Após ativar conexões VPC e conceder autorização, configure estes parâmetros. Selecione uma VPC e um vSwitch existentes. Clique em Create VPC ou Create vSwitch para criar novos recursos. Criar uma VPC e Criar um vSwitch.
   Zona do vSwitch
   vSwitch
   Grupo de segurança	Após ativar conexões VPC e conceder autorização, configure este parâmetro. Selecione um grupo de segurança existente. Clique em Create Security Group para criar um grupo. Criar um grupo de segurança.

4. Clique em OK.

   Após a criação, o novo endpoint aparece em MQTT Device Connection.

Personalizar o certificado MQTT para instâncias Premium Enterprise Edition

Para personalizar o certificado e o nome de domínio para conexões MQTT com uma instância Premium Enterprise Edition:

1. No canto superior direito da página Instance Details da instância Premium Enterprise Edition, clique em View Development Configurations.

2. No painel Development Configurations, na aba MQTT, clique em Configure em Custom Certificate.

3. Na caixa de diálogo Custom Certificate, em Custom Configuration, clique em On.

   Nota

   Se Custom Configuration já estiver ativado, pule esta etapa.

4. Insira o conteúdo do certificado e a chave privada no formato PEM obtidos da sua autoridade certificadora (CA) e clique em OK.

   Aviso

   Atualizar o conteúdo do certificado ou a chave privada após a configuração inicial pode causar falha na verificação do certificado. Isso desconecta dispositivos do IoT Platform e interrompe serviços. Proceda com cautela.

   A página exibe o nome de domínio personalizado extraído do seu certificado. Use este nome de domínio para conexões de dispositivos MQTT.

   Importante

   Configure um registro CNAME com seu provedor de domínio para resolver o nome de domínio personalizado para o endpoint MQTT padrão da instância.