Page Comparison

...

Steps to obtain the ClientID, Client Secret, Scopes and Environment

Follow the below listed steps and obtain the ClientID, Client Secret, Scoper and Environment to later use while configuring Blackline app in Zilla.

1. Login to your Blackline account and Search for ‘API Client Settings’ in the Search Bar
   

   Image Added

2. Within API Credentials Management, click ‘Create Client’
   

   Image Added

3. In the Create Client configuration window,

   • add the scope bl.users

   • add your instance scope

   • description
     

     Image Added

4. Once all of the fields have been configured, click ‘Create Client’.
   

   Image Added

5. This will result in providing you with the ClientID + Secret that will allow you to authenticate to the Blackline APIs.
   

   Image Added

Steps to setup Blackline application instance in Zilla

• Visit the Zilla application and login using your admin credentials and then click Add Applicationin the top right.

...

• Add the configuration details and click Sync Now / Next.

...

To obtain the ClientID, Client Secret, Scopes and Environment, submit a formal request to Blackline’s Technical Support Team. This request must be submitted by the Blackline Admin’s Account that will be tied to this integration (later steps involve using this Admin Account to generate API Key). Navigate to the following path to submit such a request:

Blackline Home Admin >> Community (Leftside Panel) >>> My Cases >> Log A Case

Image Removed

In the Case Description, summarize the following:

Hello Blackline Tech Team,

I am in the process of setting up an API Integration with our 3rd party vendor Zilla Security. As part of this integration, I will need the following OAuth Credentials from you:

• ClientID

• ClientSecret

• Scopes

• Environment Name

This integration will require the following scopes:

GET /v1/users
GET /v1/users/{id}/entities
GET /v1/users/{id}/roles-products
GET /v1/users/{id}/teams

Thanks,

The Blackline Technical Team should deliver these listed items via their API Connector Installation Form.

The final 2 requirements needed as part of this integration are username + password. These can be retrieved by simply bringing up the User record for the Blackline Admin, where we find their username and also have the ability to Generate API Key.

Image Removed

• Click Next, the sync will begin.

...

• Click Next, the sync will begin.

...

• On the next dialog, click Done.

• On the Sync Summary dialog, check the summary and click on Close.