

# 設定 AWS IoT Wireless
<a name="setting-up-iotwireless"></a>

註冊 AWS 時，您的 AWS 帳戶 帳戶會自動註冊 AWS 中的所有服務，包括 AWS IoT Wireless。您只需支付實際使用服務的費用。

請執行下節中的步驟來設定 AWS IoT Wireless：

**Topics**
+ [設定您的 AWS 帳戶](#iotwireless-setup-account)
+ [安裝 Python 和 AWS CLI](#wireless-onboard-prereq)

## 設定您的 AWS 帳戶
<a name="iotwireless-setup-account"></a>

首次使用 AWS IoT Core for LoRaWAN 或適用於 Amazon Sidewalk 的 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>

若要建立管理員使用者，請選擇下列其中一個選項。


****  

| 選擇一種管理管理員的方式 | 到 | By | 您也可以 | 
| --- | --- | --- | --- | 
| 在 IAM Identity Center (建議) | 使用短期憑證存取 AWS。這與安全性最佳實務一致。有關最佳實務的資訊，請參閱 *IAM 使用者指南*中的 [IAM 安全最佳實務](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#bp-users-federation-idp)。 | 請遵循 AWS IAM Identity Center 使用者指南的[入門](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html)中的說明。 | 請參閱 AWS Command Line Interface 使用者指南中的[設定 AWS CLI 以使用 AWS IAM Identity Center](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 使用者指南](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html)中的管理 IAM 使用者的存取金鑰，設定程式設計存取。 | 

### 以 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 文件》**中的[設定硬體開發套件 (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。在這種情況下，在執行命令時請以 `python3` 取代 `python` 的所有執行個體。如果仍然產生錯誤，請下載並執行 [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，然後指向已安裝的 Python3 版本。

```
$ brew install python
```

------

### 設定 AWS CLI
<a name="wireless-prereq-cli"></a>

以下步驟說明如何設定 AWS CLI 和 boto3 (適用於 Python 的 AWS SDK)。您必須先註冊 AWS 帳戶 並建立管理使用者，然後再依照這些步驟進行。如需指示，請參閱 [設定 AWS IoT Wireless](#setting-up-iotwireless)。

1. 

**安裝及設定 AWS CLI**

   您可以使用 AWS CLI，以程式設計方式將您的 Sidewalk 終端裝置加入適用於 Amazon Sidewalk 的 AWS IoT Core。如果您想使用 AWS IoT 主控台來加入裝置，可以跳過本節。開啟 [AWS IoT Core 主控台](https://console.aws.amazon.com/iot/home#/)，然後繼續下一節，開始將裝置連接到適用於 Amazon Sidewalk 的 AWS IoT Core。如需有關設定 AWS CLI 的指示，請參閱[安裝和設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)。

1. 

**安裝 boto3 (適用於 Python 的 AWS 開發套件)**

   下列命令顯示如何安裝 boto3 (適用於 Python 的 AWS 開發套件) 和 AWS CLI。您也會安裝 botocore，這是執行 boto3 所需的。如需詳細說明，請參閱《Boto3 文件指南》**中的[安裝 Boto3](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#installation)。
**注意**  
`awscli` 版本 `1.26.6` 需要 3.10 或更高版本的 PyYAML 版本，但不得高於 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 呼叫。如需組態指示，請參閱：
   + 《Boto3 文件指南》**中的[組態](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html#configuration)
   + 《AWS CLI 文件指南》**中的[組態和憑證檔案設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)