Configure suas credenciais do Vonage
Para concluir este tutorial, você precisará de um Account da Vonage e uma aplicação da Vonage. Se você ainda não tem um Account na Vonage, pode se cadastrar e começar com crédito grátis.
Criar uma aplicação da Vonage
Um aplicativo da Vonage representa seu serviço de back-end e contém as credenciais necessárias para chamar a API do Verify.
Siga estas etapas no Painel do Vonage:
- Abra o Painel do Vonage e selecione Applications no menu à esquerda.
- Clique Criar um novo aplicativo.
- Digite um nome para o seu aplicativo (por exemplo:
verify-tutorial). - Clique Gerar chave pública e chave privada.
- Um arquivo de chave privada será baixado automaticamente.
- Salve este arquivo em um local seguro. Ele é necessário para gerar JWTs e deve permanecer no backend.
- Role a página até a seção “Recursos” e ative o “Registro de Rede”.
- Selecione o ambiente Playground.
- Deixe o restante da configuração do Registro de Rede em branco por enquanto. Voltaremos a isso mais adiante neste tutorial.
- Clique Criar um novo pedido para terminar.
- Após a criação, copie o ID do aplicativo exibido no painel.
Regra importante de segurança
- A chave privada nunca deve ser incluída em um aplicativo móvel.
- Apenas o backend o utilizará para se autenticar na Vonage.
Configurar variáveis de ambiente
Agora vamos armazenar as credenciais da Vonage no .env arquivo utilizado pelo backend.
Abra o .env arquivo que você criou anteriormente e adicione:
VONAGE_APPLICATION_ID=your_application_id_here
VONAGE_PRIVATE_KEY_PATH=./private.key
Observação: Usando um caminho relativo (./private.key) mantém o projeto portátil e evita caminhos específicos de cada máquina.
Explicação:
VONAGE_APPLICATION_ID: o ID do aplicativo no Painel de Controle da Vonage.VONAGE_PRIVATE_KEY_PATH: caminho para o arquivo da chave privada usado para assinar JWTs.
Coloque o arquivo da chave privada baixado na sua pasta de backend e renomeie-o como private.key. Em seguida, adicione-o ao .gitignore arquivo:
Estrutura de pastas atualizada
Após essa etapa, sua pasta “backend” ficará assim:
backend/
├── app.js
├── .env
├── .gitignore
├── private.key
├── node_modules
└── package.json
Introdução à autenticação silenciosa
A autenticação silenciosa leva um bom tempo para ser compreendida. Este tutorial mostra como criar uma integração do zero usando Node.js e Kotlin