Verificar usuários usando seus números de telefone celular
A Autenticação de dois fatores do SMS (Autenticação de dois fatores) é um procedimento de verificação de segurança, que é acionado por meio de um usuário que faz logon em um site, software ou aplicativo. No processo de logon, o usuário recebe automaticamente um SMS para seu número de celular contendo um código numérico exclusivo.
Há várias organizações que fornecem esse serviço e, desde que tenham APIs REST bem documentadas, é possível integrar facilmente o AEM Forms usando os recursos de integração de dados do AEM Forms. Para o propósito deste tutorial, usei Nexmo para demonstrar o caso de uso de SMS 2FA.
As etapas a seguir foram seguidas para implementar o SMS 2FA com o AEM Forms usando o serviço Nexmo Verify.
Criar conta de desenvolvedor
Crie uma conta de desenvolvedor com Nexmo. Anote a chave da API e a chave secreta da API. Essas chaves são necessárias para chamar as APIs REST do serviço do Nexmo.
Criar arquivo Swagger/OpenAPI
A Especificação de OpenAPI (antiga Especificação do Swagger) é um formato de descrição de API para APIs REST. Um arquivo OpenAPI permite descrever toda a API, incluindo:
- Pontos de extremidade disponíveis (https://experienceleague.adobe.com/users?lang=pt-BR) e operações em cada ponto de extremidade (GET /users, POST /users)
- Parâmetros de operação Entrada e saída para cada operação Métodos de autenticação
- Informações de contato, licença, termos de uso e outras informações.
- As especificações da API podem ser escritas em YAML ou JSON. O formato é fácil de aprender e legível tanto para seres humanos quanto para máquinas.
Para criar seu primeiro arquivo swagger/OpenAPI, siga o Documentação da OpenAPI
Use o editor swagger para criar seu arquivo swagger para descrever as operações que enviam e verificam o código OTP enviado usando SMS. O arquivo swagger pode ser criado no formato JSON ou YAML. O arquivo Swagger completo pode ser baixado de aqui
Criar fonte de dados
Para integrar o AEM/AEM Forms com aplicativos de terceiros, precisamos criar fonte de dados na configuração dos serviços em nuvem.
Criar modelo de dados do formulário
A integração de dados do AEM Forms fornece uma interface intuitiva para criar e trabalhar com modelos de dados de formulário. Um modelo de dados de formulário depende de fontes de dados para o intercâmbio de dados.
O modelo de dados do formulário preenchido pode ser baixado aqui
Criar formulário adaptável
Integre as invocações POST do Modelo de dados de formulário ao formulário adaptável para verificar o número do celular inserido pelo usuário no formulário. Você pode criar seu próprio formulário adaptável e usar a invocação de POST do modelo de dados de formulário para enviar e verificar o código OTP de acordo com seus requisitos.
Se quiser usar os ativos de amostra com suas chaves de API, siga as seguintes etapas:
- Baixar o modelo de dados do formulário e importar para AEM usando gerenciador de pacotes
- Baixe o formulário adaptável de exemplo baixado aqui. Este formulário de amostra usa as invocações de serviço do modelo de dados de formulário fornecido como parte deste artigo.
- Importe o formulário para o AEM do Forms e interface do usuário de documentos
- Abra o formulário no modo de edição. Abra o editor de regras do seguinte campo
- Edite a regra associada ao campo. Forneça as chaves de API apropriadas
- Salve o formulário
- Visualizar o formulário e testar a funcionalidade