Node.js

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:

  1. Abra o Painel do Vonage e selecione Applications no menu à esquerda.
  2. Clique Criar um novo aplicativo.
  3. Digite um nome para o seu aplicativo (por exemplo: verify-tutorial).
  4. 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.
  5. 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.
  6. Clique Criar um novo pedido para terminar.
  7. 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:

echo "private.key" >> .gitignore

Estrutura de pastas atualizada

Após essa etapa, sua pasta “backend” ficará assim:

backend/
├── app.js
├── .env
├── .gitignore
├── private.key
├── node_modules
└── package.json