# AWS IoT Wireless 시작하기
AWS 계정에 가입하고 IAM 사용자를 생성하는 단계를 따라 AWS IoT 무선를 시작할 수 있습니다. 가입한 후에는 AWS Management Console, AWS IoT 무선 API 또는 AWS CLI를 사용하여 Sidewalk 및 LoRaWAN 디바이스와 게이트웨이를 온보딩할 수 있습니다. 장치를 온보딩할 때 리소스를 더 쉽게 식별할 수 있도록 리소스를 설명하고 태그를 지정하는 방법을 고려하세요.
다음 주제에서는 AWS IoT 무선를 시작하는 방법을 보여 줍니다.
**Topics**
+ [AWS IoT Wireless 설정](setting-up-iotwireless.md)
+ [AWS IoT 무선 리소스 설명](iotwireless-describe-resources.md)
# AWS IoT Wireless 설정
AWS에 가입하면 AWS IoT 무선를 포함하여 AWS의 모든 서비스에 AWS 계정 계정이 자동으로 등록됩니다. 사용자에게는 사용한 서비스에 대해서만 요금이 청구됩니다.
AWS IoT 무선를 설정하려면 다음 단원의 단계를 수행합니다.
**Topics**
+ [AWS 계정 설정](#iotwireless-setup-account)
+ [Python 및 AWS CLI 설치](#wireless-onboard-prereq)
## AWS 계정 설정
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 계정에 가입
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 사용자를 생성합니다.
다음 옵션 중 하나를 선택하여 관리 사용자를 생성합니다.
****
| 관리자를 관리하는 방법 한 가지 선택 | 목적 | 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 IAM Identity Center 사용할 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 사용자로 로그인
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 Management Console
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 설치
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 설치
다음 섹션에 설명된 대로 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에 Python을 설치하려면 다음 `sudo` 명령을 실행합니다.
```
sudo apt install python3
sudo apt install python3-pip
```
------
#### [ macOS ]
Mac 시스템에서는 Homebrew를 사용하여 Python을 설치합니다. Homebrew는 pip도 설치하는데, pip은 설치된 Python3 버전을 가리킵니다.
```
$ brew install python
```
------
### AWS CLI 설정
다음 단계는 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(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 호출을 승인합니다. 구성 지침은 다음을 참조하세요.
+ **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)
# AWS IoT 무선 리소스 설명
LoRaWAN 또는 Sidewalk 디바이스 온보딩을 시작하기 전에 디바이스, 게이트웨이 및 대상의 명명 규칙을 고려하세요. AWS IoT 무선는 사용자가 생성하는 리소스를 식별하는 몇 가지 옵션을 제공합니다. AWS IoT 무선 리소스는 생성될 때 고유 ID가 부여되는데, 이 ID는 설명적이지 않으며 리소스 생성 후 변경할 수도 없습니다. 또한 이름을 지정하고, 설명을 추가하고, 태그와 태그 값을 대부분의 AWS IoT 무선 리소스에 연결하여 리소스를 더욱 편리하게 선택, 식별 및 관리할 수 있습니다.
+
**[리소스 이름 및 설명](#wireless-describe-resource-names)**
디바이스, 게이트웨이, 및 프로필의 경우 리소스 이름은 리소스를 만든 후 변경할 수 있는 선택적 필드입니다. 리소스 허브 페이지에 표시된 목록에 이름이 나타납니다.
대상에 대해 AWS 계정 및 AWS 리전에 고유한 이름을 제공합니다. 대상 리소스를 생성한 후에는 대상 이름을 변경할 수 없습니다.
이름은 최대 256자까지 사용할 수 있지만 리소스 허브의 표시 공간은 제한됩니다. 가능한 경우 이름의 구별 부분이 처음 20\$130자에 나타나도록 하세요.
+
**[리소스 태그](#wireless-describe-resource-tags)**
태그는 AWS 리소스에 연결될 수 있는 메타데이터의 키-값 페어입니다. 태그 키와 해당 값을 모두 선택합니다.
게이트웨이, 대상 및 프로파일에 최대 50개의 태그를 연결할 수 있습니다. 디바이스는 태그를 지원하지 않습니다.
## 리소스 이름 및 설명
**이름에 대한 AWS IoT 무선 리소스 지원**
| Resource | 이름 필드 지원 |
| --- | --- |
| 대상 | 이름은 리소스의 고유 ID이며 변경할 수 없습니다. |
| 무선 디바이스 | 이름은 리소스의 선택적 설명자이며 변경할 수 있습니다. |
| LoRaWAN 게이트웨이 | 이름은 리소스의 선택적 설명자이며 변경할 수 있습니다. |
| 프로필 | 이름은 리소스의 선택적 설명자이며 변경할 수 있습니다. |
이름 필드는 리소스 허브 목록에 나타나지만 공간이 제한되어 있으므로 이름의 처음 15\$130자만 표시될 수 있습니다. 리소스의 이름을 선택할 때 리소스를 식별하는 방식과 콘솔에 표시되는 방식을 고려하세요.
**설명**
대상, 디바이스 및 게이트웨이 리소스는 최대 2,048자를 수용할 수 있는 설명 필드도 지원합니다. 설명 필드는 개별 리소스의 세부 정보 페이지에만 나타납니다. 설명 필드에는 많은 정보가 포함될 수 있지만 리소스의 세부 정보 페이지에만 표시되기 때문에 여러 리소스의 컨텍스트에서 검색하는 데 편리하지는 않습니다.
## 리소스 태그
**AWS 태그에 대한 AWS IoT 무선 리소스 지원**
| Resource | AWS 태그 지원 |
| --- | --- |
| 대상 | 최대 50개의 AWS 태그를 리소스에 추가할 수 있습니다. |
| 무선 디바이스 | 이 리소스는 AWS 태그를 지원하지 않습니다. |
| LoRaWAN 게이트웨이 | 최대 50개의 AWS 태그를 리소스에 추가할 수 있습니다. |
| 프로파일 | 최대 50개의 AWS 태그를 리소스에 추가할 수 있습니다. |
태그란 AWS 리소스를 식별하고 정리할 때 사용할 수 있는 메타데이터 역할을 하는 단어 또는 문구입니다. 태그 키는 정보 범주로 간주하고 태그 값은 해당 범주의 특정 값으로 간주할 수 있습니다. 예를 들어, 태그 값이 *색상(color)*인 경우 어떤 리소스에는 해당 태그에 대해 *파란색(blue)* 값을 부여하고 다른 리소스에는 *빨간색(red)* 값을 부여할 수 있습니다. 이를 통해 AWS 콘솔의 [태그 편집기](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)를 사용하여 *색상(color)* 태그 값이 *파란색(blue)*인 리소스를 찾을 수 있습니다.
AWS IoT 무선의 태깅에 대한 자세한 내용은 [AWS IoT 무선 리소스에 태그 지정](tagging-iotwireless.md) 단원을 참조하세요.
태그 지정 및 태그 지정 전략에 대한 자세한 내용은 [태그 편집기](https://docs.aws.amazon.com/ARG/latest/userguide/tag-editor.html)를 참조하세요.