GitHubはどのようにして全リポジトリに永続的なオーナーを付与したか
How GitHub gave every repository a durable owner (github.blog)
要約
GitHubは、セキュリティインシデント対応において、リポジトリのオーナーシップを明確にすることが不可欠であると認識しました。そこで、GitHub Actionsのワークフロー内でリポジトリのオーナーシップを永続化する仕組みを導入しました。これにより、リポジトリの管理者が不在になった場合でも、自動的にオーナーシップが引き継がれ、セキュリティ管理の継続性が保証されるようになりました。
全文翻訳
GitHubが全リポジトリに永続的なオーナーを付与した方法
GitHubには、内部のGitHub組織に14,000を超えるリポジトリがあります。2025年初頭の時点で、アーカイブされていないリポジトリは11,000を超えていましたが、その大部分には明確なオーナーが存在しませんでした。本番サービスに関連付けられたリポジトリについては、歴史的に堅牢な永続的オーナーシップがありましたが、関連サービスを持たないリポジトリについては、オーナーが誰であるかを確実に知る方法がありませんでした。
このギャップは、シークレットスキャンの修正作業中に繰り返し発生する問題となりました。技術的にはシークレットをローテーションできましたが、リポジトリのオーナーを知らずに行うのはリスクが高く、しばしば混乱を招き、修正作業をどこにルーティングすべきか明確な方法がありませんでした。1ヶ月半かけて、アクティブな全リポジトリのオーナーシップを検証し、使用されなくなった約8,000のリポジトリをアーカイブし、リポジトリ作成時に最初からオーナーシップを必須とするように変更しました。
当初のオーナーシップモデル
長年、GitHubは内部のService Catalogを通じて、デプロイされたサービスのオーナーシップを追跡してきました。各サービスエントリには、それがどのリポジトリに存在するか、担当チーム、エグゼクティブスポンサー、サポート情報などのメタデータが記録されていました。これにより、サービスからリポジトリへのマッピングが得られました。
Repo Ownershipアプリのサービスオーナーシップエントリの例を以下に示します。
- team: github/repo-ownership-dev
repo: https://github.com/github/repo-ownership
name: repo-ownership
kind: moda
long_name: Repo Ownership
description: Service enforcing repo ownership across the org
maintainer: mrecachinas
exec_sponsor: stephanmiehe
...
この豊富なメタデータにより、インシデント対応、オンコールルーティング、脆弱性管理、コンプライアンススコープ設定などのサービス中心のワークフローが可能になります。
残念ながら、その関係は多対一(つまり、1つのサービスは1つのリポジトリにしか関連付けられませんでしたが、1つのリポジトリは複数のサービスを持つことができました)でした。これは、サービスから開始すれば、リポジトリとそのオーナーを見つけることができたことを意味します。しかし、リポジトリから開始してオーナーを見つける必要があった場合、ルックアップを逆にする必要があり、それはそもそもサービスにマッピングされたリポジトリに対してのみ機能しました。
これにより、チームリポジトリ、ドキュメントリポジトリ、内部ツール、ワンオフプロジェクトリポジトリ、個人実験リポジトリ、およびデプロイされたサービスをバックアップしないその他のすべてを含む、重大なオーナーシップのギャップが残りました。これらの「オーナー不明」のリポジトリのオーナーに連絡する必要があるたびに、手作業が必要でした。コミット履歴を確認する、READMEを読む、Slackで尋ねる、またはリポジトリ名に基づいて推測する、といった作業です。
ワンオフの作業であれば、そのような曖昧さは煩わしいものの管理可能ですが、組織全体に広がる定期的なセキュリティワークフローにとっては、現実的なリスクとなります。シークレットスキャンのクリーンアップ中、アラートに関する情報に基づいた意思決定を行う前に、適切なオーナーを見つけようと多くの時間を費やしました。
新しいオーナーシップモデルの設計
根本的に、リポジトリのオーナーシップをファーストクラスのプロパティにする必要がありました。各リポジトリ内に専用のファイルでオーナーシップを保存することや、中央集権的なリポジトリで管理することを検討しましたが、最終的にGitHubカスタムプロパティを選択しました。このアプローチは、オーナーシップを管理するためのネイティブで構造化された、組織全体でクエリ可能な方法を提供しました。また、オーナーシップの種類に応じて、エンタープライズおよび組織のポリシーとルールセットを選択的に強制することも可能になりました。
ownership-typeとownership-nameの2つのカスタムプロパティを作成しました。
ownership-typeは、「Service Catalog」、「Hubber Handle」(「Hubber」はGitHub社員を指す言葉です)、および「Team」の3つの値を受け入れました。これらはGitHubにおけるリポジトリオーナーシップの現実的な範囲をカバーしていました。リポジトリは、サービス(オンコールチームと定義されたライフサイクルを持つ)、チーム(共有ドキュメントリポジトリや内部ツールなど)、または個人(個人プロジェクトや実験など)のいずれかに属します。ownership-nameは、軽い検証付きのテキストフィールドでした。GitHubアプリはすべての値を検証しました。Hubberハンドルは、実際のGitHub組織への所属に対してチェックされ、チームは組織内に存在し、少なくとも2人のメンバーがいることが確認され、Service CatalogエントリはService Catalog自体に対して確認されました。フォーマットについては意図的に許容範囲を広げました。例えば@my-teamと入力した場合でも受け入れました。オーナーシップの追加を容易にし、存在しないチーム、退職した従業員、廃止されたサービスなどの無効なエントリを捕捉するために、堅牢な検証に依存することを目指しました。
初日のカバレッジ
誰かに何かを依頼する前に、Service Catalogからリポジトリカスタムプロパティへの定期的な同期を構築しました。既知のサービスをバックアップするすべてのリポジトリについて、ownership-typeを「Service Catalog」に設定し、ownership-nameを自動的に入力しました。これにより、約1,500のリポジトリがカバーされ、チームリポジトリ、ドキュメントリポジトリ、ワンオフプロジェクト、個人リポジトリが残りました。
ロールアウト
これをロールアウトするために、Kubernetes CronJobをバックエンドとするGitHubアプリを構築しました。強制ロジックは、Service Catalog、GitHub API、およびいくつかの内部システムにアクセスする必要があったため、単純なGitHub Actionsワークフローでは不十分でした。
以下の図は、初期オーナーシップスキャンから警告Issueの作成、自動クローズ、または30日後のアーカイブまでのリポジトリオーナーシップ強制フローを示しています。
[画像: リポジトリオーナーシップ強制のフローチャート:リポジトリがオーナーシップについてスキャンされ、オーナーシップがない場合は30日間のアーカイブ警告Issueが開かれ、未解決のIssueはアーカイブにつながり、解決されたIssueは自動的にクローズされます。]
CronJobの最初の実行を土曜日の午前にスケジュールしましたが、誰も気にかけていないだろうと考えていました…大きな間違いでした!組織全体のリポジトリにIssueが出現し始め、人々はSlackで、リポジトリにアーカイブされるという新しいIssueについて質問し始めました。グローバルに分散された企業では、常に誰かがオンラインになっています。
30日間の猶予期間の後、オーナーシップが設定されていないリポジトリをすべてアーカイブしました。アーカイブを選択したのは、それが元に戻せて非破壊的だからです。リポジトリは読み取り専用になり、GitHub Actionsの実行は停止しますが、何も削除されません。誰かが再び必要になった場合、それをアンアーカイブしてオーナーシップを設定し、続行するための簡単な方法を提供しました。これにより、すべてのエッジケースを議論するのではなく、安全に広範囲にアーカイブを適用することができました。
最初の猶予期間が経過し、大量のアーカイブが完了した後、強制ループを30日から1時間に短縮しました。作成時のオーナーシップ要件を回避できた新しいリポジトリは、ほぼ即座にフラグが立てられるようになりました。
シャープエッジ
これはほとんどシームレスにロールアウトされましたが、2つの軽微な内部インシデントで興味深いエッジケースが露呈しました。
最初のインシデントは、オーナーシップが適用されていなかったリポジトリをアーカイブしたことによって引き起こされました。Datadogは、監視ワークフローの一部として、そのリポジトリにIssueを開くように設定されていました。リポジトリがアーカイブされ、DatadogがIssueを作成できなくなったとき、当社の内部監視サービスがそれを検知し、担当チームに自動的にページングし、彼らは私たちにエスカレーションしました。
そのインシデントは、通知方法のギャップを露呈しました。オーナーシップIssueはリポジトリに着陸していましたが、誰も直接通知されていませんでした。これを修正するために、リポジトリ管理者に@-mentionし、フォールバックとして書き込みアクセス権を持つすべてのユーザーをオーナーシップIssueに割り当てました。これにより、Issueが埋もれたり見過ごされたりすることなく、実際にオーナーシップを設定できる人々がすぐにそれらを確認できるようになりました。
2番目のインシデントは、データ信頼性の問題でした。Service Catalogの停止に対しては堅牢でしたが、それが古いデータや破損したデータを返す可能性は考慮していませんでした。もし悪いデータが原因で、実際にはService Catalogエントリを失っていないリポジトリのバッチが失われたとアプリが判断した場合、私たちは正当なオーナーを持つリポジトリを大量にアーカイブすることになります。
正当なリポジトリをアーカイブするリスクを軽減するために、低ウォーターマークを追加しました。各実行中に、アクションを実行する前に、アプリは実行しようとしているアーカイブの数と作成しようとしているIssueの数を集計します。その数が控えめな閾値を超えた場合、実行を完全に中止し、悪い実行のリスクを冒す代わりにDatadogモニターをトリガーします。Service Catalogに到達できない場合、ジョブはService Catalogの検証をスキップし、独立して検証できるもののみをチェックします。
結果(数字で見る)
約3,000のアクティブなリポジトリと11,000のアーカイブ済みリポジトリ(開始時の約3,000から増加)で完了しました。全体の作業は、最初の(土曜日の)実行から安定状態まで45日未満で完了しました。現在、すべてのアクティブなリポジトリには検証済みのオーナーがいるか、アーカイブされます。
新しくアーカイブされたリポジトリの多くは、長年コミットされていませんでした。放棄された実験、完了したハッカソンプロジェクト、さらには2008年の個人プロトタイプまでありました。それらをアーカイブすることで、最終的にサーフェスエリアが減少し、アクティブなリポジトリのインベントリが現実に即したものになりました。
オーナーシップを定着させる
100%のカバレッジを達成しても、それが100%を維持しなければ意味がありません。そのため、リポジトリ作成ページ(以下に示す)、内部ツール、自動化を含むすべてのリポジトリ作成ワークフローでオーナーシッププロパティを強制し、すべての新しいリポジトリで必須としました。
[画像: GitHubリポジトリ作成ページに、必須のオーナーシップカスタムプロパティフィールドが表示されています。]
また、強制ループを締めました。オーナーシップを失ったリポジトリは、元の30日間の猶予期間ではなく、1時間以内にフラグが立てられるようになりました。
各オーナーシップタイプには独自の耐久性特性があり、それらを考慮して設計しました。Service Catalogエントリはサービスライフサイクルに従います。サービスが非推奨になると、そのリポジトリも通常アーカイブされ、それは意図された動作です。チームは少なくとも2人のメンバーがいることで検証され、チームの存在とメンバーシップは比較的安定しています。個人のHubberハンドルは、誰かが会社を辞めたときにのみ無効になります。これは通常、その個人のリポジトリもアーカイブされるべきであることを意味します。単一の個人よりも長く存続するのに十分重要なリポジトリの場合、オーナーシップは個人ではなく、チームまたはサービスであるべきです。
あなたにとっての意味
GitHubカスタムプロパティを使用して、同様のオーナーシップモデルを今日から実装できます。推奨するアプローチは次のとおりです。
- オーナーシップの分類を定義する。 あなたの組織に適したオーナーの種類を決定してください。サービス、チーム、個人は私たちには機能しましたが、あなたのカテゴリは異なるかもしれません。
- 組織レベルでカスタムプロパティを作成する。
ownership-typeプロパティを、許可された値を持つシングルセレクトとして設定し、ownership-nameプロパティをテキストとして設定します。カスタムプロパティはAPIを通じてクエリ可能で、組織全体で表示されます。 - サービスカタログやアセットインベントリがある場合は、同期する。 すでに追跡しているリポジトリのオーナーシップを事前に設定することが、人々がギャップを埋めるように依頼する前に、意味のあるカバレッジを得るための最も速い方法です。
- リポジトリ作成時にオーナーシップを強制する。 プロパティを必須にして、インベントリが今後もクリーンに保たれるようにします。
- 既存のリポジトリに対して猶予期間ワークフローを構築する。 合理的な締め切り(私たちは30日を使用しました)を持つIssueを開き、その後、引き継がれなかったリポジトリをアーカイブします。アーカイブは元に戻せて非破壊的なので、安全なデフォルトです。
- 最初の強制実行を土曜日に実行しないでください!
- 大規模な自動化を信頼する前に、ガードレールを構築する。 低ウォーターマークと@-mentionフォールバックは、元の設計にはありませんでした。それらは実際のインシデントから生まれました。リポジトリをアーカイブしたり、大規模にIssueを開いたりするシステムを構築している場合は、データソースが時々間違っている可能性があり、通知が失われることもあると想定してください。最初からそのように設計してください。
カスタムプロパティの詳細については、カスタムプロパティのドキュメントを参照してください。
執筆者
[画像: Michael Recachinas]
Michael RecachinasはGitHubのスタッフセキュリティエンジニアであり、脆弱性管理、セキュア開発ライフサイクルツール、開発者中心のセキュリティ自動化に焦点を当てた大規模なセキュリティプログラムを主導しています。彼は、大規模に動作し、チームが安全な選択を容易な選択にするのを助けるシステムを構築することにキャリアを費やしてきました。