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á.

Configurando mensagens de verificação e convite

Com o Amazon Cognito, você pode personalizar SMS e enviar por e-mail mensagens de verificação e mensagens de convite de usuário para aprimorar a segurança e a experiência do usuário do seu aplicativo. Com o Amazon Cognito, você pode escolher entre verificações de links com base em código ou com um clique para atender às necessidades do seu aplicativo. Este tópico discute como você pode personalizar a autenticação multifatorial (MFA) e as comunicações de verificação no console do Amazon Cognito.

Na guia Mensagens em Modelos de mensagens, você pode personalizar:

Modelos de mensagens

Você pode usar modelos de mensagem para inserir espaços reservados em suas mensagens. O Amazon Cognito substitui os espaços reservados pelos valores correspondentes. Você pode referenciar espaços reservados do modelo universal em modelos de mensagem de qualquer tipo, embora esses valores não estejam presentes em todos os tipos de mensagem.

Uma das respostas automatizadas disponíveis com recursos avançados de segurança é notificar o usuário de que o Amazon Cognito detectou atividades potencialmente maliciosas. Você pode usar espaços reservados de modelo de segurança avançada para fazer o seguinte:

Os recursos avançados de segurança adicionam os seguintes espaços reservados que você pode inserir nos modelos de mensagem:

Personalizando a mensagem SMS

Você pode personalizar a SMS mensagem para autenticação multifator (MFA) na guia Mensagens, sob o título Modelos de mensagem.

O Amazon Cognito impõe um tamanho máximo para SMS as mensagens, incluindo o código de autenticação, de 140 a 8 UTF caracteres.

Personalizando mensagens SMS de verificação

Você pode personalizar a SMS mensagem para verificações de número de telefone editando o modelo em Deseja personalizar suas mensagens SMS de verificação? título.

O tamanho máximo da mensagem, incluindo o código de verificação, é UTF de 140 a 8 caracteres.

Personalizar mensagens de verificação de e-mail

Para verificar o endereço de e-mail de um usuário em seu grupo de usuários com o Amazon Cognito, você pode enviar ao usuário uma mensagem de e-mail com um link que pode ser selecionado ou enviar um código que possa ser inserido.

Para personalizar o assunto do e-mail e o conteúdo da mensagem para mensagens de verificação de endereço de e-mail, edite o modelo de Mensagem de verificação na guia Mensagens de seu grupo de usuários. Você pode selecionar um Tipo de verificação de Código ou Link ao editar seu modelo de Mensagem de verificação.

Se você escolher Código como tipo de verificação, sua mensagem personalizada deverá conter o espaço reservado {####}. Ao enviar a mensagem, o código de verificação substitui esse espaço reservado.

Se você escolher Link como o tipo de verificação, sua mensagem personalizada deverá conter o espaço reservado no formato {##Verify Your Email##}. Você pode alterar a string de texto entre os caracteres do espaço reservado, por exemplo, {##Click here##}. Um link de verificação intitulado Verify Your Email (Verificar seu e-mail) substitui esse espaço reservado.

O link para uma mensagem de verificação de e-mail direciona seu usuário para URL algo semelhante ao exemplo a seguir.

https://<your user pool domain>/confirmUser/?client_id=abcdefg12345678&user_name=emailtest&confirmation_code=123456

O tamanho máximo da mensagem, incluindo o código de verificação (se presente), é de 20.000 a UTF 8 caracteres. Você pode usar HTML tags nessa mensagem para formatar o conteúdo.

Como personalizar mensagens de convite a usuários

Você pode personalizar a mensagem de convite de usuário que o Amazon Cognito envia aos novos usuários por mensagem SMS de e-mail editando o modelo de mensagens de convite na guia Mensagens.

O tamanho máximo de uma SMS mensagem, incluindo o código de verificação, é UTF de 140 a 8 caracteres. O tamanho máximo de uma mensagem de e-mail, incluindo o código de verificação, é de 20.000 a UTF 8 caracteres. Você pode usar HTML tags em suas mensagens de e-mail para formatar o conteúdo.

Personalizar o endereço de e-mail

Por padrão, o Amazon Cognito envia mensagens de e-mail aos usuários dos seus grupos de usuários do endereço no-reply@verificationemail.com. Você pode optar por especificar endereços de e-mail personalizados FROM e REPLY -TO em vez de no-reply@verificationemail.com.

Autorizando o Amazon Cognito a enviar e-mails da SES Amazon em seu nome (a partir de um endereço de e-mail FROM personalizado)

Você pode configurar o Amazon Cognito para enviar e-mails de um endereço de FROM e-mail personalizado em vez do endereço padrão. Para usar um endereço personalizado, você deve dar permissão ao Amazon Cognito para enviar mensagens de e-mail a partir de uma identidade SES verificada pela Amazon. Na maioria dos casos, é possível conceder essa permissão criando uma política de autorização de envio. Para obter mais informações, consulte Como usar a autorização de envio com a Amazon SES no Guia do desenvolvedor do Amazon Simple Email Service.

Quando você configura um grupo de usuários para usar a Amazon SES para mensagens de e-mail, o Amazon Cognito cria a AWSServiceRoleForAmazonCognitoIdpEmailService função em sua conta para conceder acesso à Amazon. SES Nenhuma política de autorização de envio é necessária quando a função vinculada ao serviço AWSServiceRoleForAmazonCognitoIdpEmailService é usada. Você só precisa adicionar uma política de autorização de envio ao usar a funcionalidade de e-mail padrão em seu grupo de usuários e uma SES identidade verificada da Amazon como FROM endereço.

Para obter mais informações sobre a função vinculada ao serviço criada pelo Amazon Cognito, consulte Como usar funções vinculadas a serviço para o Amazon Cognito.

O exemplo a seguir da política de autorização de envio concede ao Amazon Cognito uma capacidade limitada de usar uma identidade SES verificada pela Amazon. O Amazon Cognito só pode enviar mensagens de e-mail quando o fizer em nome do grupo de usuários na condição aws:SourceArn e da conta na condição aws:SourceAccount. Para obter mais exemplos, consulte exemplos de políticas de autorização de SES envio da Amazon no Amazon Simple Email Service Developer Guide.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "stmnt1234567891234",
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "email.cognito-idp.amazonaws.com"
                ]
            },
            "Action": [
                "SES:SendEmail",
                "SES:SendRawEmail"
            ],
            "Resource": "<your SES identity ARN>",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "<your account number>"
                },
                "ArnLike": {
                    "aws:SourceArn": "<your user pool ARN>"
                }
            }
        }
    ]
}

O console do Amazon Cognito adiciona uma política semelhante para você quando você seleciona uma SES identidade da Amazon no menu suspenso. Se você usar o CLI ou API para configurar o grupo de usuários, deverá anexar uma política estruturada como no exemplo anterior à sua Amazon SES Identity.