Onboarding Troubleshoot

Boaz Dremer Updated by Boaz Dremer

Onboarding Troubleshoot

Github

In order to connect LinearB to Github the user that is authenticating should have organization admin rights in the organization that s/he is trying to connect.

When the user has sufficient permissions to the relevant organization, the authentication dialog will include a button that asks the user to grant access to the organization as well as the personal account (See image below). The user must first grant access to the organization and only then (after indication that organization access is granted) click on "Authorize LinearB". Failing to do so will cause LinearB to get only personal repositories from the Github account and not organization level repositories.

If the organization appears with "Request" button next to it. The user does not have sufficient privileges on the organization level to grant access to LinearB. In order to proceed with the onboarding process the user will have to first request access from the organization administrator through the "Request" button. Only after the organization administrator grants access to LinearB the user will be able to proceed and authorize.

If the LinearB were not granted access on organization level The user will either see only her personal repositories or will receive permission denied error. In this case the user should proceed with the following steps:

1. Go to Github -> Account -> Settings ->

2. Select Applications -> Authorized OAuth Apps. Go to LinearB

3. Click on "more" (...) and choose to revoke access to LinearB OAuth App.

4. Once access is revoked you can click on "Retry" button in the LinearB error screen in order to re-authorize LinearB making sure that in the Github Auth page access is first granted to your organization.

Gitlab

Gitlab permissions issues may occur when the user fails to authorize LinearB and clicks on "Deny" in the Gitlab authorization form. In such case the user will need to click "Retry" in the LinearB error page and then click on "Authorize" when back to the Gitlab authorization form.

BitBucket

BitBucket permissions issues may occur when the user fails to grant access LinearB and clicks on "Cancel" in the BitBucket authorization form. In such case the user will need to click "Retry" in the LinearB error page and then click on "Grant Access" when back to the BitBucket authorization form.

NOTE: LinearB is not fetching public repositories when showing the list of repositories for scanning. Only private repositories will be available for selection.

How did we do?

Github server (on-prem) connection guide

Contact