Single Sign-On allows you to securely log your users into your personally branded user portal ( https://[your-domain].voiceportals.net ) securely from your current website.
We have chosen to use JSON Web Tokens (JWT) as our SSO solution. You can get all the information you need about it at https://jwt.io
For the quick how-to of JWT and SSO with our site, we will be giving example code using PHP, using the library available at https://github.com/firebase/php-jwt.
In order to log a user in via SSO, you need to have all of this information available to you. Then, you will generate a JWT token with username and sso_key inside the payload, encoded using your API token.
Example
1
$token='your-api-token';
2
$sso_key='your-users-sso-key';
3
$username='your-users-username';
4
5
$jwt=array(
6
'username'=>$username,
7
'sso_key'=>$sso_key
8
);
9
$jwt=Firebase\JWT\JWT::encode($jwt,$token);
10
echo$jwt;
Copied!
// prints something to the effect of: // ``` eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1c2VybmFtZSI6InlvdS11c2Vycy11c2VybmFtZSIsInNzb19rZXkiOiJ5b3VyLXVzZXJzLXNzby1rZXkifQ.XdS2AAqCE5bQi6w59Rq0QUgrXC6ApjbFN0p-ZoMr-2c
1
It's that simple. You then take the $jwt variable and pop it into a URL: https://your-domain.voiceportals.net/sso/your-user-id/jwt-token
2
3
So, say your user id is 238, your domain is awesomevoip and your token is the one generated above, the URL would look like: