To create configuration login to both Okta and Surveypal with admin access.
Go to Okta
Check UI from top left corner
If using “Classic UI” then
Click “Applications” dropdown and select “Applications”
Click “Add Application”
Click “Create New App”
Select Platform “Web” and Sign on method “OpendID Connect”
Click “Create”
Set “Application name” and set any temporary url to “Login redirect URIs”
Click “Save”.
If using “Developer Console”
Click “Applications” dropdown and select “Applications”
Click “Add Application”
Select “Web” and click “Next”
Leave URLs as they are. You may change other settings according to your needs.
Click “Done”
Scroll down to “Client Credentials”. Leave page open.
Go to Surveypal
Select “Your Account” – “Sign in settings”
Click “Enable single sign-on”
Select “Okta”
Set “Configuration name”
Copy “Subdomain” from your Okta domain. E.g. if domain is https://surveypal.okta.com/ the
subdomain is “surveypal”. Don’t go into admin trap if domain you see in the url contains “-admin”.
Copy “Client id” and “Client secret” from Okta configuration (see viii). You will see endpoints and urls prefilled.
Click “Save”
Go back to Okta
Scroll up to “General Settings”
Click “Edit”
Copy value for “Login redirect URI” from Surveypal “Redirect URL”
Copy value for “Initiate login URI” from Surveypal “Login URL”
Click “Save”
Select “Assignments”
Assign access to selected people to allow them to access the application.
You are all set!
Test login by copying “Login URL” from Surveypal and open it in browser where you are not logged in to either Okta or Surveypal. You should see Okta login prompt and after login you should be redirected to your Surveypal account.
Note! User accounts need to be created manually in Surveypal. If account with Okta email is not found from Surveypal customer organization then login fails and user is redirected to login screen. There isn’t proper error catch for that yet and it can cause confusion.