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á. # Criação de conexões para destinos de API em EventBridge As etapas a seguir apresentam a você como criar uma conexão com um endpoint HTTPS. **Topics** + [Definir a conexão](#eb-target-connection-create-define) + [Configurar o endpoint de invocação](#eb-target-connection-create-invocation) + [Configurar a autorização do endpoint](#eb-target-connection-create-auth) + [Configurar criptografia](#eb-target-connection-create-cmkms) ## Definir a conexão 1. Abra o [console do EventBridge](https://console.aws.amazon.com/events). 1. No painel de navegação à esquerda, em **Integração**, selecione **Conexões**. 1. Escolha **Criar conexão**. 1. Na página **Criar conexão**, insira um **Nome da conexão** e uma **Descrição**. ## Configurar o endpoint de invocação Em seguida, use a seção **Configurar invocação** para especificar o tipo de API que você deseja que a conexão invoque. EventBridge conexões oferecem suporte público e privado APIs. + Para **Tipo de API**, escolha se o endpoint é uma API pública ou privada. Se você escolher uma API privada, especifique a configuração de recursos do Amazon VPC Lattice a ser usada para se conectar a ela. Em **API privada**: + Para usar uma configuração de recursos do VPC Lattice existente, escolha uma configuração de recursos no menu suspenso. + Para criar uma nova configuração de recursos do VPC Lattice, escolha **Nova configuração de recursos**. Acontece o direcionamento para o console de serviço do Amazon VPC Lattice, no qual você pode criar uma nova configuração. Para obter mais informações, consulte [Criar uma configuração de recursos](https://docs.aws.amazon.com/vpc-lattice/latest/ug/create-resource-configuration.html) no *Guia do usuário do Amazon VPC Lattice*. ## Configurar a autorização do endpoint Em seguida, especifique as configurações de autorização a serem usadas para acessar o endpoint. EventBridge suporta métodos básicos de autenticação de credenciais de OAuth cliente e chave de API. 1. Em **Configurar autorização**, escolha o tipo de endpoint ao qual você deseja se conectar. ------ #### [ Custom endpoint ] Se a conexão for com um endpoint que não seja um endpoint de parceiro, escolha **Configuração personalizada**. 1. Em **Tipo de autorização**, selecione o método de autorização a ser usado pela conexão. 1. Especifique os detalhes de configuração da autorização do método de autorização escolhido: + **Básico** Insira o **Nome de usuário** e a **Senha** a serem usados na autorização com o endpoint HTTPS. + **OAuth Credenciais do cliente** 1. Para **endpoint de OAuth autorização**, escolha se o endpoint a ser usado para autorização de conexão é um endpoint público ou privado. Se você escolher **Privado**, especifique a **configuração do recurso de OAuth endpoint privado**: + Para usar uma configuração de recursos existente, escolha uma configuração de recursos no menu suspenso. + Para criar uma nova configuração de recursos, escolha **Nova configuração de recursos**. Acontece o direcionamento para o console de serviço do Amazon VPC Lattice, no qual você pode criar uma nova configuração. Para obter mais informações, consulte [Criar uma configuração de recursos](https://docs.aws.amazon.com/vpc-lattice/latest/ug/create-resource-configuration.html) no *Guia do usuário do Amazon VPC Lattice*. 1. Especifique as seguintes informações de autorização: + Endpoint de Autorização + Método HTTP + ID de cliente + Segredo do cliente 1. Em **Parâmetros OAuth HTTP**, adicione quaisquer parâmetros adicionais a serem incluídos para autorização com o endpoint de autorização. Para fazer isso: + Selecione **Parâmetro** na lista suspensa. + Insira uma **Chave** e **Valor**. Para incluir um parâmetro adicional, escolha **Adicionar parâmetro**. + **Chave de API** Insira o **Nome da chave API** e o **Valor** associado a ser usado na autorização da chave de API. ------ #### [ Partner endpoint ] Se a conexão for com um endpoint de parceiro, escolha **Usar o modelo de parceiro**. Para obter uma lista de endpoints de parceiro disponíveis, consulte [Parceiros de destino de API](eb-api-destination-partners.md). 1. Em **Destino de parceiro**, selecione o parceiro ao qual se conectar. Em **Tipo de autorização**, EventBridge habilita os métodos de autorização disponíveis para o parceiro. 1. Em **Tipo de autorização**, selecione o método de autorização a ser usado pela conexão. 1. Especifique os detalhes de configuração da autorização do método de autorização escolhido: + **Básico** Insira o **Nome de usuário** e a **Senha** a serem usados na autorização com o endpoint HTTP. + **OAuth Credenciais do cliente** 1. Para o **endpoint de OAuth autorização**, escolha se o endpoint a ser usado para autorização de conexão é um endpoint público ou privado (VPC). Se você escolher **Privado**, especifique a **configuração do recurso de OAuth endpoint privado**: + Para usar uma configuração de recursos do VPC Lattice existente, escolha uma configuração de recursos no menu suspenso. + Para criar uma nova configuração de recursos do VPC Lattice, escolha **Nova configuração de recursos**. Acontece o direcionamento para o console de serviço do Amazon VPC Lattice, no qual você pode criar uma nova configuração. Para obter mais informações, consulte [Criar uma configuração de recursos](https://docs.aws.amazon.com/vpc-lattice/latest/ug/create-resource-configuration.html) no *Guia do usuário do Amazon VPC Lattice*. 1. Especifique as seguintes informações de autorização: + Endpoint de Autorização + Método HTTPS + ID de cliente + Segredo do cliente 1. Em **Parâmetros OAuth HTTP**, adicione quaisquer parâmetros adicionais a serem incluídos para autorização com o endpoint de autorização. Para fazer isso: + Selecione **Parâmetro** na lista suspensa. + Insira uma **Chave** e **Valor**. Para incluir um parâmetro adicional, escolha **Adicionar parâmetro**. + **Chave de API** Insira o **Nome da chave API** e o **Valor** associado a ser usado na autorização da chave de API. ------ 1. Em **Parâmetros de invocação HTTP**, adicione os parâmetros adicionais a serem incluídos na solicitação de autorização. Para adicionar um parâmetro: 1. Selecione **Parâmetro** na lista suspensa. 1. Insira uma **Chave** e **Valor**. Para incluir um parâmetro adicional, escolha **Adicionar parâmetro**. ## Configurar criptografia Por fim, especifique o tipo de chave KMS que você deseja usar EventBridge ao criptografar e descriptografar os parâmetros de autorização que ela armazena como segredo.. AWS Secrets Manager Por padrão, EventBridge usa um Chave pertencente à AWS. Para obter mais informações, consulte [Criptografia de conexões](encryption-connections.md). 1. Escolha o KMS key para usar EventBridge ao criptografar o segredo da conexão. + Escolha **Usar Chave pertencente à AWS** EventBridge para criptografar o segredo usando um Chave pertencente à AWS. Chave pertencente à AWS É um KMS key que EventBridge possui e gerencia para uso em várias AWS contas. Em geral, a menos que seja necessário auditar ou controlar a chave de criptografia que protege os recursos, uma Chave pertencente à AWS é uma boa escolha. Esse é o padrão. + Escolha **Usar chave gerenciada pelo cliente** EventBridge para criptografar o segredo usando o chave gerenciada pelo cliente que você especifica ou cria. Chaves gerenciadas pelo cliente estão KMS keys na sua AWS conta que você cria, possui e gerencia. Você tem controle total sobre essas KMS keys. 1. Especifique um existente chave gerenciada pelo cliente ou escolha **Criar um novo KMS key**. EventBridge exibe o status da chave e quaisquer aliases de chave que tenham sido associados ao especificado chave gerenciada pelo cliente. 1. Escolha **Criar conexão**. **nota** Para conexões para endpoints privados, EventBridge cria a associação de recursos necessária ao criar a conexão. Isso pode demorar até 90 segundos.