GitHub Integration

Pensar Console integrates with GitHub to scan and secure your repositories. The integration uses a GitHub App to provide secure access to your code without requiring personal access tokens.

Prerequisites

Before connecting GitHub, ensure you have:

1. A GitHub account with access to the repositories you want to scan
2. Organization owner or admin access (if installing on an organization)

Connecting GitHub

From Workspace Settings

1. Navigate to Settings → Integrations in your Pensar Console workspace
2. Expand the GitHub section
3. Click Install another GitHub account (or Install GitHub if this is your first connection)
4. A popup window will open to GitHub’s app installation page
5. Select the organization or user account where you want to install the app
6. Choose to install on all repositories or select specific repositories
7. Click Install
8. You’ll be automatically redirected back to Pensar Console

Direct Installation

You can also install the Pensar GitHub App directly from GitHub:

1. Visit github.com/apps/pensarapp
2. Click Install
3. Select the organization or user account where you want to install the app
4. Choose your repository access preferences
5. Click Install

From Onboarding

When creating a new workspace, you’ll be prompted to connect GitHub during the onboarding process. Simply follow the same steps above.

Permissions

The Pensar GitHub App requests the following permissions:

Adding Repositories

After the app is installed:

1. Go to Projects → New Project in Pensar Console
2. Your GitHub repositories will appear in the repository list
3. Select a repository and configure your project settings
4. Click Create Project to start scanning

Managing Installations

Viewing Connected Accounts

1. Navigate to Settings → Integrations
2. Expand the GitHub section
3. You’ll see all connected GitHub accounts and organizations

Adding More Accounts

Click Install another GitHub account to connect additional GitHub organizations or user accounts.

Modifying Repository Access

To change which repositories Pensar can access:

1. Go to your GitHub organization or account settings
2. Navigate to Installed GitHub Apps
3. Find Pensar and click Configure
4. Update the repository access settings
5. The changes will be reflected in Pensar Console automatically

Removing an Installation

To disconnect a GitHub account:

1. Go to your GitHub organization or account settings
2. Navigate to Installed GitHub Apps
3. Find Pensar and click Configure
4. Scroll down and click Uninstall

Troubleshooting

Installation Pending Approval

If you see “Installation pending approval”, it means you requested to install the app on an organization where you’re not an admin. An organization owner will need to approve the installation.

Repositories Not Appearing

If your repositories don’t appear in the project creation list:

1. Verify the GitHub App is installed on the correct organization
2. Check that the app has access to the specific repository
3. Ensure you have at least read access to the repository on GitHub

Permission Errors

If you see permission errors when scanning:

1. Verify the GitHub App has the required permissions listed above
2. Ensure the app is installed on the repository you’re trying to scan
3. Check that the installation hasn’t been suspended

Need Help?

If you encounter issues setting up your GitHub integration, please contact our support team at team@pensarai.com.