Creación de un token de conexión — .NET

Para autenticar a un usuario que se conecta a una sesión de OpenTok, el cliente debe conectarse mediante un token (véase esta visión general).

El siguiente código .NET muestra cómo generar un token utilizando el SDK de OpenTok para .NET:

// Set the following constants with the API key and API secret
// that you receive when you sign up to use the OpenTok API:
OpenTok opentok = new OpenTok(API_KEY, API_SECRET);

//Generate a basic session. Or you could use an existing session ID.
string sessionId = opentok.CreateSession().Id

string token = opentok.GenerateToken(sessionId);

Llamada al GenerateToken() El método devuelve una cadena. Esta cadena es el token.

El siguiente código .NET muestra cómo obtener un token con el rol de «editor» y que incluya una cadena de metadatos de conexión:

// Set the following constants with the API key and API secret
// that you receive when you sign up to use the OpenTok API:
OpenTok opentok = new OpenTok(API_KEY, API_SECRET);

//Generate a basic session. Or you could use an existing session ID.
string sessionId = opentok.CreateSession().Id

// Replace with meaningful metadata for the connection.
string connectionMetadata = "username=Bob,userLevel=4";

// Generate a token. Use the Role value appropriate for the user.
string token = opentok.GenerateToken(sessionId, Role.PUBLISHER, Null, connectionMetadata);
=

El método admite los siguientes argumentos:

  • sessionId (cadena) — El identificador de sesión correspondiente a la sesión a la que se conectará el usuario.
  • role (cadena) — Opcional. Define el rol que tendrá el usuario. Hay tres roles: suscriptor, editor y moderador. Los suscriptores solo pueden suscribirse a las transmisiones de la sesión (no pueden publicar). Los editores pueden suscribirse y publicar transmisiones en la sesión, y pueden utilizar la API de señalización. Los moderadores tienen los privilegios de los editores y, además, también pueden obligar a otros usuarios a desconectarse de la sesión o a dejar de publicar. El rol por defecto (si no se pasa ningún valor) es el de editor.
  • expireTime (int) — Opcional. La hora a la que caducará el token, definida como un valor entero correspondiente a una marca de tiempo de Unix (en segundos). Si no se especifica este valor, los tokens caducan a las 24 horas de su creación. El expireTime El valor, si se especifica, debe estar dentro de un plazo de 30 días a partir de la fecha de creación.
  • data (cadena) — Opcional. Una cadena que contiene metadatos que describen la conexión. Por ejemplo, puedes pasar el ID de usuario, el nombre u otros datos que describan la conexión. Puedes obtener estos datos de una base de datos del lado del servidor o de los datos que te facilite el cliente, dependiendo de tu aplicación.