Custom Authentication - miniOrange | Admin Guide - Zoho Directory

Custom authentication with miniOrange

 

Prerequisites

Roles required to perform this action :

  • Organization Owner

  • Organization Admin


Configure SAML with miniOrange 

  1. Sign in to the miniOrange admin console.
  2. Click Apps in the left menu, then click Add Application.
  3. In the Choose Application Type page, click SAML/WS-FED.
  4. In the displayed list of apps, search and select Zoho. You will land in the Basic Settings page.
  5. Type "Zoho Directory" in the Custom Application Name field.
  6. Enter the SP Entity ID or Issuer from the following table based on the Data Center (DC) your Zoho Directory account is present in.

    Data Center
    Corresponding Entity ID
    United States of America (US)
    zoho.com
    Europe (EU)
    zoho.eu
    India (IN)
    zoho.in
    Australia (AU)
    zoho.com.au
    China (CN)
    zoho.com.cn
    Japan (JP)
    zoho.com
    Canada (CA)
    zohocloud.ca
    Saudi Arabia (SA)
    zoho.sa
    United Kingdom (UK)
    zoho.uk

  7. Enter the ACS URL in the ACS URL field. 
    Note: You can find the ACS URL in Zoho Directory's Custom Authentication page.


  8.  Click Next. You will land on the Attribute Mapping page.
  9. Select E-Mail Address under Name ID.
  10. Select urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress under NameID Format.
  11. Click Next. You will land on the Login Policy page. The Group Name is "DEFAULT" and cannot be edited.
  12. Enter a Policy Name and select a Login Method from the dropdown menu.
    Note: NameID defines what the service provider expects in the subject element of the SAML response. NameID Format defines the format of the subject element content. Group Name refers to the group of users in your organization that have access to SAML SSO. Policy Name refers to the name of that policy which will be enforced for users who try to access certain apps that require single sign-on. Login Method refers to how users will sign in to their account. 
  13. Click Save. You will be redirected to the APPS page.
  14. Click Select next to the Zoho Directory app you configured, then click Metadata.
  15. If you want to set miniOrange as your IdP, click Show Metadata Details under INFORMATION REQUIRED TO SET MINIORANGE AS IDP. Otherwise, if miniOrange acts as a broker service between your actual IdP and the SP, click Show Metadata Details under INFORMATION REQUIRED TO AUTHENTICATE VIA EXTERNAL IDPS.
  16. Click Download Certificate.
  17. Copy the SAML Login URL and SAML Logout URL, then use the information to set up SAML in Zoho Directory.
    1. Paste the SAML Login URL in the Sign-in URL field.
    2. Paste the SAML Logout URL in the Sign-out URL field.
    3. Browse and upload the X.509 Certificate in the Verification Certificate field.

Test the SAML connection 

Add yourself to the group DEFAULT to test the connection.
  1. Go to Zoho Directory.
  2. Enter your email address, then click NEXT.
  3. Click Sign in another way.
  4. Click Sign in with SAML. You will be redirected to sign in through miniOrange.