Technology

GitHubの権限管理を自動化、審査に応答がなければ失効

この記事のポイント

  1. 実現したこと

    管理用アプリEvergreenは、活動のないリポジトリへの警告と猶予期間後のアーカイブを自動で進める。

  2. 実現の仕組み

    アクセス審査用Issueのチェック欄を読み、残す外部協力者と権限を失効させる外部協力者を振り分ける。

  3. 得られた結果

    GitHubが構築した処理では、権限失効が一部失敗しても完了扱いにせず、失敗分を次回実行で再試行する。

  4. 従来との違い

    共有組織の手作業によるアクセス管理に、四半期ごとの審査と未回答時の自動失効を組み込んだ。

GitHubのアクセス審査を表すイラスト。空欄のチェック項目が並ぶ審査票の周囲にリポジトリの箱があり、外部協力者の鍵の多くは失効用トレイへ、1つは再試行を示す記号とともに保留トレイへ移されている。
AI生成画像

外部協力者のアクセス権限を、審査に応答がないまま残さず自動で失効させる。GitHubは共有組織向けの管理アプリEvergreenを構築した。失効処理が一部でも失敗すれば審査を未完了に保ち、次回実行で残りを処理する。

四半期の審査を定期実行へ移す

GitHubは、従業員が顧客やパートナーと製品試用や専門サービスで共同作業する共有組織向けに、管理用のGitHub AppであるEvergreenを構築した。担当者が追跡していた外部協力者のアクセス確認やリポジトリの整理を、定期的に動く処理へ移している。

処理本体は、コンテナ内で動くGo製の小規模なWebhookサーバーである。制御用リポジトリに置いた4つのGitHub Actionsワークフローが四半期ごとに動き、休眠確認、アクセス審査、休眠リポジトリの整理、アクセス権限の整理を起動する。

Issueのチェック欄を権限変更へつなぐ

アクセス審査では、各リポジトリのIssueが判断の窓口になる。担当者が権限を残す外部協力者にチェックを付けてIssueを閉じると、アプリがその選択を読み取り、選ばれた人の権限を維持し、それ以外の人の権限を失効させる。

Issueを閉じる操作には、判断者の確認も組み込まれている。GitHub従業員以外が閉じた場合はIssueを再び開いて理由を通知し、権限変更の判断として受け付けない。

未回答なら失効し、処理失敗なら保留する

審査の期限まで応答がない場合、整理処理は審査開始時に記録した外部協力者全員の権限を失効させる。対象を開始時のスナップショットで定め、未回答の審査でも権限の見直しを進める。

ただし、失効を試みただけでは審査を完了させない。一件でも失敗すれば審査を保留し、Issueを開いたまま次回実行で失敗分を再試行するため、失効済みの記録が付くのは全件の処理が成功してからになる。

変更履歴を残し、休眠リポジトリは削除しない

審査の経過は、リポジトリごとに一つのJSONファイルとして制御用リポジトリへ保存する。審査対象者、期限、判断者、処理結果などがGitのコミット履歴に残るため、アクセス変更の経緯を同じ履歴で追うことができる。

リポジトリ自体の整理には、活動の有無を使う。人による活動が一定期間なければ警告し、猶予期間後も活動がなければアーカイブするが、リポジトリや内容は削除せず、復旧可能な状態を保つ。