Invoke Registration Widget - Developer Portal

The PRIVO Registration Widget provides registration functionality for new users utilizing the PRIVO UI layout. The request properties are used as follows:

Property	Required?	Description
siteId	REQUIRED	The site/service that the User is registering for. Provided by PRIVO administrator.
mode	OPTIONAL	Set to SIMPLE if rendering widget in an iframe, otherwise, do not include in request. SIMPLE mode removes the PRIVO UI header and footer values.
siteToken	OPTIONAL	Provide this parameter if the desire is to have user redirected to PRIVO Account Settings upon completion of registration. Provided by PRIVO administrator.
redirect_uri	REQUIRED	The Client endpoint URL to redirect the User to upon completion of registration.
access_token	REQUIRED	RP client access_token requested through /oauth/token endpoint.

NOTE: If mode=SIMPLE is being utilized the redirecting of the user upon successful authentication must be handled on the partner's website. One technique is to, on the redirected partner page, add a JavaScript onload handler to process the request from PRIVO and redirect the user accordingly.

The fragment part of the redirect_uri contains the following properties.

Property	Description
serviceId	Unique identifier for the User and is the same as standard claim ‘sub’.
access_token	The User access token to make subsequent API calls, such as /userinfo.

Sample Request:

 GET {{url}}/lgs?
       siteId=999
       &mode=SIMPLE
       &redirect_uri=https://client.example.org/cb
       &access_token=eyJhbGciOiJSUzIi.......3gZthv7Y

Sample Response:

HTTP/1.1 302 Found
Location: https://client.example.org/cb?
serviceId=2f35732f467......a6735424c6e4f413d3d
&access_token=MMJGKKssey......iOiJyc2Ex