Docs
How To
GitHub Integration Setup

GitHub Integration Setup

This guide explains how to configure GitHub integration in Dr Migrate to enable the Application Assessment feature with GitHub Copilot.

Before you begin: This configuration is required before you can use the “Assess with copilot” option in Application Assessment. For information about using the Application Assessment feature, see Application Assessment with GitHub Integration.

Prerequisites

System Requirements

Requirement Details
GitHub Account A GitHub account with access to the repository where you want to create issues
GitHub Repository A repository where application assessment issues will be created
Admin Access Administrator access to Dr Migrate to configure the integration

Required Permissions

Permission Scope
Repository Write Access Ability to create issues in the target GitHub repository
OAuth App Creation Permission to create OAuth apps in your GitHub account or organization

Configure GitHub OAuth App

Before you can use the GitHub integration, you need to create a GitHub OAuth App and configure it in Dr Migrate.

Navigate to GitHub Settings

Go to your GitHub account and click your profile picture → Settings. In the left sidebar, click Developer settings.

For organization accounts, navigate to Settings → Developer settings → OAuth Apps.

Create OAuth App

Click OAuth Apps → New OAuth App.

Configure Application Settings

Fill in the following details:

  • Application name: DrMigrate Integration (or your preferred name)
  • Homepage URL: Your Dr Migrate application URL (e.g., https://yourdomain.com)
  • Authorization callback URL: https://yourdomain.com/auth/github/callback
  • Application description: (Optional) Integration for migration management

Generate Client Secret

After creating the app, click Generate a new client secret.

Copy the secret immediately—it will only be shown once!

Copy Credentials

Copy both the Client ID and Client Secret from the GitHub OAuth App page.

Configure GitHub Integration in Dr Migrate

Navigate to Admin → GitHub Integration in Dr Migrate and enter the Client ID and Client Secret you copied from GitHub.

GitHub Integration Configuration Screen
Your Client Secret will be securely stored in Azure Key Vault. Never share or commit these credentials to source control.

For detailed instructions, refer to the GitHub documentation on creating OAuth apps.

Verification

After configuring the GitHub integration:

  1. Navigate to an application with Java or .NET detected technology
  2. Go to the 6R Treatments menu
  3. Verify that the “Assess with copilot” option is available

If the option is not available or you encounter errors when creating issues, verify that:

  • The OAuth app credentials are correctly entered in Admin → GitHub Integration
  • The callback URL matches your Dr Migrate application URL
  • Your GitHub account has write access to the target repository

Next Steps

Once GitHub integration is configured, you can use the Application Assessment feature. See Application Assessment with GitHub Integration for instructions on using the feature.