Directory Apps - Bitly | Marketplace Installation Guides - Zoho One

Bitly for Zoho Directory

Prerequisites

An Enterprise account with Bitly

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 Bitly.
  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 Bitly.
  3. If you want to test the SAML configuration before allowing users to access Bitly, uncheck Display app to users. You can later make the app visible to all users.
  4. Click Add.
  5. Click 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 copy the Issuer, the Sign-in URL, and the X.509 Certificate.

Configure SAML in Bitly

  1. Sign in to Bitly.
  2. Click Settings in the left menu.
  3. Under Account settings, click Single sign-on.
  4. Under Step 1, enter a subdomain for your SSO login page (This name can't be changed later).
  5. Click Verify.
  6. Under Step 2, enter the email domain of the users who will have access to the single sign-on (Any email domains you add will need to have at least one verified email address in Bitly).
  7. (Optional) Under Step 3, select a default group for the new users.
  8. In Step 4, under Choose your Identity Provider, select Zoho Directory.
  9. In the IDP URL or Entity ID and Issuer URL fields, paste the Issuer  value copied from the Zoho Directory Admin Panel.
  10. In the SAML endpoint and x.509 Certificate fields, paste the Sign-in URL and X.509 Certificate values copied from the Zoho Directory Admin Panel.
  11. Click Save.

Test the SAML connection

  1. Return to the Zoho Directory Admin Panel.
  2. Go to Applications, then click Bitly.
  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 Bitly's homepage.

Make the app visible to all users

After successfully testing the SSO, you can make Bitly available for all users to access from their My Apps page.
To make Bitly visible to all users:
  1. Sign in to the Zoho One Admin Panel.
  2. Go to Applications, then click Bitly.
  3. Click Unhide.
  4. You can now access Bitly from Zoho One's My Apps page.