Developer Workspace

Request certificates

To ensure that only trusted developers and manufacturers can create virtual devices and plugins that communicate with SmartThings Cloud, Developer Workspace provides ways to apply for certificates of your devices and plugins.

Request a certificate for devices

SmartThings Cloud allows trusted developers and manufacturers with a device certificate to connect their devices with SmartThings Cloud. To test your physical or virtual devices, please request a certificate for devices only once.

Depending on your development environment, use SmartThings CLI to request a device certificate.

Using SmartThings CLI

You can easily request a device certificate using SmartThings CLI with the following command.

st request device-crt --device-name <Device Name> [--email <Email>] [--mnid <Manufacturer ID>] [--common-name <Common Name>] [--organization <Organization>] [--organizational-unit <Organizational Unit>] [--locality <Locality>] [--state <State>] [--country <Country>] [--out-dir <Output Cert File Directory>]
Fields Mandatory / Optional Description
Email Optional Your email address
Manufacturer ID Mandatory Your manufacturer ID (MNID)
Name Optional The name of your enterprise
Country, State, Locality Optional Your country (and language), state, and locale of your enterprise (headquarters)
Organization, Organizational Unit Optional Specifics about your company
Output Cert File Directory Optional The directory certificate file will be located here

Request certificates for plugins

You need two types of certificates to install your plugin on the SmartThings app: an Author Certificate and a Distributor Certificate. These certificates are used for signing and verifying your plugin.

The author certificate identifies the author and enables future updates to the plugin. The same key must be used in all versions of your plugin, so you should keep it in a safe and secure place.

The distributor certificate identifies the distributor. The issued distributor certificate enables installation of the plugin to the registered device for testing. After the plugin is uploaded to the Stores, it is replaced by the official distributor certificate.

If you request certificates for plugins successfully, these following four files will be created:

  • author.crt: author certificate
  • author.pri: author key
  • distributor.crt: distributor certificate
  • distributor.pri: distributor key

in this folder: C:\Users\%user%\.iotcloud\tools\security_profiles\%userId%

IMPORTANT

Keep your author key(author.pri) and certificate (author.crt) in a safe and secure place. Ensure that you have secure backups. If you lose your author key or certificate, you will not be able to publish any updates on to your plugins. The same key and certificate must be used to sign all versions of your plugins.

You can request a certificate for a plugin using SmartThings CLI without downloading SmartThings SDK. To request certificates, use the following command.

st request ppk-crt --passwd <Password> [--distributor-type <Distributor Type>] [--common-name <Common Name>] [--organization <Organization>] [--organizational-unit <Organization Unit] [--locality <Locality>] [--state <State>] [--country <Country>]
Fields Mandatory / Optional Description
Password Mandatory A password used to protect access to your private key
Distributor Type Mandatory Permission level to use plugin API (Use “Public” only)
Name Optional The name of your enterprise
Country, State, Locality Optional Your country (and language), state, and locale of your enterprise (headquarters)
Organization, Organizational Unit Optional Specifics about your company