In this article, we'll go over the steps for setting up an Integrations Hub SSO with ACGI.
1. Get Started with Integrations Hub.
2. Add a new SSO connector from the Integrations Hub dashboard.
3. You will be brought to a page with different SSO options. Select ACGI.
4. You will now be shown the below screen to set up your connector and credentials.
5. Let's begin by giving your connector a name. This name can be whatever you'd like but we normally suggest this format: {Name of Organization} SSO
6. You need some additional information from your ACGI platform to set up your credentials, but first you will start with your ACGI Login URL. Add this to the field located under the Name.
The Login URL should follow the below format:
https://{yourACGIwebsite}/{vendorID}/censsareqauth
7. Under the Login URL field, click "Select Credentials" then click "Add New Credentials" from the drop-down menu:
You should now have a half-window open up on the right side of your screen labeled "Create New Credentials".
8. You will now need to gather some information from your ACGI platform to set up your credentials:
Vendor Code
Integrator UserName
Integrator Password
9. You will also need to add a series of URLs. These can be created using the following formulas, using the two variables of {yourACGIwebsite} and {vendorID}:
Authentication Url:
https:// {yourACGIwebsite}/{vendorID}/CENSSAWEBSVCLIB.AUTHENTICATION
Customer Info Url:
https:// {yourACGIwebsite}/{vendorID}/CENSSAWEBSVCLIB.GET_CUST_INFO_XML
Customer Details Url:
https://{yourACGIwebsite}/{vendorID}/CENSSAWEBSVCLIB.GET_ID_BY_NAME_AND_EMAIL_XML
Decryption Url:
https:// {yourACGIwebsite}/{vendorID}/CENSSAWEBSVCLIB.DECRYPT_STR_XML
10. Now click the "Add" button at the bottom of the "Create New Credentials" half-window. Click "save" at the top of left the connector settings.
11. Located under "Save" on the top left of your screen, click the "Field Mapping" tab.
12. Standard OpenWater fields will populate under Basic Fields, OpenWater Field column- you can add or remove any that you need to by using the drop-down options:
Does the Basic Field options not include a field you need? You can add custom fields to your OpenWater instance here:
https://{YourOpenWaterInstanceName}.secure-platform.com/admin/organizations/main/userprofileformtemplate/preview
Next, in Integrations Hub, click on "Custom Fields" under "Basic Fields" on the left side of your screen. You'll now have drop-down options just like the basic fields shown above where you can add custom fields in the same manner.
13. Next, under the column called ACGI Field, click each one to assign the corresponding ACGI field. Do this by:
Click the empty field
Search within the payload for the exact field
Select the field that matches
Click Save
14. Once you have your field mapping configured, click "Save" in the top left of the page again. Then click "Publish".
15. When you're ready, click "Test" at the top of your screen next to "Save" and "Publish", then follow the login prompt.
16. If this test was successful, you are ready to finish your SSO setup via your OpenWater instance. First, go back to your "Settings" tab and copy the Begin URL:
17. Login to your OpenWater instance as an admin: https://{YourOpenWaterInstanceName}.secure-platform.com/admin/
18. From the dashboard settings located on the left side of your screen, scroll down to System Settings > Login Configuration
19. On this Login Configuration page, add the below settings:
Check "Use 3rd Party Corporate Authentication"
Choose "Json Web Token" from the list
The Login URL is the Begin URL we just copied from Integrations Hub
Secret Key will be the same JWT Secret Key located in your integrations hub settings page
For your Login Button Text, we suggest: Login with {CompanyName}
Click Save
Your SSO is now complete- high-five yourself, you did it!
Testing Your New SSO
As with any new integration or workflow, testing is super important! You can now load up your site in an incognito window, then test out your login.