Adding GitHub organization to GitProtect

This article contains information on how to add GitHub organization to GitProtect.

The default Adding GitHub organization to GitProtect

To add a GitHub organization to GitProtect go to the DevOps tab on the left side of the window, expand it and select GitHub.

Now hit the GitHub button.

Due to the fact, that you selected GitHub from DevOps drop-down list, the appropriate Git environment has been selected. You don't need to select GitHub in the Authentication section.

In the Settings tab, you can decide that you want to register the GitProtect app using login and Personal Access Token. If you will toggle this switch, GitProtect will ask about your login and will require you to select the Personal Access Token from the Password Manager (if exist) or add a new one.

See also how to add a new Personal Acces Token to the Safe Password Manager:

Add A New Password

and also how to create a Personal Acces Token in GitHub:

The second thing, which is available to configure is the switch responsible to automatically add a new repositories to the GitProtect panel if its will appeared in GitHub.

The last section to configure is Repositories list sync options.

In general, during the adding process, you can specify the hours, when GitProtect should synchronize with your GitHub, or set a time interval.

Before hitting the Proceed button, pay attention to the default device. The default device is the device assigned to GitProtect that is used to retrieve GitHub organization and their data. It also performs the backup plan itself.

By default, the application uses a device marked with the main icon, but you can choose, which device should be responsible for performing this operation by clicking the Change button and selecting one of the devices from the list.

Now the adding process is finished. You can hit the Proceed button.

If Register using login and password/token switch was set to OFF, then the system may display GitHub sign in page, which you have to go through in order to complete the authentication process.

GitHub App (Beta)

Adding GitHub organization using GitHub App

Just like when adding an organization using OAuth, when adding via a GitHub App, we go to DevOps, select GitHub, and click the GitHub button. A window will appear where, similar to the OAuth process, we select "GitHub."

Next, from the dropdown menu "Connect Using," we select the option "GitHub App."

Next, we choose whether we want our organization to be automatically refreshed and set how frequently we want this to occur. Then, we click "Proceed".

A window will appear where we select where we want to install our application.

We must install the application in each organization and user account that we want to back up.

Next, we choose which repositories (all or selected) the application will have access to. Information on the permissions granted to the application is also provided here.

After clicking "Install & Authorize" repeat this operation for all organizations. At the end our organizations will be visible and ready for protection.

See also:

GitHub App overview

Pop-ups

To add an organization correctly, you may be asked to grant permissions to the GitProtect application. Your browser have to allow pop-ups.

Depending on which browser you use, you can edit the browser settings or allow the permission window to be triggered once.

Last updated