View Bridge agent configuration   

Once the Bridge agent is set up, you will be able to view and modify the allowed Configuration when required.

1. In Qntrl, navigate to  (settings) >> Advanced >> Bridge >> select Bridge. 
   
2. Hover your cursor over the Bridge name, then click on the action menu, , and select Open Agent.
   
3. This will direct you to the Bridge Agent login page. Log in with your User name and Password.
   

4. Click Settings icon at the top right of the header bar.

5. Click Configuration from the left pane.
   
1. Bridge Configuration displays details such as Org Name, Bridge name, Registration key, Polling Interval, and Installation Directory.
   
2. Storage Configuration holds the Storage type.
   
3. Version Details displays the Version of Bridge. 
   

      

Change login password   

1. Navigate to  (settings) >> Advanced >> Bridge >> select Bridge.  
2. Hover your cursor over the Bridge name, then click on the action menu, , and select Open Agent.
   
3. This will direct you to the Bridge Agent login page. Log in with your User name and Password.
4. Click Settings icon at the top-right of the header.
   
5. Click Reset Password from the left pane.
6. Enter your Current Password and New Password.
7. Click Save to update the login password. 
   

Store credentials in Bridge   

1. In Qntrl, navigate to  (settings) >> Advanced >> Bridge >> select Bridge.  

2. Hover your cursor over the Bridge name, then click on the action menu, , and select Open Agent.   

3. This will direct you to the Bridge Agent login page. Log in with your User name and Password.

4. Click Settings icon at the top right of the header bar.

5. Click Credentials from the left pane.

6. Click Add Credentials button present at the top right of the page.

7. Enter the Credential details.
   
1. Credential Name: Give a name to the Credential.
   
2. Type: Click the dropdown menu and select the suitable Credential type based on the service you wish to connect with and complete the relevant fields associated with the chosen Credential type. For instance, if you intend to perform a task within the AD module, choose Type as 'Active Directory'.
   
1. API - Provide API Key
   
2. JDBC - Provide User Name and Password
   
3. SSH - Provide Public Key/Password
   
4. PowerShell - Provide User Name and Password
   
5. Active Directory - Provide User DN and Password

8. Click Save. The credentials will be stored and ready for use.

Types of Credentials       

1. API  

1.  Append To: Select Parameter or Header to append the credential
   
2. Token: Enter the API token generated in the target service, included in the API request header or parameter.
   
3. Header Name: If the Append To field is selected as Header, enter the name of the HTTP header carrying the API token (e.g., Authorization, API-Key, Bearer).
   
4. Parameter Name: If the Append To field is selected as Parameter, enter the query parameters or request body parameters containing the API token.

2. JDBC 

Grants access to a database connection by establishing a connection with a database using the provided username and password. Upon selecting JDBC as the credential type, fill in the following field details.

• Username: Username associated with the database account.

• Password: Password for the corresponding username to authenticate database access.

3. SSH (Secure Shell) 

Enables secured connections to UNIX and Linux devices by executing commands over SSH protocol. This credential type has two modes of authentication.

i. Password Authentication:

1. Authentication Mode: Select the Authentication mode Password/Public Key
   

• User Name: Username on the target machine.
  
• Password: Password for script execution.

• User Name: Username on the target machine.
  
• Identity: Location of the Private Key.
  
• Passphrase: Password that can be added optionally for an extra layer of security during the key generation.

4. PowerShell 

Used for secure connections with Windows machines by executing Powershell commands. If you've chosen Powershell as the credential type, provide the following details in the designated fields.

• User Name: Username on the Windows machine.
  

• Password: Password associated with the machine for script execution.

5. Active Directory 

Used for authentication and accessing resources within an Active Directory environment. For AD credential types fill in the following details.

• User DN: Distinguished Name of the Active Directory.
  

• Password: Active Directory password.
  

OAuth Configuration  

Pre-requisite

Configuring OAuth for Connection

Follow the below steps to configure OAuth for your connection:

1. In Qntrl, navigate to  (settings) >> Advanced >> Bridge >> select Bridge.  

2. Hover your cursor over the Bridge name, then click on the action menu, , and select Open Agent.          

3. This will direct you to the Bridge Agent login page. Log in with your User name and Password.

4. Once logged into Bridge Agent, click  Settings icon located at the top-right of the header bar.

5. Select Configure OAuth from the left pane.

6. If you've registered your application before, enter your Client ID and Client Secret.

• Client ID: Unique identifier you receive when you register your application with Zoho.

• Client Secret: Unique key generated when you register your application with Zoho.

• Authorized redirect URI: URI endpoint for client-based applications to which Zoho Accounts has to redirect the user-agent with the access token after authorizing the client.

To register your application and generate a Client ID and Client Secret, select the '+' icon next to Client ID and follow the registration process outlined in Register your Application section, commencing from step 3.

7. Click Save and Connect.

8. Upon successful authorization, the connection will be created and the status will be shown as Connected.

9. You have the option to modify or revoke the connection you've created by simply clicking the Edit or Revoke buttons.
   

Register your Application    

1. Visit the Zoho API Console by navigating to the official website Zoho API Console and click GET STARTED.

2. Choose the "Server-based Application" client type and click CREATE NOW.

3. Provide the following details:

Client Name: Enter the name of the application you want to register with Zoho.

Homepage URL: Input the URL of your application's web page.

Authorized Redirect URIs: Specify a valid application URL to which Zoho Accounts will redirect you, providing             a grant token (code) upon successful authentication.

4. Click CREATE.

5. Upon successful registration, you will receive the following credentials:

Client ID: The consumer key generated from the connected app.

Client Secret: The consumer secret generated from the connected app.

For more in-depth information about OAuth integration with Zoho, you can  refer to Zoho's OAuth documentation