OAuth, specifically OAuth 2.0 is the industry standard for authentication across multiple platforms. Popular platforms such as Google, Facebook, and LinkedIn support sign in through OAuth. OpenWater supports these three providers out of the box. In addition, many IT departments have implemented OAuth as their protocol of choice for third party systems. We can work with your implementation of OAuth.
OAuth is used by a lot of places and systems, here is a small list of compatible providers:
Microsoft 365 / Microsoft Dynamics
Neon AMS / Neon CRM
CiviCRM (Drupal / WordPress)
Get Started with Integrations Hub
Add a new Single Sign On connector for Basic OAuth
You will have to give your IT provider a redirect URL, this is the Process Url
In return your IT admin should give you the following:
Login Url (Auth Url)
Token Url Endpoint
User Info / Profile Url Endpoint
Give the connector name, then paste in the Login Url (Auth Url) into the Login Url. Then click on Credentials and add new credential. Paste in the Client ID, Client Secret, Token Endpoint and User Info Endpoint. Finally click to add a scope.
Toggle to Field Mapping and click on the No Fields have been provided yet, hyperlink
If all worked well you'll see a message like this
Refresh the integrations hub page, and now proceed to map the fields.
Click the gray area to configure that field.
Click on any of the matched texts to map the field, then press Save
Now head back to Settings, and Copy the Begin Url
Then head to OpenWater and update the Login Configuration. Set it to Json Web Token and paste in the Begin Url to the Login Url, and enter the shared secret set in step 1.
Great, you can now save this and load up your site in an incognito window, then test out your login.