Skip to main content

Required Permissions

The user authorizing the Github connection needs specific organization-level permissions.

For Organization Installation

Only Organization Owners can install GitHub Apps. The Organization Owner role:
  • Has complete administrative access to the organization
  • Can install and authorize GitHub Apps for the entire organization
  • Can select “All repositories” or specific repositories during installation
  • Can purchase, install, manage billing for, and cancel GitHub Marketplace apps
Note: The GitHub App Manager role allows users to create, edit, and delete GitHub App registrations, but it does not grant the ability to install or uninstall GitHub Apps in the organization.

For Personal Account Installation

The user just needs to be the account owner of their personal GitHub account.

For GitHub Advanced Security Access

Since this integration pulls from GitHub Advanced Security (Code Scanning, Secrets Scanning, Dependabot), ensure:
  • GitHub Advanced Security is enabled on the repositories or organization
  • The installing user has read access to security alerts (usually automatic for Owners)

Key Points

  • GitHub Apps require installation - not just OAuth authorization
  • The user selects which repositories to grant access to
  • Can grant access to all repositories or specific repositories
  • The app needs permissions to read Code Scanning, Secret Scanning, and Dependabot alerts
Recommendation: Use an Organization Owner account for the installation to ensure the Leen GitHub App can be installed with access to all necessary repositories and security alerts.

Supported Data Models

Create a Connection for GitHub Advanced Security

1
1

Create a GitHub connection

  1. With Leen API Key and Customer’s Org ID, make an API request to create a new GitHub Connection.
More information can be found on the API Reference page.
The response will look like this:

Onboarding GitHub Advanced Security

Follow the steps below to onboard your environment to our GitHub Advanced Security integration.
1

Granting permission to Leen app for GitHub

  1. Open the oauth2_authorize_url from the connection creation step.
  2. Select the account/organization for which the github app needs to be installed for access to GitHub Advanced Security Alerts. GitHub-select-org
  3. Select the repositories that need to be authorized for the access. (Selection possible for all repositories or specific ones as well.) GitHub-select-repos
  4. Click Install and Authorize button to complete the GitHub app installation.
  5. The page will be redirected to Leen on a successful authorization. GitHub-auth-success