ソースコード内の機密情報をBitbucketで隠すには?Gitの履歴からも消去する具体的な手順を解説

BitbucketとGitの履歴から機密情報を完全に消去する手順を解説するイメージ プログラミング言語

ソースコードにAPIキーやパスワード、秘密鍵といった機密情報を書き込んだままBitbucketにプッシュしてしまった、という経験はないだろうか。
これは決して珍しいミスではなく、実務でも個人開発でも起こりうるが、放置すれば情報漏洩や不正アクセスといった深刻なリスクに直結する。

特に注意したいのは、ファイルを修正して機密情報を削除しても、Gitのコミット履歴には古い内容が残り続けるという点だ。
単に最新版から消すだけでは不十分で、履歴全体から対象の情報を完全に消去しなければ、いつでも第三者に参照される可能性がある。

Bitbucketにはリポジトリの公開範囲を設定する機能はあるものの、一度履歴に記録された情報を標準の管理画面だけで完全に消すことはできない。
適切な手順でGit側から履歴を書き換えた上で強制的に反映させ、さらにキャッシュや参照された状況がないか確認する必要がある。

本記事では以下の内容を順を追って解説する。

  • 機密情報が残留する仕組みとリスクの本質
  • Bitbucket上で事前に行うべき設定と準備作業
  • Gitコマンドを用いて特定のファイルや文字列を履歴から一括削除する手順
  • 作業後にBitbucketへ反映し、検証する方法
  • 今後の再発を防ぐための.gitignoreの設定と事前チェックの仕組み

作業にはいくつかの注意点が存在する。
コミット履歴を書き換えるため、複数人で開発を行っている場合は事前に共有を行い、他のメンバーの作業に影響を与えないタイミングで実施することが不可欠だ。
また、作業前には必ずリポジトリのバックアップを取得し、万が一の場合に備える必要がある。

「一度公開してしまったからもう遅い」と諦める必要はない。
正しい手順で対処すれば、機密情報をGitの履歴ごとBitbucket上から完全に消去することは可能である。
本記事を参考に、安全な状態にリポジトリを回復させ、今後の管理体制を整えてほしい。

ソースコードに機密情報を記載してしまう理由とGit履歴のリスク

Git履歴に機密情報が残留する仕組みと漏洩リスクの説明図

開発現場では短いコードを迅速に動作させることが優先される場面が多く、動作確認用に一時的に記述したIDやパスワード、APIキーをそのままコミットしてしまうケースが多く見られます。
また、外部の設定ファイルに記載すべき情報を直接ソースコードに埋め込んでしまう、ファイルの除外設定が不十分であるといった理由から、機密情報がリポジトリに混入する事態が日常的に発生しています。

こうした状況を「単なる軽微なミス」と軽視することは非常に危険です。
たとえ後から値を変更したりファイルを削除したりしても、情報が完全に消去されたことにはなりません。
機密情報が過去のコミット履歴に残留し続ける限り、それを閲覧できる状態が維持され、情報漏洩や不正アクセスのきっかけとなります。
公開リポジトリであればなおさら、検索エンジンやキャッシュサービスにインデックスされた時点で、第三者による情報収集が容易に行われる可能性が高まります。

機密情報が残留する仕組みとは

Gitはファイルの変更履歴を一連の記録として保存する分散型バージョン管理システムです。
最新の状態だけでなく、過去の各時点におけるファイルの内容を完全に保持する設計となっています。

具体的には以下のような仕組みで情報が残留します。

  • コミットを作成するたびにファイルの内容が一意の識別子と紐付けられて保存され、後からファイルを修正しても過去の内容は上書きされず別のデータとして存在し続ける
  • ブランチやタグ、マージの履歴によって過去のコミットが参照されている場合、そのコミットに含まれるファイルの内容は明示的に削除操作を行うまで維持される
  • ローカル環境で削除を行っても、リモートリポジトリ側に過去のデータが残っている限り、その情報を取得する手段が残される

つまり最新版から値を消去するだけでは、「最新の状態には情報が現れていない」という事実が変わるだけであり、過去のどの時点に情報が存在していたかを追跡することは依然として可能なのです。

Bitbucketだけで完全削除ができない理由

Bitbucketにはリポジトリの閲覧権限を調整する機能や特定のコミットを非表示にする機能が備わっていますが、これらは表示上の制御に過ぎず、データ自体を消去するものではありません。

Bitbucketの管理画面から行える操作には以下のような限界があります。

  • ファイルを削除する操作を行っても、そのファイルが存在していた過去のコミット履歴には引き続きアクセスできる状態が維持される
  • 権限を制限したりリポジトリを非公開に変更したりしても、過去に取得されたクローンやキャッシュが存在する場合、そこから情報が流出する可能性が残る
  • Bitbucket側でキャッシュされたページやインデックスは、ウェブ上に残留する期間がサービスの仕様に依存し、即時に消去することが困難である

このように、Bitbucketのインターフェースから可能な範囲には限度があり、Gitの履歴構造自体に手を加えなければ根本的な解決には至りません。
見た目上の除去だけで安心することなく、Git内部の履歴データを直接書き換える作業が必要となるのです。

作業前に必ず行うべき準備と注意点

Bitbucketの機密情報削除作業前のチェックリストとバックアップ手順

Gitのコミット履歴を書き換える作業はリポジトリの構造自体に変更を加えるため、不測の不具合やデータの損失が生じるリスクが常に伴います。
作業を安全かつ確実に進めるためには、実際の手順に着手する前に体制を整え、影響範囲を明確にしておくことが不可欠です。
準備を省略したまま作業を進めた結果、復旧が困難な状況に陥ったり、チーム全体の開発を停滞させたりする事態は避けなければなりません。

ここでは履歴の消去作業を開始する前に完了させておくべき項目を体系的に解説します。
いずれも作業後の安全性を左右する重要な要素であり、それぞれの手順を確実に実施してから次の段階へ進むことが求められます。

リポジトリのバックアップ取得方法

履歴の書き換えは不可逆的な変更を含むため、作業前に現状のリポジトリを完全に複製し、万が一の場合に備えることが鉄則です。
単にファイルをコピーするだけではコミットの関係性やブランチ情報が失われるため、Gitの機能を利用して履歴全体を保存する必要があります。

具体的には以下の手順でバックアップを作成します。

  • 対象リポジトリとは別のディレクトリに、--mirrorオプションを付けて完全なミラーリポジトリを複製する
  • 作成したミラーリポジトリを圧縮し、作業を行う環境とは異なる場所に保管する
  • バックアップが正常に取得できたことを確認した上で、作業用のローカルリポジトリを新たにクローンし、これを編集対象とする

この方法であれば、コミットの連鎖やタグといった情報も含めて完全に保存されるため、作業に失敗した場合でも元の状態を正確に復元することが可能です。
作業が無事完了した後も、しばらくはバックアップを削除せずに保持しておくことを推奨します。

Bitbucketの権限とアクセス設定の確認

履歴を強制的に反映させる作業にはリポジトリへの書き込み権限が必要となるほか、作業期間中に第三者が変更を加えると衝突が発生する原因となります。
そのため、Bitbucket上の設定を事前に確認し、不要なアクセスを制限することが重要です。

確認すべき主な項目は以下の通りです。

  • 自身のアカウントにリポジトリの管理者権限または書き込み権限が付与されていることを確認する
  • 作業対象のブランチに対する保護設定が適用されている場合、一時的に解除または調整を行う
  • 外部のユーザーや非公開のチームメンバーで不必要なアクセス権が付与されていないか確認し、必要に応じて削除する
  • リポジトリの公開設定を確認し、広範囲に公開されている場合は作業期間中の制限について検討する

特にブランチ保護の設定が有効なままでは強制プッシュが拒否され、作業が中断されるケースが多く見られます。
設定の変更後は作業が完了次第、速やかに元の状態へ戻すことを忘れないでください。

複数人開発時の作業タイミングと周知方法

チームで開発を行っているリポジトリでは、履歴の書き換えが他のメンバーの作業に直接影響を与えます。
過去のコミットが変更されると、各自が保持しているローカルの履歴とサーバー上の履歴が一致しなくなり、通常のプルやプッシュが実行できなくなるからです。
作業に先立ち、チーム全体で情報を共有し、影響を最小限に抑える体制を整えなければなりません。

実施すべき調整と周知の内容は以下の通りです。

  • 作業を実施する日時を事前に通知し、その時間帯には対象ブランチへのコミットやプッシュを一時的に停止してもらう
  • 作業完了後には各自のローカル環境でgit resetやgit pull --rebaseなどの操作が必要となることを具体的に伝える
  • 作業の影響範囲を明らかにし、対象外のブランチや関連しないプロジェクトには影響がないことを説明する
  • 万が一トラブルが発生した場合の連絡先と復旧予定を併せて周知し、チーム全体で不安が生じないよう配慮する

作業はできる限りチーム全体の作業が少ない時間帯や計画的な調整が行いやすいタイミングを選び、一方的に実行することは避けてください。
履歴の書き換えはチーム全員の協力があって初めて安全に完了できる作業である、という認識を共有することが成功の鍵となります。

git filter-repoを使用して特定のファイルを履歴から完全削除する手順

git filter-repoコマンドで機密ファイルを一括削除する作業画面

Gitの履歴から機密情報を含むファイルを完全に取り除くためには、git filter-repoが現在最も推奨されるツールです。
従来使用されていたgit filter-branchに比べて処理速度が速く、構文が直感的であり、複雑な履歴構造に対しても安定した結果が得られるという特長があります。
ただし強力なツールである分、操作がリポジトリ全体の履歴に影響を与えるため、作業前のバックアップと動作確認が不可欠です。
本手順では、特定のファイルやディレクトリを対象に、コミット履歴全体を通じて確実に削除する方法を段階的に説明します。

git filter-repoのインストールと基本的な使い方

git filter-repoはGit本体に標準で付属していないため、使用する前に環境に応じたインストール作業が必要となります。
インストール後も、安全に作業を進めるための原則と動作確認の手順を理解しておかなければなりません。

主な環境別のインストール方法は以下の通りです。

  • Debian系またはUbuntu系のLinuxディストリビューションではパッケージマネージャーを利用して導入できる
  • macOSではHomebrewを使用し、WindowsではChocolateyまたはPythonのパッケージ管理ツールを利用する
  • Python環境が利用可能な場合はpip install git-filter-repoによりクロスプラットフォームで導入することができる

インストールが完了したら、作業用のリポジトリディレクトリへ移動し、git filter-repo --versionを実行して正常に認識されることを確認します。
以降の作業では以下の原則を守ってください。

  • リモートリポジトリとの接続が維持された状態で作業を行うこと
  • いきなり変更を反映させるのではなく、--dry-runオプションを活用して影響範囲を事前に確認する習慣をつける
  • 作業後はgit logやファイルの存在確認を行い、意図した通りに処理されたことを検証する

パス指定による特定ファイル・ディレクトリの削除

機密情報を含むファイルが明らかである場合、ファイルパスを直接指定して削除する方法が最も確実で安全です。
git filter-repoでは--pathオプションを用いて対象を特定し、--invert-pathsを併用することで指定したパスのみを削除する動作になります。

特定のファイルを削除する際の基本的な構文は以下の通りです。

git filter-repo --path 削除対象のファイルパス --invert-paths

パス指定を行う際には以下の点に注意してください。

  • パス記述はリポジトリのルートディレクトリからの相対パスとなり、絶対パスは使用しない
  • ディレクトリ全体を対象とする場合、末尾にスラッシュを付加することで明示的にディレクトリであることを示す
  • 複数のファイルやディレクトリを同時に指定する場合は--pathオプションを必要な回数だけ記述する
  • ワイルドカードを使用することも可能だが、予期しないファイルまで削除してしまうリスクが高まるため、事前に--dry-runで確認してから実行する

たとえばルート直下にある.envファイルとconfig/secrets/ディレクトリの両方を履歴から除外する場合、以下のように記述します。

git filter-repo --path .env --path config/secrets/ --invert-paths --dry-run

実行後に表示される処理内容を確認し、問題がなければ--dry-runを外して実際に処理を実行してください。
処理が完了すると、該当するファイルは最新版から消去されるだけでなく、過去のいずれのコミットにも存在しない状態となります。
この段階でローカルの履歴は書き換えられているため、次の手順でBitbucketへ反映させることになりますが、その際には他のメンバーの作業状況と強制プッシュの手順に十分留意してください。

APIキーやパスワードなど特定の文字列を一括削除する方法

正規表現を使ってGit履歴から機密文字列を検索し削除する図

機密情報が複数のファイルに分散して記述されている場合や、ファイル単位ではなく特定の文字列だけを履歴から取り除きたい場合があります。
たとえばAPIキー、データベースのパスワード、秘密鍵の一部といった情報は、ファイルを削除するとアプリケーションの動作に支障が出るものの、値そのものだけを確実に消去したいケースが多く見られます。
このような状況では文字列単位での一括削除が有効であり、git filter-repoの機能を活用することで、過去のコミットを含めて対象の文字列を系統的に除去することが可能です。

ただし文字列の削除は処理範囲が広範囲に及ぶため、条件を誤ると必要なコードまで失われるリスクが高まります。
正確に対象を絞り込み、事前に影響範囲を検証する手順が特に重要となります。

正規表現を活用したパターン指定のコツ

APIキーやパスワードは固定の文字列として存在する場合もあれば、一定の形式を持った文字列として複数箇所に出現する場合もあります。
正規表現を用いると、完全に一致する文字列だけでなく、パターンに基づいて条件に合致する情報を一括で対象にすることができます。

パターン指定を行う際の基本的な考え方は以下の通りです。

  • 固定された値が明らかな場合は完全一致の記述を優先し、曖昧な検索条件を使用しない
  • キーの形式に規則性がある場合は、先頭の固定文字列と文字数の範囲を組み合わせて特定する
  • 変数名や記述形式にバリエーションがある場合は、行全体を対象とせず値の部分のみにマッチするように記述する
  • 特殊記号や記号の連続が含まれる場合はエスケープ処理を適切に行い、意図しない文字列にマッチしないように注意する

git filter-repoでは--replace-textオプションを使用し、外部ファイルに記述したルールに基づいて文字列を置換または削除する方法が推奨されます。
置換ルールの記述例は以下の通りです。

regex:^API_KEY=.*$
==>API_KEY=REDACTED

このように記述すると、API_KEY=で始まる行全体をAPI_KEY=REDACTEDに置き換え、元の値を履歴から完全に消去することができます。
値の部分だけを削除したい場合や空白を挿入したい場合も、同様に置換後の文字列を指定するだけで対応可能です。

正規表現の記述では、できる限り条件を厳しく設定することが肝心です。
たとえば.+のような広範囲にマッチする記述を避け、[A-Za-z0-9]{32}のように文字種と長さを制限することで、他のコードや変数名が誤って対象となる事態を防ぐことができます。

誤って他の情報を消さないための事前テスト方法

文字列の一括処理は強力な反面、設定した条件が想定外の箇所に作用すると、プログラムの動作に必要な記述まで失われる危険性があります。
処理を実行する前に影響範囲を把握し、意図した通りに動作することを確認する手順を省略してはなりません。

事前テストを行う手順は以下の通りです。

  • まず--dry-runオプションを付けて実行し、表示される処理対象の一覧を確認する
  • 実行結果に含まれるファイル名と行数を記録し、本来削除する必要のない箇所が含まれていないか目視で確認する
  • 確認の段階で誤った対象が検出された場合は正規表現の条件を修正し、再度--dry-runで検証する
  • 実際に処理を行う場合でも、作業用の一時ディレクトリに検証用のクローンを作成し、そこで先に実行して結果を確認する

処理後の確認も同様に重要です。
実行が完了したら以下の作業を行います。

  • git log -pコマンドを使用し、過去のコミットにおいて対象の文字列が出現しないことを確認する
  • アプリケーションが正常に起動すること、必要な設定値が正しく保持されていることを動作確認により検証する
  • 複数のブランチが存在する場合は、各ブランチに対象の文字列が残留していないことを個別に確認する

これらの確認作業を経て初めて、Bitbucketへの反映を行うことができます。
条件の調整と確認を繰り返すことは手間のかかる作業に感じられるかもしれませんが、一度履歴を書き換えて公開してしまうと修正が非常に困難になるため、この段階で慎重に作業を進めることが結果的に最も安全かつ効率的な方法となります。

履歴を書き換えたローカルリポジトリをBitbucketに反映させる手順

強制プッシュで書き換えたGit履歴をBitbucketに反映する画面

Gitの履歴を書き換えた時点で、ローカルリポジトリのコミットIDはBitbucket上の履歴と一致しなくなります。
通常のgit pushでは処理が拒否されるため、履歴の整合性を維持しながら安全に変更を反映させる特別な手順が必要となります。
この段階では強制的な上書き送信を行うことになりますが、操作を誤るとBitbucket側のデータが失われたり、他のメンバーの作業が無効になったりするリスクが存在します。
ここでは影響を最小限に抑えつつ確実に履歴を反映させる方法を解説します。

–force-with-leaseを活用した安全な強制プッシュ

--forceオプションを用いたプッシュは、リモートの状態に関係なくローカルの内容で上書きする強力な手段ですが、他の人が既にプッシュしていた変更を意図せず消してしまう危険性があります。
この問題を回避するために推奨されるのが--force-with-leaseオプションです。
これは「現在のリモートの状態が、自分が最後に確認した状態と同じ場合に限り上書きを許可する」仕組みであり、知らない間に他の変更が混入していた場合には自動的に処理を中断してくれます。

基本的な手順は以下の通りです。

  • 書き換え作業を終えたローカルリポジトリで、現在のブランチを確認し、対象外のブランチが存在する場合は個別に処理を行う
  • git push --force-with-lease origin ブランチ名を実行し、Bitbucketへの反映を試みる
  • 処理が拒否された場合は、他のメンバーによる変更が先行している可能性が高いため、状況を確認してから再度調整を行う
  • 複数のブランチを対象とする場合でも、一括で送信するのではなく1つずつ確認しながら実行う

このオプションが登場する以前は、強制プッシュは「危険な操作」としてできる限り避けられてきました。
しかし--force-with-leaseを利用することで、「誰も触っていないことを確認した上で上書きする」という制御が可能になり、履歴の書き換え作業における安全性が飛躍的に高まります。
それでも複数人で開発しているリポジトリでは、作業前の周知とタイミング調整が不可欠である点に変わりはありません。

Bitbucket側でキャッシュされた情報の削除と反映確認

強制プッシュが正常に完了しても、Bitbucket上では直ちに全ての情報が更新されるとは限りません。
サービス側で一時的に保持されるキャッシュや、過去に生成された閲覧用URLが残留している場合があるからです。
機密情報を確実に消去するためには、反映後の状態を確認し、必要に応じてキャッシュの削除を要請する作業が求められます。

反映を確認しキャッシュに対処する手順は以下の通りです。

  • Bitbucketのウェブ画面を開き、対象のファイルを閲覧し、最新表示に機密情報が現れないことを確認する
  • コミット履歴を遡り、過去のいずれのバージョンにも該当する情報が存在しないことを確認する
  • ページを再読み込みしても古い内容が表示される場合、Bitbucketのサポート窓口へ問い合わせ、該当箇所のキャッシュ削除を依頼する
  • 公開リポジトリの場合、検索エンジンのインデックスに残留している可能性があるため、各サービスの削除申請フォームを利用して情報の除去を申請する

これらの作業は「完了した」と判断するまで繰り返し行う必要があります。
特に公開されていたリポジトリでは、第三者が既に情報を取得している可能性をゼロにはできません。
そのため、今回消去したAPIキーやパスワードは今後使用せず、新しい値を発行して安全な方法で管理することが不可欠です。
今回の作業は「過去の痕跡を消すためのもの」であり、「流出した情報を無効にする作業」と同時に実施して初めて完全な対策となります。

作業完了後に残留がないか検証する方法

GitコマンドとBitbucket画面で機密情報残留を検証する方法

Git履歴の書き換えとBitbucketへの反映が完了した時点で、作業が正しく終了したと判断することは早計です。
機密情報が完全に消去されたことを確認するためには、複数の角度から検証を行い、想定外の箇所に情報が残留していないか確かめる必要があります。
特に公開リポジトリの場合は、過去にインデックスされたページや外部のキャッシュから情報が参照されるリスクが残るため、ローカル環境と公開環境の両方を対象に確認作業を進めることが重要です。

ローカル環境でのgrepコマンドによる検索確認

最も基礎的かつ確実な検証手段が、ローカル環境での文字列検索です。
ファイルの最新状態だけでなく、コミット履歴全体を対象に検索を実施することで、表面上は消えていても内部データに情報が残っていないか確認できます。

実施すべき確認作業は以下の通りです。

  • まず最新の作業ツリーを対象にgrepコマンドを実行し、対象となる機密文字列が存在しないことを確認する
  • 次にgit log -pとパイプを組み合わせ、過去の全コミット履歴を通じて検索し、いずれの箇所にも該当文字列が出現しないことを確認する
  • ブランチを切り替えながら同様の確認を行い、対象外のブランチや古いブランチに情報が残留していないか確認する
  • 可能であれば、作業を行った環境とは別のディレクトリにリポジトリを新規クローンし、そのクローン先で同じ検索を実施して最終的な状態を検証する

この段階で検索結果が1件でも検出された場合は、履歴の書き換え作業が不完全であったか、対象外の箇所に情報が存在していた可能性があります。
検索結果の出力先とコンテキストを詳しく確認し、該当箇所を特定した上で再度git filter-repoによる削除作業を実施してください。
値の一部だけが別の文字列として残留しているケースも見られるため、完全な文字列だけでなく一部の特徴的な部分文字列でも検索を行うと安全性が高まります。

公開URLやキャッシュサービスの確認と削除申請

Bitbucket上の最新表示と直接のコミットリンクを確認しても、インターネット上の全ての場所で情報が消えているとは限りません。
検索エンジンのキャッシュ、ウェブアーカイブサービス、その他第三者が過去に取得したページに情報が保持されている場合があります。
これらに対してはBitbucket上の操作だけでは削除が行えないため、各サービスへ個別に申請を行う必要があります。

実施する確認と対処の手順は以下の通りです。

  • 検索エンジンでリポジトリのURLや機密情報に関連するキーワードを検索し、古いページがインデックスされていないか確認する
  • キャッシュやアーカイブサービスに該当ページが存在する場合、各サービスが提供する削除申請フォームから情報の除去を依頼する
  • 削除申請が受理された後も、定期的に状況を確認し、インデックスから完全に消去されるまで追跡を行う
  • 機密情報が広範囲に流出していると判断される場合は、関係するサービスのパスワードやAPIキーを速やかに無効化し、新しい値へ置き換える

これらの作業には時間がかかる場合が多く、削除が実施されるまでの期間は状況に応じて異なります。
また、一度公開された情報を完全に消し去ることは極めて困難であるという事実を認識し、「消去できたから安心」ではなく「流出しても影響が出ないようにする」という姿勢が不可欠です。
今回使用していたAPIキーやパスワードは今後一切使用せず、権限を取り消した上で新しい管理体制を構築することが、長期的な安全性を確保する最も確実な方法となります。

今後の再発を防止するための環境整備

機密情報を誤ってコミットさせないための事前防止体制図

Git履歴から機密情報を消去する作業は、過去に起きた問題を解決するための緊急的な対処に過ぎません。
いかに完全に消去できたとしても、情報が公開されていた時間が存在する以上、リスクがゼロになることはなく、作業に費やした時間と労力は本来必要のないコストであったといえます。
真に重要なのは、同じ事態が二度と起こらないように開発環境自体を改善し、機密情報がコミットされる前に阻止する仕組みを構築することです。
ここでは、日常的な開発の中で機密情報を安全に管理し、誤ったコミットを未然に防ぐための具体的な方法を解説します。

.gitignoreの適切な設定方法と除外すべきファイル

.gitignoreは、指定したファイルやディレクトリをGitの管理対象から除外するための設定ファイルです。
この設定が不十分であると、開発環境ごとに異なる設定ファイルや本来外部に出すべきでない情報が含まれたファイルが、誤ってリポジトリに登録される原因となります。
単にファイル名を記述するだけでなく、プロジェクトの特性に応じたきめ細かな設定が求められます。

除外対象として優先的に記載すべき項目は以下の通りです。

  • 環境変数やAPIキー、データベース接続情報を記述した.envや.localといった名前のファイル
  • パスワードや秘密鍵、証明書ファイルなど、権限情報を含むディレクトリまたはファイル
  • 開発環境ごとに内容が異なる設定ファイルで、サンプルファイルから実ファイルを生成する運用のもの
  • 一時ファイルやログファイル、ビルドによって生成される生成物ディレクトリ

設定を行う際にはいくつかの原則を守ってください。

  • 特定のファイル名を明示的に指定し、安易にワイルドカードを使用して広範囲を除外しない
  • 除外したファイルのサンプル版やテンプレート版を別途管理し、開発者が初回設定を行いやすいように配慮する
  • プロジェクトのルートに.gitignoreを配置し、チーム全体で同一のルールを共有する
  • 既に管理下にあるファイルを後から除外する場合は、git rm --cachedを使用して履歴から削除した上で設定を追加する

このように整備された.gitignoreは、新しいメンバーが参加した際にも安全な設定方法を示す指針となり、プロジェクトの品質を維持する基礎となります。

コミット前に自動検知するpre-commitフックの導入

.gitignoreはファイル単位での除外に有効ですが、設定ファイルに記載されていない箇所に直接機密情報が書き込まれた場合や、一時的なコードの中に記述された値に対しては効果がありません。
このようなケースを防ぐためには、コミットが実行される直前に自動的に検査を行う仕組みが必要です。
Gitに標準で備わっているpre-commitフックを利用すると、コミット処理を中断させる条件を独自に定義し、機密情報が含まれる場合には警告を表示して登録を阻止できます。

導入する際の基本的な考え方と手順は以下の通りです。

  • リポジトリ内の.git/hooksディレクトリに実行可能なスクリプトとしてpre-commitファイルを作成する
  • スクリプト内では、コミット対象のファイルから特定のパターンに一致する文字列を検索する
  • APIキーやトークン、パスワードといったキーワードに加え、固定長の文字列や特殊記号を含むパターンを正規表現で定義する
  • 条件に一致する文字列が検出された場合、エラーメッセージを表示してexit 1によりコミットを中断する

チーム全体で運用するためには、検知ルールをプロジェクト内の共通ファイルで管理し、各開発者の環境で自動的に有効化されるようにすることが望ましいです。
また、誤検知によって正当なコミットが妨げられることのないよう、検知パターンは厳しすぎず緩すぎない範囲で調整し、例外的に許可する場合の手順を明確に定めておく必要があります。

これらの仕組みは一度導入すれば終わりではなく、プロジェクトの進行と共に定期的に見直しを行い、新たな管理対象や設定パターンを追加していくことで、はじめて効果を発揮し続けます。
機密情報の管理は特別な手順ではなく、日常のコミット作業の一部として自然に組み込まれるべきものです。
開発者一人ひとりの意識と自動化された仕組みの両輪で、安全な開発環境を維持していくことが最も確実なリスク管理となります。

まとめ:BitbucketのGit履歴から機密情報を完全に消去するポイント

Bitbucket Git履歴から機密情報を消去する全体の流れと重要ポイントまとめ

ソースコードにAPIキーやパスワードといった機密情報を記述したままBitbucketにアップロードしてしまう問題は、経験のある開発者であっても起こりうるものであり、決して恥じるような単純なミスだけが原因ではありません。
開発のスピードを優先する中で確認が疎かになったり、動作確認用に仮に記述した値をそのまま放置したり、設定ファイルの管理ルールがチーム内で統一されていなかったりと、複数の要因が重なって発生するのが実情です。
しかし問題の大小にかかわらず、一度公開された情報は放置すれば重大な被害につながる可能性があり、早期かつ正確な対応が求められます。

本記事で解説してきた一連の作業は、単にファイル上から値を消すのではなく、Gitの仕組みそのものに対処するものであるため、通常のコード修正とは異なる注意点が数多く存在します。
作業を安全に完了させるためには、いくつかの段階を経て慎重に進める必要があり、それぞれの場面で核心となるポイントを見落としてはなりません。

最初に押さえておくべき根本的な理解は、ファイルを削除したり上書きしたりするだけでは過去の履歴から情報が消えないというGitの性質です。
最新の状態から機密情報が見えなくなっていても、それは現在の状態が変更されただけであり、その変更前のデータはコミット履歴の中に保持され続けます。
Bitbucketの管理画面からファイルを削除したりリポジトリを非公開に変更したりするだけでは、この履歴部分のデータには手が届かないため、第三者が過去のコミットを参照すれば機密情報を取得できる状態が維持されてしまいます。
完全な解決のためには、Git側で履歴そのものを書き換える作業が不可欠となるのです。

作業を開始する前の準備段階では、リスク管理が最も重要なポイントとなります。
履歴の書き換えはリポジトリの構造を根本的に変更するため、予期しない不具合やデータの損失が生じる可能性が常に伴います。
万が一の場合に備えて、作業前には完全なバックアップを別の場所に取得し、作業後に問題が発生しても元の状態に戻せる体制を整えておかなければなりません。
また、複数人で開発を行っているリポジトリでは、作業の実施日時を事前にチーム全体へ通知し、作業期間中のコミットを一時的に控えてもらうよう調整することが必要です。
履歴が書き換えられると各自のローカル環境とBitbucket上の履歴が一致しなくなるため、作業後に必要な手順を案内し、混乱を避ける配慮も欠かせません。

実際の削除作業では、現在最も推奨されているgit filter-repoを使用する方法が確実です。
特定のファイルやディレクトリを対象とする場合はパスを正確に指定し、APIキーやパスワードといった文字列を個別に消去したい場合は正規表現を活用して対象を特定します。
いずれの場合も事前に--dry-runオプションで影響範囲を確認し、必要なファイルやコードが誤って削除されることのないように注意してください。
特に文字列の一括削除では条件が広範囲に及びやすく、正規表現の記述を誤るとプログラムの動作に必要な部分まで影響を受ける可能性があるため、対象となるパターンをできるだけ厳しく限定し、実際に処理を実行する前に検証を繰り返すことが重要です。

ローカル環境での作業が完了した後は、Bitbucketへの反映を安全に行う手順が続きます。
履歴が書き換えられているため通常のプッシュは受け付けられませんが、安易に--forceを使用するのではなく、--force-with-leaseオプションを活用し、他の人の変更を誤って消すことのないよう配慮してください。
反映後にはBitbucket上で実際に過去のコミットを確認し、機密情報が表示されないことを目視で確認するとともに、キャッシュやインデックスの状況によっては時間をおいて再確認を行い、必要に応じてサポートへ削除依頼を行うことも考慮してください。

作業が完了したからといって安心してはなりません。
最も重要な事実として、一度公開された情報を完全に消し去ることは非常に困難であるという点が挙げられます。
検索エンジンやキャッシュサービスに残留している可能性があるだけでなく、もし悪意のある第三者が既に情報を取得していた場合、その行動を取り消すことはできません。
したがって、消去作業と並行して、漏洩した可能性のあるAPIキーやパスワードを速やかに無効化し、新しい値へ置き換える手続きを行ってください。
これは忘れがちですが、安全性を回復する上で最も効果のある対策の一つです。

そして、今回のような事態を二度と引き起こさないためには、事前の予防体制を整えることが最も確実な解決策となります。
.gitignoreを適切に設定して機密情報を含むファイルをコミット対象から除外し、サンプルファイルのみを管理する運用を定着させることで、ファイル単位での混入を防ぐことができます。
さらにpre-commitフックを導入し、コミット時に自動的に機密情報の有無を検知する仕組みを構築すると、個別の記述に対しても強力な抑止力となります。
これらの仕組みは一度設定して終わるのではなく、チームのメンバーが変わったりプロジェクトの形が変わったりする中で、継続的に見直し改善していくことで真の効果を発揮します。

機密情報の管理は特別なスキルを必要とする難しい作業ではなく、開発に携わる人すべてが日常的に意識すべき基本的な責任です。
今回の経験を教訓として、開発環境全体の安全性を高め、安心してプログラミングに打ち込める体制を築いていただければと願っています。

コメント

タイトルとURLをコピーしました