Adding Enterprise Code Servers

The first step in setting up a BluBracket tenant is adding code servers. This enables the BluBracket servers to communicate with a company’s GitHub services, which are necessary to generate alerts, insights, and reports. In this document we will walk through the necessary steps to get a customer up and running. The following is a breakdown of the steps:

Navigating to the Enterprise Code Servers section of the Settings page
Selecting a Server Type
Entering an Organization and Locating GitHub Organizations
Entering a Token and Creating a GitHub Personal Access Token

Navigating to the Enterprise Code Servers section of the Settings page

Adding an Enterprise Code Server starts with navigating to the appropriate section in the Settings section of the tenant portal. After authenticating into the portal, select the Settings option in the left navigation bar.

Once the Setting section is exposed, select the “Enterprise code servers” section. This will expose any code servers that have already been configured as well as the “Add” button for adding new code servers. Click on the “Add” button to expose the configuration bar at the right of the page.

Selecting a Server Type

Now that the configuration bar is exposed, the first thing we want to do is select a Server Type. We will be setting up a GitHub Cloud server, so in the dropdown select the “GitHub Cloud” option.

Entering an Organization and Locating GitHub Organizations

The next thing to do is select an Organization to point the server to. Organizations are usually, but not always, set up as lines of business or projects. For example, Google may have Organizations for Nest, Android, Add Words, etc., all under the same server. It is possible to point a server at multiple Organizations. Enter the targeted Organization into the input field.

If you don’t know the Organizations used by the company you can find them in the GitHub administrator portal. Log into your GitHub account as an administrator and navigate to the following location: https://github.com/settings/organizations . From this location it is possible to identify all of the Organizations used by that account.

Entering a Personal Access Token (PAT)

The next step in adding the code server is adding the Personal Access Token (PAT). The following documents walks through the process of obtaining a PAT:

Enter the token in the location indicated below.

Finally, select either the “All Repositories” or “Customer Select Repositories” option and click on the Save button.

At this point, if you’ve completed all of the above steps and entered the information accurately, the Enterprise Code Server should be up and running and start to pull the desired data.

Related articles