Skip to content

Configuring GitHub Authentication

To enable single sign-on (SSO) and streamline user management, you can integrate GitHub—either public GitHub.com or a private GitHub Enterprise instance—as an OAuth provider in the MemVerge AI platform. Follow the steps below to register a GitHub OAuth application and connect it to your cluster.

1. Choose Your GitHub Version

  1. Public GitHub.com
  2. Use this option if your organization stores code on GitHub’s public service.
  3. Private GitHub Enterprise
  4. If you have a self-hosted GitHub Enterprise server, select this option and provide the internal URL when prompted.

Note: The steps for creating an OAuth app are similar, but the form URLs differ slightly between public and enterprise GitHub.

2. Create an OAuth App in GitHub

  1. Open GitHub Settings
  2. Log in to GitHub and navigate to your Profile → Settings.
  3. Under Developer Settings, select OAuth Apps (or GitHub Apps if your UI differs).

  4. Click “New OAuth App” to begin registration.

  5. Fill In App Details

  6. Application name: Any recognizable name for the MemVerge AI platform integration (e.g., “MemVerge.ai”).
  7. Homepage URL: Enter the URL of your MemVerge AI deployment (e.g., https://demo.memvergelab.com).
  8. Application description (optional): A brief note indicating the purpose of this app.

  9. Authorization callback URL: Must match your platform’s callback address (e.g., https://demo.memvergelab.com).

  10. Register Application

  11. Once complete, click Register application. GitHub will generate a Client ID and Client Secret.

3. Configure the MemVerge AI Platform

  1. Open Auth Providers
  2. In the MemVerge AI UI, select Users & Authentication → Auth Providers.

  3. Choose GitHub from the list and ensure you pick the matching option (public or enterprise).

  4. Enter OAuth Credentials

  5. Client ID: Paste the Client ID from the GitHub OAuth App.

  6. Client Secret: Paste the Client Secret.

  7. Save and Activate

  8. Click Save at the bottom of the dialog.
  9. Once saved, you can switch GitHub to Active. MemVerge AI will now accept GitHub-authenticated logins.

4. Testing & Troubleshooting

  • Login Prompt: After enabling GitHub, navigate to your platform’s login page. You should see a Sign in with GitHub option.
  • Enterprise URL: For GitHub Enterprise, verify the internal domain is set correctly in your Auth Provider settings.
  • Callback Mismatch: If you encounter errors like “redirect_uri mismatch”, confirm the Authorization callback URL in GitHub matches exactly what is listed in MemVerge AI.
  • Certificate and Firewall: For self-hosted GitHub Enterprise, ensure SSL certificates and network rules permit secure connectivity between the MemVerge AI platform and GitHub.

With GitHub OAuth configured, users can seamlessly log in using their GitHub credentials, leveraging existing security measures (e.g., two-factor authentication) and organizational membership. This setup simplifies onboarding and enhances security across your AI workloads.