Adding a Custom Provider Button

For more authentication options on your site, you may add OpenID providers to the Social Login UI. Find out more about becoming an OpenID Provider here.

To add a custom provider button, configure the following settings:




Set customOpenid to true to use the custom OpenID settings.


Use this to set the flow. Enter the name of a valid flow file (for example: openid).


Use this to create the button text (usually, the Identity Provider name).
The default text is “Sign In”.

Note: Long provider names will be truncated. Also, a leading symbol is needed when adding an apostrophe to text (for example: Provider’s).


Use this setting to define the color of the button text. Use a standard webcolor hexadecimal value (for example: #729fcf).


An ID that you create to use for keying configuration objects in the multi-custom OpenID scenario, or to call the trigger flow. For example: yourCustomId.


This URL must point to a valid OpenID endpoint.


Use this setting to pass information to the provider as JSON.


Enter the full path to a large icon image for the provider. Other Janrain provider icons are 128×128 pixels. This image must be hosted on your servers.


Add the custom provider ID created in the customOpenidProviderId setting to the array of available identity providers in your UI. You must also add openid to this array.

Single Custom OpenID Setup

To enable a single OpenID provider in your UI, your code should look similar to this:

janrain.settings.providers = ['google','facebook','openid','open-eye-dee'];
janrain.settings.customOpenid = true;
janrain.settings.customOpenidFlow = 'openid';
janrain.settings.customOpenIdProviderName = 'yourCustomId';
janrain.settings.customOpenIdProviderColor = '#729fcf';
janrain.settings.customOpenidProviderId = 'open-eye-dee';
janrain.settings.customOpenidIdentifier = '';
janrain.settings.customOpenidOpxblob = '{'origin':'','otherParam':'other cool value'}';
janrain.settings.customOpenidLargeIcon = '';

Multi-custom OpenID Setup

To set up multiple OpenID providers in your UI, use code similar to this:

Note. The icons will not display properly unless you modify the CSS for your UI.
janrain.settings.providers = ['google','facebook','openid','alpha','gamma','beta','delta'];
janrain.settings.customOpenid = true; 
janrain.settings.customOpenidProviderId = ['alpha','gamma','beta','delta'];
janrain.settings.customOpenIdProviderName =      'alpha':'Aardvark',     'beta':'Badger',     'gamma':'Giraffe',     'delta':'Donkey' };
janrain.settings.customOpenIdProviderColor = {     'alpha':'#729fcf',     'beta':'#729fcf',     'gamma':'#729fcf',     'delta':'#729fcf' };
janrain.settings.customOpenidIdentifier = {     'alpha':'',     'beta':'',     'gamma':'',     'delta':'' };
janrain.settings.customOpenidLargeIcon = {     'alpha':'',     'beta':'',     'gamma':'',     'delta':''