シークレット管理は、開発者が認証情報を生成、保存、配布、廃止するために使用する手法やシステムのことです。例として、サーバーレス関数内のアプリケーションプログラミングインターフェイス (API) キーや、コネクションプール内のデータベースのパスワードなどがあります。シークレット管理により、誰が (または何が) 特定の値をいつまで、どのような条件で読み取れるかが制限されます。シークレットの漏洩は深刻化している問題であり、2024 年には約 2,400 万個もの新しいハードコードされたシークレットが公開 GitHub コミットに追加されました。
以下では、開発者が管理するシークレットの種類、保存やアクセスの仕組み、また、開発者やチームが作成するプロジェクトごとに個別の API キーをプロビジョニングする上で Stripe Projects がどのように役立つかについて説明します。
この記事でわかること
アプリケーションプログラミングインターフェイス (API) キー、アクセストークン、データベース認証情報、証明書、暗号化キーには、それぞれ独自のリスクとライフサイクルがあります。
範囲が限定された認証情報、スケジュール設定されたローテーション、および監査ログにより、1 つのシークレットの漏洩が引き起こす被害が制限されます。
アプリケーションプログラミングインターフェイス (API) やインフラストラクチャーを呼び出す自律型ツールには、広範なアカウント権限ではなく、個別で範囲が限定された、取り消し可能なアクセス権が必要です。
シークレット管理のベストプラクティスはなぜ重要なのか?
シークレット管理は、アプリケーション (アプリ) が依存する認証情報を生成、保存、配布、廃止する方法を対象としています。適切なシークレット管理により、アクセス権が明確化されて取り消しが容易になるため、認証情報の漏洩による被害が制限されます。不十分なシークレット管理では、漏洩した 1 つの値を見つけた誰もが本番環境システムにアクセスできてしまう可能性があります。
開発者が保護する必要があるのはどのような種類のシークレットか?
シークレットにはいくつかの一般的なカテゴリーがあり、それぞれの機能は少し異なります。
一般的にシークレット管理が対象とするものは以下のとおりです。
アプリケーションプログラミングインターフェイス (API) キー: 決済代行業者やマッピング API などのサードパーティサービスに対してアプリケーションを認証します。通常、これらは自動的に期限切れになることはないため、キーが漏洩すると、手動で取り消されるまでアカウントへのフルアクセスが許可されることがよくあります。
アクセストークン: オープンオーソリ (OAuth) アクセストークンと JavaScript Object Notation (JSON) Web トークンは、ユーザーまたはサービスの権限を保持し、通常は API キーよりも短いライフサイクルを持ちます。これらは、モバイルアプリ、シングルサインオンのフロー、サービス間の呼び出しで使用されます。
データベース認証情報: PostgreSQL、MySQL、MongoDB などのシステムのユーザー名、パスワード、接続文字列は、設定ファイルやコネクションプールに配置されます。これらは多くの場合、複数の環境に同時に複製されます。
証明書と秘密鍵: Transport Layer Security (TLS) 証明書と Secure Shell (SSH) キーは、ID を検証し、サーバー間の接続を保護します。期限切れの証明書や不適切に保存された証明書は、情報漏洩と同じくらいの頻度でシステム停止を引き起こします。
暗号化キー: 保存中または転送中のデータを暗号化するキーは、Amazon Web Services Key Management Service (AWS KMS) や HashiCorp Vault のトランジットエンジンなどのサービスによって管理されます。キーを紛失すると、そのキーで保護されているデータにアクセスできなくなる可能性があります。
環境変数: これら自体はシークレットではありません。多くのアプリケーションが実行中のプロセスにシークレットを取り込むために使用する配信メカニズムであり、ログファイルやクラッシュレポートに値を漏洩させやすい手段でもあります。
これらのシークレットは、ローカルの開発マシン、継続的インテグレーションおよび継続的デリバリー (CI/CD) パイプライン、クラウドインフラストラクチャー、本番環境システムなど、さまざまな環境に現れます。ある環境では厳重に保護されている値が、別の環境では無防備な状態になっていることもあります。
シークレット管理はどのように機能するのか?
シークレット管理では、ハードコードされた値がルックアップに置き換えられます。データベースのパスワードをコードに直接書き込む代わりに、実行時にアプリケーションが集中型ストアにパスワードを要求し、そのストアがパスワードを解放するかどうかを決定します。
環境変数はよりシンプルです。コンテナオーケストレーションシステムを使用すると、デプロイ時にシークレットを環境変数またはマウントされたファイルとして挿入できます。これにより、シークレットはコードベースから除外されますが、実行中のコンテナ内に配置された後は暗号化されません。構成管理システムはその中間に位置します。転送中および構成リポジトリ内ではシークレットを保護しますが、その後、受信側のシステムがシークレットをどのように処理するかについては、引き続き責任を負う必要があります。
集中型認証情報管理プラットフォームは、ストレージ上にローテーション、バージョニング、監査証跡を構築します。コードがシークレットを必要とする場合、サービスアカウント、Identity and Access Management (IAM) ロール、または有効期間の短いトークンを介してプラットフォームに対して認証を行い、静的な認証情報ではなく、範囲と時間が限定された認証情報を受け取ります。これにより、システム内の他のすべての認証情報に影響を与えることなく、単一のサービスのアクセスを遮断できます。
シークレット管理のベストプラクティスにはどのようなものがあるか?
適切なシークレット管理は、チームが長期にわたって継続する習慣に依存します。
これらのプラクティスは、ほぼすべての厳格なフレームワークに組み込まれています。
最小権限のアクセスを付与する: 各サービスまたは担当者には、特定の環境とアクションに限定された、必要な特定のシークレットのみを付与します。ステージング環境にデプロイする継続的インテグレーション (CI) パイプラインが、本番環境にデプロイするパイプラインと同じ認証情報を保持してはなりません。
スケジュールに従ってシークレットをローテーションする: ライフサイクルの長い API キーやデータベースのパスワードは、定期的にローテーションし、従業員の退職後や漏洩の疑いがある場合は直ちにローテーションする必要があります。自動ローテーションにより、ローテーションを省略する理由がなくなります。
トークンに有効期限を設定する: 数分または数時間で期限切れになる有効期間の短いトークンは、漏洩した場合の被害の期間を制限します。OAuth アクセストークンは通常、1 つの静的な値ではなく、ライフサイクルの長いリフレッシュトークンとペアになっています。
すべてのアクセスリクエストをログに記録する: 監査ログには、どの ID が、いつ、どこから、どのシークレットにアクセスしたかを記録する必要があります。そうすることで、インシデント発生時に認証情報が侵害されたかどうかを推測ではなく明確に回答できます。
環境ごとにシークレットを分離する: 開発、ステージング、本番の各環境には、個別の Vault または名前空間に保存された独自の認証情報が必要です。テストデータベースのパスワードが本番環境のデータベースに対して機能してはなりません。
チャットやメールではなく、Vault を介してシークレットを共有する: 認証情報を Slack やサポートチケットに貼り付けると、認証情報を保護するように構築されていないシステムに配置されることになります。代わりに、多くのシークレット管理プラットフォームでは、一時的で取り消し可能な共有リンクがサポートされています。
コミットごとに漏洩した認証情報をスキャンする: GitHub シークレットスキャン、TruffleHog、Gitleaks などのスキャナーは、マージの前または直後にコミットとプルリクエストをチェックし、認証情報の偶発的な漏洩がないか確認します。
バージョン履歴から漏洩したシークレットを削除する: 古い値がまだ機能する場合、git 履歴から削除しても意味がないため、最初に漏洩した認証情報を取り消します。その後、git filter-repo や BFG Repo-Cleaner などのツールを使用して過去のコミットから認証情報を削除できますが、それ以前にリポジトリをクローンしたユーザーは引き続きコピーを保持することになります。
不十分なシークレット管理にはどのようなリスクがあるか?
公開 GitHub コミットに関する GitGuardian の年次調査によると、2024 年にはコミット作成者の 15% がシークレットを漏洩させていたことが判明しています。直接的なリスクは不正アクセスです。漏洩したデータベース認証情報が発見される可能性があり、自動スキャナーはプッシュから数分以内に公開リポジトリを検索できます。
最初の漏洩にとどまらず、盗まれたことに気づかれないキーが何カ月も有効なまま放置されることがあります。多くの企業にはログインの失敗を検出するプロセスはあっても、技術的に有効な認証情報の不正使用を検出するプロセスがないためです。このような方法で侵入した攻撃者は、すでに認証情報を所持しているため、認証をバイパスする必要がまったくありません。
不十分なシークレット管理は、犯罪者とは関係のないリスクも生み出します。証明書の期限切れはシステム停止の原因となります。ローテーションされた認証情報がすべての場所で更新されていないと、予期しないタイミングで連携が機能しなくなります。また、メールや共有ドキュメントを通じて非公式にシークレットを共有しているチームは、誰が実際にアクセス権を持っているか把握できなくなる可能性があります。
シークレット管理は AI エージェントや開発ワークフローにどのように適用されるか?
AI コーディングエージェントは、API の呼び出し、データベースへのクエリ、コードのデプロイなど、実際の作業を行うために実際の認証情報を必要とすることが多いため、状況を一変させます。エージェントはマシンの速度で命令を実行するため、適切に範囲が限定されていない認証情報は、誰かが気づく前に複数のシステム全体に被害を及ぼす可能性があります。
このリスクは、エージェントが呼び出せるツールの数に比例して増大します。決済 API、クラウドプロバイダー、および社内チケットシステムに接続されたエージェントには、すべてをカバーする広範な単一の権限セットではなく、それぞれに対して個別の、範囲が限定された認証情報が必要です。このような分離がない場合、侵害された 1 つのエージェントセッションが、意図したよりもはるかに大きな影響を及ぼす可能性があります。
Stripe 上で構築を行う開発者に対して、Stripe Projects はこの課題の一部を解決します。開発者またはチームが作成するプロジェクトごとに、そのプロジェクトのデータと環境に限定された個別の API キーをプロビジョニングできます。あるエージェントやアプリケーションで使用されるキーで、他のものにアクセスすることはできません。Stripe Projects は、サードパーティのインフラストラクチャーサービスのプロビジョニング、認証情報の保存、および請求を処理します。
適切なシークレット管理ツールをどのように選択すればよいか?
インフラストラクチャーによって適切な選択肢は異なります。
いくつかの質問により、リストをすばやく絞り込むことができます。
ID プロバイダーと連携しているか? 既存の Identity and Access Management (IAM) やシングルサインオン (SSO) の設定で認証できないシステムでは、管理する ID システムが 2 つに増えてしまいます。これは通常、アクセス制御が弱まることを意味します。
使用しているサービスの自動ローテーションをサポートしているか? 一般的なデータベースやクラウドサービス向けのネイティブなローテーション機能により、自分でローテーションスクリプトを構築して保守する手作業を省くことができます。
有効期間が短く、範囲が限定された認証情報を強制できるか? 静的でライフサイクルの長いシークレットは、排除すべきパターンです。動的な値を発行せずに値を保存するだけのシステムでは、問題の半分しか解決できません。
実際に使用可能な監査ログを作成できるか? インシデントを再構築するのに十分な詳細を含めずにアクセスを記録するログは、必要なときにあまり役立ちません。
AI ツールが必要とするシークレットをどのように扱うか? エージェントや自動化されたワークフローが認証情報をリクエストする場合は、システムが人間のアクセスとは別にそれらの範囲を限定して期限切れにすることができるかどうかを確認します。
Stripe Projects の活用方法
Stripe Projects を使用すると、開発者やその AI エージェントは、コマンドラインインターフェイス (CLI) からサービスの追加、認証情報の生成、請求の管理を行うことができます。
Stripe Projects のメリット
コマンドラインからサードパーティ製サービスをプロビジョニングする: プロバイダーごとに異なるツールやワークフローを使用する代わりに、1 つのワークフローを使用して、サービスの追加、認証情報の管理、プランのアップグレードを行います。ダッシュボード、設定ファイル、インフラストラクチャーコードを必要とせずに、ホスティング、データベース、認証、AI などを管理します。
認証情報を自動的に同期する: ローカル環境、マシン、チームメンバー、エージェント間で環境変数をポータブルに保ちます。アプリケーションプログラミングインターフェイス (API)キーをコピーして貼り付ける必要はありません。
CLI またはコーディングエージェントから請求を管理する: 請求情報を一度設定するだけで、サードパーティ製サービスと安全に共有できます。CLI から、ティアのアップグレードやダウングレード、使用状況の監視、サブスクリプションの管理を実行します。
Stripe Projectsによりアプリのプロビジョニングを簡素化する方法の詳細を表示するか、このコマンドをターミナルにコピーして貼り付け、今すぐ開始してください:
brew install stripe/stripe-cli/stripe && stripe plugin install projects && npx skills add https://github.com/stripe/ai --skill stripe-projects -y -g
この記事の内容は、一般的な情報および教育のみを目的としており、法律上または税務上のアドバイスとして解釈されるべきではありません。Stripe は、記事内の情報の正確性、完全性、妥当性、または最新性を保証または請け合うものではありません。特定の状況については、管轄区域で活動する資格のある有能な弁護士または会計士に助言を求める必要があります。