Set up single sign-on (SSO) for ContactMonkey using Okta as your SAML 2.0 identity provider. ContactMonkey supports both Service Provider (SP) and Identity Provider (IdP) initiated SAML 2.0 authentication.
Looking for OIDC? Click here.
Before You Begin
Contact ContactMonkey Technical Support first. You'll need two pieces of information from our team before you can complete this setup:
- Application Callback URL - The URL where Okta sends authentication responses
- SP Entity ID - Your unique ContactMonkey organization identifier
What you'll need:
- Admin access to your Okta dashboard
- The Application Callback URL from ContactMonkey support
- The SP Entity ID from ContactMonkey support
Please also review this article for requirements and frequently asked questions.
Configure Okta for ContactMonkey
Step 1: Create a New App Integration
- Log in to your Okta admin dashboard
- Navigate to Applications → Applications from the sidebar
- Click Create App Integration
- Select SAML 2.0 as the sign-in method
- Click Next
Step 2: Configure General Settings
- Enter a recognizable app name (e.g., "ContactMonkey")
- Upload your company or ContactMonkey logo (optional)
- Click Next
Step 3: Configure SAML Settings
- Under General settings, enter the URLs provided by ContactMonkey Support
- Single sign-on URL: Paste your Application Callback URL
- Audience URI (SP Entity ID): Paste your SP Entity ID
- Under Attribute Statements, add three attributes exactly as shown:
3. Click Next
Step 4: Complete the Setup
- Under Feedback, select This is an internal app that we have created
- Click Finish
Step 5: Download Metadata File
- Navigate to the Sign On tab
- Under Settings, locate the Metadata URL
- Open the metadata URL in your browser
- Save the page as an XML file (e.g., `ContactMonkey-SAML-metadata.xml`)
- Send this XML file to ContactMonkey Technical Support to complete your SSO setup
Step 6: Assign Users
- Navigate to the Assignments tab
- Click Assign to select users or groups
- Choose which users should access ContactMonkey through SSO
Important: Only users explicitly assigned to this application can log in to ContactMonkey using SSO.