

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

# Amazon EventBridge를 사용하여 AD용 커넥터를 이벤트 기반 애플리케이션에 통합
<a name="eventbridge-integration"></a>

AD용 커넥터에서 발생하는 이벤트를 사용하여 애플리케이션 구성 요소 간에 통신하고 다운스트림 프로세스를 시작하는 이벤트 기반 애플리케이션(EDAs)에 AD용 커넥터를 통합할 수 있습니다.

예를 들어 계정에서 다음 AD용 커넥터 이벤트가 발생할 때 다른 AWS 서비스 또는 사용자 지정 구성 요소를 호출할 수 있습니다.
+ 인증서가 생성되거나 생성이 실패할 때 생성됩니다.
+ 인증서가 등록되었거나 등록에 실패합니다.

이렇게 하려면 Amazon EventBridge를 사용하여 AD용 커넥터에서 다른 소프트웨어 구성 요소로 이벤트를 라우팅합니다. Amazon EventBridge는 이벤트를 사용하여 애플리케이션 구성 요소를 함께 연결하는 서버리스 서비스이므로 추가 코드 및 작업 없이 AD용 커넥터와 같은 AWS 서비스를 이벤트 기반 아키텍처에 더 쉽게 통합할 수 있습니다.

## EventBridge가 AD 이벤트용 커넥터를 라우팅하는 방법
<a name="eventbridge-routes-service-events"></a>

다음은 AD 이벤트용 커넥터에서 EventBridge가 작동하는 방법입니다.

많은 AWS 서비스와 마찬가지로 AD용 커넥터는 이벤트를 생성하고 EventBridge 기본 *이벤트 버스*로 전송합니다. 이벤트 버스는 이벤트를 수신하여 지정한 목적지 또는 *대상*으로 라우팅하는 라우터입니다. 대상에는 다른 AWS 서비스, 사용자 지정 애플리케이션 및 SaaS 파트너 애플리케이션이 포함될 수 있습니다.

EventBridge는 사용자가 이벤트 버스에서 생성한 *규칙*에 따라 이벤트를 라우팅합니다. 각 규칙마다 필터 또는 *이벤트 패턴*을 지정하여 원하는 이벤트만 선택할 수 있습니다. 이벤트가 이벤트 버스로 전송될 때마다 EventBridge는 이벤트를 각 규칙과 비교합니다. 이벤트가 규칙과 일치하면 EventBridge는 이벤트를 지정된 대상으로 라우팅합니다.

![AWS 서비스는 EventBridge 기본 이벤트 버스로 이벤트를 전송합니다. 이벤트가 규칙의 이벤트 패턴과 일치하면 EventBridge는 해당 규칙에 지정된 대상으로 이벤트를 라우팅합니다.](http://docs.aws.amazon.com/ko_kr/privateca/latest/userguide/images/eventbridge-integration-how-it-works.png)


## AD 이벤트용 커넥터
<a name="eventbridge-service-events"></a>

EventBridge로 전송된 AD 이벤트용 커넥터 목록은 [https://docs.aws.amazon.com/eventbridge/latest/ref/events-ref-pca-connector-ad.html](https://docs.aws.amazon.com/eventbridge/latest/ref/events-ref-pca-connector-ad.html) 참조의 AD용 커넥터 주제를 참조하세요.

### 이벤트 구조
<a name="eventbridge-event-structure"></a>

 AWS 서비스의 모든 이벤트에는 두 가지 유형의 데이터가 포함됩니다.
+ 이벤트의 소스인 AWS 서비스, 이벤트가 생성된 시간, 이벤트가 발생한 계정 및 리전 등 이벤트에 대한 메타데이터를 포함하는 공통 필드 집합. 이러한 일반 필드의 정의는 *Amazon EventBridge 이벤트 참조*의 [이벤트 구조](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)를 참조하세요.
+ 해당 특정 서비스 이벤트와 관련된 데이터를 포함한 `detail` 필드.

## AD 이벤트용 커넥터와 일치하는 이벤트 패턴 생성
<a name="eventbridge-event-delivery-filter"></a>

이벤트 패턴은 이벤트가 포함해야 하는 데이터를 지정하는 필터입니다.

각 이벤트 패턴은 다음을 포함하는 JSON 객체입니다.
+ 이벤트를 전송하는 서비스를 식별하는 `source` 속성입니다. AD 이벤트용 커넥터의 경우 소스는 입니다`aws.pca-connector-ad`.
+ (선택 사항): 일치해야 하는 이벤트 이름의 배열을 포함하는 `detail-type` 속성.
+ (선택 사항): 일치시킬 다른 이벤트 데이터를 포함하는 `detail` 속성입니다.

예를 들어 다음 이벤트 패턴은 AD용 커넥터에서 모든 인증서 정책 등록 성공 이벤트를 선택합니다.

```
{
  "source": ["aws.pca-connector-ad"],
  "detail-type": ["Certificate Policy Enrollment Succeeded"]
}
```

이벤트 작성에 대한 자세한 내용은 *EventBridge 사용 설명서*의 [이벤트 패턴](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)을 참조하세요.

## EventBridge에서 이벤트 수신
<a name="eventbridge-service-as-target"></a>

AD 인증서용 커넥터를 규칙의 대상으로 지정할 수 있습니다. 이를 통해 AD용 커넥터는 다른 AWS 서비스, 사용자 지정 애플리케이션 및 SaaS 파트너를 비롯한 다양한 소스에서 이벤트를 수신할 수 있습니다. 자세한 내용은 *EventBridge 사용 설명서*의 [이벤트에 반응하는 규칙 생성을 참조하세요](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html).

대상으로 지정할 수 있는 AWS 서비스의 전체 목록은 *EventBridge 이벤트* 참조의 [대상 유형을](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-console-targets) 참조하세요.