Skip to main content

← Back to parent Epic

MAZENG-FT-38 · Connect Maze to an authorized GitHub repository

Feature intent

A user needs to connect Maze to an approved GitHub repository without exposing raw access credentials to application code.

Why it matters

A user needs to connect Maze to an approved GitHub repository without exposing raw access credentials to application code.

Expected outcome

A recoverable, explicit GitHub Enterprise connection lets users select authorized repositories and branches safely.

In scope

  • Authenticate through a configured GitHub App or OAuth authority.
  • List authorized organization repositories and branches.
  • Make repository owner, host, and default branch explicit and support reconnect after failure.
Delivery status
IN_BACKLOG
Owner
RootAtSkic
Parent Epic
MAZENG-EP-11
Solution approval
PENDING

Acceptance

Acceptance outcomes

  1. 01

    Maze supports authenticated GitHub Enterprise access without exposing the raw access token to application code.

  2. 02

    The user can list available organization repositories and branches.

  3. 03

    Authentication failures produce a recoverable reconnect flow.

  4. 04

    Repository owner, host, and default branch are explicit rather than silently assumed.

Dependencies and risks

Dependencies

None recorded.

Risks

  • Connection depends on GitHub App or OAuth configuration and organization permissions.
  • Legacy OAuth callback URLs are hard-coded to http://maze.local.
  • The legacy Octokit client is globally configured and does not instantiate correctly scoped per-request clients.

Authoritative Architecture tasks

No authoritative Architecture tasks are linked.

Original source