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:
Launch your application from inside Zilla
Set up an API configuration
Send your data securely to Zilla
Step-by-Step Instructions
Note: You must use organization’s owner account to setup the OAuth app and authenticate it. The owner account is also required to get outside collaborators.
Steps To Create a Github Connector
1. Sign in to Github. In the upper-right corner of any page, click your profile photo, then click Settings.
2. In the left sidebar, click Developer settings.
3. In the left sidebar, click OAuth Apps, then click Register a new application
4. Name your Zilla connector then click Register application.
Homepage URL should be https://app.zillasecurity.com/
5. Copy your Client ID and Client secret to a place you may access again (you will need these credentials to connect from Zilla in a future step).
For the Authorization callback URL simply copy and paste https://app.zillasecurity.com/api/auth/callback/github into the text box.
Setup Github Application Integration on Zilla
1. Locate your desired Github application instance on Zilla, click Sync now in the top right and enable API Integration. Find the Client Id and Secret you obtained in the last step and enter them into the corresponding boxes. For Organization Id, enter the username of your organization on Github (located at Your Organizations tab when you click profile image at upper right corner). For "Sync repositories as resource permissions", choose Yes if the integration should sync user access for each repository within the organization. This option results in additional Repository Role permissions in the Available Permissions.
Note: When updating the “Sync repositories as resource permissions” setting from No to Yes, you must revoke all user tokens in Github.
If “Sync repositories as resource permissions” is Yes, on the Permissions tab additional permissions are displayed for each account (e.g., “admin: repo1“, “maintain: repo2”, “read: repo3”, “triage: repo4”, “write: repo5”).
Click Update or Next.
2. Click Next.
3. If required, grant access. Your sync will start once you have granted Zilla access.
4. Once complete you may view the data on Zilla.
When you have finished with all the steps above, review the information in Zilla that was synced.
Having trouble? Try our Troubleshooting articles or contact support@zillasecurity.com.