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 콘솔로 이동
- AWS IoT 콘솔로 이동
- 왼쪽 사이드바에서 [ 관리 ] → [ 디바이스] 를 클릭합니다
1.2 새 디바이스 생성
- '디바이스 생성'을 클릭합니다
- '단일 디바이스 생성'을 선택합니다
- '다음'을 클릭합니다
- 'Thing 이름'에
'tulip-interface-client'를입력하세요 - 나머지 필드는 기본값 그대로 둡니다
- '다음'을 클릭합니다
2단계: 장치 인증서 생성
2.1 인증서 구성
- '새 인증서 자동 생성'을 선택하십시오
- '다음'을 클릭합니다
2.2 IoT 정책 생성
- '정책 생성'을 클릭합니다
- 새 탭이 열리면:
- 정책 이름:
TulipMQTTPolicy - 정책 문서: JSON 탭을 클릭하고 다음 내용을 붙여넣으세요:
json { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:*" ], "Resource": "*" } ] } - '생성'을 클릭합니다
- 이전 탭으로 돌아갑니다
2.3 정책 연결
- 정책 목록을 새로 고침
- 'TulipMQTTPolicy'를 선택합니다.
- 'Thing 생성'을 클릭합니다
3단계: 인증서 파일 다운로드
3.1 필수 파일 다운로드
중요: 다음 파일을 즉시 다운로드하십시오(나중에 다운로드할 수 없습니다):
- 장치 인증서 →
certificate.pem.crt로 저장 - 개인 키 파일 →
private.pem.key로 저장 - Amazon Root CA 1 →
AmazonRootCA1.pem으로 저장 - '완료'를 클릭하십시오
3.2 인증서 체인 파일 생성
- 텍스트 편집기에서
certificate.pem.crt파일을 엽니다. - 텍스트 편집기에서
AmazonRootCA1.pem을엽니다. cert_chain.pem이라는 새 파일을 만듭니다.certificate.pem.crt파일의 전체 내용을cert_chain.pem파일로 복사합니다- 파일 끝에 새 줄을 추가합니다
AmazonRootCA1.pem의 전체 내용을 복사하여cert_chain.pem의끝에 추가하십시오cert_chain.pem을저장합니다
4단계: 개인 키 형식 변환
4.1 온라인 변환 도구
명령줄 사용을 피하기 위해 온라인 도구를 사용합니다:
- SSL Converter 또는 유사한 도구로 이동하십시오
- '변환 원본: RSA 개인 키'를 선택하세요
- '변환 대상: PKCS#8'을 선택하세요
private.pem.key파일을 업로드하세요- 변환된 파일을
private_pkcs8.pem으로 다운로드하세요
보안 참고 사항: 실제 운영 환경에서는 보안을 강화하기 위해 오프라인 도구 또는 명령줄을 사용하십시오.
5단계: IoT 엔드포인트 가져오기
5.1 엔드포인트 찾기
- AWS IoT 콘솔에서 설정 (왼쪽 사이드바)으로 이동합니다.
- '디바이스 데이터 엔드포인트'에서 엔드포인트 URL을 복사하세요
- 형식은 다음과 같습니다:
a1234567890123-ats.iot.us-west-1.amazonaws.com - 이 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 에 업로드하십시오:
- 인증서 파일:
cert_chain.pem업로드 - 개인 키 파일:
private_pkcs8.pem업로드 - CA 인증서 파일:
AmazonRootCA1.pem업로드
6.3 토픽 구성
- 게시 토픽:
tulip/data - 구독할 토픽:
tulip/commands(선택 사항)
7단계: CloudWatch 로깅 활성화 (선택 사항)
7.1 IAM 역할 생성
- IAM 콘솔로 이동
- '역할 ( Roles )' → '역할 생성(Create role) ' 을 클릭합니다
- AWS 서비스 → IoT를 선택합니다
- '다음'을 클릭합니다
- CloudWatchLogsFullAccess를 검색하여 선택합니다
- '다음'을 클릭합니다.
- 역할 이름:
IoTLogsRole - '역할 생성'을 클릭합니다.
7.2 IoT 로깅 활성화
- AWS IoT 콘솔로 돌아갑니다.
- 설정 (왼쪽 사이드바)으로 이동
- '로그'에서 '편집'을 클릭합니다
- 상세 수준: 정보
- 역할 설정:
IoTLogsRole선택 - '업데이트'를 클릭합니다
8단계: 연결 테스트
8.1 AWS 콘솔에서 모니터링
- '테스트' → 'MQTT 테스트 클라이언트'로 이동
- '토픽 구독'을 클릭합니다.
- 토픽 필터:
tulip/data - '구독'을 클릭합니다
8.2 Tulip에서 테스트하기
- 다음에서 테스트 메시지를 전송합니다. Tulip Interface
- AWS MQTT 테스트 클라이언트에 메시지가 표시되어야 합니다
8.3 CloudWatch 로그 확인 (활성화된 경우)
- CloudWatch 콘솔로 이동
- '로그 ' → '로그 그룹'을 클릭합니다
- AWSIotLogsV2를 찾습니다
- 로그 그룹을 클릭하여 연결 로그를 확인하십시오
문제 해결
일반적인 문제 및 콘솔 해결 방법
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 콘솔 - IoT 관리 메인
- MQTT 테스트 클라이언트 - 메시지 테스트
- CloudWatch 로그 - 연결 로그 보기
- IAM 콘솔 - 역할 및 정책 관리
성공 표시기
✅ 연결 성공
- Tulip Interface "연결됨" 상태가 표시됨
tulip/data를구독하면 AWS MQTT 테스트 클라이언트에 메시지가 표시됨- CloudWatch 로그에
Publish-In이벤트 성공이 표시됨
❌ 연결 실패
- 인증서 파일 형식이 올바른지 확인하십시오
- 엔드포인트 URL이 AWS 콘솔의 주소와 정확히 일치하는지 확인하십시오
- 포트 8883이 사용되고 있는지 확인하십시오
- 클라이언트 ID가 Thing 이름과 정확히 일치하는지 확인하십시오
보안 모범 사례
- 인증서 저장: 인증서 파일을 Tulip에 안전하게 저장하십시오
- 정책 세분화: 테스트 후, 더 엄격한 정책을 생성하십시오
- 모니터링: 운영 환경 모니터링을 위해 CloudWatch 로깅을 활성화하십시오
- 정기적인 갱신: 인증서 갱신 계획 수립 (인증서 유효 기간은 2049년까지)
지원 리소스
- AWS IoT 문서: docs.aws.amazon.com/iot
- Tulip 지원: MQTT 커넥터 관련 문제가 있는 경우 Tulip 지원팀에 문의하십시오
- AWS 지원: IoT Core 관련 문제는 AWS 지원을 이용하십시오
참고: 이 가이드에서는 AWS 콘솔만을 사용합니다. 자동화 또는 스크립팅에 대해서는 CLI 기반 가이드를 참조하십시오.
