--- title: "AWS IoT Core(MQTT 브로커) 통합 가이드" slug: "aws-iot-core-mqtt-broker-integration-guide" updated: 2026-10-22T12:37:53Z published: 2026-10-22T12:37:53Z canonical: "support.tulip.co/aws-iot-core-mqtt-broker-integration-guide" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.tulip.co/llms.txt > Use this file to discover all available pages before exploring further. # AWS IoT Core(MQTT 브로커) 통합 가이드 Tulip Interface AWS IoT Core 통합 - AWS 콘솔 가이드 # Tulip Interface AWS IoT Core 통합 - AWS 콘솔 가이드 ## 개요 이 가이드에서는 명령줄을 사용하지 않고 **AWS 콘솔만** 사용하여 Tulip Interface 를 AWS IoT Core에 연결하는 방법을 설명합니다. ## 필수 조건 - IoT 권한이 부여된 AWS 콘솔 액세스 권한 - MQTT 커넥터 기능을 갖춘 Tulip Interface 에 대한 액세스 권한 - 웹 브라우저 --- ## 1단계: IoT Thing 생성 ### 1.1 AWS IoT 콘솔로 이동 1. [AWS IoT 콘솔](https://console.aws.amazon.com/iot/)로 이동 2. 왼쪽 사이드바에서 [ **관리** ] → [ **디바이스**] **를** 클릭합니다 ### 1.2 새 디바이스 생성 1. **'디바이스 생성'을** 클릭합니다 2. **'단일 디바이스 생성'을** 선택합니다 3. **'다음'을** 클릭합니다 4. 'Thing 이름'에 `'tulip-interface-client'를` 입력하세요 5. 나머지 필드는 기본값 그대로 둡니다 6. **'다음'을** 클릭합니다 --- ## 2단계: 장치 인증서 생성 ### 2.1 인증서 구성 1. **'새 인증서 자동 생성'을** 선택하십시오 2. **'다음'을** 클릭합니다 ### 2.2 IoT 정책 생성 1. **'정책 생성'을** 클릭합니다 2. 새 탭이 열리면: 3. **정책 이름**: `TulipMQTTPolicy` 4. **정책 문서**: **JSON** 탭을 클릭하고 다음 내용을 붙여넣으세요: `json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:*" ], "Resource": "*" } ] }` 5. **'생성'을** 클릭합니다 6. 이전 탭으로 돌아갑니다 ### 2.3 정책 연결 1. 정책 목록을 새로 고침 2. **'TulipMQTTPolicy'를** 선택합니다. 3. **'Thing 생성'을** 클릭합니다 --- ## 3단계: 인증서 파일 다운로드 ### 3.1 필수 파일 다운로드 **중요**: 다음 파일을 즉시 다운로드하십시오(나중에 다운로드할 수 없습니다): 1. **장치 인증서** → `certificate.pem.crt`로 저장 2. **개인 키 파일** → `private.pem.key`로 저장 3. **Amazon Root CA 1** → `AmazonRootCA1.pem`으로 저장 4. **'완료'를** 클릭하십시오 ### 3.2 인증서 체인 파일 생성 1. 텍스트 편집기에서 `certificate.pem.crt` 파일을 엽니다. 2. 텍스트 편집기에서 `AmazonRootCA1.pem을` 엽니다. 3. `cert_chain.pem`이라는 새 파일을 만듭니다 `.` 4. `certificate.pem.crt` 파일의 전체 내용을 `cert_chain.pem` 파일로 복사합니다 5. 파일 끝에 새 줄을 추가합니다 6. `AmazonRootCA1.` pem의 전체 내용을 복사하여 `cert_chain.pem의` 끝에 추가하십시오 7. `cert_chain.pem을` 저장합니다 --- ## 4단계: 개인 키 형식 변환 ### 4.1 온라인 변환 도구 명령줄 사용을 피하기 위해 온라인 도구를 사용합니다: 1. [SSL Converter](https://www.sslshopper.com/ssl-converter.html) 또는 유사한 도구로 이동하십시오 2. **'변환 원본**: RSA 개인 키'를 선택하세요 3. **'변환 대상**: PKCS#8'을 선택하세요 4. `private.pem.key` 파일을 업로드하세요 5. 변환된 파일을 `private_pkcs8.pem`으로 다운로드하세요 **보안 참고 사항**: 실제 운영 환경에서는 보안을 강화하기 위해 오프라인 도구 또는 명령줄을 사용하십시오. --- ## 5단계: IoT 엔드포인트 가져오기 ### 5.1 엔드포인트 찾기 1. AWS IoT 콘솔에서 **설정** (왼쪽 사이드바)으로 이동합니다. 2. **'디바이스 데이터 엔드포인트**'에서 엔드포인트 URL을 복사하세요 3. 형식은 다음과 같습니다: `a1234567890123-ats.iot.us-west-1.amazonaws.com` 4. **이 URL을 저장해 두세요**. Tulip 구성에 필요합니다 --- ## 6단계: Tulip Interface MQTT 커넥터 구성 ### 6.1 MQTT 연결 설정 Tulip Interface 의 MQTT 커넥터에서 다음을 구성하십시오: - **MQTT 브로커 호스트**: `[5단계에서 확인한 엔드포인트]` - **포트**: `8883` - **프로토콜**: `TLS 기반 MQTT` 또는 `MQTTS` - **클라이언트 ID**: `tulip-interface-client` ### 6.2 인증서 구성 다음 파일을 Tulip Interface 에 업로드하십시오: 1. **인증서 파일**: `cert_chain.pem` 업로드 2. **개인 키 파일**: `private_pkcs8.pem` 업로드 3. **CA 인증서 파일**: `AmazonRootCA1.pem` 업로드 ### 6.3 토픽 구성 - **게시 토픽**: `tulip/data` - **구독할 토픽**: `tulip/commands` (선택 사항) --- ## 7단계: CloudWatch 로깅 활성화 (선택 사항) ### 7.1 IAM 역할 생성 1. [IAM 콘솔](https://console.aws.amazon.com/iam/)로 이동 2. **'역할** ( **Roles** )' → '역할 **생성(Create role**) **'** 을 클릭합니다 3. **AWS 서비스** → **IoT를** 선택합니다 4. **'다음'을** 클릭합니다 5. **CloudWatchLogsFullAccess를** 검색하여 선택합니다 6. **'다음'을** 클릭합니다. 7. 역할 이름: `IoTLogsRole` 8. **'역할 생성'을** 클릭합니다. ### 7.2 IoT 로깅 활성화 1. [AWS IoT](https://console.aws.amazon.com/iot/) 콘솔로 돌아갑니다. 2. **설정** (왼쪽 사이드바)으로 이동 3. **'로그**'에서 **'편집'을** 클릭합니다 4. **상세 수준**: 정보 5. **역할 설정**: `IoTLogsRole` 선택 6. **'업데이트'를** 클릭합니다 --- ## 8단계: 연결 테스트 ### 8.1 AWS 콘솔에서 모니터링 1. **'테스트'** → **'MQTT 테스트 클라이언트**'로 이동 2. **'토픽 구독'을** 클릭합니다. 3. **토픽 필터**: `tulip/data` 4. **'구독'을** 클릭합니다 ### 8.2 Tulip에서 테스트하기 1. 다음에서 테스트 메시지를 전송합니다. Tulip Interface 2. AWS MQTT 테스트 클라이언트에 메시지가 표시되어야 합니다 ### 8.3 CloudWatch 로그 확인 (활성화된 경우) 1. [CloudWatch 콘솔](https://console.aws.amazon.com/cloudwatch/)로 이동 2. **'로그** ' → **'로그 그룹'을** 클릭합니다 3. **AWSIotLogsV2를** 찾습니다 4. 로그 그룹을 클릭하여 연결 로그를 확인하십시오 --- ## 문제 해결 ### 일반적인 문제 및 콘솔 해결 방법 #### 1. 인증서가 작동하지 않음 **문제**: 인증서**오류로** 인해 연결에 실패함**해결 방법**: - 개별 인증서가 아닌 `cert_chain.pem을` 사용하고 있는지 확인하십시오. - 개인 키가 PKCS#8 형식(`private_pkcs8.pem`)인지 확인하십시오. #### 2. 정책 문제 **문제**:**로그에** 인증 실패가**표시됨해결** 방법:1. **[보안** ] → [ **정책**]으로 이동2. **TulipMQTTPolicy를**클릭3. JSON 정책에서 `"*"` 리소스에 대해 `"iot:*"` 가 허용되는지 확인 #### 3. 잘못된 엔드포인트 **문제**:**브로커에** 연결할 수**없음해결 방법**:1. IoT 콘솔에서 **‘설정** ’으로 이동합니다.2. 정확한 엔드포인트 URL( `‘-ats’` 접미사 포함)을 복사합니다.3. 포트 `8883을` 사용합니다. #### 4. 인증서 미연결 **문제**: 인증**실패해결 방법**:1. **[보안** ] → **[인증서**]로 이동합니다.2. 해당 인증서를 클릭합니다.3. **[Things** ] 및 **[정책** ] 탭을 확인합니다.4. `tulip-interface-client` thing과 `TulipMQTTPolicy가` 연결되어 있는지 확인합니다. --- ## 파일 요약 Tulip 구성을 위해 다음 파일이 있어야 합니다: ``` 📁 다운로드된 파일├── certificate.pem.crt # 원본 장치 인증서├── private.pem.key # 원본 개인 키├── AmazonRootCA1.pem # Amazon 루트 CA├── cert_chain.pem # 인증서 + 루트 CA ← 이 파일을 사용하세요└── private_pkcs8.pem # 변환된 개인 키 ← 이 파일을 사용하세요 ``` --- ## 빠른 참조 카드 ### Tulip MQTT 구성 요약 | 설정 | 값 | | --- | --- | | **호스트** | `[사용자 엔드포인트]-ats.iot.[리전].amazonaws.com` | | **포트** | `8883` | | **클라이언트 ID** | `tulip-interface-client` | | **토픽** | `tulip/data` | | **인증서** | `cert_chain.pem` | | **개인 키** | `private_pkcs8.pem` | | **CA 인증서** | `AmazonRootCA1.pem` | ### AWS 콘솔 바로 가기 - [IoT 콘솔](https://console.aws.amazon.com/iot/) - IoT 관리 메인 - [MQTT 테스트 클라이언트](https://console.aws.amazon.com/iot/home#/test) - 메시지 테스트 - [CloudWatch 로그](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups) - 연결 로그 보기 - [IAM 콘솔](https://console.aws.amazon.com/iam/) - 역할 및 정책 관리 --- ## 성공 표시기 ### ✅ 연결 성공 - Tulip Interface "연결됨" 상태가 표시됨 - `tulip/data를` 구독하면 AWS MQTT 테스트 클라이언트에 메시지가 표시됨 - CloudWatch 로그에 `Publish-In` 이벤트 성공이 표시됨 ### ❌ 연결 실패 - 인증서 파일 형식이 올바른지 확인하십시오 - 엔드포인트 URL이 AWS 콘솔의 주소와 정확히 일치하는지 확인하십시오 - 포트 8883이 사용되고 있는지 확인하십시오 - 클라이언트 ID가 Thing 이름과 정확히 일치하는지 확인하십시오 --- ## 보안 모범 사례 1. **인증서 저장**: 인증서 파일을 Tulip에 안전하게 저장하십시오 2. **정책 세분화**: 테스트 후, 더 엄격한 정책을 생성하십시오 3. **모니터링**: 운영 환경 모니터링을 위해 CloudWatch 로깅을 활성화하십시오 4. **정기적인 갱신**: 인증서 갱신 계획 수립 (인증서 유효 기간은 2049년까지) --- ## 지원 리소스 - **AWS IoT 문서**: [docs.aws.amazon.com/iot](https://docs.aws.amazon.com/iot/) - **Tulip 지원**: MQTT 커넥터 관련 문제가 있는 경우 Tulip 지원팀에 문의하십시오 - **AWS 지원**: IoT Core 관련 문제는 AWS 지원을 이용하십시오 --- **참고**: 이 가이드에서는 AWS 콘솔만을 사용합니다. 자동화 또는 스크립팅에 대해서는 CLI 기반 가이드를 참조하십시오.