AWS IoT Core(MQTT 브로커) 통합 가이드

Prev Next

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 콘솔로 이동
  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 또는 유사한 도구로 이동하십시오
  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 콘솔로 이동
  2. '역할 ( Roles )' → '역할 생성(Create role) ' 을 클릭합니다
  3. AWS 서비스 → IoT를 선택합니다
  4. '다음'을 클릭합니다
  5. CloudWatchLogsFullAccess를 검색하여 선택합니다
  6. '다음'을 클릭합니다.
  7. 역할 이름: IoTLogsRole
  8. '역할 생성'을 클릭합니다.

7.2 IoT 로깅 활성화

  1. AWS 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 콘솔로 이동
  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 콘솔 바로 가기


성공 표시기

✅ 연결 성공

  • 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
  • Tulip 지원: MQTT 커넥터 관련 문제가 있는 경우 Tulip 지원팀에 문의하십시오
  • AWS 지원: IoT Core 관련 문제는 AWS 지원을 이용하십시오

참고: 이 가이드에서는 AWS 콘솔만을 사용합니다. 자동화 또는 스크립팅에 대해서는 CLI 기반 가이드를 참조하십시오.