

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Integrando o Connector for AD em aplicativos orientados a eventos usando a Amazon EventBridge
<a name="eventbridge-integration"></a>

Você pode incorporar o Connector for AD em aplicativos orientados a eventos (EDAs) que usam eventos que ocorrem no Connector for AD para se comunicar entre os componentes do aplicativo e iniciar processos posteriores. 

Por exemplo, você pode invocar outros AWS serviços ou componentes personalizados quando os seguintes eventos do Connector for AD ocorrerem em sua conta:
+ Um certificado é criado ou quando a criação falha.
+ Um certificado está inscrito ou a inscrição falha.

Você faz isso usando EventBridge a Amazon para rotear eventos do Connector for AD para outros componentes de software. EventBridge A Amazon é um serviço sem servidor que usa eventos para conectar componentes do aplicativo, facilitando a integração de AWS serviços como o Connector for AD em arquiteturas orientadas por eventos sem código e operações adicionais.

## Como EventBridge roteia o Connector para eventos do AD
<a name="eventbridge-routes-service-events"></a>

Veja como EventBridge funciona com o Connector for AD events:

Como acontece com muitos AWS serviços, o Connector for AD gera e envia eventos para o *barramento de eventos EventBridge * padrão. Um barramento de eventos é um roteador que recebe eventos e os roteia para *destinos* que você especifica. Os alvos podem incluir outros AWS serviços, aplicativos personalizados e aplicativos SaaS de parceiros. 

EventBridge roteia os eventos de acordo com *as regras* que você cria no ônibus do evento. Para cada regra, você especifica um filtro, ou um *padrão de evento*, para selecionar apenas os eventos desejados. Sempre que um evento é enviado para o barramento de eventos, EventBridge compare-o com cada regra. Se o evento corresponder à regra, EventBridge roteará o evento para o (s) destino (s) especificado (s).

![\[AWS os serviços enviam eventos para o barramento de eventos EventBridge padrão. Se o evento corresponder ao padrão de eventos de uma regra, EventBridge roteará o evento para os destinos especificados para essa regra.\]](http://docs.aws.amazon.com/pt_br/privateca/latest/userguide/images/eventbridge-integration-how-it-works.png)


## Conector para eventos do AD
<a name="eventbridge-service-events"></a>

Para obter uma lista dos eventos do Connector for AD enviados EventBridge, consulte o tópico Connector for AD na [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).

### Estrutura de eventos
<a name="eventbridge-event-structure"></a>

Todos os eventos dos AWS serviços contêm dois tipos de dados:
+ Um conjunto comum de campos contendo metadados sobre o evento, como o serviço da AWS que é a origem do evento, a hora em que o evento foi gerado, a conta e a região em que o evento ocorreu, e outros. Para obter definições desses campos gerais, consulte [Estrutura de eventos na Amazon EventBridge Events](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html) *Reference*. 
+ Um campo `detail` que contém dados específicos para esse evento de serviço específico. 

## Criação de padrões de eventos que correspondam aos eventos do Connector for AD
<a name="eventbridge-event-delivery-filter"></a>

Os padrões de eventos são filtros que especificam quais dados os eventos que você deseja selecionar devem conter.

Cada padrão de evento é um objeto JSON que contém:
+ Um atributo `source` que identifica o serviço que envia o evento. Para eventos do Connector for AD, a origem é`aws.pca-connector-ad`.
+ (Opcional): um atributo `detail-type` que contém uma matriz dos nomes de eventos a serem correlacionados.
+ (Opcional): um atributo `detail` que contém quaisquer outros dados relacionados aos eventos a serem correlacionados.

Por exemplo, o padrão de evento a seguir selecionaria todos os eventos de inscrição bem-sucedida da política de certificado do Connector for AD:

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

Para obter mais informações sobre como escrever padrões de eventos, consulte [Padrões de eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) no *Guia do usuário do EventBridge *.

## Recebendo eventos de EventBridge
<a name="eventbridge-service-as-target"></a>

Você pode especificar o Conector para certificados AD como o destino de uma regra. Isso permite que o Connector for AD receba eventos de uma ampla variedade de fontes, incluindo outros AWS serviços, aplicativos personalizados e parceiros de SaaS. Para obter mais informações, consulte [Criação de regras que reagem a eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) no *Guia EventBridge do usuário*. 

Para obter uma lista completa dos AWS serviços que você pode especificar como destinos, consulte [Tipos de destino](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html#eb-console-targets) na *Referência de EventBridge eventos*. 