Prerequisites

1. Gatekeeper Enterprise plan or Custom Enterprise plan
   
2. Administrator privileges with access to Settings
   

Configure SAML in Zoho One/Directory

1. If you're a Zoho One user:
   
1. Sign in to Zoho One , then click Directory in the left menu.
   
2. Go to Marketplace, then click Browse Applications.
   
3. Use the search bar to find and install Gatekeeper.
   
   
   
   
2. If you're a Zoho Directory user:
   
1. Sign in to Zoho Directory , then click Admin Panel in the left menu.
   
2. Go to Applications, then click Add Application.
   
3. Use the search bar to find and add Gatekeeper.
   
   
3. Name your app and enter Domain Name and Account ID.
   
   

   Note: Your Domain Name is the first part of your Gatekeeper URL. If your URL is "zylker.gatekeeperhq.com," your Domain Name will be "zylker." You can find your Account ID in the Gatekeeper's SSO URL while configuring SAML in Gatekeeper. For example, https://staging.gatekeeperhq/<account id>/single_sign_on/saml2/sso.
   
4. Click Add.
   
5. Click on the Single Sign-On tab.
   
6. Click Service Provider Details to check and verify the SP details. You can also edit them, if needed.
   
7. Click Identity Provider Details, then click Download IDP Metadata. A file named "GateKeeper.xml" will be downloaded.
   
   

Configure SAML in Gatekeeper

1. Sign in to your Gatekeeper account as an administrator with access to Settings.
   
2. Click Settings, then click Configuration in the left menu.
   
3. Click Authentication.
   
4. If you want to enable your users to sign in using their credentials even after configuring SAML, choose Allow all authentication methods. Otherwise, choose Require SAML 2.0 authentication. It is recommended to choose Allow all authentication methods while configuring and testing your SAML connection to prevent users from being locked out of their accounts.
   
5. Click Save.
   
6. Click Configure SAML 2.0 under Require SAML 2.0 authentication.
   
7. Open the GateKeeper.xml file that you downloaded and copy the IDP metadata. Paste it in the IDP metadata XML field.
   
8. Click Create. You will receive Gatekeeper's metadata information.
   
9. Click Save.
   

Note: Only the Live users in Gatekeeper can access their Gatekeeper accounts using SAML SSO. Archived users cannot access their Gatekeeper accounts using SAML SSO.

Test the SAML connection

1. Return to the Zoho Directory Admin Panel.
   
2. Go to Applications, then click Gatekeeper.
   
3. Click Assign Users, choose yourself from the list, then click Assign.
   
4. Click on the  icon next to the app's name. If everything is working, you should be automatically signed in and taken to Gatekeeper's homepage.
   
   

Enforce SAML SSO

1. Sign in to your Gatekeeper account as an administrator with access to Settings.
   
2. Click Settings, then click Configuration in the left menu.
   
3. Click Authentication, then choose Require SAML 2.0 authentication.
   
4. Click Save.