기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # IDT 사용량 지표 필요한 권한이 있는 AWS 자격 증명을 제공하는 경우는 사용량 지표를 AWS IoT Device Tester 수집하여에 제출합니다 AWS. 이는 옵트인 기능이며 IDT 기능을 개선하는 데 사용됩니다. IDT는 다음과 같은 정보를 수집합니다. + AWS 계정 IDT를 실행하는 데 사용되는 ID + 테스트를 실행하는 데 사용되는 IDT AWS CLI 명령 + 실행되는 테스트 제품군 + {{}} 폴더의 테스트 제품군 + 디바이스 풀에 구성된 디바이스 수 + 테스트 케이스 이름 및 런타임 + 테스트 결과 정보(예: 테스트 통과, 실패, 오류 발생 또는 건너뛰었는지 여부) + 제품 기능 테스트 + IDT 종료 행동(예: 예상치 못한 종료 또는 조기 종료) IDT가 전송하는 모든 정보는 `{{}}/results/{{}}/` 폴더의 `metrics.log` 파일에도 기록됩니다. 로그 파일을 보면 테스트 실행 중에 수집된 정보를 볼 수 있습니다. 이 파일은 사용량 지표를 수집하도록 선택한 경우에만 생성됩니다. 지표 수집을 비활성화하기 위해 추가 조치를 취할 필요가 없습니다. 자격 AWS 증명을 저장하지 말고 자격 증명이 저장된 경우 해당 AWS 자격 증명에 액세스하도록 `config.json` 파일을 구성하지 마십시오. ## 자격 AWS 증명 구성 가 아직 없는 경우 [생성](#idt-metrics-aws-account) AWS 계정해야 합니다. 이미가 있는 경우 IDT가 사용자를 대신하여에 사용량 지표를 [전송할 수 있도록 계정에 필요한 권한을 구성](#idt-metrics-permissions)하기만 AWS 계정하면 AWS 됩니다. ### 1단계: 생성 AWS 계정 이 단계에는 AWS 계정을 생성하고 구성합니다. 이미 AWS 계정이 있으면 [2단계: IDT에 대한 권한 구성](#idt-metrics-permissions) 섹션으로 건너뜁니다. 이 없는 경우 다음 단계를 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/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 수행하는 것입니다. 다음 옵션 중 하나를 선택하여 관리 사용자를 생성합니다. **** | 관리자를 관리하는 방법 한 가지 선택 | 목적 | 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-emergency-iam-user.html)에 나와 있는 지침을 따르세요. | IAM 사용 설명서에 나온 [IAM 사용자의 액세스 키 관리](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_credentials_access-keys.html)를 수행하여 프로그래밍 방식의 액세스를 구성합니다. | ### 2단계: IDT에 대한 권한 구성 이 단계에서는 IDT가 테스트를 실행하고 IDT 사용 데이터를 수집하는 데 사용하는 권한을 구성합니다. AWS Management Console 또는 AWS Command Line Interface (AWS CLI)를 사용하여 IDT에 대한 IAM 정책과 사용자를 생성한 다음 사용자에게 정책을 연결할 수 있습니다. + [IDT에 대한 권한 구성(콘솔)](#idt-metrics-permissions-console) + [IDT에 대한 권한 구성(AWS CLI)](#idt-metrics-permissions-cli) **IDT에 대한 권한을 구성하려면(콘솔)** 콘솔을 사용하여 AWS IoT Greengrass용 IDT에 대한 권한을 구성하려면 다음 단계를 수행하세요. 1. [IAM 콘솔](https://console.aws.amazon.com/iam)에 로그인합니다. 1. 특정 권한으로 역할을 생성하는 권한을 부여하는 고객 관리형 정책을 만듭니다. 1. 탐색 창에서 **정책**을 선택한 후 **정책 생성**을 선택합니다. 1. **JSON** 탭에서 자리 표시자 콘텐츠를 다음 정책으로 바꿉니다. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] } ``` ------ 1. **정책 검토**를 선택합니다. 1. **이름**에서 **IDTUsageMetricsIAMPermissions**을 입력합니다. **Summary(요약)** 아래에서 정책에 의해 부여된 권한을 검토합니다. 1. **정책 생성**을 선택합니다. 1. IAM 사용자를 생성하고 사용자에 권한을 연결합니다. 1. IAM 사용자를 생성합니다. [IAM 사용 설명서](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_users_create.html#id_users_create_console)에서 *IAM 사용자 생성(콘솔)*의 1\~5단계를 따르세요. 이미 IAM 사용자를 생성한 경우 다음 단계로 건너뛰세요. 1. IAM 사용자에게 권한을 연결합니다. 1. **Set permissions(권한 설정)** 페이지에서 **Attach existing policies to user directly(사용자에게 직접 기존 정책 연결)**를 선택합니다. 1. 이전 단계에서 만든 **IDTUsageMetricsIAMPermissions** 정책을 검색합니다. 확인란을 선택합니다. 1. **다음: 태그**를 선택합니다. 1. **Next: Review(다음: 검토)**를 선택하여 선택 사항의 요약을 봅니다. 1. **사용자 생성**을 선택합니다. 1. 사용자의 액세스 키(액세스 키 ID와 비밀 액세스 키)를 보려면 암호와 액세스 키 옆에 있는 **Show(표시)**를 선택합니다. 액세스 키를 저장하려면 **Download .csv(csv 다운로드)**를 선택한 후 안전한 위치에 파일을 저장합니다. 나중에이 정보를 사용하여 AWS 자격 증명 파일을 구성합니다.   **IDT에 대한 권한을 구성하려면(AWS CLI)** 다음 단계에 따라를 사용하여 AWS CLI 에 대한 IDT 권한을 구성합니다 AWS IoT Greengrass. 1. 아직 설치되지 않은 AWS CLI 경우 컴퓨터에를 설치하고 구성합니다. *AWS Command Line Interface 사용 설명서* [AWS CLI설치](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) 단계를 따르세요. **참고** AWS CLI 는 명령줄 셸의 AWS 서비스와 상호 작용하는 데 사용할 수 있는 오픈 소스 도구입니다. 1. IDT 및 AWS IoT Greengrass 역할을 관리할 수 있는 권한을 부여하는 다음 고객 관리형 정책을 생성합니다. ------ #### [ Linux or Unix ] ``` aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] }' ``` ------ #### [ Windows command prompt ] ``` aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document '{\"Version\": \"2012-10-17\", \"Statement\": [{\"Effect\": \"Allow\", \"Action\": [\"iot-device-tester:SendMetrics\"], \"Resource": \"*\"}]}' ``` **참고** Linux, macOS 또는 Unix 터미널 명령과 다른 JSON 구문을 사용하기 때문에 이 단계에는 Windows 명령 프롬프트 예제가 포함되어 있습니다. ------ #### [ PowerShell ] ``` aws iam create-policy --policy-name IDTUsageMetricsIAMPermissions --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot-device-tester:SendMetrics" ], "Resource": "*" } ] }' ``` ------ 1. IAM 사용자를 만들고 AWS IoT Greengrass용 IDT에 필요한 권한을 연결합니다. 1. IAM 사용자를 생성합니다. ``` aws iam create-user --user-name {{user-name}} ``` 1. 생성한 `IDTUsageMetricsIAMPermissions` 정책을 새 IAM 사용자에 연결합니다. {{user-name}}을 IAM 사용자 이름으로 바꾸고 명령에서 {{}}를 자신이 사용하는 AWS 계정계정의 ID로 바꾸세요. ``` aws iam attach-user-policy --user-name {{user-name}} --policy-arn arn:aws:iam::{{}}:policy/IDTGreengrassIAMPermissions ``` 1. 사용자에 대한 비밀 액세스 키를 만듭니다. ``` aws iam create-access-key --user-name {{user-name}} ``` 출력을 안전한 위치에 저장합니다. 나중에이 정보를 사용하여 AWS 자격 증명 파일을 구성합니다. ## IDT에 AWS 자격 증명 제공 IDT가 자격 AWS 증명에 액세스하고 지표를 제출하도록 허용하려면 다음을 AWS수행합니다. 1. IAM 사용자의 AWS 자격 증명을 환경 변수로 저장하거나 자격 증명 파일에 저장합니다. 1. 다음 명령을 실행하여 환경 변수를 설정합니다. ------ #### [ Linux or Unix ] ``` export AWS_ACCESS_KEY_ID={{access-key}} export AWS_SECRET_ACCESS_KEY={{secret-access-key}} ``` ------ #### [ Windows Command Prompt (CMD) ] ``` set AWS_ACCESS_KEY_ID={{access-key}} set AWS_SECRET_ACCESS_KEY={{secret-access-key}} ``` ------ #### [ PowerShell ] ``` $env:AWS_ACCESS_KEY_ID="{{access-key}}" $env:AWS_SECRET_ACCESS_KEY="{{secret-access-key}}" ``` ------ 1. 자격 증명 파일을 사용하려면 다음 정보를 `~/.aws/credentials` 파일에 추가합니다. ``` [profile-name] aws_access_key_id={{access-key}} aws_secret_access_key={{secret-access-key}} ``` 1. `config.json` 파일의 `auth` 섹션을 구성합니다. 자세한 내용은 [(선택 사항) config.json 구성](set-custom-idt-config.md#config-json-custom) 단원을 참조하십시오.