Blackline

Owned by Vaibhav Mishra
Last updated: Jun 07, 2024 by Sowmya Manian
3 min read

 Steps to setup Blackline application instance in Zilla

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

image-20240416-175645.png

  • A window with a search bar appears, type in blackline in the search bar. Blackline application entry will appear at the top of the list, click Add to Applications button to the right.

image-20240524-141644.png

  • Fill in the form with appropriate details and then click Add to Applications button.

  • A detailed view of Blackline application appears. Click Sync now or the gear icon in top right corner to configure your application.

  • Enable API Integration option from the dialog.

 

  • 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

 

 

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.

 

 

GET /v1/users

GET /v1/users/{id}/entities

GET /v1/users/{id}/roles-product

GET /v1/users/{id}/teams

 

  • Click Next, the sync will begin.