Description

You can construct a link on your page so that the user can manage personal data. This documentation will show you how to construct secured URLs to link to the following services:

  • Edit account
  • Edit social networks
  • Reset my password
  • Change my email
  • Change my mobile phone
  • Cancel account
  • Complete account

In most cases you only need to connect to the edit account endpoint, as this endpoint contains links to the rest of user actions (except for completing account, this endpoint is designed for other purposes, see complete account for more info).

Endpoint URL:

 GET https://{your-endpoint-domain.com}/register/{logged_user_input}

Request parameters

To create the edit account link, you have to construct a URL with the following GET parameters:

ParameterDescriptionType
nextURL encoded redirection authorization URL after data editing if it’s been successful (see below how is constructed).string
cancel_urlURL encoded redirection authorization URL after data editing if there’s been an error in the process or it’s been cancelled (see below how is constructed).string
scope (optional) the section with which to configure the data editing.string
oauth_tokenThe user’s access_token, with which to access their private information.string

{logged_user_input} possible values

You will have to replace the value with one of the following, depending on which service you would like to access.

ValueDescription
edit_account_inputLink to give the access to the user to change the personal data.
edit_account_social_inputLink to give the access to the user to manage the social networks.
edit_account_password_inputLink to give the access to the user to change the password.
edit_account_email_inputLink to give the access to the user to change the email.
edit_account_mobile_inputLink to give the access to the user to change the mobile phone.
edit_account_unsubscribe_inputLink to give the access to the user to cancel the account.

How to construct {next_url} and {cancel_url} parameters:

All the redirection URLs in DRUID are checked before carrying out the redirection. So that you can construct the URL, you need to use the parameters mentioned above.

The format of the next and cancel URL is the following and must be URL encoded:

https://{your-endpoint-domain.com}/oauth2/authorize/redirect?client_id={your_client_id}&redirect_uri={your_redirect_uri}

{next_url} and {cancel_url} parameters:

ParameterDescriptionType
client_idIdentifier of the client application.string
redirect_uriin accordance with which, Auth Server will construct the final redirection.string

Example:

So a final example of the URL would be the following.

Response

The server checks that the entry parameters are correct, and after that it redirects the user browser to his profile page.

Once the user updates his profile page, the OAuth server sends the control of the browser to the app by GET to the URL that  received in redirect_uri parameter.