Visión general de la creación de tokens

Para autenticar a un usuario que se conecta a una sesión, la página del usuario debe enviar un token junto con el ID de la aplicación. Se genera un token para cada usuario que intente conectarse a una sesión.

Para obtener más información sobre cómo conectarse, consulta la documentación en unirse a una sesión.

Funciones

A cada ficha se le asigna un funciónque determina las capacidades del cliente que se conecta utilizando ese token. Existen tres roles:

• Suscriptor - Los clientes que se conectan con un token de suscriptor pueden conectarse a sesiones y suscribirse a flujos de otros clientes. No pueden publicar sus propios flujos en una sesión.
• Editorial - Los clientes que se conectan con un token de editor pueden conectarse a sesiones, publicar secuencias de audio y vídeo en la sesión y suscribirse a las secuencias de otros clientes.
• Solo para editores - Los clientes que se conectan con un token de sólo publicación pueden conectarse a la sesión y publicar flujos de audio y vídeo en la sesión, pero no pueden suscribirse a los flujos de otros clientes. Además, los clientes que se conectan con un token de sólo publicación no pueden envío de señales. Nota: Actualmente, los SDK del servidor admiten la creación de tokens exclusivos para editores.
• Moderador - Además de publicar y suscribirse a flujos, los moderadores se conectan en un cliente mediante la función SDK de cliente puede obligar a otros clientes a desconectarse de una sesión o a dejar de publicar transmisiones de audio y vídeo. (Se puede obligar a cualquier cliente a desconectarse o a dejar de publicar, pero solo un moderador que utilice los SDK del cliente puede llevar a cabo estas funciones de moderación). Además, los moderadores conectados pueden forzar que una o varias transmisiones de la sesión silencien el audio publicado.

Fechas de caducidad

Los tokens caducan tras un periodo de tiempo determinado (hasta 30 días). Puedes especificar el periodo de caducidad al generar el token.

Datos de conexión

Para cada token, puedes añadir una cadena que contenga metadatos que describan al cliente. Por ejemplo, puedes pasar el ID de usuario, el nombre u otros datos que describan al cliente. Estos datos se pueden obtener de una base de datos del lado del servidor o de los datos que te facilite el cliente, dependiendo de tu aplicación. La longitud de la cadena está limitada a 1000 caracteres. Estos datos no se pueden actualizar una vez establecidos.

Los SDK del cliente de Vonage Video incluyen propiedades que permiten examinar los datos de conexión de un cliente conectado a una sesión.

Buenas prácticas para generar fichas

Los tokens son fáciles de generar. Se generan mediante una función hash y tu clave secreta. Al generar un token no se realiza ninguna llamada a la API de nuestros servidores. Recomendamos:

• Generar un nuevo token para cada usuario en el momento en que intenta conectarse. Los tokens tienen un tiempo de expiración, que por defecto es 24 horas una vez creado el token. Una vez caducado, no podrás utilizar el token para conectarte a la sesión.
• No almacene fichas ni intente reutilizarlas.
• No utilices los tokens generados en la herramienta Playground en aplicaciones de producción. La estructura de los tokens de Playground es algo diferente y causará problemas cuando se utilicen en una aplicación de producción.
• Uso de datos de conexión para identificar usuarios. Los datos de conexión son una forma segura de almacenar información sobre tus usuarios (como un ID de usuario, que puede ayudarte a identificar a tus usuarios en tu aplicación).

Generación de fichas

Puede generar fichas utilizando uno de los métodos siguientes SDK del lado del servidor.