Supported Features
Single Sign On (OpenID Connect) initiated via Simply Stakeholders
Requirements
Okta SSO must be enabled for your account
Configuration Steps
Set up Okta integration from App Catalog (Coming Soon)
Go to Okta admin site
Go to Applications page
Click "Browse App Catalog"
Search for the "Simply Stakeholders" application and add it
Add an Application label and click "Done"
Go to the "Sign On" tab for the application and click "Edit"
For the "Region" field, enter your Region; e.g.
au
orus
Click "Save"
Go to the "Okta API Scopes" tab and grant the
okta.users.read
scope
Set up Okta integration manually
If it's not possible to use the App Catalog, you can set up the application manually:
Go to Okta admin site
Go to Applications page
Click "Create App Integration"
Under "Sign-in method", select "OIDC - OpenID Connect"
Under "Application type", select "Web Application"
Click "Next"
For "App integration name", enter "Simply Stakeholders - Manual"
For "Sign-in redirect URIs", enter
https://<region>-oauth.simplystakeholders.com/SimplyStakeholders/ExternalAuthenticationCallback/Okta
where<region>
isau
,uk
,us
,eu
orca
depending on your Region.For "Sign-out redirect URIs", remove the value
Under "Assignments", select the appropriate assignment type
Under "Okta API Scopes", grant the
okta.users.read
scopeClick "Save"
Gather information from Okta
In the Okta admin page, click on the Simply Stakeholders application and then navigate to the Sign On tab
Copy the values of Client ID and Client Secret (click the eye button to toggle the visibility)
Click on your username in the top-right of the page and copy your Okta Org URL from the popup that appears
Add information to Simply Stakeholders
Log into Simply Stakeholders using your username/password
Go to Admin (cog wheel icon button) > Account > SSO
Enter the Okta Org URL with "https://" in front of it
Enter the Client ID/Secret of the application
Click "Save"
Link initial Okta account
On the SSO page, click the "Sign in with Okta" button
Log into your Okta account if necessary
You will be redirected to a page saying that your account was linked successfully
Link other Okta accounts
To link Okta accounts for other users, you must be signed in with Okta SSO and have an admin role with "View users and their details" permission in Okta.
Go to Admin > Users & Roles > Users
Click the + button to add a user
Enter the User Login Name, User Display Name, Email and Mobile No. fields
Enter the Okta Username field
Click "Save"
Log in with Okta SSO
Click the "Sign in with Okta" button on the login page
Enter your client code
Click "Sign In"
Log into your Okta account if necessary
You will be redirected back to the application