Neon CRM OAuth and OpenID connect Single Sign-On (SSO) | Neon CRM SSO Login

Neon CRM Single Sign-On (SSO) with WordPress OAuth & OpenID Connect Single Sign-On (SSO) plugin. Enable secure login into WordPress using Neon CRM as OAuth and OpenID Connect provider. Neon CRM Single Sign-On (SSO) with WordPress allows your users to login to your WordPress and access the site by authenticating with their Neon CRM. You can also configure plugin using different IDPs such as Azure B2C, Office 365, and other custom providers. It supports advanced Single Sign-On (SSO) features such as user profile Attribute mapping, Role mapping, multi tenant login etc. Here we will go through a guide to configure Single Sign-On (SSO) between WordPress and Neon CRM for user authentication. By the end of this guide, users should be able to perform secure login to WordPress and access the site with Neon CRM SSO. To know more about other features we provide in WP OAuth Single Sign-On ( OAuth & OpenID Connect Client ) plugin, you can click here.

Usecases

Pre-requisites : Download And Installation

• Log into your WordPress instance as an admin.
• Go to the WordPress Dashboard -> Plugins and click on Add New.
• Search for a WordPress OAuth Single Sign-On (SSO) plugin and click on Install Now.
• Once installed click on Activate

Steps to configure Neon CRM Single Sign-On (SSO) Login into WordPress

1. Setup Neon CRM as OAuth Provider

• Go to https://app.neonsso.com/login and sign up/login.

• From Configure OAuth tab in OAuth Client Single Sign-On (SSO) plugin , collect Redirect/Callback URL, and enter it into your Neon CRM Application.
• Copy your Client ID and Client Secret and save it on your miniOrange OAuth Client Single Sign-On (SSO) plugin Configuration.

You have successfully configured Neon CRM as OAuth Provider for achieving user authentication with Neon CRM Single Sign-On (SSO) login into your WordPress Site.

2. Setup WordPress as OAuth Client

• Go to Configure OAuth tab and click Add New Application to add a new client application into your website.

• Choose your Application from the list of OAuth / OpenID Connect Providers, Here Custom OAuth 2.0 App.

• Copy the Callback URL to be used in Neon CRM Configuration. Click Next.


• Please refer the below table for configuring the endpoints for Neon CRM in the plugin.

  Client ID :	from the Neon CRM SSO application configured
  Client Secret :	from the Neon CRM SSO application configured
  Scopes	openid
  Authorize Endpoint:	https://{{your Neon CRM organization id}}.z2systems.com/np/oauth/auth
  Access Token Endpoint:	https://{{your Neon CRM organization id}}.z2systems.com/np/oauth/token
  Get User Info Endpoint:	https://api.neoncrm.com/neonws/services/api/account/retrieveIndividualAccount?accountId=


• Enter the Client Credentials like Client ID & Client Secret in the setup dialogue box. Enter the scope value as openid. Click Next.

• Click on Finish to save the configuration.

You have successfully configured WordPress as OAuth Client for achieving Neon CRM Single Sign-On (SSO) with WordPress for user authentication.

3. User Attribute Mapping

• User Attribute Mapping is mandatory for enabling users to successfully login into WordPress. We will be setting up user profile attributes for WordPress using below settings.

Finding user attributes

• Go to Configure OAuth tab. Scroll down and click on Test Configuration.

• You will see all the values returned by your OAuth Provider to WordPress in a table. If you don't see value for First Name, Last Name, Email or Username, make the required settings in your OAuth Provider to return this information.
• Once you see all the values in Test Configuration, go to Attribute / Role Mapping tab, you will get the list of attributes in a Username dropdown.

4. Sign In Settings

• The settings in Single Sign-On (SSO) Settings tab define the user experience for Single Sign-On (SSO). To add a Neon CRM login widget on your WordPress page, you need to follow the below steps.

Sign in settings for WordPress 5.7 and before

• Go to WordPress Left Panel > Appearances > Widgets.
• Select miniOrange OAuth. Drag and drop to your favourite location and save.


Sign in settings for WordPress 5.8

• Go to WordPress Left Panel > Appearances > Widgets.
• Select miniOrange OAuth. Drag and drop to your favourite location and save.

• Open your WordPress page and you can see the Neon CRM SSO login button there. You can test the Neon CRM Single Sign-On (SSO) now.

Sign in settings for WordPress 5.9

• Make sure the "Show on login page" option is enabled for your application. (Refer to the below image)

• Now, go to your WordPress Login page. (Eg. https://< your-wordpress-domain >/wp-login.php)
• You will see an Neon CRM SSO login button there. Once you click the login button, you will be able to test the Neon CRM Single Sign-On (SSO).