Before You Start
You need admin access to your Okta account and admin/system technician Whistleblower Software Settings.
Users must already exist in Whistleblower Software before they can sign in via SAML.
SAML 2.0 is available only on the Advanced plan.
Step 1: Create a New App Integration in Okta
In your Okta admin panel, go to Applications and click Create App Integration.
Step 2: Select SAML 2.0
Choose SAML 2.0 and click Next.
Step 3: Name the Application
Enter a name such as "Whistleblower Software" and click Next.
Step 4: Enter the ACS URL and Entity ID
Go to Settings > Security in Whistleblower Software. Enable Login with SAML. Copy the Application ACS URL (this is the Single sign-on URL in Okta) and the Application entity ID (this is the SP Entity ID in Okta).
Enter these into the corresponding fields in Okta. Then:
Set Name ID format to EmailAddress.
Set Application username to Email.
Step 5: Complete the Setup in Okta
Select I'm an Okta customer adding an internal app and click Finish.
Step 6: Get the Okta Metadata
Click View SAML setup instructions. Under the Optional section, copy the IDP metadata content and save it as a .xml file on your computer.
Step 7: Upload the Okta Metadata File into Whistleblower Software
Go back to Settings > Security in Whistleblower Software. Under Identity provider metadata file, upload the .xml file you just saved from Okta.
Step 8: Assign Users
In Okta, assign the relevant users to the Whistleblower Software application.
Only administrators, system technician and user-defined users with access to security settings can make these changes in Whistleblower Software.
We’re here to support you. If you have questions reach out to us directly via the Messenger icon in the bottom right corner of your screen, or send us an email at support@whistleblowersoftware.com