Direct Connect \ Social Login
1. Trigger the social network authentication
To start the authentication with a social network you only need to send yours users to a specific URL called Direct Connect URL. You could for example place that URL on a hyperlink so that users trigger the social network authentication when they click on the link.
Your must replace the following placeholders in the Direct Connect URL by your own values.
The subdomain of your OneAll site.
The key of the social network to login with.
Example: twitter, facebook, linkedin, vimeo [...]
Required URL Parameters
You must add the following URL parameters to the Direct Connect URL.
|Required URL Parameter||Description|
The service to be used , must be
The url encoded link to the callback script on your server.|
Upon successful authentication with his social network account, the user is redirected back to the specified
to which the OneAll API adds the
callback_uri is a link to a script hosted your server. The purpose of that script is to read the
and to fetch the user's social network profile data by sending a HTTP request with that token to the Read Connection Details
resource of the OneAll API.
Optional URL Parameters
There are a number of optional URL parameters can be added to the Direct Connect URL.
|Optional URL Parameter||Description|
Defines the permission scope to request from the social network.
Default: Compiled from the options that you have ticked in your OneAll account.
Sets the login data to be used, eg. the OpenID URL.
2. Retrieve the user's social network profile data
Upon successful authentication with a social network account, users will be redirected back to the
callback_uri to which the
OneAll API will add the url parameter
connection_token. This token uniquely identifies the user's connection with his social
The callback script then uses the
connection_token to fetch the user's social network profile data by sending a HTTP request with that token to
the OneAll API.