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

https://<site-subdomain>.api.oneall.com/socialize/connect/direct/<provider-key>/

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.

User Contributed Notes