SAML with Okta
Kindo has an application in the Okta Integration Network (OIN) catalog that configures SAML sign-in for you. You need to be an Okta administrator to add it, and an organization Admin in Kindo.
Before you configure Okta, create your organization’s SAML connection in Kindo under Settings → SSO. Follow Single Sign-On (SSO) Setup and keep the ACS URL and SP Entity ID available.
Supported features
Section titled “Supported features”- SP-initiated SSO: users start at the Kindo login screen.
- IdP-initiated SSO: users start from the Kindo tile in Okta.
- Just-in-time provisioning: Kindo creates an account on a user’s first sign-in when their email address uses your organization’s verified domain.
Choose how to add Kindo to Okta
Section titled “Choose how to add Kindo to Okta”Add the Kindo app from the Okta catalog. If any of these apply, create a custom SAML app instead:
- Searching the catalog for Kindo returns no app.
- Your SP Entity ID in Kindo contains
?providerId=. The catalog app expects an SP Entity ID that ends in/sp/entity/<provider ID>.
Add Kindo from the Okta catalog
Section titled “Add Kindo from the Okta catalog”The catalog app needs your Kindo SSO provider ID. Kindo shows it next to the SAML Connection heading in Settings → SSO. It’s also the last part of the ACS URL, after /sp/acs/. For example, in https://api.kindo.ai/auth/sso/saml2/sp/acs/saml-a1b2c3d4, the provider ID is saml-a1b2c3d4.
-
In the Okta Admin Console, open Applications and Resources → Applications.
-
Select Browse App Catalog.
-
Search for Kindo, select the Kindo app, then select Add Integration.
-
On General Settings, keep or change the Application label. Choose the app visibility settings your organization uses.
-
Enter your Kindo SSO provider ID, then select Done.
-
On the app’s Sign On tab, select Edit. Set Application username format to Email, then select Save.
The email address must match the user’s Kindo email address on your organization’s verified domain.
The catalog app sends the email, givenName, and surname SAML attributes that Kindo reads, so you don’t add attribute statements.
Continue with Add the Okta details in Kindo.
Create a custom SAML app
Section titled “Create a custom SAML app”Use a custom app when the catalog app doesn’t fit. For an existing custom Kindo app, open it and edit its SAML settings. Skip the creation steps and continue with the SAML configuration below.
To create an application:
-
In the Okta Admin Console, open Applications and Resources → Applications.
-
Select Create App Integration.
-
Select SAML 2.0, then Next.
-
Enter an application name. Select Next to open Configure SAML.
Configure SAML for the application:
-
Enter these settings:
Okta field Value Single sign-on URL Kindo ACS URL Audience URI (SP Entity ID) Kindo SP Entity ID Recipient Kindo ACS URL Destination Kindo ACS URL Default RelayState Leave blank Name ID format EmailAddress Application username Email The email address must match the user’s Kindo email address on your organization’s verified domain.
-
Under Attribute Statements, add attributes with these exact names.
Name Value emailuser.emailgivenNameuser.firstNamesurnameuser.lastNameThe
emailattribute and Name ID must contain the same address. The recommendedgivenNameandsurnameattributes populate the user’s display name. -
Select Next.
-
Select I’m an Okta customer adding an internal app.
-
Select Finish.
For field details, see the Okta SAML application reference.
Add the Okta details in Kindo
Section titled “Add the Okta details in Kindo”These steps are the same for the catalog app and a custom app. Use metadata XML to import the IdP settings:
-
On the application’s Sign On tab in Okta, open the Metadata URL and save the page as an
.xmlfile. -
In Kindo, open Settings → SSO → Identity Provider (IdP) Configuration.
-
Select Upload metadata XML and choose the downloaded file. The file imports immediately. To use pasted XML, paste the XML contents and select Import.
-
Confirm that the certificate shows
Valid until <date>.
For manual configuration:
-
Enter these values in Identity Provider (IdP) Configuration:
Kindo field Okta value IdP Entity ID Issuer Redirect URL Sign on URL Signing certificate Full PEM contents of okta.cert, downloaded with Download on the Signing Certificate rowOn the catalog app, these values are under More details in the SAML 2.0 section of the Sign On tab.
-
Select Save. Confirm that the certificate shows
Valid until <date>.
Assign users and test
Section titled “Assign users and test”Users must be assigned to the Okta application to sign in.
-
In Okta, open Assignments and assign a pilot user or group.
-
Open Kindo in a private browser window. Select Continue with SAML SSO and enter the pilot user’s email address. Complete sign-in with Okta.
-
Test sign-in from the Kindo tile in Okta.
-
Assign the remaining users or groups after the pilot succeeds.
-
If your organization requires SSO, enable SSO Enforcement. Test a fresh sign-in with enforcement enabled.
