Configura tus credenciales de Vonage
Para completar este tutorial, necesitarás un Account de Vonage y una solicitud de Vonage. Si aún no tienes una Account de Vonage, puedes inscribirte y comenzar con crédito gratis.
Crear una aplicación de Vonage
Una aplicación de Vonage representa tu servicio backend y contiene las credenciales necesarias para llamar a la API de Verify.
Sigue estos pasos en el Panel de Vonage:
- Abre el panel de control de Vonage y selecciona Applications del menú de la izquierda.
- Haz clic Crear una nueva aplicación.
- Introduzca un nombre para su aplicación (por ejemplo:
verify-tutorial). - Haz clic Generar clave pública y privada.
- Se descargará automáticamente un archivo de clave privada.
- Guarda este archivo en un lugar seguro. Es necesario para generar JWT y debe permanecer en el backend.
- Desplácese hasta la sección Capacidades y active Registro de red.
- Seleccione el entorno Patio de recreo.
- Deje el resto de la configuración del Registro de Red vacía por ahora. Volveremos a ella más adelante en el tutorial.
- Haz clic Generar nueva aplicación para terminar.
- Una vez creada, copia el ID de la aplicación que aparece en el panel de control.
Importante norma de seguridad
- La clave privada nunca debe incluirse en una aplicación móvil.
- Solo el backend lo utilizará para autenticarse con Vonage.
Configurar variables de entorno
Ahora vamos a guardar las credenciales de Vonage en el .env archivo utilizado por el backend.
Abra el .env el archivo que has creado anteriormente y añade:
VONAGE_APPLICATION_ID=your_application_id_here
VONAGE_PRIVATE_KEY_PATH=./private.key
Nota: Utilizando una ruta relativa (./private.key) mantiene la portabilidad del proyecto y evita rutas específicas para cada máquina.
Explicación:
VONAGE_APPLICATION_IDel ID de la aplicación desde Vonage Dashboard.VONAGE_PRIVATE_KEY_PATH: ruta al archivo de la clave privada que se utiliza para firmar los JWT.
Coloca el archivo de clave privada descargado en la carpeta de tu backend y ponle un nombre private.key. A continuación, añádalo al .gitignore archivo:
Estructura de carpetas actualizada
Después de este paso, su carpeta backend tendrá el siguiente aspecto:
backend/
├── app.js
├── .env
├── .gitignore
├── private.key
├── node_modules
└── package.json
Primeros pasos con la autenticación silenciosa
La autenticación silenciosa lleva bastante tiempo entenderla. Este tutorial te muestra cómo crear una integración desde cero con Node.js y Kotlin.