파트너를 위한 파트너 이벤트 개요 - Azure Event Grid

Event Grid의 파트너 이벤트를 통해 고객은 Azure 서비스와 같은 Azure의 다른 이벤트 소스에 사용하는 것과 동일한 메커니즘을 사용하여 등록된 시스템에서 발생하는 이벤트를 구독 할 수 있습니다. 등록된 시스템을 Event Grid와 통합하는 것을 "파트너"라고 합니다. 또한 이 기능을 사용하면 고객이 플랫폼의 고객 솔루션/엔드포인트에 이벤트를 수신 및 라우팅하도록 지원하는 파트너 시스템에 이벤트를 보낼 수 있습니다. 일반적으로 파트너는 SaaS(Software-as-a-Service) 또는 ERP 공급자이지만, 내부 팀에서 이벤트를 사용할 수 있게 만들려는 회사 플랫폼일 수도 있습니다. 파트너는 Event Grid와 의도적으로 통합하여 Azure에서 끝나는 엔드투엔드 고객 사용 사례(고객이 파트너가 보낸 이벤트를 구독) 또는 파트너 시스템(고객이 Azure Event Grid에서 보낸 Microsoft 이벤트를 구독)을 실현합니다. 고객은 Azure Event Grid를 사용하여 파트너가 게시한 이벤트를 webhook, Azure Functions, Azure Event Hubs 또는 Azure Service Bus 같은 지원되는 대상으로 보냅니다. 또한 고객은 Azure Event Grid를 사용하여 Outlook, Teams 또는 Microsoft Entra ID와 같은 Microsoft 서비스에서 발생하는 이벤트를 고객의 솔루션이 대응할 수 있도록 라우팅합니다. 파트너 이벤트를 통해 고객은 플랫폼 및 네트워크 경계에서 이벤트 기반 솔루션을 빌드하여 이벤트를 안정적으로, 안전하게, 대규모로 받거나 보낼 수 있습니다.

파트너 이벤트: 작동 방식

파트너는 Azure 고객이 이벤트를 구독할 수 있도록 이벤트를 Azure Event Grid에 게시할 수 있는 Event Grid 리소스를 만듭니다. 대부분의 파트너(예: SaaS 공급자)는 이 통합 기능만 사용합니다.

Event Grid 리소스를 만들어 Azure Event Grid의 이벤트를 받을 수도 있습니다. 이 사용 사례는 고객이 엔드포인트를 노출하여 이벤트를 수신할 수 있는 플랫폼을 소유하고 있거나 관리하는 조직을 위한 것입니다. 이러한 조직 중 일부는 플랫폼 내에서 이벤트 라우팅 기능이 있는 ERP 시스템으로, 들어오는 Azure 이벤트를 플랫폼에 호스트되는 고객 애플리케이션으로 보냅니다.

이벤트를 게시하거나 이벤트를 수신하는 경우 이러한 일반적인 단계에 따라 동일한 종류의 Event Grid 리소스를 만듭니다.

1. Event Grid 팀(askgrid@microsoft.com)에 문의하여 파트너가 되고자 한다고 알립니다. 이메일을 받으면 온보딩 프로세스를 안내해드리고, Azure Portal에서 서비스를 찾을 수 있도록 서비스에서 Azure Event Grid 갤러리에서 입장권을 얻을 수 있도록 도와드리겠습니다.

2. 파트너 등록을 만듭니다. 전역 리소스이며 일반적으로 한 번만 만들면 됩니다.

3. 파트너 네임페이스를 만듭니다. 이 리소스는 Azure에 이벤트를 게시할 수 있는 엔드포인트를 노출합니다. 파트너 네임스페이스를 만들 때, 앞에서 만든 파트너 등록을 제공해 주세요.

4. 고객은 고객의 Azure 구독에서 파트너 항목를 만들 수 있도록 승인합니다.

5. 고객이 파트너의 웹 페이지에 액세스하거나 명령을 실행하고, 사용자 환경을 정의하여 Azure로의 이벤트 흐름 또는 시스템에 Microsoft 이벤트를 수신할 수 있는 기능을 요청합니다. 이 요청에 대한 응답으로 파트너는 고객의 입력으로 이 작업을 수행하도록 시스템을 설정합니다. 예를 들어 고객에게는 Azure로 전달해야 하는 특정 이벤트를 시스템에서 선택하는 옵션이 있을 수 있습니다.

6. 채널을 사용하여 고객의 Azure 구독 및 리소스 그룹에서 파트너 항목을 만듭니다. 채널은 파트너 네임스페이스에 포함된 리소스입니다.

7. 고객은 Azure 구독 및 리소스 그룹에서 만든 파트너 항목을 활성화합니다.

8. 파트너 네임스페이스에 이벤트 게시를 시작합니다.

   참고 항목

   Event Grid 리소스를 만들려는 모든 Azure 구독에 Azure Event Grid 리소스 공급자를 등록해야 합니다. 그렇지 않으면 리소스를 만드는 작업이 실패합니다.

왜 파트너 이벤트를 사용해야 하나요?

다음 요구 사항 중 하나 이상에 해당되는 경우 파트너 이벤트 기능을 사용하는 것이 좋습니다.

이벤트 게시자인 파트너

• Azure의 고객이 이벤트를 사용할 수 있게 하는 메커니즘을 원합니다. 사용자는 자신이 소유하고 관리하는 파트너 토픽 및 이벤트 구독을 사용하여 이러한 이벤트를 필터링하고 라우팅할 수 있습니다. 토픽 및 도메인과 같은 기타 통합 방법을 사용할 수 있습니다. 그러나 이러한 접근 방식은 파트너와 고객 간에 리소스 소유권, 관리 및 요금 청구를 완벽하게 분리할 수 없습니다. 또한 파트너 이벤트 기능은 서비스를 쉽게 검색할 수 있는 보다 직관적인 사용자 환경을 제공합니다.
• 이벤트를 다른 고객에게 라우팅하려면 단일 지역 엔드포인트(네임스페이스의 엔드포인트에)에 이벤트를 게시하는 간단한 다중 테넌트 모델이 필요합니다.
• 게시된 이벤트와 관련된 메트릭을 표시하려고 합니다.
• 이벤트에 클라우드 이벤트 1.0 스키마를 사용하려고 합니다.

구독자인 파트너

• 서비스가 Microsoft Azure에서 시작하는 고객 이벤트에 대응하도록 원합니다.
• 고객이 플랫폼에서 호스트하는 애플리케이션을 사용하여 Microsoft Azure 서비스 이벤트에 대응하도록 원합니다. 플랫폼의 이벤트 라우팅 기능을 사용하여 올바른 고객 솔루션에 이벤트를 전달합니다.
• 고객이 플랫폼 엔드포인트와 같은 기술 세부 정보를 알 필요 없이 서비스 이름을 대상으로 선택하는 간단한 모델을 원합니다.
• 시스템/플랫폼에서 Cloud Events 1.0 스키마를 지원합니다.

파트너가 관리하는 리소스

파트너는 다음과 같은 종류의 리소스를 관리합니다.

파트너 등록

등록에는 파트너와 관련된 일반 정보가 있습니다. 파트너 네임스페이스를 만들 때 등록이 필요합니다. 즉, Azure Event Grid와 통합하는 데 필요한 Azure 리소스를 만들려면 파트너 등록이 필요합니다.

등록은 전역적입니다. 즉, 특정 Azure 지역과 연결되지 않습니다. 단일 파트너 등록을 만들어서 파트너 네임스페이스를 만들 때 사용할 수 있습니다.

채널

채널은 파트너 네임스페이스에 중첩된 리소스입니다. 채널의 두 가지 주요 목적은 다음과 같습니다.

• 고객의 Azure 구독에서 파트너 리소스를 만들 수 있는 리소스 종류. partner topic 유형의 채널을 만들면 고객의 Azure 구독에 파트너 토픽이 만들어집니다. 파트너 토픽은 파트너 시스템에서 이벤트를 게시할 때 이벤트가 라우팅되는 고객의 리소스입니다.

  채널의 수명 주기는 연결된 고객 파트너 토픽 또는 대상과 동일합니다. 예를 들어 partner topic 유형의 채널이 삭제되면 연결된 고객의 파트너 토픽도 삭제됩니다. 마찬가지로 고객이 파트너 토픽을 삭제하면 Azure 구독의 연결된 채널이 삭제됩니다.

• 이벤트를 라우팅하는 데 사용되는 리소스. partner topic 유형의 채널은 이벤트를 고객의 파트너 토픽으로 라우팅하는 데 사용됩니다. 두 가지 유형의 라우팅 모드를 지원합니다.

  • 채널 이름 라우팅. 이 라우팅 유형을 사용하면 이벤트를 라우팅할 채널의 이름을 제공하는 aeg-channel-name이라는 http 헤더를 사용하여 이벤트를 게시합니다. 채널은 파트너 토픽에 대한 파트너의 표현이므로 채널로 라우팅된 이벤트는 고객의 파트너 토픽에 표시됩니다. 이러한 종류의 라우팅은 원본 기반 라우팅만 지원하는 event channels에는 없는 새 기능입니다. 채널 이름 라우팅을 사용하면 원본 기반 라우팅보다 더 많은 사용 사례를 구현할 수 있으며 권장하는 라우팅 모드입니다. 예를 들어 채널 이름 라우팅을 선택하는 고객은 다른 이벤트 원본에서 시작되는 이벤트를 요청하여 단일 파트너 토픽에 랜딩할 수 있습니다.
  • 원본 기반 라우팅. 이 라우팅 방법은 이벤트의 source 컨텍스트 특성 값을 기반으로 합니다. 예를 들어 원본은 채널에 매핑되고 값이 "A"인 소스와 함께 이벤트가 제공되는 경우 해당 이벤트는 원본 속성에 "A"가 포함된 채널에 연결된 파트너 토픽으로 라우팅됩니다.

  채널 및 관련 파트너 토픽으로 라우팅되는 이벤트 유형을 선언할 수 있습니다. 이벤트 유형은 파트너 토픽에 대한 이벤트 구독을 만들 때 고객에게 표시되며 이벤트 처리기 대상으로 보낼 특정 이벤트 유형을 선택하는 데 사용됩니다. 자세히 알아보기.

  Important

  이벤트 유형은 채널에서 관리할 수 있으며, 값이 업데이트되면 변경 내용이 관련 파트너 토픽에 즉시 반영됩니다.

파트너 네임스페이스

파트너 네임스페이스는 Azure Event Grid에 이벤트를 게시할 엔드포인트가 있는 지역 리소스입니다. 파트너 네임스페이스에는 채널 또는 이벤트 채널(레거시 리소스)이 포함됩니다. 채널과 해당 파트너 리소스가 동일한 지역에 있어야 하므로 고객이 파트너 토픽 또는 대상을 요청하는 지역에 파트너 네임스페이스를 만들어야 합니다. 관련 파트너 토픽이 있는 특정 지역에는 채널이 있으면 안 됩니다(예: 다른 지역에 있음).

파트너 네임스페이스에는 채널 또는 이벤트 채널이 포함됩니다. 네임스페이스의 파트너 토픽 라우팅 모드 속성에 따라 결정됩니다. 채널 이름 헤더로 설정되면 채널은 네임스페이스 아래에 만들 수 있는 유일한 리소스 종류입니다. 파트너 토픽 라우팅 모드가 이벤트의 원본 특성으로 설정되면 네임스페이스는 이벤트 채널만 포함할 수 있습니다. 올바른 partner topic routing mode 설정을 결정하는 것은 채널 이름 라우팅 또는 원본 기반 라우팅 중에 하나를 선택하는 결정이 아닙니다. 채널은 둘 다 지원합니다. 새로운 유형의 라우팅 리소스인 채널과 레거시 리소스인 이벤트 채널 중 무엇을 사용할지 결정하는 것입니다.

이벤트 채널

이벤트 채널은 들어오는 이벤트를 파트너 토픽으로 라우팅하기 위해 파트너 이벤트와 함께 처음 릴리스된 리소스입니다. 이벤트 채널은 원본 기반 라우팅만 지원하며 항상 고객 파트너 토픽을 나타냅니다.

확인된 파트너

확인된 파트너는 Microsoft에서 신원을 확인한 파트너 조직입니다. 파트너는 Microsoft의 확인을 받는 것이 좋습니다. 이러한 확인은 고객에게 합법적인 조직과 거래한다는 믿음을 주기 때문에 고객은 확인된 파트너와 함께하기를 원합니다. 확인이 완료된 파트너는 고객이 파트너의 서비스를 쉽게 검색하고 파트너의 이벤트를 구독할 때 자사 환경을 사용할 수 있는 Event Grid 갤러리에 추가됩니다.

파트너 항목을 만들 수 있는 고객의 권한 부여

고객은 Azure 구독에서 파트너 항목을 만들 수 있는 권한을 부여합니다. 권한 부여는 고객 Azure 구독의 지정된 리소스 그룹에 대해 부여되며 시간이 제한됩니다. 파트너는 고객이 설정한 만료 날짜 전에 채널을 만들어야 합니다. 이벤트를 보내거나 받도록 시스템을 구성하고 권한 부여가 만료되기 전에 채널을 만들 수 있도록 충분한 기간을 설정해 달라고 고객에게 제안하는 설명서가 있어야 합니다. 권한 부여 없이 또는 기간이 만료된 후 채널을 만들려고 시도하면 채널 만들기가 실패하고 고객의 Azure 구독에 리소스가 만들어지지 않습니다.

파트너 항목 활성화

고객은 파트너가 만든 파트너 토픽 또는 대상을 활성화합니다. 그러면 채널의 활성화 상태가 Activated로 변경됩니다. 채널이 활성화되면 파트너는 채널이 포함된 파트너 네임스페이스 엔드포인트에 이벤트 게시를 시작할 수 있습니다.

지정된 파트너 토픽에 대한 이벤트 게시를 시작할 수 있는 시기를 알아보는 프로세스를 자동화하려면 어떻게 해야 할까요?

이때 다음 두 가지 방법을 사용할 수 있습니다.

• 채널 상태를 정기적으로 읽어(폴링) 활성화 상태가 NeverActivated에서 Activated로 전환되었는지 확인합니다. 이 작업은 계산 집약적일 수 있습니다.
• 모니터링하려는 채널이 포함된 Azure 구독 또는 리소스 그룹에 대한 이벤트 구독을 만듭니다. 채널이 업데이트될 때마다 Microsoft.Resources.ResourceWriteSuccess 이벤트를 받게 됩니다. 그런 다음, 이벤트에 제공된 Azure Resource Manager ID를 사용하여 채널의 상태를 읽고 업데이트 때문에 상태가 Activated로 변경된 것이 맞는지 확인해야 합니다.

참조

• Swagger
• ARM 템플릿
• ARM 템플릿 스키마
• REST API
• CLI 확장

SDK

• .NET
• Python
• Java
• Ruby
• JS
• Go

다음 단계

• Event Grid 파트너로 온보딩하는 방법(Azure Portal)
• 파트너 토픽 온보딩 양식
• 파트너 토픽 개요
• Auth0 파트너 토픽
• Auth0 파트너 토픽을 사용하는 방법