Documentation

Support

Vivox Core SDK

Vivox Core SDK

Generate a token on the client

Generate Vivox Access Tokens on the client.
Read time 1 minuteLast updated 20 hours ago

To generate your access token, call
vx_debug_generate_token()
with the following parameters:
  • The issuer
  • The expiration time in epoch seconds since January 1, 1970 UTC
  • The action (for example, "mute")
  • A serial number (a simple static incrementing counter is adequate - this allows for the generation of more than one request in the same second for the same set of claims)
  • An optional subject (the target for kick and mute actions, null otherwise)
  • The from URI (always the signing in or signed in user URI - required for all actions)
  • The to URI (null for the login action, and the channel URI for join, kick, and mute)
  • A pointer to a buffer holding the token signing key
  • The length of the token signing key
The following examples display access tokens for login, join, join_muted, kick, and mute, respectively:
static long long serialNumber = 0;// Loginrequest->access_token = vx_debug_generate_token("issuer", time(NULL) + 120, "login", serialNumber++, NULL, "sip:.issuer.me.@mt1s.vivox.com", NULL, (const unsigned char *)key, (int)strlen(key));// Joinrequest->access_token = vx_debug_generate_token("issuer", time(NULL) + 120, "join", serialNumber++, NULL, "sip:.issuer.me.@mt1s.vivox.com", "sip:confctl-g-issuer.lobby@mt1s.vivox.com", (const unsigned char *)key, (int)strlen(key));// Join Mutedrequest->access_token = vx_debug_generate_token("issuer", time(NULL) + 120, "join_muted", serialNumber++, NULL, "sip:.issuer.me.@mt1s.vivox.com", "sip:confctl-g-issuer.lobby@mt1s.vivox.com", (const unsigned char *)key, (int)strlen(key));// Kickrequest->access_token = vx_debug_generate_token("issuer", time(NULL) + 120, "kick", serialNumber++, "sip:.issuer.them.@mt1s.vivox.com", "sip:.issuer.me.@mt1s.vivox.com", "sip:confctl-g-issuer.lobby@mt1s.vivox.com", (const unsigned char *)key, (int)strlen(key));// Muterequest->access_token = vx_debug_generate_token("issuer", time(NULL) + 120, "mute", serialNumber++, "sip:.issuer.them.@mt1s.vivox.com", "sip:.issuer.me.@mt1s.vivox.com", "sip:confctl-g-issuer.lobby@mt1s.vivox.com", (const unsigned char *)key, (int)strlen(key));// Transcriptionrequest->access_token = vx_debug_generate_token("issuer", time(NULL) + 120, "trxn", serialNumber++, NULL, "sip:.issuer.me.@mt1s.vivox.com", "sip:confctl-g-issuer.lobby@mt1s.vivox.com", (const unsigned char *)key, (int)strlen(key));