Create client devices in an Amazon IoT Greengrass group - Amazon IoT Greengrass
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.

Amazon IoT Greengrass Version 1 no longer receives feature updates, and will receive only security patches and bug fixes until June 30, 2023. For more information, see the Amazon IoT Greengrass V1 maintenance policy. We strongly recommend that you migrate to Amazon IoT Greengrass Version 2, which adds significant new features and support for additional platforms.

Create client devices in an Amazon IoT Greengrass group

In this step, you add two client devices to your Greengrass group. This process includes registering the devices as Amazon IoT things and configuring certificates and keys to allow them to connect to Amazon IoT Greengrass.

  1. In the Amazon IoT console navigation pane, under Manage, expand Greengrass devices, and then choose Groups (V1).

  2. Choose the target group.

  3. On the group configuration page, choose Client devices, and then choose Associate.

  4. In the Associate a client device with this group modal, choose Create new Amazon IoT thing.

    The Create things page opens in a new tab.

  5. On the Create things page, choose Create single thing, and then choose Next.

  6. On the Specify thing properties page, register this client device as HelloWorld_Publisher, and then choose Next.

  7. On the Configure device certificate page, choose Next.

  8. On the Attach policies to certificate page, do one of the following:

    • Select an existing policy that grants permissions that client devices require, and then choose Create thing.

      A modal opens where you can download the certificates and keys that the device uses to connect to the Amazon Web Services Cloud and the core.

    • Create and attach a new policy that grants client device permissions. Do the following:

      1. Choose Create policy.

        The Create policy page opens in a new tab.

      2. On the Create policy page, do the following:

        1. For Policy name, enter a name that describes the policy, such as GreengrassV1ClientDevicePolicy.

        2. On the Policy statements tab, under Policy document, choose JSON.

        3. Enter the following policy document. This policy allows the client device to discover Greengrass cores and communicate on all MQTT topics. For information about how to restrict this policy's access, see Device authentication and authorization for Amazon IoT Greengrass.

          { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Publish", "iot:Subscribe", "iot:Connect", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "greengrass:*" ], "Resource": [ "*" ] } ] }
        4. Choose Create to create the policy.

      3. Return to the browser tab with the Attach policies to certificate page open. Do the following:

        1. In the Policies list, select the policy that you created, such as GreengrassV1ClientDevicePolicy.

          If you don't see the policy, choose the refresh button.

        2. Choose Create thing.

          A modal opens where you can download the certificates and keys that the device uses to connect to the Amazon Web Services Cloud and the core.

  9. In the Download certificates and keys modal, download the device's certificates.

    Important

    Before you choose Done, download the security resources.

    Do the following:

    1. For Device certificate, choose Download to download the device certificate.

    2. For Public key file, choose Download to download the public key for the certificate.

    3. For Private key file, choose Download to download the private key file for the certificate.

    4. Review Server Authentication in the Amazon IoT Developer Guide and choose the appropriate root CA certificate. We recommend that you use Amazon Trust Services (ATS) endpoints and ATS root CA certificates. Under Root CA certificates, choose Download for a root CA certificate.

    5. Choose Done.

    Make a note of the certificate ID that's common in the file names for the device certificate and keys. You need it later.

  10. Return to the browser tab with the Associate a client device with this group modal open. Do the following:

    1. For Amazon IoT thing name, choose the HelloWorld_Publisher thing that you created.

      If you don't see the thing, choose the refresh button.

    2. Choose Associate.

  11. Repeat steps 3 - 10 to add a second client device to the group.

    Name this client device HelloWorld_Subscriber. Download the certificates and keys for this client device to your computer. Again, make a note of the certificate's ID that's common in the file names for the HelloWorld_Subscriber device.

    You should now have two client devices in your Greengrass group:

    • HelloWorld_Publisher

    • HelloWorld_Subscriber

  12. Create a folder on your computer for these client devices' security credentials. Copy the certificates and keys into this folder.