기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS Partner Central 및 AWS Marketplace 이벤트에 대한 실시간 알림 설정
다음 주제에서는 AWS Partner Central 및 AWS Marketplace 이벤트에 대한 실시간 EventBridge 알림을 설정하는 방법을 설명합니다. 연결된 앱을 구성하여 Salesforce에서 알림을 설정하거나 AWS CloudFormation 템플릿을 사용할 수 있습니다.
Salesforce 연결 앱 구성
다음 단계에서는 Salesforce에서 연결된 앱을 구성하는 방법을 설명합니다. 대상 연결에 OAuth 인증을 사용하려면 연결된 앱을 생성해야 합니다. 자세한 내용은이 안내서 수동으로 알림 구성 요소 생성뒷부분의 단원을 참조하십시오.
Salesforce 조직에 시스템 관리자로 로그인합니다.
설정의 빠른 찾기 상자에를 입력한
apps
다음 앱 관리자를 선택합니다.-
Lightning Experience 앱 관리자 페이지에서 연결된 앱 새로 만들기를 선택하고 연결된 앱 생성을 선택한 다음 계속을 선택합니다.
새 연결된 앱 페이지가 나타납니다.
다음을 수행합니다.
연결된 앱 이름 상자에 앱 이름을 입력합니다.
연락처 이메일 상자에 이메일 주소를 입력합니다.
(선택 사항) Salesforce 설명서의 기본 연결 앱 설정 구성
에 설명된 대로 나머지 필드를 작성합니다.
-
OAuth 설정 활성화 확인란을 선택한 후 다음을 수행합니다.
디바이스 흐름에 활성화 확인란을 선택합니다. 결과 콜백 URL을 무시할 수 있습니다.
사용 가능한 OAuth 범위에서 APIs 통해 사용자 데이터 관리를 선택하고 추가 버튼을 사용하여 범위를 선택한 범위 목록으로 이동합니다.
-
다음 확인란을 선택합니다.
지원되는 권한 부여 흐름을 위해 코드 교환(PKCE) 확장을 위한 증명 키 필요
-
웹 서버 흐름에 보안 암호 필요
-
새로 고침 토큰 흐름에 보안 암호 필요
-
클라이언트 자격 증명 흐름 활성화
클라이언트 자격 증명 흐름 활성화를 선택한 후 나타나는 메시지에서 확인을 선택합니다.
페이지의 하단으로 스크롤하고 저장(Save)을 선택합니다.
-
계속을 선택한 다음 소비자 세부 정보 관리를 선택합니다.
자격 증명 확인 페이지가 나타나고 시스템에서 확인 코드를 연락처 이메일 주소로 보냅니다.
-
확인 코드 상자에 확인 코드를 입력하고 확인을 선택합니다.
연결된 앱의 페이지가 나타납니다.
소비자 세부 정보에서 소비자 키 및 고객 보안 암호의 복사 버튼을 선택합니다.
-
설정의 빠른 찾기 상자에 앱을 입력하고 연결된 앱 관리를 선택한 다음 방금 생성한 연결된 앱을 선택합니다.
-
정책 편집을 선택한 후 다음을 수행합니다.
허용된 사용자 목록에서 모든 사용자가 자체 권한을 부여할 수 있음을 선택합니다.
IP 완화 목록에서 IP 제한 적용을 선택합니다.
Run As 목록에서 클라이언트 자격 증명 흐름을 할당할 사용자인 실행 사용자를 선택합니다. Salesforce에서는 실행 사용자가 사용자를 대신하여 액세스 토큰을 반환해야 합니다.
저장을 선택합니다.
AWS CloudFormation 스택을 사용하여 알림 설정
다음 주제에서는 이제 AWS CloudFormation 템플릿을 사용하여 실시간 EventBridge 알림을 설정하는 방법을 설명합니다. 이 단계는 AWS Partner CRM 커넥터 버전 3.0 이상에만 적용됩니다.
AWS Partner CRM 커넥터 버전 3.0 이상의 경우 AWS CloudFormation 템플릿을 사용하여 Amazon EventBridge 통합을 위한 AWS 구성 요소를 구성하거나 구성 요소를 수동으로 생성할 수 있습니다. 사용하려면 다음에서 템플릿을 AWS CloudFormation다운로드합니다.
도메인 URL 찾기
AWS CloudFormation 템플릿은 도메인 URL을 필수 파라미터 중 하나로 사용합니다.
URL을 찾으려면
Salesforce에 로그인합니다.
설정 섹션의 빠른 찾기 상자에를 입력합니다
my domain
.왼쪽 창의 회사 설정에서 내 도메인 링크를 선택합니다.
현재 내 도메인 URL 상자에 주소를 복사합니다.
참고
AWS CloudFormation 템플릿에 URL을 입력할 때 https:// 접두사를 사용해야 합니다.
AWS CloudFormation 스택 사용
다음 주제의 단계에서는 실시간 알림을 설정하는 AWS CloudFormation 스택을 생성하고 배포하는 방법을 설명합니다.
-
다음 템플릿을 다운로드합니다.
참고
각 템플릿을 별도로 배포하고 둘 다에 대해 동일한 단계를 따릅니다.
-
Partner Central API 통합: https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_PCAPI.json
-
(선택 사항) AWS Marketplace 통합: https://servicecatalogconnector.s3.amazonaws.com/APIDestinationCFT_AWSMP.json
-
AWS 콘솔에서 AWS Marketplace 판매자 계정에 로그인하고 버지니아 북부에서 실행되는지 확인합니다. EventBridge는 해당 리전에서만 작동합니다.
콘솔에서를 검색
cloudformation
한 다음 AWS CloudFormation 콘솔을 엽니다.스택 페이지에서 스택 생성을 선택합니다.
기존 템플릿 선택 및 템플릿 파일 업로드 라디오 버튼을 선택합니다.
파일 선택을 선택하여 다운로드한 템플릿을 연 다음 다음을 선택합니다.
스택 세부 정보 지정 페이지에서 다음을 입력합니다.
스택 이름 - 스택의 이름을 입력합니다.
클라이언트 ID - 연결된 앱을 생성할 때 기록해 둔 소비자 키를 입력합니다.
클라이언트 보안 암호 - 연결된 앱을 생성할 때 기록해 둔 소비자 보안 암호를 입력합니다.
-
도메인 URL - 다음 형식을 사용합니다.
https://
domain_URL
.
마친 후에는 다음을 선택합니다.
스택 옵션 구성 페이지에서 끝까지 스크롤하여 가 IAM 리소스를 생성할 AWS CloudFormation 수 있음을 승인합니다 확인란을 선택한 후 다음을 선택합니다.
제출을 선택합니다.
성공적으로 배포되면 템플릿은 API 대상, 연결, 이벤트 규칙 및 배달 못한 편지 대기열을 생성합니다.
수동으로 알림 구성 요소 생성
다음 단계에서는 EventBridge 알림을 위한 구성 요소를 수동으로 생성하는 방법을 설명합니다.
주제
Amazon EventBridge API 대상 및 연결 생성
EventBridge에서 API 대상 및 연결을 생성하려면 새 연결을 사용하는 API 대상을 생성합니다. 이 경우 API 대상은 이벤트를 다시 게시하기 위해 Salesforce에 대한 REST API 호출입니다. 연결에는 API 호출에 대한 인증 정보가 포함됩니다. 연결에는 여러 가지 권한 부여 방법이 허용됩니다.
사전 조건
API 대상 연결에 OAuth 권한 부여를 사용하려면 Salesforce에서 연결된 앱을 생성합니다. 이렇게 하려면 Salesforce 설명서의 OAuth 2.0 클라이언트 자격 증명 흐름을 위한 연결된 앱 구성
EventBridge 콘솔에서 API 대상을 생성하려면
Amazon EventBridge 사용 설명서의 API 대상 생성의 단계를 따릅니다.
Salesforce와 관련된 구성을 설정합니다.
Salesforce의 내 도메인 페이지의 설정에서 조직의 도메인 이름을 기록해 둡니다. 이를 사용하여 EventBridge 콘솔에서 API 대상 및 연결을 설정합니다. 다음 단계에서는 그 방법을 설명합니다.
대상 및 연결을 생성하려면
https://console.aws.amazon.com/events/
EventBridge 콘솔을 열고 왼쪽 탐색 창에서 API 대상을 선택합니다. -
API 대상 테이블까지 아래로 스크롤하여 API 대상 생성을 선택합니다.
API 대상 생성 페이지가 나타납니다.
다음 정보를 입력합니다.
API 대상의 이름입니다. 최대 64자의 대문자 또는 소문자, 숫자, 점(.), 대시(-) 또는 밑줄(_) 문자를 사용할 수 있습니다.
이 이름은 현재 리전의 계정에 대해 고유해야 합니다.
(선택 사항) API 대상에 대한 설명을 입력합니다.
API 대상 엔드포인트의 경우 URL을 사용합니다
https://
.my-salesforce-domain-name
.my.salesforce.com/services/data/v58.0/sobjects/event-api-name
HTTP 메서드에서 POST를 선택합니다.
-
연결 구성에서 새 연결 생성을 선택하고 다음을 수행합니다.
이름과 선택적 설명을 입력합니다.
대상 유형에서 기타를 선택합니다.
OAuth 클라이언트 자격 증명을 선택합니다.
-
권한 부여 엔드포인트에서 미리 채워진 엔드포인트를 수락합니다.
—또는—
프로덕션 조직을 사용하는 경우 채워진 엔드포인트를 다음 URL로 바꿉니다.
https://
my-salesforce-domain-name
.my.salesforce.com/services/oauth2/token HTTP 메서드에서 POST를 선택합니다.
클라이언트 ID에 Salesforce의 연결된 앱에서 소비자 키를 입력합니다.
클라이언트 보안 암호에 Salesforce에서 연결된 앱의 소비자 보안 암호를 입력합니다.
다음 OAuth 값을 추가합니다.
파라미터: 본문 필드
키: grant_type
값: client_credentials
생성(Create)을 선택합니다.
참고
Salesforce 조직에서 API 액세스에 다중 인증을 사용하는 경우 사용자는 Salesforce APIs에 액세스하려면 두 번째 인증 챌린지를 완료해야 합니다. 자세한 내용은 Salesforce 설명서의 API 액세스를 위한 다중 인증 로그인 요구 사항 설정을
API 대상을 생성한 후 대상을 대상으로 사용하는 규칙을 생성할 수 있습니다.
EventBridge 규칙 생성 및 API 대상에 연결
EventBridge 규칙은 이벤트 버스에서 API 대상으로 이벤트를 라우팅하므로 이벤트를 Salesforce에 다시 게시하기 위해 REST를 호출합니다.
EventBridge 규칙에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 이벤트에 대응하는 Amazon EventBridge 규칙 생성을 참조하세요. EventBridge
변경 세트 이벤트 생성
다음 단계에서는 변경 세트 이벤트를 생성하는 방법을 설명합니다.
-
Amazon EventBridge에서 규칙을 선택합니다.
-
목록에서 원하는 이벤트 버스를 선택합니다.
-
Rules(규칙) 섹션에서 Create rule(규칙 생성)을 선택합니다.
-
규칙의 이름을 입력한 후 다음을 선택합니다.
-
이벤트 패턴에서 사용자 지정 패턴(JSON 편집기)을 선택하고 다음 필터를 입력합니다. 세부 유형 조합을 사용할 수 있습니다.
{ "source": [ "aws.marketplacecatalog" ], "detail-type": [ "Change Set Succeeded", "Change Set Failed", "Change Set Cancelled" ] }
이벤트 패턴 일치에 대한 자세한 내용은 설명서의 Amazon EventBridge 이벤트 패턴의 콘텐츠 필터링을 AWS 참조하세요.
-
다음을 선택합니다.
-
대상 선택의 대상 1에서 EventBridge API 대상을 선택합니다.
-
목록에서 방금 생성한 API 대상을 선택합니다.
-
추가 설정을 폅니다.
-
대상 입력 구성에서 입력 변환기 및 입력 변환기 구성을 선택합니다. 이렇게 하면 원래 이벤트의 세부 정보 섹션에 있는 Salesforce 이벤트 필드만 전송됩니다.
입력 경로는 다음과 같아야 합니다.
{ "Name": "$.detail-type", "awsapn__Account_Number__c": "$.account", "awsapn__EntityId__c": "$.detail.ChangeSetId" }
템플릿은 다음과 같아야 합니다.
{ "Name":
Name
, "awsapn__Account_Number__c":awsapn__Account_Number__c
, "awsapn__EntityId__c":awsapn__EntityId__c
} -
다음을 선택한 후 다음을 선택합니다.
-
규칙을 검토한 다음 규칙 생성을 선택합니다.
참고
API 대상 문제를 해결하려면 Amazon SQS 콘솔을 사용하여 대상에 배달 못한 편지 대기열을 추가할 수 있습니다. 대기열은 배달할 수 없는 메시지와 오류를 수신합니다. Amazon SQS 콘솔에서 대기열의 메시지를 폴링하여 오류를 확인할 수 있습니다. 자세한 내용은 Amazon SQS 사용 설명서의 배달 못한 편지 대기열을 사용하여 EventBridge에서 전송되지 않은 이벤트 처리 및 Amazon SQS에서 메시지 수신 및 삭제를 참조하세요. Amazon SQS Amazon SQS
제안 릴리스 이벤트 생성
다음 단계에서는 제안 릴리스 이벤트를 생성하는 방법을 설명합니다.
-
Amazon EventBridge 콘솔에서 ChooseRules.
-
목록에서 원하는 이벤트 버스를 선택합니다.
-
Rules(규칙) 섹션에서 Create rule(규칙 생성)을 선택합니다.
-
규칙의 이름을 입력한 후 다음을 선택합니다.
-
이벤트 패턴에서 사용자 지정 패턴(JSON 편집기)을 선택한 다음 다음 필터를 입력합니다.
{ "source": [ "aws.marketplacecatalog" ], "detail-type": [ "Offer Released" ] }
이벤트 패턴 일치에 대한 자세한 내용은 Amazon EventBridge 사용 설명서의 Amazon EventBridge 이벤트 패턴의 콘텐츠 필터링을 참조하세요. EventBridge
-
다음을 선택합니다.
-
대상 선택의 대상 1에서 EventBridge API 대상을 선택한 다음 목록을 열고 방금 생성한 API 대상을 선택합니다.
-
추가 설정을 폅니다.
-
대상 입력 구성 입력 변환기 선택에서 입력 Tansformer 구성을 선택합니다. 이 단계는 최상위 Amazon 이벤트 필드가 Salesforce로 전송되는 것을 방지합니다. 원래 이벤트의 세부 정보 섹션에 있는 Salesforce 이벤트 필드가 포함된 부분만 전송됩니다.
다음 입력 경로를 사용합니다.
{ "Name":"$.detail-type", "awsapn__Account_Number__c":"$.account", "awsapn__EntityId__c":"$.detail.offer.id", "awsapn__Manufacturer_Account_Id__c":"$.detail.manufacturer.accountId", "awsapn__Product_Id__c":"$.detail.product.id", "awsapn__Seller_Account_Id__c":"$.detail.sellerOfRecord.accountId" }
다음 템플릿을 사용합니다.
{ "Name":
Name
, "awsapn__Account_Number__c":awsapn__Account_Number__c
, "awsapn__EntityId__c":awsapn__EntityId__c
, "awsapn__Seller_Account_Id__c":awsapn__Seller_Account_Id__c
, "awsapn__Manufacturer_Account_Id__c":awsapn__Manufacturer_Account_Id__c
, "awsapn__Product_Id__c":awsapn__Product_Id__c
} -
다음을 선택한 후 다음을 선택합니다.
-
규칙을 검토한 다음 규칙 생성을 선택합니다.
참고
API 대상 실행 문제를 해결하려면 Amazon SQS 배달 못한 편지 대기열을 대상에 추가합니다. 대기열은 오류와 함께 배달할 수 없는 메시지를 수신합니다. 그런 다음 메시지를 폴링하여 오류를 볼 수 있습니다. 자세한 내용은 AWS 설명서의 이벤트 재시도 정책 및 배달 못한 편지 대기열 사용 및 메시지 수신 및 삭제(콘솔)를 참조하세요.
기회 이벤트 생성
기회 이벤트는 기회의 상태 또는 세부 정보 변경에 대한 실시간 알림을 제공합니다.
SDK를 사용하여 프로그래밍 방식으로 EventBridge 규칙을 생성하고 관리할 수도 있습니다. AWS SDKs
이벤트 유형
다음 목록은 파트너가 기회를 사용할 때 생성되는 이벤트 유형을 설명합니다. 링크를 클릭하면 각 이벤트에 대한 API 설명서로 이동합니다.
예제 이벤트
{ "version": "1", "id": ""
d1example-0c9c-4655-15bf-c5exampleb08
", "source": "aws.partnercentral-selling", "detail-type": "Opportunity Created", "time": ""2023-10-28T13:31:05Z
", "region": ""us-east-1
", "account": ""123456789123
", "detail": { "schemaVersion": "1", "catalog": "AWS", "opportunity": { "identifier": ""O1234567
", "url": "Partner Central Opportunity Page URL
" } } }
규칙 예
다음 표에는 이전 섹션에 나열된 이벤트와 함께 사용할 수 있는 EventBridge 규칙의 예가 나와 있습니다. 규칙은 이벤트 버스에서 API 대상으로 이벤트를 라우팅하므로 이벤트를 Salesforce에 다시 게시하기 위해 REST를 호출합니다.
이벤트 유형 |
예제 |
---|---|
생성된 기회 |
|
기회 업데이트됨 |
|
참여 초대 생성됨 |
|
참여 초대 수락됨 |
|
참여 초대 거부됨 |
|
모든 이벤트 |
|