About OneLogin SAML Integration
Single Sign-On with OneLogin (SAML) in Iru Endpoint allows you to set up SAML-based SSO integration with OneLogin, providing secure authentication for users accessing Iru Endpoint through their OneLogin credentials.How It Works
OneLogin SAML integration allows your users to authenticate to Iru Endpoint using their existing OneLogin credentials. Once configured, users can access Iru Endpoint through a single sign-on experience, eliminating the need for separate passwords and improving security through centralized authentication. The integration works by establishing a trusted relationship between Iru Endpoint and OneLogin, where OneLogin acts as the identity provider (IdP) and Iru Endpoint acts as the service provider (SP). When users attempt to access Iru Endpoint, they’re redirected to OneLogin for authentication, and upon successful login, OneLogin sends a SAML assertion back to Iru Endpoint confirming the user’s identity.Setting Up the SAML Connection
1
Navigate to Settings
Navigate to the Settings page.
2
Access Authentication Settings
Click the Access tab.
3
Add New Connection
Find the Authentication section and click the Add button at the bottom left of the authentication section.
4
Select SAML Connection
In the new blade, select the Custom SAML connection option.
5
Continue Setup
Click Next.
6
Show Advanced Details
Click Show Advanced Details.
7
Copy Required URLs
Copy the contents of the Assertion Consumer Service URL and the Entity ID after the urn:auth0:-prod: portion of the string.
8
Keep Tab Open
Leave this tab open, and continue to the OneLogin instructions below.
Configuring OneLogin Application
1
Navigate to OneLogin
Navigate to the following OneLogin configuration page, or find the Iru Endpoint app in the catalog:
2
Save Application
Click the Save button in the upper right hand corner.
3
Open Configuration Tab
Click on the Configuration tab.
4
Configure ACS URL
Paste in the Assertion Consumer Service URL you previously copied in the Consumer (ACS) URL field.
5
Configure Entity ID
Paste in the ending of the Entity ID you previously copied in the Iru Endpoint Connection Name field. Note only enter the part after “urn:auth0:kandji-prod:”
6
Configure Encryption (EU Tenants Only)
For EU tenants only: Copy the contents of the encryption certificate below and paste it into the Public Key box in the SAML Encryption section. If you have a US tenant, you can skip this step and continue to step 7.
7
Save Configuration
Click Save.
8
Configure SSO Settings
Click on the SSO tab.
9
Set Signature Algorithm
Change the signature algorithm to SHA-256.
10
Copy Sign In URL
Copy the Sign In URL, under SAML 2.0 Endpoint (HTTP)
11
Copy Sign Out URL
Copy the Sign Out URL, under SLO Endpoint (HTTP)
12
Save SSO Settings
Click Save in the upper right-hand corner.
13
View Certificate Details
Click View Details under the certificate section in the SSO tab.
14
Download Certificate
Download the certificate in a X.509 PEM format.
15
Assign Users
You may now assign users to this OneLogin application and close the tab.
Configuring Iru Endpoint SAML Connection
1
Set Connection Name
Set the Connection Name to OneLogin.
2
Configure Sign In URL
Paste in the Sign In URL you copied from OneLogin.
3
Configure Sign Out URL
Paste in the Sign Out URL you copied from OneLogin.
4
Upload Certificate
Upload the Certificate you downloaded from OneLogin.
5
Save Connection
Save the connection (do not modify any other settings).
Enable the SAML Connection
Once you have configured the SAML connection in both Iru Endpoint and your identity provider, you can now enable the connection. Please refer to our Single Sign-On support article for step-by-step instructions.Enforcing Single Sign-On
Once you have configured at least one Single Sign-On connection, you can disable the Standard Authentication connection. Disabling Iru Endpoint standard authentication will disable the ability for Iru Endpoint administrators in your tenant to authenticate via Email/Password, Google Sign in, or Office 365 Sign in. Please refer to our Single Sign-On support article for step-by-step instructions.
Once you have configured at least one Single Sign-On connection, you can disable the Standard Authentication connection. Disabling Iru Endpoint standard authentication will disable the ability for Iru Endpoint administrators in your tenant to authenticate via Email/Password, Google Sign in, or Office 365 Sign in. Please refer to our Single Sign-On support article for step-by-step instructions.
Testing the Integration
1
Add Test User
Add a test user to the Admin Team in Iru Endpoint by clicking New User.
2
Configure User Information
Fill in all of the corresponding user information. This user must exist in OneLogin and must be assigned to the Iru Endpoint SSO app in your OneLogin tenant.
3
Submit User
Click Submit.
4
Close Invite Window
Once the invite is submitted, close the Invite User window.
5
Refresh Access Page
Refresh the Access page in Iru Endpoint. You should see the user you added.
6
Test SSO Login
Go to the user’s email to accept the invite and log in with the new SAML SSO connection.