Setting up AWS IoT Wireless - AWS IoT Wireless
Set up your AWS accountInstalling Python and the AWS CLI

Setting up AWS IoT Wireless

When you sign up for AWS, your AWS account is automatically signed up for all services in AWS, including AWS IoT Wireless. You are charged only for the services that you use.

To set up AWS IoT Wireless, perform the steps in the following section:

Set up your AWS account

Before you use AWS IoT Core for LoRaWAN or AWS IoT Core for Amazon Sidewalk for the first time, complete the following tasks to set up your AWS account.

Sign up for an AWS account

If you do not have an AWS account, complete the following steps to create one.

To sign up for an AWS account

  1. Open https://portal.aws.amazon.com/billing/signup.

  2. Follow the online instructions.

    Part of the sign-up procedure involves receiving a phone call and entering a verification code on the phone keypad.

    When you sign up for an AWS account, an AWS account root user is created. The root user has access to all AWS services and resources in the account. As a security best practice, assign administrative access to a user, and use only the root user to perform tasks that require root user access.

Create an IAM user

To create an administrator user, choose one of the following options.

Choose one way to manage your administrator To By You can also
In IAM Identity Center

(Recommended)

 Use short-term credentials to access AWS.

This aligns with the security best practices. For information about best practices, see Security best practices in IAM in the IAM User Guide.

 Following the instructions in Getting started in the AWS IAM Identity Center User Guide. Configure programmatic access by Configuring the AWS CLI to use AWS IAM Identity Center in the AWS Command Line Interface User Guide.
In IAM

(Not recommended)

 Use long-term credentials to access AWS. Following the instructions in Creating your first IAM admin user and user group in the IAM User Guide. Configure programmatic access by Managing access keys for IAM users in the IAM User Guide.

Sign in as an IAM user

After you create an IAM user, you can sign in to AWS with your IAM user name and password.

Before you sign in as an IAM user, you can verify the sign-in link for IAM users in the IAM console. On the IAM Dashboard, under IAM users sign-in link, you can see the sign-in link for your AWS account. The URL for your sign-in link contains your AWS account ID without dashes (‐).

If you don't want the URL for your sign-in link to contain your AWS account ID, you can create an account alias. For more information, see Creating, deleting, and listing an AWS account alias in the IAM User Guide.

To sign in as an IAM user

  1. Sign out of the AWS Management Console.

  2. Enter your sign-in link, which includes yout AWS account ID (without dashes) or your AWS account alias.

    https://aws_account_id_or_alias.signin.aws.amazon.com/console

  3. Enter the IAM user name and password that you just created.

When you're signed in, the navigation bar displays "your_user_name @ your_aws_account_id".

Installing Python and the AWS CLI

Before you connect your LoRaWAN or Sidewalk end device, you must set up and install Python, and configure the AWS CLI.

Important

To perform the entire onboarding workflow for provisioning and registering your Sidewalk end device, you must also set up your Sidewalk gateway and the HDK. For instructions, see Setting up the hardware development kit (HDK) and Setting up a Sidewalk gateway in the Amazon Sidewalk documentation.

Install Python and Python3-pip

To use the AWS CLI and boto3 as described in the next section, you must use a Python version 3.6 or later. If you want to onboard your end devices using the AWS IoT console, you can skip this section and continue to setting up your AWS account. To check whether you’ve already installed Python and Python3-pip, run the following commands. If running these commands return the version, it means that Python and Python3-pip have been installed correctly.

python3 -V
pip3 --version

If this command returns an error, it might be because Python is not installed, or your operating system calls the Python v3.x executable as Python3. In that case, replace all instances of python with python3 when you run the commands. If it still produces an error, either download and run the Python installer, or install Python depending on your operating system as described below.

Windows

On your Windows machine, download Python from the Python website and then run the installer to install Python on your machine.

Linux

On your Ubuntu machine, run the following sudo command to install Python.

sudo apt install python3
sudo apt install python3-pip
macOS

On your Mac machine, use Homebrew to install Python. Homebrew also installs pip, which then points to the installed Python3 version.

$ brew install python

Setting up your AWS CLI

The following steps show you how to configure your AWS CLI and boto3 (AWS SDK for Python). Before you follow these steps, you must sign up for an AWS account and create an administrative user. For instructions, see Setting up AWS IoT Wireless.

  1. Install and configure the AWS CLI

    You can use the AWS CLI to programmatically onboard your Sidewalk end devices to AWS IoT Core for Amazon Sidewalk. If you want to onboard your devices using the AWS IoT console, you can skip this section. Open the AWS IoT Core console and then continue to the next section to get started with connecting your devices to AWS IoT Core for Amazon Sidewalk. For instructions on configuring the AWS CLI, see Installing and configuring the AWS CLI.

  2. Install boto3 (AWS SDK for Python)

    The following commands show you how to install boto3 (AWS SDK for Python) and the AWS CLI. You'll also install botocore, which is required to run boto3. For detailed instructions, see Installing Boto3 in the Boto3 Documentation Guide.

    Note

    awscli version 1.26.6 requires PyYAML version that's 3.10 or later, but not later than 5.5.

    python3 -m pip install botocore-version-py3-none-any.whl
python3 -m pip install boto3-version-py3-none-any.whl
  3. Configure your credentials and default Region

    Configure your credentials and default Region in the ~/.aws/credentials and ~/.aws/config files. The boto3 library uses these credentials to identify your AWS account and authorize API calls. For configuration instructions, see: