Direct Connect \ Social Login
Social Login allows your users to login and register with their social network accounts and gives you access to the full social network profile data. Social Login can be embedded either by using JavaScript or by using Direct Connect which works without any JavaScript or iFrames.
1. Trigger the social network authentication
Simply send your users to the Direct Connect URL to start the authentication with a social network. You could for example place that URL on a hyperlink so that users trigger the social network authentication when they click on that link.
Direct Connect URL
Placeholders
Make sure to replace the indicated placeholders by your own values.
Placeholder | Description |
---|---|
* #site-subdomain# |
The subdomain of your OneAll site. Example: myshop |
* #provider-key# |
The key of the social network to login with. Example: twitter, facebook, linkedin, vimeo [...] |
Required URL Parameters
Make sure to always specify the following URL parameters.
URL Parameter | Description |
---|---|
* service |
The service to be used, in this case social_login Example: &service=social_login |
* callback_uri |
The url encoded link to the callback script on your own server. Example: &callback_uri=https%3A%2F%2Fyour-website.com%2Fcallback.php |
Optional URL Parameters
Optionally add the following URL parameters.
URL Parameter | Description |
---|---|
scope |
Defines the permission scope to request from the social network. Default: Compiled from the options that you have ticked in your OneAll account. Example: &scope=user_birthday,user_hometown |
force_reauth |
Set to true to force the user to re-enter his social network credentials.Default: false Example: &force_reauth=true |
login_data |
Sets the login data to be used, eg. the OpenID URL. Default: none Example: &login_data=http%3A%2F%2Fmy.server.name%2Fopenidserver%2F |
2. Retrieve and use the social network profile data
a. Trigger the authentication
First send the user to the Direct Connect URL. This will trigger the authentication and the user will be prompted to login with his
social network account. After a successful authentication, our system will retrieve the user's social network profile data and
store it in a new Connection which is uniquely identified by a connection_token
.
b. Retrieve the social network profile
The user is then seamlessly redirected back to the specified callback_uri
to which
our system will add the generated connection_token
as GET
parameter.
Your callback script now uses the connection_token
to fetch the user's social network profile data by sending a HTTP request with that token to
the Connection API.
c. Use the retrieved data in your workflow
The available data can now be used to per example create a new account for that user or log the user in.