Contact UsGet started
© 2025 Direct Cursus Technology L.L.C.

Getting started with Yandex IoT Core brokers

Written by
Updated at May 13, 2025

To get started with Yandex IoT Core:

  1. Create an X.509 certificate.
  2. Create a broker.
  3. Set up message exchange.

Note

The broker is at the Preview stage.

Getting started

Sign up in Yandex Cloud and create a billing account:

  1. Navigate to the management console and log in to Yandex Cloud or register a new account.
  2. On the Yandex Cloud Billing page, make sure you have a billing account linked and it has the ACTIVE or TRIAL_ACTIVE status. If you do not have a billing account, create one and link a cloud to it.

If you have an active billing account, you can navigate to the cloud page to create or select a folder for your infrastructure to operate in.

Learn more about clouds and folders.

Create a certificate for the broker

If you have a certificate, add it to the broker after creation. If you do not have a certificate, create it using the OpenSSL program:

openssl req -x509 \
-newkey rsa:4096 \
   -keyout private-key.pem \
   -out cert.pem \
   -nodes \
   -days 365 \
   -subj '/CN=localhost'

Where:

  • -x509: Certificate type, X.509.
  • -newkey: Encryption algorithm.
  • -keyout: File with the private key of the certificate.
  • -out: File with the public key of the certificate.
  • -nodes: This flag is set when no public key encryption is required.
  • -days: Certificate validity period in days.
  • -subj: Request object.

Create a broker

  1. In the management console, select the folder where you want to create a broker.

  2. Select IoT Core.

  3. In the left-hand panel, select Brokers.

  4. Click Create broker.

  5. Under General information, specify the broker name: my-broker.

  6. Add a certificate:

    • To add a file:

      1. Choose the File method.
      2. Click Attach file.
      3. Select the file with the public key of the certificate and click Open.
      4. Click Add.

    • To add text:

      1. Choose the Text method.
      2. Paste the public key of the certificate to the Content field.
      3. Click Add.

  7. Click Create.

  1. Create a broker:

    yc iot broker create --name my-broker

    Result:

    id: b91ki3851h**********
folder_id: aoek49ghmk*********
created_at: "2022-05-28T11:29:42.420Z"
name: my-broker
status: ACTIVE

  2. Add the certificate to the broker:

    yc iot broker certificate add \
   --broker-name my-broker \
   --certificate-file cert.pem

    Where:

    • --broker-name: Broker name
    • --certificate-file: Path to the public key of the certificate.

    Result:

    broker_id: b91ki3851h**********
fingerprint: 1f21cf6d0183d****
certificate_data: |
   -----BEGIN CERTIFICATE-----
   MIIEpDCCAow...
   -----END CERTIFICATE-----
created_at: "2023-07-11T16:20:53.466370019Z"

Set up message exchange

  1. Subscribe to receive messages in a broker.
  2. Send a message in a broker.

What's next

Previous
Device registry
Next
All guides