Guides

GitHub Integration

Rapticore Integrates with the customer’s GitHub instance using a GitHub App.

📘

Rapticore only integrates with GitHub Cloud, currently.

For more information, refer to our GitHub integration reference.

Setup

Setup involves:

  1. Creating a GitHub App in your organization
  2. Installing the created GitHub App

GitHub privileges

You must have permissions to modify Organization settings in your GitHub organization

📘

Rapticore only requires read permissions on repository metadata for integration.

Rapticore privileges

You must have an Admin role to configure GitHub integrations in Rapticore.

Rapticore Configuration

  1. Login to Rapticore as an admin user and navigate to the Manage > Integrations page and select the GitHub integration
1030
  1. Click New Organization and enter your organization name and then click "Create App"
1412 1056

📘

This may redirect you to GitHub and require you to confirm your identity by entering your GitHub Password

  1. Click Create a GitHub App
1056

📘

Optional: Change the name of the GitHub App if there is a name conflict.

This will redirect you back to Rapticore to install the application.

  1. Confirm the GitHub details and click "Install App"
1235

This will redirect you back to GitHub where you can confirm the application details.

  1. Click "Install" to proceed.
1232

This will redirect you to a confirmation page.

  1. Optionally, select specific repositories to be integrated and click Install

🚧

Rapticore recommends using the default configuration to track "All repositories" so that newly created repositories will automatically be detected by Rapticore without reconfiguring your installed GitHub App permissions to detect them.

1232

This will redirect you back to Rapticore.

  1. Confirm the GitHub App was installed. You will see the Organization displayed with an Edit button.
1399

❗️

Troubleshooting

If after you follow the prior steps, the GitHub Organizations shows "Install App" instead of "Edit", click on "Install App" and then follow the Troubleshooting steps.

Once completed, you can navigate to the Applications > Repositories page in Rapticore and view your integrated GitHub repositories.

Updated over 3 years ago

What’s Next