

# AWS IoT Wireless のセットアップ
<a name="setting-up-iotwireless"></a>

AWS にサインアップすると、AWS アカウント は、AWS IoT Wireless を含めた AWS 内のすべてのサービスに自動的にサインアップされます。料金は、使用するサービスの料金のみが請求されます。

AWS IoT Wireless をセットアップするには、次のセクションのステップを実行します。

**Topics**
+ [AWS アカウントのセットアップ](#iotwireless-setup-account)
+ [Python および AWS CLI のインストール](#wireless-onboard-prereq)

## AWS アカウントのセットアップ
<a name="iotwireless-setup-account"></a>

Amazon Sidewalk に AWS IoT Core for LoRaWAN または AWS IoT Core を初めて使用する場合は、AWS アカウント をセットアップするのに以下のタスクを実行してください。

**Topics**
+ [AWS アカウントへのサインアップ](#aws-sign-up-iotwireless)
+ [IAM ユーザーの作成](#create-iam-user-iotwireless)
+ [IAM ユーザーとしてのサインイン](#sign-in-iam-user-iotwireless)

### AWS アカウントへのサインアップ
<a name="aws-sign-up-iotwireless"></a>

AWS アカウント をお持ちでない場合は、以下の手順を実行してアカウントを作成してください。

**AWS アカウント にサインアップするには**

1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開きます。

1. オンラインの手順に従います。

   サインアップ手順の一環として、通話呼び出しを受け取り、電話のキーパッドを使用して検証コードを入力するように求められます。

   AWS アカウントにサインアップすると、*AWS アカウントのルートユーザー*が作成されます。ルートユーザーには、アカウントのすべての AWS のサービスとリソースへのアクセス権があります。セキュリティのベストプラクティスとして、[管理ユーザーに管理アクセスを割り当て](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)、[ルートユーザーアクセスが必要なタスク](https://docs.aws.amazon.com/accounts/latest/reference/root-user-tasks.html)を実行する場合にのみ、ルートユーザーを使用してください。

### IAM ユーザーの作成
<a name="create-iam-user-iotwireless"></a>

管理者ユーザーを作成するには、以下のいずれかのオプションを選択します。


****  

| 管理者を管理する方法を 1 つ選択します | 目的 | 方法 | 以下の操作も可能 | 
| --- | --- | --- | --- | 
| IAM Identity Center 内 (推奨) | 短期の認証情報を使用して AWS にアクセスします。これはセキュリティのベストプラクティスと一致しています。ベストプラクティスの詳細については、IAM ユーザーガイドの「[IAM でのセキュリティのベストプラクティス](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)」を参照してください。 | 「AWS IAM アイデンティティセンター ユーザーガイド」の「[開始方法](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)」の手順に従います。 | 「AWS Command Line Interface ユーザーガイド」の「[AWS IAM アイデンティティセンター を使用するための AWS CLI の設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-sso.html)」に従って、プログラムによるアクセスを設定します。 | 
| IAM 内 (非推奨) | 長期認証情報を使用して AWS にアクセスする。 | 「IAM ユーザーガイド」の「[最初の IAM 管理者のユーザーおよびグループの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html)」の手順に従います。 | IAM ユーザーガイドの「[IAM ユーザーのアクセスキーの管理](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)」に従って、プログラムによるアクセスを設定します。 | 

### IAM ユーザーとしてのサインイン
<a name="sign-in-iam-user-iotwireless"></a>

IAM ユーザーを作成したら、IAM ユーザー名とパスワードを使用して AWS にサインインできます。

IAM ユーザーとしてサインインする前に、IAM コンソールで IAM ユーザーのサインインのリンクを確認できます。IAM ダッシュボードの IAM ユーザーのサインインのリンクの下に、AWS アカウント のサインインのリンクが表示されます。サインインリンクの URL には、ダッシュ (‐) を含まない AWS アカウント ID が含まれています。

サインインリンクの URL に AWS アカウント ID を含めない場合は、アカウントのエイリアスを作成します。詳細については、*IAM ユーザーガイド*の [AWS アカウント のエイリアスの作成、削除および一覧表示](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html#CreateAccountAlias)を参照してください。

**IAM ユーザーとしてサインインするには**

1. からサインアウトします AWS マネジメントコンソール

1. AWS アカウント ID (ダッシュを除く) または AWS アカウント エイリアスを含まめたサインインリンクを入力します。

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

1. 作成した IAM ユーザー名とパスワードを入力します。

サインインすると、ナビゲーションバーに「*your\$1user\$1name @ your\$1aws\$1account\$1id*」が表示されます。

## Python および AWS CLI のインストール
<a name="wireless-onboard-prereq"></a>

LoRaWAN または Sidewalk エンドデバイスを接続する前に、インストール Python をセットアップし、AWS CLI を設定する必要があります。

**重要**  
Sidewalk エンドデバイスのプロビジョニングと登録に関するオンボーディングワークフロー全体を実行するには、Sidewalk ゲートウェイと HDK をセットアップする必要もあります。手順については、「Amazon Sidewalk ドキュメント」の「[Hardware Development Kit (HDK) のセットアップ](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-hdk.html)」と「[Sidewalk ゲートウェイのセットアップ](https://docs.sidewalk.amazon/getting-started/sidewalk-onboard-prereq-gateway.html)」を参照してください。

**Topics**
+ [Python および Python3-pip のインストール](#wireless-prereq-python)
+ [AWS CLI のセットアップ](#wireless-prereq-cli)

### Python および Python3-pip のインストール
<a name="wireless-prereq-python"></a>

次のセクションで説明するように、AWS CLI と boto3 を使用するには、Python バージョン 3.6 以降が必要です。AWS IoT コンソールを使用してエンドデバイスをオンボードする場合は、このセクションを飛ばして AWS アカウント のセットアップを続行できます。Python と Python3-pip が既にインストールされているかどうかを確認するには、次のコマンドを実行します。これらのコマンドを実行してバージョンが返される場合は、Python と Python3-pip が正しくインストールされています。

```
python3 -V
pip3 --version
```

このコマンドでエラーが返される場合は、Python がインストールされていないか、オペレーティングシステムが Python v3.x 実行可能ファイルを Python3 として呼び出していることが原因である可能性があります。その場合は、コマンドを実行するときに `python` のすべてのインスタンスを `python3` に置き換えてください。それでもエラーが発生する場合は、[Python インストーラ](https://www.python.org/downloads/)をダウンロードして実行するか、以下で説明するように、ご使用のオペレーティングシステムに応じて Python をインストールしてください。

------
#### [ Windows ]

Windows マシンで、[Python のウェブサイト](https://www.python.org/downloads/windows/)から Python をダウンロードし、インストーラーを実行して Python をマシンにインストールします。

------
#### [ Linux ]

Ubuntu マシンで、以下の `sudo` コマンドを実行して Python をインストールします。

```
sudo apt install python3
sudo apt install python3-pip
```

------
#### [ macOS ]

Mac マシンで、Homebrew を使用して Python をインストールします。Homebrew では pip もインストールされます。その後、pip はインストールされた Python3 バージョンを指定します。

```
$ brew install python
```

------

### AWS CLI のセットアップ
<a name="wireless-prereq-cli"></a>

以下の手順は、AWS CLI および boto3 (AWS SDK for Python) を設定する方法を示しています。これらのステップを実施する前に、AWS アカウント にサインアップし、管理ユーザーを作成しておく必要があります。手順については、[AWS IoT Wireless のセットアップ](#setting-up-iotwireless) を参照してください。

1. 

**AWS CLI のインストールと設定**

   AWS CLI を使用すると、Sidewalk エンドデバイスを AWS IoT Core for Amazon Sidewalk にプログラム的にオンボードできます。AWS IoT コンソールを使用してデバイスをオンボードする場合は、このセクションを省略できます。[AWS IoT Core コンソール](https://console.aws.amazon.com/iot/home#/)を開いて次のセクションに進み、デバイスの AWS IoT Core for Amazon Sidewalk への接続を開始してください。AWS CLI の設定方法については、「[AWS CLI のインストールと設定](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。

1. 

**boto3 (AWS SDK for Python) のインストール**

   次のコマンドは、boto3 (AWS SDK for Python) と AWS CLI のインストール方法を示しています。boto3 を実行するために必要な botocore もインストールする必要があります。詳細な手順については、「Boto3 ドキュメントガイド」の「[Boto3 のインストール](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation)」を参照してください。
**注記**  
`awscli` バージョン `1.26.6` には、PyYAML バージョンの 3.10 以降、5.5 以前が必要です。

   ```
   python3 -m pip install botocore-version-py3-none-any.whl
   python3 -m pip install boto3-version-py3-none-any.whl
   ```

1. 

**認証情報およびデフォルトのリージョンの設定**

   `~/.aws/credentials` および `~/.aws/config` ファイル内で、認証情報およびデフォルトのリージョンを設定します。boto3 ライブラリは、これらの認証情報を使用して AWS アカウント を識別し、API コールを承認します。設定手順については、以下を参照してください。
   + 「[設定](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration)」(Boto3 ドキュメントガイド)
   + 「[設定ファイルと認証情報ファイルの設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)」(AWS CLI ドキュメントガイド)