Skip to main content

Get A Connector For Cloud Tenant

The document provides a detailed guide on how to onboard a connector for a IDHub Cloud tenant.

Pre-Requisites​

  • Ensure that you have an active IDHub subscription before getting a connector for your cloud tenant. Click here to get your 30 days free trial of your IDHub Cloud subscription.

  • Go to the sath website and at the top navigation menu under Product go to Identity Connectors and then click on the connector that you want to deploy

  • Then you will be taken to the Cloud connector details page. Click on the button deploy in the cloud

Pick A Connector​

  • Select the connector from Pick a Connector drop-down.
  • Enter the name of the connector. This connector name will help you identify the connector.
  • Choose your Billing Interval
    • Monthly
    • Yearly
  • Choose your Billing Plan
    • Small
    • Medium
    • Large
  • Finally click on the Add to Cart button to proceed further.

Checking out​

  • This is the checkout page which shows the product or service that you have added to the cart, the pricing and other information.
  • Click on the Checkout order button, to proceed to the next page.

Contact and Billing Details​

  • If you are visiting this page for the 1st time, then you will have to enter the required information which are the following:
    • Phone Number
    • Company Name
    • Address Line1
    • Address Line2
    • Country
    • Zip/Postal Code
  • Next time when you visit the page the above information would be auto-filled in this page.

Order Confirmation Page​

  • Finally you will be shown the order confirmation page.
  • Click on the Account Management link which will redirect you to the account management page.

Account Management​

This is your account management dashboard. From the left menu click on the Connectors. In the connectors page, this will show you the complete list of all connectors that you have deployed in your tenant along with it's health status.

info
  • If you have not deployed any connector, the page would display No Connectors Available
  • You can click on the Add New button at the top to add new connectors
  • You can click on the Login to Tenant button to login to your IDHub Cloud Tenant.

Connector Manager​

  • Click on the 3 dots menu for the connector and then click on the Manager Menu.
  • You will be taken to the IDHub Connector manager page

Connector Manager page​

  • Here you will have to enter the application URL and the tenant name. The application URL is the IDHub application URL for example: https://app.sath.com
  • Now click on the REGISTER button in order to proceed further.

IDHub Tenant Login and tenant verification​

You will then be redirected to your tenant login and would be asked to login to your tenant (if not already done so). Once the tenant login is verified you will be taken to the next page,

Connector Information page​

This page shows the following information:

  • Connector type
  • Connector health
  • IDHub info
    - Application URL
    - Connector tenant
    - Onboard Application
    Now click on the Onboard now link to proceed further

Enter the Application Credentials​

The next screen set-up will ask you to enter the credentials for your target system instance. Different connectors have different credentials and setups that you need to do at the target system, before you can onboard that connector in IDHub.

info

Please refer to the connector guide in order to find out the pre-requisites for deploying the connector.

After adding the required target system configuration details, click on the Apply and Next button to proceed further.

Account JSON​

Now you will be taken to the Account JSON page as is shown below:

note
  • This page contains the default settings used to fetch and provision accounts using specific attributes. You can modify these default settings as needed

Click on the Apply and Next button to proceed further to the Entitlement JSON page.

Entitlement JSON​

note

This page contains the default settings used to fetch and provision entitlements using specific attributes. You can modify these default settings as needed.

Click on the Apply and Next button to proceed further.

Scratchpad​

note
  • This page functions as the scratch pad for the connector configuration.
    • Here you can enter any notes, reminders, or any information you may need for future reference for the connector configuration.
  • Information entered in this page, will not be used for provisioning or reconciliation in IDHub.

Now click on the Next button and then click on the ONBOARD button. This will start the onboarding of the connector and once finished

Enter Application Name​

In this screen enter the name of the application. There are two additional checkboxes which are as follows:

  • Do you want to get users from your application to IDHub
    • If checked, then the target system is created as a "Trusted App" in IDHub. All users with unique email addresses in the target system instance would be added to IDHub.
  • Do you want to review accesses of all permissions on "Who has access to what" in your application
    • This will create a certificate definition for you in your IDHub tenant. This you can later modify for performing access reviews on your target system accounts.

Setup will take some time and display the confirmation message. At this stage, target system (connector) is successfully installed and target system application is also onboarded to IDHub.

Verify the onboarded Application​

Now, log into your IDHub tenant and then click on the Manage catalog. You will see the target system application.

Ending Notes​

If you have any questions or concerns, or if there are areas you wish to explore further, please feel free to reach out IDHub Support. Your feedback is incredibly valuable, not only in improving these resources, but also in helping to shape future content.