Updated on 2022-02-24 GMT+08:00

Subscribing to Data

Overview

An NA calls the subscription API of the IoT platform to inform the IoT platform where a notification is to be pushed and the type of the notification to be pushed, such as device service data and device alarms.

HTTPS is used for subscription push, and the certificate of the NA must be loaded.

Procedure

  1. An NA calls the subscription API of the IoT platform to subscribe to data. For details about the subscription API, see the Northbound API Reference.
  2. Log in to the Management Portal, and choose System Management > Application Management > Application List. On the page displayed, click the created application.
  3. On the Information tab page of the application details page, click Manage Certificate in the Message Push pane.
  4. Click Add. Set the parameters based on Table 1, and click Confirm.

    Table 1 CA Certificate dialog box

    Parameter

    Description

    CA Certificate

    You must apply for and purchase a CA certificate in advance. The CA certificate is provided by the NA.

    Domain/IP and Port

    Specify the domain name or IP address and port number used by the IoT platform to push messages to the NA. Set this parameter to the domain name or IP address and port number in the callback URL in the subscription API. Example values are api.ct10649.com:9001 and 127.0.1.2:8080.

    LoadBalance Nickname

    Nickname of the LoadBalance to which the certificate is loaded. Retain the default value Default.

    Check Common Name

    Specify whether the common name of the CA certificate is verified to ensure that the loaded certificate matches the applied certificate. It is recommended that the common name be verified.

    Common Name

    This parameter is displayed when Check Common Name is set to ON. This parameter specifies the common name of the CA certificate. Obtain the value from the certificate applicant.

    Use Device Certificate

    Enable this function if the NA needs to verify the validity of the IoT platform.

    • If this function is enabled, one-way authentication is used (the IoT platform verifies the server corresponding to callback URL). In this case, unidirectional authentication must also be configured on the server.
    • If this function is turned on, the server corresponding to the callback URL must apply for the corresponding certificate file and upload the device certificate on the IoT platform.

    Device Certificate

    A device certificate, also called public key certificate, is a digital certificate that contains a public key. The device certificate is provided by the NA.

    Private Key File

    Specify the private key file contained in the user key pair. You can set a password to protect a private key file, preventing access by anyone without the password.

    Private Key Password

    Specify the password used to encrypt a private key file.