Blackline

Overview

This document provides instructions on how to connect to an API to import data from this application into your instance of Zilla.

In this guide, you will:

1. Launch your application from inside Zilla

2. Set up an API configuration

3. Send your data securely to Zilla

Step-by-Step Instructions

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.

• 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.

• 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 & Environment, this will need to come from Blackline’s Technical Support Team, after submitting a formal request to them. 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 & 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.