Gerenciamento de identidades no Amazon SES

No console do Amazon SES, você pode exibir uma lista de identidades para exibir e editar suas configurações de detalhes, associar um conjunto de configurações padão ou excluir uma ou mais identidades.

nota

Os procedimentos descritos nesta seção se aplicam somente às identidades na Região da AWS selecionada. Para gerenciar identidades que foram criadas em mais de uma região, repita os procedimentos para cada Região da AWS.

Visualização de uma lista de identidades no Amazon SES

Você pode usar o console ou a API do Amazon SES para visualizar uma lista de identidades de domínio e endereço de e-mail verificadas ou aguardando verificação. Você também pode visualizar as indetidades para os quais a verificação não foi bem-sucedida.

Para visualizar suas identidades de domínio e endereço de e-mail (console)

1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

2. No console, use o seletor de regiões para escolher a Região da AWS para a qual deseja visualizar sua lista de identidades.

   nota

   Este procedimento só exibe uma lista das identidades para a Região da AWS selecionada.

3. No painel de navegação, em Configuration (Configuração), escolha Verified identities (Identidades verificadas). A tabela Loaded identities (Identidades carregadas) exibe as identidades de domínio e de endereço de e-mail. A coluna Status (Situação) mostra se uma identidade foi verificada, está com verificação pendente ou se foi reprovada no processo de verificação. As definições de todos os valores de status possíveis são as seguintes:

   • Verified (Verificado): sua identidade é verificada com sucesso para envio no SES.

   • Failure (Falha): a SES não conseguiu verificar sua identidade. Se for um domínio, significa que o SES não conseguiu detectar os registros DNS dentro de 72 horas. Se for um endereço de e-mail, significa que o e-mail de verificação enviado para o endereço de e-mail não foi reconhecido dentro de 24 horas.

   • Pending (Pendente): o SES ainda está tentando verificar a identidade.

   • Temporary Failure (Falha temporária): para um domínio verificado anteriormente, o SES verificará periodicamente o registro DNS necessário para verificação. Se, em algum momento, o SES não conseguir detectar o registro, o status muda paraTemporary Failure (Falha temporária). O SES verificará novamente o registro DNS por 72 horas, e, se não for possível detectar o registro, o status do domínio muda para Failure (Falha). Se for capaz de detectar o registro, o status do domínio muda para Verified (Verificado).

   • Not started (Não iniciado): você ainda não iniciou o processo de verificação.

4. Para classificar identidades por status de verificação, escolha a coluna Status.

5. Para visualizar a página de detalhes de uma identidade, selecione a identidade que deseja visualizar.

Exclusão de uma identidade no Amazon SES

Você pode usar o console ou a API do Amazon SES para remover uma identidade de domínio ou de endereço de e-mail da sua conta na Região da AWS selecionada.

Para remover uma identidade de domínio ou de endereço de e-mail (console)

1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

2. No console, use o seletor de regiões para escolher a Região da AWS da qual deseja excluir uma ou mais identidades.

3. No painel de navegação, em Configuration (Configuração), escolha Verified identities (Identidades verificadas).

   A tabela Loaded identities (Identidades carregadas) exibe uma lista das identidades de domínio e de endereço de e-mail.

4. Na coluna Identidade, selecione a identidade a ser excluída. Você pode excluir várias identidades marcando a caixa ao lado de cada identidade que deseja excluir.

5. Escolha Delete (Excluir).

Edição de uma identidade existente no Amazon SES

Você pode usar o console ou a API do Amazon SES para editar uma identidade de domínio ou de endereço de e-mail da sua conta na selecionada Região da AWS.

Para editar uma identidade de domínio ou de endereço de e-mail (console)

1. Faça login no AWS Management Console e abra o console do Amazon SES em https://console.aws.amazon.com/ses/.

2. No console, use o seletor de regiões para escolher a Região da AWS a partir da qual deseja editar uma ou mais identidades.

3. No painel de navegação, em Configuration (Configuração), escolha Verified identities (Identidades verificadas).

   A tabela Loaded identities (Identidades carregadas) exibe uma lista das identidades de domínio e de endereço de e-mail.

4. Na coluna Identity (Identidade), selecione a identidade que você deseja editar (clicando diretamente no nome da identidade em vez de marcar sua caixa de seleção).

5. Na página de detalhes da identidade, selecione a guia que contém as categorias que você gostaria de editar.

6. Em qualquer um dos contêineres de categoria da guia selecionada, escolha o botão Edit (Editar) do atributo que você deseja editar, faça suas alterações e escolha Save changes (Salvar as alterações).

   1. Se você deseja editar atributos na guia Authentication (Autenticação), e sua identidade de domínio está hospedada no Amazon Route 53, e você ainda não publicou seus registros de DNS, haverá um botão Publish DNS records to Route53 (Publicar registros DNS no Route53) ao lado do botão Edit (Editar) em um ou ambos os contêineres DomainKeys Identified Mail (DKIM) (Correio identificado DomainKeys DKIM) ou Custom MAIL FROM domain (Customizar domínio E-MAIL DE).

      nota

      A guia Authentication (Autenticação) só está presente quando sua conta tem um domínio verificado ou um endereço de e-mail que use um domínio verificado em sua conta.

   2. Você pode publicar os registros de DNS diretamente a partir do botão Publish DNS records to Route53 (Publicar registros de DNS no Route53). Basta clicar nele, um banner de confirmação será exibido e o botão Publish DNS records to Route53 (Publicar registros de DNS no Route53) não estará mais visível para o respectivo contêiner.

7. Repita as etapas 5 e 6 para cada atributo de identidade que você gostaria de editar.

Edite uma identidade para usar um conjunto de configurações padrão usando a API

Você pode usar a operação PuteMailIdentityConfigurationSetAttributes para adicionar ou remover um conjunto de configurações padrão de uma identidade de e-mail existente.

nota

Antes de concluir os procedimentos desta seção, é necessário instalar e configurar a AWS CLI. Para obter mais informações, consulte o Guia do usuário do AWS Command Line Interface.

Para adicionar um conjunto de configurações padrão usando a AWS CLI

• Na linha de comando, insira o seguinte comando para usar a operação PuteMailIdentityConfigurationSetAttributes.

aws sesv2 put-email-identity-configuration-set-attributes --email-identity ADDRESS-OR-DOMAIN --configuration-set-name CONFIG-SET

Nos comandos anteriores, substitua ADDRESS-OR-DOMAIN pela identidade do e-mail que você deseja verificar. Substitua CONFIG-SET pelo nome do conjunto de configurações que você deseja definir como o conjunto de configurações padrão para a identidade.

Se o comando for executado com êxito, ele será encerrado sem fornecer nenhuma saída.

Para remover um conjunto de configurações padrão usando o AWS CLI

• Na linha de comando, insira o seguinte comando para usar a operação PuteMailIdentityConfigurationSetAttributes.

aws sesv2 put-email-identity-configuration-set-attributes --email-identity ADDRESS-OR-DOMAIN

Nos comandos anteriores, substitua ADDRESS-OR-DOMAIN pela identidade do e-mail que você deseja verificar.

Se o comando for executado com êxito, ele será encerrado sem fornecer nenhuma saída.

Recupere o conjunto de configurações padrão usado pela identidade (API)

Você pode usar a operação GetEmailIdentity para retornar o conjunto de configurações padrão para uma identidade de e-mail, se aplicável.

nota

Antes de concluir os procedimentos desta seção, é necessário instalar e configurar a AWS CLI. Para obter mais informações, consulte o Guia do usuário do AWS Command Line Interface.

Para retornar um conjunto de configurações padrão usando o AWS CLI

• Na linha de comando, insira o comando a seguir para usar a operação GetEmailIdentity (ObterIdentidadeE-mail).

aws sesv2 get-email-identity --email-identity ADDRESS-OR-DOMAIN

Nos comandos anteriores, substitua ADDRESS-OR-DOMAIN pela identidade de e-mail para a qual você deseja saber o conjunto de configurações padrão, se houver.

Se o comando for executado com êxito, ele fornecerá um objeto JSON com os detalhes da identidade do e-mail.

Substitua o conjunto de configurações padrão usado pela identidade (API)

Você pode usar a operação SendEmail para enviar emails com um conjunto de configurações diferente. Se você fizer isso, o conjunto de configurações que você especificar substituirá o conjunto de configurações padrão para a identidade.

nota

Antes de concluir os procedimentos desta seção, é necessário instalar e configurar a AWS CLI. Para obter mais informações, consulte o Guia do usuário do AWS Command Line Interface.

Para substituir um conjunto de configurações padrão usando o AWS CLI

• Na linha de comando, insira o comando a seguir para usar a operação SendEmail (EnviarE-mail).

aws sesv2 send-email --destination file://DESTINATION-JSON --content file://CONTENT-JSON --from-email-address ADDRESS-OR-DOMAIN --configuration-set-name CONFIG-SET

Nos comandos anteriores, substitua DESTINATION-JSON (DESTINO-JSON) pelo seu arquivo JSON de destino, CONTENT-JSON (CONTEÚDO-JSON) pelo seu arquivo JSON de conteúdo, ADDRESS-OR-DOMAIN (ENDEREÇO-OU-DOMÍNIO) pelo seu endereço de e-mail FROM (DE) e CONFIG-SET (CONJ-CONFIG) pelo o nome do conjunto de configurações que deseja usar em vez do conjunto de configurações padrão da identidade.

Se o comando for executado com êxito, ele produzirá um MessageId.