メインコンテンツへスキップ
見出し画像

GitHubをPrivateにしただけでは、顧客の機密情報は守れない

    「RepositoryはPrivateだから大丈夫です」

    顧客案件のソースコードや社内システムをGitHubで管理するとき、よく聞く言葉です。確かに、Publicのまま放置するよりははるかに安全です。しかし、Privateは安全対策の完成形ではありません。見知らぬ人がWebから閲覧しにくくなるだけで、社内の誰が読めるのか、退職した人がまだ入れるのか、外部ツールが何を取得できるのか、GitHub Actionsが本番環境へ何を送れるのかまでは決めてくれません。

    むしろ事故は、派手なサイバー攻撃よりも、日常の小さな設定から起きます。社員個人のアカウントがRepositoryを所有していた。外注先へ付けたAdmin権限が契約終了後も残っていた。APIキーを誤ってCommitした。便利そうなGitHub AppへOrganization全体の権限を渡した。mainブランチへ誰でも直接Pushできた。本番Deployが承認なしで走った。

    こうした問題は、エンジニアだけの責任ではありません。Repositoryの所有者、契約、権限、課金、退職手続き、事故時の連絡は、経営・管理・法務・人事・情報システムにも関係します。

    この記事の結論は明確です。GitHubの安全性は、Privateという一つの設定ではなく、所有、認証、権限、変更、秘密情報、自動化、外部接続、監査、復旧を重ねた運用で決まります。 そして、設定しただけでは不十分です。実際に拒否されるかを試し、定期的に見直し、事故が起きたときに止められる状態まで作る必要があります。

    この記事では、GitHub Organizationが会社のRepositoryを所有する前提で、経営者、管理担当者、非エンジニア、エンジニア、外部委託管理者が一緒に実行できる順序へ整理します。画面名や料金、利用条件は変更されるため、実行時点のGitHub画面と公式文書を必ず再確認してください。

    Privateは入口を閉めるだけで、社内の鍵までは管理しない

    Private Repositoryは、一般公開を防ぐための重要な設定です。ただし、これだけで安全だと考えるのは危険です。

    たとえば、オフィスの玄関を施錠していても、退職者が合鍵を持ったままなら安心できません。清掃会社や保守会社が、必要以上の部屋へ入れる状態も同じです。金庫の暗証番号を机に貼っていたら、入口の鍵が強くても意味がありません。

    GitHubでも考え方は変わりません。

    RepositoryがPrivateでも、権限を持つ人は内容をCloneできます。Cloneとは、Repositoryの内容と履歴をローカルPCへ複製することです。GitHub上のアクセス権を削除しても、すでに複製されたデータが自動で消えるわけではありません。

    また、PrivateからPublicへ変更すると、コードだけでなく、Issue、Pull Request、Wiki、Actionsの履歴、添付物、Releaseなど、周辺情報の公開範囲にも影響する可能性があります。あとからPrivateへ戻しても、公開中に取得された情報を回収することはできません。

    つまり、Privateは必要条件ですが、十分条件ではありません。

    画像

    安全なGitHub運用は、少なくとも次の九層で考えます。

    所有者は会社か。ログインは本人確認できるか。必要な人だけが読めるか。重要な変更にはレビューがあるか。秘密情報を誤って入れないか。自動処理の権限が広すぎないか。外部AppやWebhookは必要最小限か。誰が何をしたか記録できるか。事故時に止めて復旧できるか。

    一つでも抜けると、他の層が強くても事故につながります。

    所有と権限を会社の管理下へ戻す

    細かな設定を増やす前に、まず「誰の資産で、誰が触れられるのか」を会社として管理できる状態へ戻します。この節では、Repositoryの所有者、Organization Owner、一般メンバー、外部委託先の順に、アクセスの土台を確認します。

    最初に確認すべきはRepositoryの所有者である

    セキュリティ設定を細かく触る前に、対象Repositoryが誰のものかを確認します。

    Repository名の左側には、通常「所有者名 / Repository名」が表示されます。この所有者が会社のGitHub Organizationなら、会社が管理の主体になれます。社員個人のユーザー名や外部委託先のOrganizationであれば、会社の統制が効きにくい状態です。

    個人所有が危険なのは、技術的な問題だけではありません。

    その人が退職したときに移管できるのか。請求先は誰なのか。事故時にOrganization Ownerが対応できるのか。契約上、顧客成果物を会社が管理していると言えるのか。個人アカウントの二要素認証や復旧手段を、会社として確認できるのか。

    この段階で曖昧なら、他の設定を進めても土台が弱いままです。

    確認記録には、Repository名、現在の所有者、会社Organization名、判定、確認日、確認者を残します。単なるメモではなく、後から「誰が、いつ、何を確認したか」を追える証拠です。

    画像

    Organization Ownerは少なすぎても多すぎても危険になる

    Organization Ownerは、会社のGitHub全体へ強い権限を持つ役割です。請求、メンバー、セキュリティ設定、Repository、Appなど、影響範囲が広くなります。

    一人だけにすると、その人が不在、退職、アカウント停止になったとき、会社のGitHub管理が止まる可能性があります。反対に、念のため多くの人へOwnerを付けると、侵害される入口と誤操作の可能性が増えます。

    単独Ownerは業務停止リスクが高いため、少なくとも復旧可能な複数名体制を検討します。ただし、Ownerを増やすほど侵害対象も増えます。企業規模、緊急対応、請求管理、24時間運用を踏まえ、必要性を説明できる人数へ限定します。

    大切なのは人数そのものではなく、役割です。

    請求を担当する人。緊急時にメンバーを削除できる人。Organization SecretやGitHub Appを管理する人。SSOやID管理を担当する人。これらをOwnerへ集中させるのか、より限定された権限へ分けるのかを決めます。

    Ownerを追加するときは、便利だからではなく、必要な責任を果たすために付与します。外すときも、先に代替担当と復旧手段を確認します。

    全員がすべてを見られる初期設定をやめる

    GitHub Organizationには、一般メンバーへ自動的に与える基本権限があります。これが広いままだと、担当外の社員が顧客Repositoryを閲覧できる可能性があります。

    顧客案件では、原則としてBase permissionsをNo permissionにし、担当Teamを通じて必要なRepositoryだけへ権限を付けます。

    画面では、Organization → Settings → Access → Member privileges → Base permissionsへ進みます。Enterprise側でPolicyが固定されている場合は、Organization Ownerでも変更できません。

    ここでいうTeamは、部署名を付けるだけの名簿ではありません。誰がどのRepositoryへ何の目的でアクセスできるかを管理する単位です。

    閲覧だけならRead。IssueやPull Requestの整理ならTriage。通常の開発ならWrite。Repository運用の責任者ならMaintain。危険な設定変更まで含むAdminは最小人数に限定します。

    個人へ直接権限を付ける運用は、最初は楽です。しかし、人が増えるほど削除漏れが起きやすくなります。異動、休職、兼務、外注、契約終了のたびに個別確認が必要になるためです。

    Team経由なら、担当Teamから外すことで関連Repositoryへの権限をまとめて見直せます。

    画像

    ただし、Base permissionsを変更すると、Teamや個別権限が付いていない人が急にRepositoryを開けなくなる場合があります。変更前に、必要なTeamが作られているか、Botや外部ツールが個人権限へ依存していないかを確認します。

    設定後は、担当外の一般メンバーで実際にRepositoryを開き、拒否されることを確認します。設定画面を見ただけでは完了ではありません。

    Repositoryを誰でも作れる状態は、見えない情報資産を増やす

    一般メンバーが自由にRepositoryを作れると、会社が把握していない情報保管場所が増えます。

    顧客名を含むRepositoryが個人判断で作られる。検証用Repositoryに本番データが入る。Publicを選んでしまう。管理Teamや保存期限が決まらない。Actionsや外部Appが勝手に追加される。

    こうしたShadow IT、つまり会社が把握していないIT利用は、Repository数が少ないうちは見えにくく、時間がたってから問題になります。

    一般メンバーによる新規Repository作成は原則制限し、必要ならPrivateだけを許可します。

    画面では、Organization → Settings → Access → Member privileges → Repository creationへ進みます。この設定は新規作成の選択肢を制限するもので、既存RepositoryのVisibility変更を自動では防ぎません。新規作成時には、業務目的、顧客、情報分類、Owner、管理Team、保存期限、Actions使用、外部App使用、承認者を記録します。

    ここで重要なのは、作成を禁止すること自体ではありません。安全に作る正式ルートを短くすることです。申請が重すぎると、個人アカウントや別サービスへ逃げる人が出ます。

    セキュリティは「何でも禁止」では続きません。安全な標準経路を最も楽な経路にする必要があります。

    二要素認証は必須だが、SMSだけでは弱い

    パスワードが漏れても、別の確認手段がなければログインできないようにする仕組みが二要素認証です。

    GitHub Organizationでは、メンバー、Billing Manager、Outside Collaboratorなどへ二要素認証を要求できます。さらに、Passkey、Security Key、Authenticator App、GitHub Mobileなど、安全性の高い方式を求める設定もあります。

    Passkeyは、端末の生体認証やPINを使ってログインする仕組みで、偽サイトへ認証情報を入力させるフィッシング攻撃に強い特徴があります。

    GitHubが「安全な二要素認証方式」として扱うのは、Passkey、Security Key、Authenticator App、GitHub Mobileです。SMSが一つでも設定されている利用者は、安全な方式だけを求めるOrganizationへアクセスできなくなるため、強制前に対象者を確認し、移行期間を設けます。

    画像

    強制する前には、Organization → Settings → Security → Authentication securityで対象設定を確認し、People画面で未対応者を洗い出して、期限と手順を通知します。いきなり有効にすると、未設定者がOrganizationから外れたり、業務へアクセスできなくなったりする可能性があります。

    復旧コードをGitHub Repositoryやメール下書きへ置いてはいけません。会社承認のPassword Managerや物理保管を使います。Ownerは復旧手段を二系統以上持ち、同じ端末だけへ依存しないようにします。

    外部委託先の権限は契約と同じ期限で管理する

    Outside Collaboratorは、Organizationの一般メンバーにはせず、特定Repositoryへアクセスさせる外部協力者です。

    便利な仕組みですが、契約終了後も権限が残りやすい場所でもあります。

    毎月、氏名、会社、契約、対象Repository、権限、開始日、終了日、責任者、次回確認日を棚卸しします。AdminやMaintainが本当に必要かも見直します。

    削除時には、GitHub上のアクセス権だけを消して完了にしません。ローカルPCへCloneしたデータ、ダウンロードしたArtifact、個人端末のキャッシュ、共有されたSecret、関連するクラウド権限も確認します。

    契約書には、契約終了時のデータ削除、バックアップ、複製、再委託、事故通知、証跡提出を含める必要があります。GitHub設定と契約条件は別々ではなく、同じアクセス管理の表裏です。

    退職、異動、外注終了に伴うGitHubやSaaSの権限削除を、人事・情シス・現場の期限と証拠まで含めて設計する方法は、こちらの記事で詳しく整理しています。

    画像

    重要な変更を一人で本番へ通さない

    所有者とアクセス権を整えても、重要な変更を一人でmainへ入れられるなら事故は防ぎ切れません。ここでは、Pull Request、Ruleset、CODEOWNERSを使い、変更内容と承認の記録を残す方法を見ていきます。

    mainへ直接書ける状態を終わらせる

    重要なRepositoryで、誰でもmainブランチへ直接Pushできる状態は危険です。

    mainは通常、正式版や本番へ近いコードを置く中心ブランチです。ここへ直接変更できると、誤操作、侵害されたアカウント、レビュー不足の変更が、そのまま本番へ進む可能性があります。

    Branch Rulesetを使い、Pull Requestを経由し、最低一人の承認を必要にします。

    画面では、Repository → Settings → Rules → Rulesets → New ruleset → New branch rulesetへ進み、Default Branchを対象にします。利用可能なら最初はEvaluateで影響を確認し、問題がなければActiveへ切り替えます。新しいCommitが追加されたら古い承認を無効にし、未解決の会話が残っている間はMergeできないようにします。Force Pushと削除も禁止します。

    Pull Requestは、変更内容を第三者が確認し、会話と記録を残してから取り込む仕組みです。

    RulesetのBypass listは、原則として空にします。Ownerだから常に例外、という運用にすると、最も強い権限を持つ人のアカウントが侵害されたときに防御が働きません。

    画像

    一人会社や一人開発では、Required approvalsを1にすると自分だけではMergeできません。その場合は、外部レビュー契約、定期レビュー、重要Repositoryだけ別承認、緊急時の期限付きBypassなど、組織の実態に合わせます。

    セキュリティ設定は厳しければ良いのではなく、実際に運用でき、例外が記録されることが重要です。

    CODEOWNERSで重要な変更のレビュー先を自動化する

    CODEOWNERSは、特定のファイルやフォルダが変更されたとき、誰にレビューを求めるかを定義するファイルです。

    たとえば、GitHub ActionsのWorkflow、Infrastructure、認証処理、権限設定、CODEOWNERS自身は、通常の機能変更より慎重に見る必要があります。

    すべての変更は開発責任者へ。`.github/workflows/`はSecurity Teamへ。`infrastructure/`はPlatform Teamへ。CODEOWNERS自身はSecurity Teamへ。このように重要領域ごとに担当を決めます。

    ただし、CODEOWNERSを書いただけでは承認必須になりません。Ruleset側でCode Ownerのレビューを要求します。また、指定したTeamが対象Repositoryへアクセスできることも必要です。

    この仕組みは、詳しい人が気づけば見る運用を、変更が起きたら自動で呼ばれる運用へ変えます。

    秘密情報はGitの外へ分離し、漏れたら失効を急ぐ

    APIキーや秘密鍵は、コードと同じ場所へ置かないことが基本です。それでも漏えいは起こり得るため、予防だけでなく、検知後に何を最優先で止めるかまで決めておきます。

    APIキーや秘密鍵はGitへ入れない

    顧客機密を扱うGitHub運用で、最も分かりやすく重大な事故の一つがSecret漏えいです。

    Secretとは、APIキー、Access Token、秘密鍵、Password、接続文字列、証明書など、他者に知られるとシステムへアクセスされる情報です。

    `.gitignore`へ`.env`や秘密鍵の拡張子を書いても、すでにCommitした情報は消えません。Gitは履歴を持つため、現在のファイルから削除しても過去のCommitに残ります。

    画像

    GitHubへ置くのは、Source Code、設定のTemplate、Schema、匿名化または合成したTest Data、暗号文、外部データの参照IDです。

    認証情報、顧客の生データ、個人番号、カード情報、医療情報などは、専用のSecret Manager、Database、権限管理されたStorageへ分離します。

    Secret Managerは、秘密情報を暗号化し、誰がいつ取得したかを管理し、必要に応じて更新できる専用保管庫です。

    Secret Protectionは費用と対象範囲を確認して導入する

    GitHub Secret Protectionには、Secret ScanningやPush Protectionなど、Secretの検出と流出防止を助ける機能があります。

    Push Protectionは、Secretらしい文字列をCommitしてPushしようとした段階で止めます。過去の漏えいを見つけるだけでなく、これから入る事故を入口で防ぐ点が重要です。

    Organization所有のPrivateまたはInternal RepositoryでSecret Scanningを使うには、GitHub TeamまたはGitHub Enterprise CloudでGitHub Secret Protectionを有効にする必要があります。費用は、対象Repositoryで機能を有効にした範囲と、直近90日間にCommitした固有のActive Committerを基準に計算されます。単価や契約方式は変わり得るため、画面のPricing calculatorで月額見積を保存してから承認します。

    導入前に、対象Repository、利用者数、見積、対象範囲、Trial、経営承認を確認します。費用を見ずにOrganization全体へ有効化すると、想定外の課金につながる可能性があります。

    画像

    費用が理由で導入しない場合も、何もしない選択にはしません。

    `.gitignore`、Pull Requestレビュー、ローカルSecret Scanner、CI上のSecret Scanner、Secret Manager、漏えい時の失効手順を組み合わせます。

    有料機能は便利ですが、組織の責任を代替しません。Push Protectionを有効にしても、利用者が回避できる設定や、検出対象外の自社Secretがあります。回避は原則禁止し、誤検知でも理由と承認者を記録します。

    SecretをPushしたとき、最初に履歴を消してはいけない

    Secret漏えいが起きると、慌ててCommitを削除したくなります。しかし、最初にやるべきことは履歴の修正ではありません。

    漏れたSecretを無効化します。新しいSecretを発行します。本番、開発、CIを新しい値へ切り替えます。不正利用のLogを確認します。GitHubのAlertとAudit Logを保存します。顧客、法務、関係者への通知要否を判断します。その後にGit履歴からの削除を検討します。

    順序が重要です。

    履歴を消している間も、漏れたSecretが有効なら悪用され続けます。RepositoryをPrivateへ変えても、すでに取得されたSecretは使えます。新しいCommitで削除しても、過去履歴には残ります。

    画像

    事故対応では、証拠を消さないことも大切です。Alert、Audit Log、利用サービス側のアクセスLog、影響時間、対象権限、実行された操作を保存します。

    「消したから大丈夫」ではなく、「何ができるSecretで、いつからいつまで有効で、実際に何が起きたか」を確認します。

    自動化へ渡す権限をJobと本番環境ごとに絞る

    GitHub Actionsは作業を速くしますが、Repository、Secret、外部サービス、本番環境をつなぐ強い権限も持ちます。この節では、Workflow全体を一括で信頼せず、Jobと接続先ごとに権限を分ける考え方を整理します。

    GitHub Actionsは便利な自動化であり、強い実行権限でもある

    GitHub Actionsは、Test、Build、Deploy、定期処理などを自動で実行する仕組みです。

    便利な一方、Repositoryの内容を読み、本番環境へ接続し、Secretを使い、Artifactを生成できるため、強い権限を持ちます。

    まず、Organizationで利用を許可するActionを制限します。

    画面では、Organization → Settings → Code, planning, and automation → Actions → Generalへ進みます。いきなり外部Actionを全面禁止せず、先に利用中の`uses:`を棚卸しします。GitHubが提供するAction、Organization内で管理するAction、明示的に許可した外部Actionなどに絞ります。

    外部Actionをすべて禁止すると、BuildやDeployが止まる可能性があります。先に`.github/workflows/`を確認し、`uses:`に書かれたAction、提供者、必要性、固定方法、利用Secretを一覧化します。

    画像

    Actionsの安全性は、Workflowファイルだけを見ても判断できません。呼び出している外部Action、そのActionの依存関係、実行Runner、本番権限、Artifact、Logまで含めて考えます。

    GITHUB_TOKENは既定で読み取り専用にする

    Workflow内では、GITHUB_TOKENという一時的なTokenを使ってGitHubへ操作できます。

    既定権限をRead-onlyにし、必要なJobだけへ必要な権限を明示します。

    同じActionsのGeneral画面にあるWorkflow permissionsで、`Read repository contents and packages permissions`を選びます。古いOrganizationやRepositoryでは、より広い既定権限が残っている可能性があるため、実値を確認します。Deployでクラウドへの認証が必要なら、`id-token: write`などをそのJobへ限定します。

    「すべてのWorkflowが書き込み可能」より、「通常は読むだけで、必要な処理だけ書ける」方が安全です。

    ActionsがPull Requestを作成・承認できる設定も、原則オフにします。自動処理が自分で変更を作り、自分で承認し、Mergeできる状態は、人間レビューを形だけにします。

    最小権限は、できることを減らすためではありません。侵害されたときに、できる被害を小さくするためです。

    外部Actionは完全なCommit SHAへ固定する

    外部Actionを`@main`や`@v3`で指定すると、その参照先が後から変わる可能性があります。

    完全なCommit SHAへ固定すると、実行するコードを特定の版へ固定できます。SHAはCommitを識別する長い文字列です。

    ただし、固定したら終わりではありません。脆弱性修正や更新が自動で入らなくなるため、更新時にRelease Noteと差分を確認します。

    画像

    安全な更新は、提供元のReleaseを確認し、Tagが指すCommit SHAを確認し、別担当者が提供元を確認し、Pull Requestで変更し、CIが成功することを確認する流れです。

    固定はSupply Chain攻撃、つまり依存する外部部品を通じた攻撃への一つの対策ですが、提供元そのものが侵害された場合や、固定した版に脆弱性がある場合までは防げません。

    本番DeployにはEnvironmentと承認を置く

    GitHub Actionsから本番へDeployする場合、Environmentを作成し、Required reviewersを設定します。

    Environmentは、本番、検証、開発など、Deploy先ごとにSecretと保護ルールを分ける仕組みです。

    本番SecretはRepository共通のSecretではなく、production Environmentへ置きます。DeployできるBranchやTagをmainやRelease Tagへ限定します。承認前にはJobが進まないことを実際に確認します。

    画像

    Pull Requestの承認と本番Deployの承認は役割が異なります。

    前者はコード変更が妥当かを見るものです。後者は、今このタイミングで本番へ反映してよいか、影響範囲や運用準備が整っているかを見るものです。

    同じ人が両方を承認する場合でも、確認観点を分けます。

    Tokenと外部サービスを定期的に棚卸しする

    人の権限だけでなく、PAT、GitHub App、Webhook、Deploy KeyもRepositoryへ入る別の入口です。導入時の審査だけで終わらせず、用途、対象範囲、期限、削除方法を定期的に確認します。

    Personal Access Tokenは短く、狭く、期限付きにする

    Personal Access Token、略してPATは、Passwordの代わりにAPIやGit操作で使う認証情報です。

    Classic PATは権限範囲が広くなりやすいため、原則としてOrganizationへのアクセスを禁止し、Fine-grained PATを使います。

    Fine-grainedは、対象Organization、対象Repository、Permission、有効期限を細かく限定できます。

    Token名は用途が分かるようにし、誰が、何のために、どのRepositoryへ、いつまで使うかを記録します。不要になったTokenはRevoke、つまり無効化します。

    Tokenを発行した本人しか把握していない状態は危険です。Organization側で承認制、最大有効期間、Active Tokenの棚卸しを設定します。

    画像

    長期Tokenは更新の手間が少ない一方、漏れたときの有効期間も長くなります。更新作業を減らすために危険を抱えるより、自動更新やGitHub Appへの移行を検討します。

    GitHub AppはRepositoryを選択して許可する

    GitHub Appは、外部サービスや社内ツールをGitHubへ接続する仕組みです。

    導入時に「便利そうだからInstall」を押すだけでは不十分です。

    画面では、Organization → Settings → Third-party Access → GitHub Appsから対象Appを開き、PermissionsとRepository accessを確認します。原則はOnly select repositoriesです。Administration、Contents、Actions、Secrets、Members、Issues、Pull requests、Webhooksなど、要求する権限を確認します。

    Repository accessは、原則としてOnly select repositoriesにし、必要なRepositoryだけを選びます。

    Organization全体へのRead権限でも、顧客コード、Issue、Pull Request、Metadataが外部サービスへ渡る可能性があります。WriteやAdministrationはさらに高い審査が必要です。

    画像

    確認する質問は五つです。

    何の業務に必要か。どのデータを読むか、書くか。どのRepositoryへ必要か。データはどこへ送られ、どれだけ保存されるか。不要になったとき、誰がSuspendまたはUninstallするか。

    Appの権限は導入時だけでなく、機能追加や契約更新時にも見直します。

    Webhookは送信先と署名検証を確認する

    Webhookは、GitHubで何かが起きたとき、外部システムへ通知する仕組みです。

    Pull Request作成、Push、Releaseなどのイベントを、指定したURLへ送れます。

    設定ではHTTPS、Webhook Secret、SSL verification、必要なEventだけを選びます。「Send me everything」は原則禁止します。

    受信側では、Webhook Secretを使って署名を検証します。署名検証をしないと、GitHubから来たように見せた偽の通知を受け入れる可能性があります。

    Recent Deliveriesで、送信内容、応答、失敗を確認します。所有者不明のWebhookは、いきなり削除せず、一旦Disableし、どの自動化が止まるか確認します。

    Deploy Keyを乱立させない

    Deploy Keyは、特定RepositoryへSSHでアクセスする鍵です。

    サーバーから一つのRepositoryを読む用途には使えますが、複数Repositoryへアクセスする自動処理で乱立させると、どの鍵がどこで使われているか分かりにくくなります。

    Key名、Repository、サーバー、用途、ReadまたはWrite、作成日、期限、責任者を台帳化します。Write accessは原則付けません。

    複数Repositoryや細かい権限管理が必要なら、GitHub Appを優先します。

    コード以外の保存先と監査記録も確認する

    機密情報はソースコードだけに現れるとは限りません。公開ページ、配布物、Build成果物、Log、Backupまで含めて、どこへ保存され、誰が見られ、いつ消えるのかを確認します。

    Pages、Release、Packages、Artifactは別の公開経路になる

    RepositoryがPrivateでも、周辺機能の公開範囲や生成物を別に確認する必要があります。

    GitHub PagesはWebサイトを公開する機能です。顧客Repositoryでは原則無効にし、公開URLが存在しないかを確認します。

    Releaseには配布ファイルを添付できます。PackagesにはContainer ImageやPackageを置けます。Actions ArtifactにはBuild結果、Test結果、Logなどが保存されます。

    ここへ`.env`、APIキー、Debug Log、顧客CSV、Database Dump、Source Map、内部URL、証明書、Test Accountが入る事故があります。

    画像

    ActionsのArtifactとLogは既定で90日間保存されます。Organization設定では、Public Repositoryは1〜90日、PrivateまたはInternal Repositoryは1〜400日の範囲で、新しく作られるArtifactとLogの保持期間を調整できます。既存分へは遡って適用されません。必要以上に長く残さず、業務・監査・法務上の必要期間と一致させます。

    ただし、短くすれば安全とは限りません。事故調査に必要なLogまで消えると原因追跡ができません。機密性と監査性の両方から保持期間を決めます。

    Audit Logは事故後に初めて見るものではない

    Audit Logは、Organizationで誰が何をしたかを確認する記録です。

    Owner追加、Member追加・削除、Outside Collaborator追加、Repository作成・削除・移管、Visibility変更、Ruleset変更、App追加、PAT関連、Secret Protection変更、Actions設定変更などを確認します。

    GitHub.comのOrganization Audit Logでは、直近180日分のイベントが対象です。ただし、Clone、Fetch、PushなどのGitイベントは7日間しか保持されません。長期監査や事故調査でGit操作まで追う必要がある企業は、事故が起きてからではなく、事前にEnterpriseのAudit Log Streamingや外部保管を設計します。

    画像

    月次レビューでは、Organization → Settings → Audit logから対象期間とActor、Action、Repositoryを絞り、重大イベントを確認します。ExportしたCSVまたはJSONは、GitHubとは別の会社保管先へ保存します。

    「異常がなかった」という記録も残します。確認者、確認日、検索条件、結果、対応を記録することで、監査が個人の記憶から組織の仕組みになります。

    Audit Logは、事故が起きた後の調査だけでなく、設定が勝手に変わっていないかを早く見つけるために使います。

    バックアップはコピーではなく、復元できることが条件である

    GitHubにあるからバックアップ済み、とは限りません。

    Repositoryを誤って削除した。Organizationへ入れなくなった。ReleaseやArtifactが消えた。Git LFSの大容量ファイルが取れない。WikiやIssue、Pull Requestの情報が必要になった。

    何を復元対象にするかを決めます。

    Git Repository本体だけか。Issue、Pull Request、Wiki、Release、Package、Actions設定、Secretの参照情報まで含むか。顧客契約上の保存期間はどれくらいか。復元先は同じOrganizationか、別の安全な保管先か。

    画像

    バックアップは、ファイルが存在するだけでは合格ではありません。別Repositoryへ復元し、履歴を読めるか、Buildできるか、必要なMetadataが戻るかをテストします。

    復元方法を知っている人が一人だけ、という状態も避けます。

    端末の安全がなければGitHubの設定だけでは守れない

    GitHub上で最小権限を設定しても、開発者のPCが侵害されれば、Cloneしたコード、Token、SSH Key、Browser Sessionが盗まれる可能性があります。

    端末暗号化、画面ロック、OS更新、EDRまたはEndpoint Security、Password Manager、業務用アカウント分離、SSH Key保護、退職時回収を行います。

    特にBrowser Sessionは見落とされやすい点です。攻撃者が有効なSession Cookieを盗めば、Passwordを知らなくてもログイン状態を悪用できる場合があります。

    GitHubの安全性はクラウド設定だけでなく、端末、ID管理、ネットワーク、契約、教育を含む全体で決まります。

    AI開発ツールへRepositoryを渡すときは、同じ権限原則を適用する

    近年は、AI Coding AgentやコードレビューAIがGitHub Repositoryを読み、Pull Requestを作り、Issueを更新する場面が増えています。

    AIだから特別に危険、という単純な話ではありません。外部App、Bot、CIと同じく、何を読めるか、何を書けるか、どこへデータが送られるか、どれだけ保存されるかを確認します。

    ただし、AIは入力されたコードや指示を解釈し、複数のToolを連続して使うため、権限の組み合わせが複雑になります。

    画像

    最初はRead-onlyで試します。次に限定RepositoryでPull Request作成を許可します。Mergeは人間承認にします。本番SecretやDeploy権限は別にします。実行Logと変更差分を残します。停止、Token失効、App削除の手順を先に用意します。

    AIによるコードレビューやSecurity Scanは有効ですが、人間の脅威モデル、設計レビュー、侵入テストを完全に置き換えるものではありません。

    Codex Securityプラグインを対話的な調査に使う場面と、CLIをCIや複数Repositoryへ組み込む場面の違いは、こちらの記事で詳しく整理しています。

    設定は受入テストに合格して初めて完了する

    セキュリティ設定で最も多い失敗は、画面でSaveを押して終わることです。

    実際に期待どおり拒否されるかを試します。

    未ログインでRepositoryを開けないか。担当外メンバーが開けないか。mainへ直接Pushできないか。承認なしでMergeできないか。Force Pushできないか。Private RepositoryをForkできないか。Actions Tokenが予定外のWriteをできないか。本番Deployが承認前に走らないか。未承認PATがアクセスできないか。GitHub Appが選択外Repositoryへ触れないか。Webhookの署名が検証されるか。Secret TestでPushが止まるか。Outside Collaborator削除後に再アクセスできないか。Backupを別Repositoryへ復元できるか。

    画像

    本物のSecretを使ってTestしてはいけません。GitHub公式のTest文字列や、自社で定めた無効なPatternを使います。

    受入テストは、エンジニアだけで完結しません。非担当者、一般メンバー、管理担当、App管理者、Backup担当など、異なる権限の人が試すことで、管理者画面から見えない問題を発見できます。

    実施順は当日、一週間、一か月に分ける

    すべてを一度に完璧にしようとすると、手が止まります。優先順位を分けます。

    当日は、会社Organization所有、Private、Owner、Base permissions、Repository作成制限、Private Fork禁止、二要素認証、Team権限、Outside Collaborator、Branch Rulesetを確認します。

    ここは、情報が見える人と変更できる人を制限する基礎です。

    一週間以内に、CODEOWNERS、Secret Protectionまたは代替Scanner、Actions許可範囲、GITHUB_TOKEN Read-only、外部ActionのSHA固定、Production Environment、PAT Policy、GitHub Apps、Webhook、Deploy Keyを確認します。

    ここは、自動処理と外部接続の事故を減らす領域です。

    一か月以内に、Audit Log月次運用、端末暗号化、Backupと復元Test、退職・外注終了手順、Incident訓練、顧客契約、AI利用、保存地域を確認します。

    ここは、一度の設定を継続運用へ変える領域です。

    画像

    組織規模に合う統制と責任分担を選ぶ

    同じGitHub設定でも、数人のスタートアップと複数部門を持つ大企業では、維持できる運用が異なります。重要なのは、大企業の制度を形だけまねることではなく、自社で実行と確認を続けられる責任分担を選ぶことです。

    小規模組織ほど、複雑な制度より明確な責任者が効く

    小さな会社やスタートアップでは、専任のSecurity Teamがいないことも多いでしょう。

    その場合、企業向けの重い制度をそのまま導入しても運用できません。必要なのは、最低限の責任を明確にすることです。

    Organization Ownerは誰か。Repository作成を承認する人は誰か。外注権限を削除する人は誰か。Secret漏えい時に失効する人は誰か。Actionsと本番Deployを見る人は誰か。月次Audit Logを確認する人は誰か。

    一人が複数役を兼ねても構いません。ただし、実行者と確認者を重要操作だけでも分けます。Public変更、Owner追加、App追加、本番Secret変更、Repository削除、課金変更は二者確認にします。

    大企業の制度を縮小コピーするより、少数の重大操作へ確実な二者確認を置く方が実効的です。

    大企業ではGitHub設定とID管理を分離しない

    大企業では、GitHubだけで人の追加・削除を管理すると、入社、異動、退職とのズレが起きます。

    Identity Provider、略してIdPは、会社のアカウントと所属を一元管理する仕組みです。SSOは会社の認証基盤を使ってGitHubへログインする仕組みです。SCIMは、人の追加、変更、削除をIdentity ProviderからGitHubへ連携する仕組みです。

    これらを使うと、退職時に会社アカウントを止めることでGitHubアクセスも連動させやすくなります。

    ただし、連携設定が正しいこと、緊急用アカウント、Bot、Service Account、Outside Collaboratorの扱いを別に決める必要があります。

    大企業では、Organization単位の設定だけでなく、Enterprise Policyで複数Organizationへ共通ルールを適用します。Ruleset、二要素認証、Actions、App、Audit Log Streamingなどを一貫させます。

    顧客データはGitHubに置けるかではなく、置く必要があるかで判断する

    技術的にはPrivate Repositoryへ多くのファイルを置けます。しかし、置けることと、置くべきことは別です。

    顧客の生データをTestに使うと、開発者のPC、CI、Artifact、Log、Backup、外部Appへ複製が広がります。削除依頼を受けても、どこに残っているか追えなくなります。

    まず、目的を確認します。

    本当に本物のデータが必要か。匿名化できないか。合成データで代替できないか。必要な項目だけに減らせないか。参照IDだけにできないか。期間を限定できないか。閲覧者を限定した別Storageへ置けないか。

    画像

    顧客データを安全に扱う最も強い方法は、不要なら持たないことです。

    事故をゼロにするより、事故を小さく早く見つける

    どれだけ設定しても、事故の可能性をゼロにはできません。

    人は間違えます。外部サービスは侵害されます。新しい脆弱性が見つかります。権限の組み合わせで想定外の経路ができます。

    だからこそ、予防だけでなく、検知、封じ込め、復旧を設計します。

    予防は、Private、二要素認証、最小権限、Ruleset、Secret Protectionです。

    検知は、Alert、Audit Log、Actions Log、クラウド側のアクセスLog、月次棚卸しです。

    封じ込めは、Token失効、App停止、Member削除、Workflow停止、Deploy停止、Secret Rotationです。

    復旧は、Backup、再発行、再Clone、設定復元、顧客通知、再発防止です。

    画像

    ここまで設計して初めて、GitHubを業務基盤として使えます。

    私が最も重く見るのは、設定項目の多さではなく運用の閉じ方である

    GitHubのセキュリティ記事は、設定一覧になりがちです。

    しかし、設定を百個並べても、誰が実行し、誰が確認し、どこへ記録し、いつ再確認し、失敗時にどう戻すかがなければ運用にはなりません。

    私が最も重く見るのは、次の四点です。

    一つ目は、会社Organizationが所有していることです。所有の曖昧さは、退職、契約、事故対応のすべてを難しくします。

    二つ目は、権限をTeamと期限で管理することです。必要な人だけ、必要な期間だけ、必要な操作だけにします。

    三つ目は、自動化を人間の承認から切り離さないことです。Actions、App、AI Agentが便利になるほど、Merge、本番Deploy、Secret、削除などの境界を明確にします。

    四つ目は、受入テストと月次レビューです。設定値ではなく、期待した拒否と記録が実際に働くかを確認します。

    画像

    継続運用では期限、例外、停止条件を先に決める

    初期設定が正しくても、権限の追加、緊急対応、新しいツールの導入が続けば、時間とともに例外が増えます。申請、期限、緊急時の扱い、停止条件を先に決め、変更が積み重なっても統制が崩れないようにします。

    権限申請は誰が何を決めるかまで固定する

    TeamやRoleを整えても、権限申請の判断が人によって変わると、時間とともに例外が積み上がります。

    申請には、対象者、所属、対象Repository、必要なRole、業務目的、開始日、終了日、承認者を含めます。AdminやMaintainを求める場合は、ReadやWriteでは不足する理由も書きます。

    承認者は、依頼者の上司だけでは不十分な場合があります。顧客案件の責任者、RepositoryのMaintainer、情報管理責任者など、データとシステムの責任を持つ人が確認します。

    権限は、入社時にまとめて付けて終わりにしません。プロジェクト終了、異動、休職、退職、契約終了で見直します。期限が来たら自動で確認依頼が出る台帳やチケットを使うと、削除漏れを減らせます。

    画像

    緊急時の例外は事前に設計しておく

    本番障害や重大Incidentでは、通常の承認を待てない場合があります。

    だからといって、Ownerや管理者を常時Bypassへ入れると、日常の防御が弱くなります。緊急例外は、使う条件、使える人、期限、記録、事後レビューを先に決めます。

    たとえば、重大障害で顧客影響が続いている。通常の承認者が不在である。復旧手順が確認済みである。この条件を満たした場合だけ、期限付きでBypassを付与します。

    実行後は、変更内容、理由、時刻、実行者、影響、元へ戻した時刻を記録し、翌営業日までにレビューします。

    例外をゼロにするのではなく、見えない例外をなくすことが重要です。

    月次レビューは設定一覧ではなく変化を見る

    月次確認で、毎回すべての画面を最初から見る必要はありません。

    前回から何が変わったかを中心に確認します。

    Ownerは増減したか。新しいMemberやOutside Collaboratorが入ったか。新しいRepository、App、Webhook、PAT、Deploy Keyが増えたか。RulesetやActions設定が変更されたか。Public化や削除が行われたか。Secret AlertやBypassが発生したか。

    変化が正当なら、申請や承認の証跡と一致するかを確認します。申請にない変化は、理由を調べます。

    このレビューを、単なるチェック作業で終わらせないために、前月の未対応、例外の期限、再発した問題も確認します。

    画像

    セキュリティ指標は数を増やすより行動へつなげる

    管理を始めると、指標を増やしたくなります。しかし、数字を集めるだけでは安全になりません。

    実務で使いやすいのは、未設定の重要項目数、期限切れ権限数、未対応Secret Alert数、未承認App数、直接Pushの失敗または発生数、復元テストの最終実施日、退職者削除の所要時間などです。

    数字が悪かったとき、誰が何をするかが決まっている指標だけを残します。

    たとえば、期限切れ権限が一件でもあれば当日中に削除確認を行う。Secret AlertがCriticalなら即時に失効を開始する。復元テストが半年以上前なら翌月までに実施する。このように行動条件と結びつけます。

    セキュリティのDashboardは、安心するための飾りではなく、止める、直す、確認するための道具です。

    導入を止める条件も決めておく

    新しいGitHub App、AI開発ツール、Actions Workflowを導入するときは、成功条件だけでなく停止条件を決めます。

    要求権限が説明できない。選択Repositoryへ限定できない。データ保存先や保持期間が分からない。契約終了後の削除方法がない。Audit Logや変更履歴が取れない。本番Secretへ直接アクセスする。人間承認を外さないと利用できない。

    こうした条件がある場合は、便利でも導入を止めます。

    Pilotでは、一つの非本番Repository、匿名化データ、Read-only、限定メンバーから始めます。問題がなければPull Request作成まで広げ、本番操作は最後に検討します。

    撤退時には、AppのUninstall、Token失効、Webhook削除、Secret Rotation、作成されたBranchやArtifactの削除、外部サービス側のデータ削除確認を行います。

    画像

    一枚の責任表で運用を閉じる

    最後に、設定項目ではなく責任者を一枚にまとめます。

    Organization Owner管理、MemberとOutside Collaborator、Repository作成、Ruleset、Secret、Actions、PAT、App、Webhook、Audit Log、Backup、Incident。各項目について、実行者、確認者、記録先、確認頻度、緊急連絡先を決めます。

    この表はnote記事本文へ載せる必要はありません。社内の運用台帳として使います。

    責任者が空欄の設定は、実質的に管理されていません。二人が同じ責任を持つ場合も、最終判断者を明確にします。

    GitHubの安全性は、高価な機能を何個有効にしたかではなく、必要な判断が期限内に行われるかで決まります。

    自社のOrganization、権限、Actions、外部App、AI開発工程をまとめて棚卸しし、研修だけでなく業務設計や改善運用まで進める支援内容は、こちらにまとめています。

    まず今日やるべきこと

    この記事を読んだ後、最初にすべての高度な機能を購入する必要はありません。

    対象Repositoryを一つ選び、次の順で確認してください。

    会社Organizationが所有しているか。Privateか。Ownerは誰か。担当外メンバーが読めないか。二要素認証が必須か。mainへ直接Pushできないか。外注先の権限が期限内か。SecretがRepositoryへ入っていないか。GitHub AppとActionsが何へアクセスできるか。事故時にTokenを失効できる人が誰か。

    一つのRepositoryで実行し、問題と例外を把握してから標準化します。最初から全Repositoryへ一括適用すると、CIやDeployを止め、例外運用が増える可能性があります。

    小さく試し、受入テストに合格し、記録を残してから横展開します。

    GitHubを安全に使うとは、開発を遅くすることではありません。誰が何をできるかを明確にし、事故の影響を小さくし、問題が起きても止めて戻せる状態を作ることです。

    Privateという一つのラベルで安心せず、会社の運用として閉じる。顧客の信頼を守るために必要なのは、そこまでです。


    出典・参考資料

    あなたへのおすすめ