Register a client certificate manually - Amazon IoT Core
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Register a client certificate manually

You can register a client certificate manually by using the Amazon IoT console and Amazon CLI.

The registration procedure to use depends on whether the certificate will be shared by Amazon Web Services accounts and Regions. The registration of a client certificate in one account or Region is not automatically recognized by another.

The procedures in this topic must be performed in each account and Region in which you want to use the client certificate. Client certificates can be shared by Amazon Web Services accounts and Regions.

Register a client certificate signed by a registered CA (console)

Note

Before you perform this procedure, make sure that you have the client certificate's .pem file and that the client certificate was signed by a CA that you have registered with Amazon IoT.

To register an existing certificate with Amazon IoT using the console
  1. Sign in to the Amazon Management Console and open the Amazon IoT console.

  2. In the navigation pane, under the Manage section, choose Security, and then choose Certificates.

  3. On the Certificates page in the Certificates dialog box, choose Add certificate, and then choose Register certificates.

  4. On the Register certificate page in the Certificates to upload dialog box, do the following:

    • Choose CA is registered with Amazon IoT.

    • From Choose a CA certificate, select your Certification authority.

      • Choose Register a new CA to register a new Certification authority that's not registered with Amazon IoT.

      • Leave Choose a CA certificate blank if Amazon Root certificate authority is your certification authority.

    • Select up to 10 certificates to upload and register with Amazon IoT.

    • Choose Activate or Deactivate. If you choose Deactive, Activate or deactivate a client certificate explains how to activate your certificate after certificate registration.

    • Choose Register.

On the Certificates page in the Certificates dialog box, your registered certificates will now appear.

Register a client certificate signed by an unregistered CA (console)

Note

Before you perform this procedure, make sure that you have the client certificate's .pem file.

To register an existing certificate with Amazon IoT using the console
  1. Sign in to the Amazon Management Console and open the Amazon IoT console.

  2. In the left navigation pane, choose Secure, choose Certificates, and then choose Create.

  3. On Create a certificate, locate the Use my certificate entry, and choose Get started.

  4. On Select a CA, choose Next.

  5. On Register existing device certificates, choose Select certificates, and select up to 10 certificate files to register.

  6. After closing the file dialog box, select whether you want to activate or revoke the client certificates when you register them.

    If you don't activate a certificate when it is registered, Activate a client certificate (console) describes how to activate it later.

    If a certificate is revoked when it is registered, it can't be activated later.

    After you choose the certificate files to register, and select the actions to take after registration, select Register certificates.

The client certificates that are registered successfully appear in the list of certificates.

Register a client certificate signed by a registered CA (CLI)

Note

Before you perform this procedure, make sure that you have the certificate authority (CA) .pem and the client certificate's .pem file. The client certificate must be signed by a certificate authority (CA) that you have registered with Amazon IoT.

Use the register-certificate command to register, but not activate, a client certificate.

aws iot register-certificate \ --certificate-pem file://device_cert_filename.pem \ --ca-certificate-pem file://ca_cert_filename.pem

The client certificate is registered with Amazon IoT, but it is not active yet. See Activate a client certificate (CLI) for information on how to activate it later.

You can also activate the client certificate when you register it by using this command.

aws iot register-certificate \ --set-as-active \ --certificate-pem file://device_cert_filename.pem \ --ca-certificate-pem file://ca_cert_filename.pem

For more information about activating the certificate so that it can be used to connect to Amazon IoT, see Activate or deactivate a client certificate

Register a client certificate signed by an unregistered CA (CLI)

Note

Before you perform this procedure, make sure that you have the certificate's .pem file.

Use the register-certificate-without-ca command to register, but not activate, a client certificate.

aws iot register-certificate-without-ca \ --certificate-pem file://device_cert_filename.pem

The client certificate is registered with Amazon IoT, but it is not active yet. See Activate a client certificate (CLI) for information on how to activate it later.

You can also activate the client certificate when you register it by using this command.

aws iot register-certificate-without-ca \ --status ACTIVE \ --certificate-pem file://device_cert_filename.pem

For more information about activating the certificate so that it can be used to connect to Amazon IoT, see Activate or deactivate a client certificate.