쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

설정
문의하기
피드백
AWS Documentation
AWS 계정 생성

Amazon EventBridge의 AWS Lambda 함수 URL에서 SaaS 이벤트 수신 URLs

RSS
포커스 모드
Amazon EventBridge의 AWS Lambda 함수 URL에서 SaaS 이벤트 수신 URLs - Amazon EventBridge
1단계: AWS CloudFormation 스택 생성2단계: GitHub 웹후크 생성Twilio에 대한 연결 설정웹후크 보안 암호 또는 인증 토큰 업데이트Lambda 함수 업데이트사용 가능한 이벤트 유형할당량, 오류 코드, 전송 재시도

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

참고

파트너가 인바운드 Webhook에 액세스할 수 있도록 타사 파트너가 보낸 인증 서명을 확인하여 Lambda 애플리케이션 수준에서 보호되는 Open Lambda를 AWS 계정에 생성합니다. 보안 팀과 함께 이 구성을 검토하세요. 자세한 내용은 Lambda 함수 URL에 대한 보안 및 인증 모델 섹션을 참조하세요.

Amazon EventBridge 이벤트 버스는 AWS CloudFormation 템플릿으로 생성된 AWS Lambda 함수 URL을 사용하여 지원되는 SaaS 공급자로부터 이벤트를 수신할 수 있습니다. 함수 URL을 사용하면 이벤트 데이터가 Lambda 함수로 전송됩니다. 그런 다음, 함수는 이 데이터를 EventBridge에서 수집하고 처리를 위해 이벤트 버스로 보낼 수 있는 이벤트로 변환합니다. 이벤트가 이벤트 버스에 있으면 규칙을 사용하여 이벤트를 필터링하고 구성된 입력 변환을 적용한 후 올바른 대상으로 라우팅할 수 있습니다.

참고

Lambda 함수 URL을 생성하면 월별 비용이 증가합니다. 자세한 내용은 AWS Lambda 요금을 참조하세요.

EventBridge에 대한 연결을 설정하려면 먼저 연결을 설정할 SaaS 공급자를 선택합니다. 그런 다음, 해당 공급자를 통해 생성한 서명 암호를 제공하고 이벤트를 전송할 EventBridge 이벤트 버스를 선택합니다. 마지막으로 AWS CloudFormation 템플릿을 사용하여 연결을 완료하는 데 필요한 리소스를 생성합니다.

현재 Lambda 함수 URL을 사용하여 EventBridge와 함께 사용할 수 있는 SaaS 공급자는 다음과 같습니다.

  • GitHub

  • Twilio

1단계: AWS CloudFormation 스택 생성

먼저 Amazon EventBridge 콘솔을 사용하여 CloudFormation 스택을 생성합니다.

  1. Amazon EventBridge 콘솔(https://console.aws.amazon.com/events/)을 엽니다.

  2. 탐색 창에서 빠른 시작을 선택합니다.

  3. Lambda fURL을 사용하는 인바운드 웹후크에서 시작하기를 선택합니다.

  4. GitHub에서 설정을 선택합니다.

  5. 1단계: 이벤트 버스 선택의 드롭다운 목록에서 이벤트 버스를 선택합니다. 이 이벤트 버스는 사용자가 GitHub에 제공하는 Lambda 함수 URL에서 데이터를 수신합니다. 새 이벤트 버스를 선택하여 이벤트 버스를 생성할 수도 있습니다.

  6. 2단계: CloudFormation을 사용하여 설정에서 새 GitHub 웹후크를 선택합니다.

  7. 내가 만든 인바운드 웹후크에 공개적으로 액세스할 수 있음을 승인합니다를 선택하고 확인을 선택합니다.

  8. 스택의 이름을 입력합니다.

  9. 파라미터에서 올바른 이벤트 버스가 나열되어 있는지 확인한 다음, GitHubWebhookSecret에 대한 보안 토큰을 지정합니다. 보안 토큰 생성에 대한 자세한 내용은 GitHub 설명서의 Setting your secret token을 참조하세요.

  10. 기능 및 변환에서 다음을 각각 선택합니다.

    • 에서 IAM 리소스를 생성할 AWS CloudFormation 수 있음을 확인합니다.

    • 가 사용자 지정 이름으로 IAM 리소스를 생성할 AWS CloudFormation 수 있음을 확인합니다.

    • 에 다음 기능이 필요할 AWS CloudFormation 수 있음을 확인합니다. CAPABILITY_AUTO_EXPAND

  11. 스택 생성을 선택합니다.

2단계: GitHub 웹후크 생성

다음으로 GitHub에 웹후크를 생성합니다. 이 단계를 완료하려면 2단계에서 생성한 Lambda 함수 URL과 보안 토큰이 모두 필요합니다. 자세한 내용은 GitHub 설명서의 Creating webhooks를 참조하세요.

Twilio에 대한 연결 설정

1단계: Twilio 인증 토큰 찾기

Twilio와 EventBridge 간의 연결을 설정하려면 먼저 Twilio 계정의 인증 토큰 또는 보안 암호를 사용하여 Twilio에 대한 연결을 설정합니다. 자세한 내용은 Twilio 설명서에서 Auth Tokens and How To Change Them을 참조하세요.

2단계: AWS CloudFormation 스택 생성

  1. Amazon EventBridge 콘솔(https://console.aws.amazon.com/events/)을 엽니다.

  2. 탐색 창에서 빠른 시작을 선택합니다.

  3. Lambda fURL을 사용하는 인바운드 웹후크에서 시작하기를 선택합니다.

  4. Twilio에서 설정을 선택합니다.

  5. 1단계: 이벤트 버스 선택에서 드롭다운 목록에서 이벤트 버스를 선택합니다. 이 이벤트 버스는 사용자가 Twilio에 제공하는 Lambda 함수 URL에서 데이터를 수신합니다. 새 이벤트 버스를 선택하여 이벤트 버스를 생성할 수도 있습니다.

  6. 2단계: CloudFormation을 사용하여 설정에서 새 Twilio 웹후크를 선택합니다.

  7. 내가 만든 인바운드 웹후크에 공개적으로 액세스할 수 있음을 승인합니다를 선택하고 확인을 선택합니다.

  8. 스택의 이름을 입력합니다.

  9. 파라미터에서 올바른 이벤트 버스가 나열되어 있는지 확인한 다음, 1단계에서 생성한 TwilioWebhookSecret을(를) 입력합니다.

  10. 기능 및 변환에서 다음을 각각 선택합니다.

    • 가 IAM 리소스를 생성할 AWS CloudFormation 수 있음을 확인합니다.

    • 가 사용자 지정 이름으로 IAM 리소스를 생성할 AWS CloudFormation 수 있음을 확인합니다.

    • 에 CAPABILITY_AUTO_EXPAND 기능이 필요할 AWS CloudFormation 수 있음을 확인합니다.

  11. 스택 생성을 선택합니다.

3단계: Twilio 웹후크 생성

Lambda 함수 URL을 설정한 후에는 이벤트 데이터를 전송할 수 있도록 Twilio에 이를 제공해야 합니다. 자세한 내용을 알아보려면 Twilio 설명서의 Configure your public URL with Twilio를 참조하세요.

웹후크 보안 암호 또는 인증 토큰 업데이트

GitHub 보안 암호 업데이트

참고

GitHub는 동시에 두 개의 보안 암호를 사용하는 것을 지원하지 않습니다. AWS CloudFormation 스택의 GitHub 보안 암호와 보안 암호가 동기화되지 않는 동안 리소스 가동 중지가 발생할 수 있습니다. 보안 암호가 동기화되지 않는 동안 전송된 GitHub 메시지는 잘못된 서명으로 인해 실패합니다. GitHub 및 CloudFormation 보안 정보가 동기화될 때까지 기다린 후 다시 시도하세요.

  1. 새 GitHub 보안 암호를 생성합니다. 자세한 내용은 GitHub 문서의 Encrypted secrets를 참조하세요.

  2. https://console.aws.amazon.com/cloudformation://에서 AWS CloudFormation 콘솔을 엽니다.

  3. 탐색 창에서 스택을 선택합니다.

  4. 업데이트할 보안 암호가 포함된 웹후크 스택을 선택합니다.

  5. 업데이트를 선택합니다.

  6. 현재 템플릿 사용이 선택되어 있는지 확인하고 다음을 선택합니다.

  7. GitHubWebhookSecret에서 기존 값 사용을 선택 취소하고 1단계에서 생성한 새 GitHub 보안 암호를 입력한 후 다음을 선택합니다.

  8. Next(다음)를 선택합니다.

  9. 스택 업데이트를 선택합니다.

보안 암호가 전파하는 데 최대 1시간까지 걸릴 수 있습니다. 이 가동 중지 시간을 줄이기 위해 Lambda 실행 컨텍스트를 새로 고칠 수 있습니다.

Twilio 보안 암호 업데이트

참고

Twilio는 동시에 두 개의 보안 암호를 사용하는 것을 지원하지 않습니다. AWS CloudFormation 스택의 Twilio 보안 암호와 보안 암호가 동기화되지 않는 동안 리소스 가동 중지가 발생할 수 있습니다. 보안 암호가 동기화되지 않는 동안 전송된 Twilio 메시지는 잘못된 서명으로 인해 실패합니다. Twilio 및 CloudFormation 보안 정보가 동기화될 때까지 기다린 후 다시 시도하세요.

  1. 새 Twilio 보안 암호를 생성합니다. 자세한 내용은 Twilio 설명서에서 Auth Tokens and How To Change Them을 참조하세요.

  2. https://console.aws.amazon.com/cloudformation://에서 AWS CloudFormation 콘솔을 엽니다.

  3. 탐색 창에서 스택을 선택합니다.

  4. 업데이트할 보안 암호가 포함된 웹후크 스택을 선택합니다.

  5. 업데이트를 선택합니다.

  6. 현재 템플릿 사용이 선택되어 있는지 확인하고 다음을 선택합니다.

  7. TwilioWebhookSecret에서 기존 값 사용을 선택 취소하고 1단계에서 생성한 새 Twilio 보안 암호를 입력한 후 다음을 선택합니다.

  8. Next(다음)를 선택합니다.

  9. 스택 업데이트를 선택합니다.

보안 암호가 전파하는 데 최대 1시간까지 걸릴 수 있습니다. 이 가동 중지 시간을 줄이기 위해 Lambda 실행 컨텍스트를 새로 고칠 수 있습니다.

Lambda 함수 업데이트

CloudFormation 스택에서 생성된 Lambda 함수는 기본 웹후크를 생성합니다. 사용자 지정 로깅과 같은 특정 사용 사례에 맞게 Lambda 함수를 사용자 지정하려면 CloudFormation 콘솔을 사용하여 함수에 액세스한 다음, Lambda 콘솔을 사용하여 Lambda 함수 코드를 업데이트하세요.

Lambda 함수에 액세스

  1. https://console.aws.amazon.com/cloudformation://에서 AWS CloudFormation 콘솔을 엽니다.

  2. 탐색 창에서 스택을 선택합니다.

  3. 업데이트할 Lambda 함수가 포함된 웹후크 스택을 선택합니다.

  4. 리소스 탭을 선택합니다.

  5. Lambda 콘솔에서 Lambda 함수를 열려면 물리적 ID에서 Lambda 함수의 ID를 선택합니다.

이제 Lambda 함수에 액세스했으므로 Lambda 콘솔을 사용하여 함수 코드를 업데이트하세요.

Lambda 함수 코드 업데이트

  1. 작업에서 함수 내보내기를 선택합니다.

  2. 배포 패키지 다운로드를 선택하고 파일을 컴퓨터에 저장합니다.

  3. 배포 패키지.zip 파일의 압축을 풀고, app.py 파일을 업데이트하고, 원본.zip 파일의 모든 파일이 포함되도록 업데이트된 배포 패키지를 압축합니다.

  4. Lambda 콘솔에서 코드 탭을 선택합니다.

  5. 코드 소스(Code source)에서 업로드(Upload from)를 선택합니다.

  6. .zip 파일을 선택한 후 [업로드(Upload)]를 선택합니다.

    1. 파일 선택기에서 업데이트한 파일을 선택하고 열기와 저장을 차례로 선택합니다.

  7. 작업에서 새 버전 발행을 선택합니다.

사용 가능한 이벤트 유형

현재 CloudFormation 이벤트 버스에서 지원되는 이벤트 유형은 다음과 같습니다.

할당량, 오류 코드, 전송 재시도

할당량

Webhook에 대한 수신 요청 수는 기본 AWS 서비스에 의해 제한됩니다. 다음 표에는 관련 할당량이 포함되어 있습니다.

Service 할당량

AWS Lambda

기본값: 동시 실행 10개

할당량 증가 요청을 비롯한 할당량에 대한 자세한 내용은 Lambda 할당량을 참조하세요.

AWS Secrets Manager

기본값: 초당 요청 5,000개

할당량 증가 요청을 비롯한 할당량에 대한 자세한 내용은 AWS Secrets Manager 할당량을 참조하세요.

참고

AWS Secrets Manager Python 캐싱 클라이언트를 사용하면 초당 요청 수가 최소화됩니다.

Amazon EventBridge

PutEvents 작업의 최대 항목 크기는 256KB입니다.

EventBridge는 리전 기반 비율 할당량을 적용합니다. 자세한 내용은 EventBridge 이벤트 버스 할당량 단원을 참조하십시오.

오류 코드

각 AWS 서비스는 오류가 발생할 때 특정 오류 코드를 반환합니다. 다음 표에는 관련 오류 코드가 포함되어 있습니다.

Service 오류 코드 설명

AWS Lambda

429 “TooManyRequestsExption”

동시 실행 할당량을 초과했습니다.

AWS Secrets Manager

500 “Internal Server Error”

초당 요청 할당량을 초과했습니다.

Amazon EventBridge

500 “Internal Server Error”

해당 리전의 비율 할당량을 초과했습니다.

이벤트 재전송

오류가 발생하면 영향을 받은 이벤트의 전송을 다시 시도할 수 있습니다. SaaS 공급자마다 재시도 절차가 다릅니다.

GitHub

GitHub 웹후크 API를 사용하여 웹후크 호출의 전달 상태를 확인하고 필요한 경우 이벤트를 다시 전송합니다. 자세한 내용은 다음 GitHub 설명서를 참조하세요.

Twilio

Twilio 사용자는 연결 재정의를 통해 이벤트 재시도 옵션을 사용자 지정할 수 있습니다. 자세한 내용은 Twilio 설명서의 Webhooks (HTTP callbacks): Connection Overrides를 참조하세요.

이 페이지에서

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.