API Gateway WebSocket API 연결 오류를 해결하려면 어떻게 해야 하나요?

간략한 설명

다음과 같은 이유로 API Gateway WebSocket API 연결 오류가 발생할 수 있습니다.

• 권한이 부족하여 백엔드에 요청할 수 없음
• API ID, AWS 리전 및 API 단계의 필드가 잘못됨
• 백엔드 통합의 오류
• AWS Identity and Access Management(IAM) 인증 오류

해결 방법

사용 사례에 따라 다음 문제 해결 단계를 수행합니다.

WebSocket API에 백엔드에 요청하는 데 필요한 권한이 있는지 확인

API Gateway는 IAM 역할, 정책, 태그 및 AWS Lambda Authorizer를 사용하여 WebSocket API에 대한 액세스를 제어합니다. 자세한 내용은 API Gateway의 WebSocket API에 대한 액세스 제어 및 관리를 참조하세요.

또한, WebSocket API 통합 요청이 올바르게 구성되었는지 확인합니다.

요청이 올바른 API ID, AWS 리전 및 API 단계로 전송되었는지 확인

이 예제 요청 URL에서 다음 필드가 올바른지 확인합니다.

wss://a1b2c3d4e5.execute-api.us-east-1.amazonaws.com/production

• WebSocket API ID는 ‘a1b2c3d4e5’입니다.
• AWS 리전은 ‘us-east-1’입니다.
• API 단계 이름 ‘프로덕션’이 있습니다.

CloudWatch 로그에서 오류 확인

지침에 따라 API Gateway WebSocket API 오류 문제 해결을 위해 Amazon CloudWatch Logs를 활성화합니다. 백엔드에 Lambda 함수가 통합된 경우 CloudWatch 로그에서 오류를 확인합니다. 자세한 내용은 AWS Lambda에 대한 CloudWatch Logs 액세스를 참조하세요.

API 메서드에 IAM 인증이 설정되어 있는 경우 API 요청에 서명되었는지 확인

IAM 인증이 활성화되어 있는 경우 API 요청이 Signature Version 4(SigV4)로 서명되었는지 확인합니다. 자세한 내용은 Signature Version 4로 AWS 요청에 서명을 참조하세요.

API Gateway API에 대해 IAM 인증을 활성화하려면 다음 단계를 따르세요.

1. API Gateway 콘솔에서 API 이름을 선택합니다.
2. Resources(리소스) 창에서 IAM 인증을 활성화하려는 메서드(예: GET 또는 POST)를 선택합니다.
3. Method Execution(메서드 실행) 창에서 Method Request(메서드 요청)을 선택합니다.
4. Settings(설정)에서 Authorization(인증)에 대해 연필 아이콘(Edit(편집))을 선택합니다. 그런 다음 드롭다운 목록에서 AWS_IAM을 선택한 다음 확인 표시 아이콘(Update(업데이트))를 선택합니다.
5. (선택 사항) IAM 인증을 활성화하려는 API 메서드마다 2~4단계를 반복합니다.
6. 변경 사항을 적용되도록 WebSocket API를 배포합니다.

---

관련 정보

CloudWatch 지표로 WebSocket API 실행 모니터링

API Gateway Lambda 권한 부여자 사용

API Gateway REST API와 함께 Lambda 권한 부여자를 사용할 때 HTTP 403 Forbidden 오류를 해결하려면 어떻게 해야 하나요?

API Gateway 프라이빗 API 엔드포인트에 대한 연결 문제를 해결하려면 어떻게 해야 하나요?