Azure Portal을 사용하여 Azure Event Grid 파트너로 온보딩

이 문서에서는 파트너 라고도 하는 타사 SaaS 공급자가 Event Grid에 온보딩되어 서비스에서 이벤트를 게시하는 방법과 최종 사용자가 해당 이벤트를 사용하는 방법을 설명합니다.

파트너를 위한 온보딩 프로세스

간단히 말해서, 사용자가 서비스의 이벤트를 사용할 수 있도록 설정하려면 일반적으로 다음 프로세스가 포함됩니다.

1. Event Grid 서비스 팀에 파트너가 되는 것에 대한 관심을 전달합니다.

2. Azure 구독에 Event Grid 리소스 공급자를 등록 합니다.

3. 파트너 등록을 만듭니다.

4. 네임스페이스를 만듭니다.

5. 한 단계로 채널 및 파트너 토픽 을 만듭니다.

   중요합니다

   파트너 토픽을 지원하는 이벤트 채널(레거시)을 만들 수 있습니다. 채널 은 새로운 라우팅 리소스 유형이며 파트너 토픽을 통해 이벤트를 보내는 두 가지 모두를 지원하는 기본 옵션입니다. 이벤트 채널은 레거시 리소스이며 곧 더 이상 사용되지 않습니다.

6. 파트너 이벤트 기능을 전 과정에 걸쳐 테스트합니다.

5단계의 경우 제공하려는 사용자 환경의 종류를 결정해야 합니다. 다음과 같은 옵션이 있습니다.

• SDK 및/또는 REST API를 사용하여 도메인에서 호스트되는 웹 GUI(그래픽 사용자 인터페이스) 환경인 고유한 솔루션을 제공하여 채널(최신 및 권장) /이벤트 채널(레거시) 및 해당 파트너 토픽을 만듭니다. 이 옵션을 사용하면 파트너 토픽을 만들 구독 및 리소스 그룹을 사용자에게 요청할 수 있습니다.
• Azure Portal 또는 CLI를 사용하여 채널(권장)/이벤트 채널(레거시) 및 관련 파트너 토픽을 만듭니다. 이 옵션을 사용하여 Azure 구독의 임의 방법으로 파트너 토픽을 만들 리소스 그룹에 있어야 합니다.

이 문서에서는 Azure Portal을 사용하여 Azure Event Grid 파트너로 온보딩하는 방법을 보여 줍니다.

파트너가 되는 것에 대한 관심 전달

파트너 되기에 대한 관심을 전달하려면 Event Grid 팀에 askgrid@microsoft.com 문의하세요. 파트너 이벤트의 사용 사례, 가상 사용자, 온보딩 프로세스, 기능, 가격 책정 등에 대한 자세한 정보를 제공하는 대화가 진행됩니다.

필수 조건

남은 단계를 완료하려면 다음 항목이 있는지 확인하세요.

• Azure 구독. 구독이 없으면 시작하기 전에 계정을 만드세요.
• Azure 테넌트입니다.

Event Grid 리소스 공급자 등록

이전에 Event Grid를 사용하지 않은 경우 Event Grid 리소스 공급자를 등록해야 합니다. 이전에 Event Grid 사용한 경우 다음 섹션으로 건너뜁니다.

Azure Portal에서 다음 단계를 수행합니다.

1. 왼쪽 메뉴에서 구독을 선택합니다.

2. 구독 목록에서 Event Grid에 사용할 구독을 선택합니다.

3. 구독 페이지의 왼쪽 메뉴에 있는 설정에서 리소스 공급자를 선택합니다.

4. Microsoft.EventGrid를 검색하고 상태가 등록되지 않음인지 확인합니다.

5. 공급자 목록에서 Microsoft.EventGrid를 선택합니다.

6. 명령 모음에서 등록을 선택합니다.

   

7. 새로 고침하여 Microsoft.EventGrid의 상태가 Registered로 변경되었는지 확인합니다.

   

파트너 등록 만들기

1. Azure Portal에 로그인합니다.

2. 왼쪽 탐색 창에서 모든 서비스를 선택한 다음 검색 창에서 Event Grid 파트너 등록 을 입력하고 선택합니다.

3. Event Grid 파트너 등록 페이지에서 명령 모음에서 + 만들기를 선택하거나 페이지의 Event Grid 파트너 등록 만들기 링크를 선택합니다.

   

4. 파트너 토픽 유형 등록 만들기 - 기본 사항 페이지에서 다음 정보를 입력합니다.

   1. 프로젝트 세부 정보 섹션에서 다음 단계를 수행합니다.
      1. Azure 구독을 선택합니다.
      2. 기존 Azure 리소스 그룹을 선택하거나 새 리소스 그룹을 만듭니다.
   2. 등록 세부 정보 섹션에서 다음 단계를 수행합니다.
      1. 등록 이름 필드에 등록할 이름을 입력합니다.
      2. 조직 이름의 경우 조직의 이름을 입력합니다.
   3. 파트너 리소스 종류 섹션에서 파트너항목 만들기 페이지에 표시될 리소스 종류에 대한 세부 정보를 입력합니다.

      1. 파트너 리소스 종류 이름의 경우 리소스 종류에 대한 이름을 입력합니다.

      2. 표시 이름에 파트너 토픽(리소스) 형식에 대한 사용자에게 친숙한 표시 이름을 입력합니다.

      3. 리소스 종류에 대한 설명을 입력합니다.

      4. 시나리오에 대한 설명을 입력합니다. 리소스에 대한 파트너 토픽을 사용할 수 있는 방법 또는 시나리오를 설명해야 합니다.

         

5. 페이지 아래쪽에서 다음: 사용자 지정 서비스를 선택합니다. 파트너 등록 만들기 페이지의 고객 서비스 탭에서 이벤트 원본에 문제가 있는 경우 구독자 사용자가 사용자에게 연락하는 데 사용할 정보를 입력합니다.

   1. 전화 번호를 입력합니다.

   2. 전화 번호의 내선 번호를 입력합니다.

   3. 지원 웹 사이트 URL을 입력합니다.

      

6. 다음: 페이지 아래쪽에 있는 태그를 선택합니다.

7. 태그 페이지에서 다음 값을 구성합니다.

   1. 추가할 태그의 이름과값을 입력합니다. 이 단계는 선택 사항입니다.
   2. 페이지 아래쪽에서 검토 + 만들기 를 선택하여 등록(파트너 토픽 유형)을 만듭니다.

8. 검토 + 만들기 페이지에서 모든 설정을 검토한 다음 만들기를 선택하여 파트너 등록을 만듭니다.

파트너 네임스페이스 만들기

1. Azure Portal의 왼쪽 탐색 메뉴에서 모든 서비스를 선택한 다음 검색 창에 Event Grid 파트너 네임스페이스를 입력한 다음 목록에서 선택합니다.

2. Event Grid 파트너 네임스페이스 페이지에서 도구 모음에서 + 만들기를 선택합니다.

   

3. 파트너 네임스페이스 만들기 - 기본 사항 페이지에서 다음 정보를 지정합니다.

   1. 프로젝트 세부 정보 섹션에서 다음 단계를 수행합니다.

      1. Azure 구독을 선택합니다.
      2. 기존 리소스 그룹을 선택하거나 리소스 그룹을 만듭니다.

   2. 네임스페이스 세부 정보 섹션에서 다음 단계를 수행합니다.

      1. 네임스페이스의 이름을 입력합니다.

      2. 네임스페이스의 위치를 선택합니다.

      3. 파트너 토픽 라우팅 모드의 경우 이벤트에서 채널 이름 헤더 또는 원본 특성을 선택합니다.

         • 채널 이름 헤더 라우팅: 이러한 종류의 라우팅을 사용하면 이벤트를 라우팅할 채널의 이름을 제공하는 http 헤더 aeg-channel-name 를 사용하여 이벤트를 게시합니다. 이 옵션을 선택하면 채널을 네임스페이스에 만듭니다.
         • 이벤트 라우팅의 원본 특성 입니다. 이 라우팅 방법은 이벤트의 컨텍스트 특성 값을 source 기반으로 합니다. 이 옵션을 선택하면 이벤트 채널을 만들게 됩니다. 이 채널은 채널 과 동일한 레거시이며 곧 더 이상 사용되지 않습니다.

         중요합니다

         • 네임스페이스를 만든 후에는 라우팅 모드를 업데이트할 수 없습니다.
         • 채널 은 새 라우팅 리소스 종류이며 기본 설정 옵션입니다. 이벤트 채널은 레거시 리소스이며 곧 더 이상 사용되지 않습니다.

   3. 등록 세부 정보 섹션에서 다음 단계에 따라 네임스페이스를 파트너 등록과 연결합니다.

      1. 파트너 등록이 있는 구독 을 선택합니다.
      2. 파트너 등록이 포함된 리소스 그룹을 선택합니다.
      3. 드롭다운 목록에서 파트너 등록 을 선택합니다.

   4. 다음: 페이지 아래쪽에 있는 태그를 선택합니다.

      

4. 태그 페이지에서 태그 를 추가합니다(선택 사항).

   1. 추가할 태그의 이름과값을 입력합니다. 이 단계는 선택 사항입니다.
   2. 페이지 아래쪽에서 검토 + 만들기를 선택합니다.

5. 검토 + 만들기 페이지에서 세부 정보를 검토하고 만들기를 선택합니다.

채널 만들기

파트너 토픽 라우팅 모드에 대한 채널 이름 헤더를 선택한 경우 이 섹션의 단계에 따라 채널을 만듭니다.

1. 만든 파트너 네임스페이스의 개요 페이지로 이동하고 명령 모음에서 + 채널을 선택합니다.

   

2. 채널 만들기 - 기본 사항 페이지에서 다음 단계를 수행합니다.

   1. 채널의 이름을 입력합니다. 채널 이름은 생성된 지역에서 고유해야 합니다.

   2. 채널 유형에 대해 파트너 토픽을 선택합니다.

      파트너 항목은 게시된 이벤트를 보유하는 리소스입니다. 나중에 처리기에서 처리할 이벤트를 보유하는 파트너 토픽에 이벤트를 전달하려면 파트너 토픽을 선택합니다.

   3. 파트너 토픽을 선택한 경우 다음 세부 정보를 입력합니다.

      1. 파트너 토픽이 만들어질 구독의 ID입니다.

      2. 파트너 토픽이 생성될 리소스 그룹입니다.

      3. 파트너 토픽의 이름입니다.

      4. 파트너 토픽의 원본 정보를 지정합니다. 원본은 최종 사용자가 볼 수 있는 파트너가 제공하는 이벤트 원본에 대한 컨텍스트 정보입니다. 이 정보는 최종 사용자가 파트너 토픽을 활성화하는 것을 고려할 때 유용합니다.

         

      5. 이벤트 유형 정의 추가를 선택하여 채널 및 관련 파트너 토픽으로 전송되는 이벤트의 종류를 선언합니다. 이벤트 유형은 파트너 토픽에서 이벤트 구독을 만들 때 고객에게 표시되며 이벤트 처리기 대상으로 보낼 특정 이벤트 유형을 선택하는 데 사용됩니다.

         

         

         

   4. 다음: 페이지 아래쪽의 추가 기능 링크를 선택합니다.

   5. 추가 기능 페이지에서 다음 단계를 수행합니다.

      1. 최종 사용자가 연결된 파트너 토픽을 활성화하는 데 도움이 되는 사용자 고유의 활성화 메시지를 설정하려면 사용자 고유의 활성화 메시지 설정 옆의 확인란을 선택하고 메시지를 입력합니다.
      2. 만료 시간 동안 이 채널을 만든 후 최종 사용자가 활성화하지 않으면 연결된 파트너 토픽과 이 채널이 자동으로 삭제되는 시간을 설정합니다. 1. 다음 선택 : 검토 + 만들기.

      

   6. 검토 + 만들기 페이지에서 채널의 모든 설정을 검토하고 페이지 아래쪽에서 만들기를 선택합니다.

      파트너 토픽 옵션:

채널 관리

채널을 만든 경우 리소스가 만들어지면 구성을 업데이트할 수 있습니다.

1. 채널의 구성 으로 이동합니다. 파트너 토픽 활성화, 활성화되지 않은 경우 만료 시간 및 이벤트 유형 정의에 대한 메시지를 업데이트할 수 있습니다.

   

이벤트 채널 만들기

파트너 토픽 라우팅 모드에 대한 이벤트에서 원본 특성을 선택한 경우 이 섹션의 단계에 따라 이벤트 채널을 만듭니다.

1. 만든 네임스페이스의 개요 페이지로 이동합니다.

   partner-namespace-overview.png

2. 도구 모음에서 + 이벤트 채널을 선택합니다.

3. 이벤트 채널 만들기 - 기본 사항 페이지에서 다음 정보를 지정합니다.

   1. 채널 세부 정보 섹션에서 다음 단계를 수행합니다.

      1. 이벤트 채널 이름의 경우 이벤트 채널의 이름을 입력합니다.
      2. 원본을 입력합니다. 원본에 적합한 값에 대한 아이디어를 얻으려면 클라우드 이벤트 1.0 사양 을 참조하세요. 또한 이 클라우드 이벤트 스키마 예제를 참조하세요.

   2. 대상 세부 정보 섹션에서 이 이벤트 채널에 대해 만들 대상 파트너 토픽에 대한 세부 정보를 입력합니다.

      1. 파트너 토픽이 생성될 구독의 ID를 입력합니다.
      2. 파트너 토픽 리소스를 만들 리소스 그룹의 이름을 입력합니다.
      3. 파트너 토픽의 이름을 입력합니다.

   3. 다음: 페이지 아래쪽의 필터를 선택합니다.

      

4. 필터 페이지에서 필터를 추가합니다. 다음 단계를 수행합니다.

   1. 각 이벤트의 특성을 필터링합니다. 모든 필터와 일치하는 이벤트만 배달됩니다. 최대 25개의 필터를 지정할 수 있습니다. 비교는 대/소문자를 구분하지 않습니다. 필터에 사용되는 유효한 키는 이벤트 스키마에 따라 달라집니다. 다음 예제에서는 eventid, source, eventtype, 및 eventtypeversioin를 키로 사용할 수 있습니다. 데이터 페이로드 내에서 .를 중첩 연산자로 사용하여 사용자 지정 속성을 사용할 수도 있습니다. 예: data, data.key, data.key1.key2.

   2. 다음: 페이지 아래쪽의 추가 기능을 선택합니다.

      

5. 추가 기능 페이지에서 파트너 토픽에 대한만료 시간 및 설명을 설정할 수 있습니다.

   1. 만료 시간은 고객이 활성화하지 않으면 토픽 및 관련 이벤트 채널이 자동으로 삭제되는 시간입니다. 시간이 제공되지 않는 경우 기본값인 7일이 사용됩니다. 확인란을 선택하여 고유한 만료 시간을 지정합니다.

   2. 이 항목은 사용자가 만들지 않은 리소스이므로 설명 은 사용자가 이 항목의 특성을 이해하는 데 도움이 될 수 있습니다. 설정되지 않은 경우 일반 설명이 제공됩니다. 확인란을 선택하여 고유한 파트너 토픽 설명을 설정합니다.

   3. “다음: 검토 + 만들기”를 선택합니다.

      

6. 검토 + 만들기에서 설정을 검토하고 만들기를 선택하여 이벤트 채널을 만듭니다.

파트너 토픽 활성화

사용자가 Azure 구독에서 만든 파트너 토픽을 구독하기 전에 먼저 파트너 토픽을 활성화합니다. 자세한 내용은 파트너 항목 활성화를 참조하세요.

다음 단계

파트너 이벤트 기능에 대한 자세한 내용은 다음 문서를 참조하세요.

• 고객을 위한 파트너 이벤트 개요
• 파트너에 대한 파트너 이벤트 개요
• 파트너 이벤트 구독
• Auth0 이벤트 구독