Skip to main content

GitHub

Connection

Connecting sends you to GitHub to approve Klef’s access.

Setup

An organization owner connects GitHub by installing Klef’s GitHub App on the organization and granting it the Members permission at read and write. Repository access also needs the repository Administration permission at read and write, and organization roles need Custom organization roles at read. Klef keeps no token: the app signs in to the installation each time it calls. Klef adds a person by the GitHub username the policy maps, or invites them by email when it maps none. An organization of managed users takes no email invitations, so map the username there.

github.member

Fields

Default Account Matching Rules

When Klef adopts an account that already exists in GitHub, it works out whose it is by trying these in order. A connection can override them.

Examples

Engineering access

The engineering group, a seat on the GitHub engineering team and the incident channels, with GitHub removed when they leave.

Leaver offboarding

Ask the manager to plan the handover, then close Microsoft, Slack and GitHub access on the last day and tell security.