コンテンツへスキップ
Latchkey ホーム
無料で始める
ドキュメントメニュー

セキュリティアーキテクチャ

LatchkeyがすべてのCIジョブをどのように隔離するか: 専用の使い捨て仮想マシン、インバウンドネットワークなし、エフェメラルな認証情報、保存時および転送中の暗号化、そしてセルフヒーリングエージェントが動作する際の制約。

仮想マシンあたりのジョブ数
1
終了後に破棄されます
インバウンドネットワークルール
0
ランナーは接続を一切受け付けません
許可されたsudoパターン
1
セルフヒーリングエージェント向け
ビルドキャッシュの保持期間
14d
セルフヒールの記録は90日間

要点

  1. すべてのジョブが専用のEC2仮想マシンを取得します。このマシンは正確に1つのジョブだけを実行し、その後、暗号化されたディスクとともに破棄されます。
  2. ランナーは自身のパブリックIPv4アドレスからインターネットに接続し、インバウンドルールがゼロのセキュリティグループの内側にあるため、インバウンド接続を受け付けません。
  3. ランナーの認証情報はジャストインタイムかつ単一使用であり(GitHub Actionsランナーは、そのマシンだけに渡される短命なリンクから自身の認証情報を一度だけ取得し、その後削除します)、どのランナーもAWSインスタンスロールを持ちません。
  4. セルフヒーリングエージェントは、1エントリのみのsudo許可リストの下で非rootユーザーとして動作し、そのAIツールはデフォルト拒否のサンドボックス内で実行されます。

このページはセキュリティレビュー向けに書かれています。ランナープラットフォームが実際にどのように構築されているか、つまり隔離境界、マシンから外部に出るもの、認証情報の取り扱い方、そしてセルフヒーリングエージェントに許可されていること・いないことを説明します。GitHub Appがあなたのリポジトリで読み取り・書き込みできる内容については、セキュリティとGitHubの権限を参照してください。

セキュリティ · 3 つの境界をまたぐ 1 つのジョブ

1 つのジョブが 3 つの信頼境界を越えます。GitHub ではジョブがキューに入り、署名付き webhook が送られます。Latchkey のコントロールプレーンは webhook の署名を検証し、このジョブ専用のマシンを起動し、1 つのジョブにだけ有効なジャストインタイム設定を発行して、暗号化して保存します。読み取れるのは、そのマシンだけに渡される短命なリンクを通したときだけです。インバウンド接続を一切受け付けないランナー VM は、起動して設定を一度だけ読み、それを削除し、ちょうど 1 つのジョブのために登録し、そのジョブだけを実行し、暗号化ディスクごと終了されます。

FIG. 7.3-Aどの境界の通過も認証され、1 つのジョブに限定されます。認証情報は一度読まれると削除され、それを使ったマシンはジョブの終了とともに消えます。

隔離: 1ジョブ、1マシン#

Latchkeyはジョブ間でマシンを共有しません。各ジョブは、そのジョブのために起動された専用のEC2仮想マシン(m6aクラス、Ubuntu 24.04 LTS)上で実行されます。あなたのジョブは、他のテナントとカーネルを共有するコンテナではなく、長期稼働する共有ホスト上のプロセスでもありません。

単一使用は慣習によってではなく、GitHubの登録レイヤーで強制されます。コールドスタートのランナーはジャストインタイム構成で登録され、GitHubはこれを正確に1つのジョブに対してのみ受け入れます。ウォームプールのランナーは --ephemeral フラグで登録され、同じ動作になります。いずれの場合も、インスタンスはシャットダウン時に終了するよう構成されているため、何らかの問題が発生しても再利用されることはありません。

境界どのように強制されるか
マシンあたり1ジョブGitHubのジャストインタイム構成(コールドスタート)または --ephemeral 登録(ウォームプール)
マシンは再利用できないインスタンス起因のシャットダウン動作が終了(terminate)に設定されています。起動テンプレートと直接起動パスの両方で設定されています
ディスクは残らないルートEBSボリュームは暗号化され、終了時に削除(delete-on-termination)としてマークされています
暴走したジョブは回収されるLatchkey on GHでは、クリーンアッププロセスが、4時間のランナー寿命(ハードキャップは8時間)を超えたインスタンスを終了させます。Latchkey CIとCLIのジョブは、遅くともそれぞれ自身の時間の上限で終了します
ランナーは1つのworkspaceに紐付くインスタンスには組織IDがタグ付けされ、単一の組織ランナーグループに登録されます
01
起動
専用のEC2インスタンスが特定の1ジョブのために起動します
02
登録
ジャストインタイム構成。正確に1つのジョブに対してのみ有効です
03
一度だけ読み取り
ランナーは認証情報を取得し、直ちにそれを削除します
04
実行
あなたのジョブがマシン上で単独で実行されます
05
終了
インスタンスがシャットダウンします。シャットダウン動作は終了(terminate)です
06
破棄
暗号化されたルートボリュームがインスタンスとともに削除されます

ランナーグループは visibility: selected と明示的なリポジトリリストで作成されるため、あなたのworkspace向けに登録されたランナーには、有効化したリポジトリのジョブのみが割り当てられます。

何がrootとして動作し、なぜそれが封じ込められているのか#

自身のVM内では、あなたのジョブは完全な制御権を持ちます: runner ユーザーはパスワードなしのsudoとDockerアクセスを持ちます。これはCIとしては通常のことであり(ビルドはパッケージをインストールし、コンテナを実行します)、そして安全である理由はまさに、影響範囲がインバウンドネットワークを持たず、ジョブの終了時に破棄される短命なマシン1台に限られているからです。存在しないサンドボックスをほのめかすよりも、これを率直に述べることを選びます。サンドボックスが実際に存在する唯一の場所は、Latchkey CI でのフォークからのプルリクエストです: そのステップは sudo なし、Docker なし、固定のネットワークで実行されます。ネットワークのセクションに記載のとおりです。GitHub Actions では、フォークからのプルリクエストのジョブもほかのジョブと同じ完全な制御権を持ち、依存関係のキャッシュから復元はしますが保存はせず、Docker レイヤーキャッシュは使いません。

ネットワーク#

ロックダウンされているもの
  • ランナーは自身のパブリックIPv4アドレスからインターネットに接続します。このアドレスはランナー自身が開始する接続にのみ使われ、マシンごとに異なるため、許可リストに登録できる固定アドレスはありません
  • ランナーのセキュリティグループはイングレスルールがゼロで、このセキュリティグループが境界です: インターネット上のいかなるものもランナーへの接続を開くことはできません
  • IMDSv2が必須であり、ホップ制限が1に設定されているため、ブリッジネットワークのコンテナがホスト経由でインスタンスメタデータを読み取ることはできません
  • どのランナーもAWSインスタンスロールを持たないため、インスタンスメタデータサービスには、ジョブが取得できるAWS認証情報が存在しません。Latchkey CIのランナーが保持する認証情報はすべて短命で、コントロールプレーンによって発行されます。発行先は、どのworkspaceも指定しないマシン自体か、そのランナーが実行する1つのジョブのいずれかです。
  • ランナーと同じリージョンのS3とDynamoDBへのトラフィックはVPCのゲートウェイエンドポイントを引き続き使用し、そのほかのAWS APIの呼び出しは、ほかのリージョンのS3とDynamoDBも含めて、ランナーのパブリックアドレスから各サービスのパブリックエンドポイントに向かいます
  • WAF(レート制限、AWS Common Rule Set、Known Bad Inputs)がWebアプリケーションの前段に配置されています
ビルドが依然として到達できるもの
  • アウトバウンドトラフィックは開放されています。CIはnpm、PyPI、Docker Hub、あなたのクラウド、そしてあなた自身のサービスに到達する必要があるためです
  • ジョブに公開したシークレットは、そのジョブから到達可能であると考えてください: GitHubホストランナーと同じモデルです
  • 唯一の例外は Latchkey CI でのフォークからのプルリクエストです: そのステップが到達できるのは GitHub と固定された一連の公開パッケージレジストリだけで、それ以外には到達できません

2026年11月3日の当社のネットワーク変更より後に作成されたランナーのトラフィックは当社のNATゲートウェイを通過せず、その接続を記録するフローログはありません。ステップが出力した内容は、そこに含まれるホストやアドレスも含めて、ジョブのログと修復の記録に引き続き保持されることがあります。NATゲートウェイを通るのは当社のコントロールプレーン自身のトラフィックで、その変更より前に作成されたランナーのトラフィックも、そのランナーが終了するまでは通ります。それらのアウトバウンド接続が到達するリモートアドレスとそれが運ぶバイト数、およびインターネットからNATゲートウェイへの接続試行は、パケットの内容もポートも含まない最大10分ごとの合計として記録されます。この記録は14日間保持され、その後3日以内に削除されます。当社の運用担当者だけがネットワークコストの調査のために読み取り、運用担当者が作成した写しは14日以内に削除されます。

認証情報とシークレット#

01
ランナーの認証情報はジョブごとに発行されます

ジャストインタイムのランナー構成が単一のジョブ用に生成され、そのインストールとジョブにスコープされた非公開のオブジェクトとして、暗号化して保存されます。それを読み取る署名付きリンクを受け取るのは、そのジョブのために起動されたマシンだけで、リンクは 30 分で失効します。

02
ランナーは一度読み取り、その後削除します

起動時にインスタンスはそのリンクから一度だけ取得し、鍵素材を含むため、2 つ目のリンクで直ちに削除します。削除に失敗して残ったものは 1 日で失効します。ウォームプールの登録トークンも同じ方法で渡されて削除され、それぞれが自身のマシン用に発行され、キャッシュされることはありません。

03
GitHubへのアクセスは短命です

GitHub Appは秘密鍵でJWTに署名し、操作ごとに短命なインストールアクセストークンと交換します。ランナー上に長期間有効なGitHubトークンが置かれることはありません。

04
プラットフォームのシークレットはランナーから隔離されています

GitHub Appの秘密鍵はParameter StoreにSecureStringとして保存されます。どのランナーもインスタンスロールを持たず、Secrets ManagerからもParameter Storeからもプラットフォームのシークレットを読み取りません。

Latchkey CIでは、ステップが読み取るシークレットは、その値全体が現れる箇所であればどこでも、ジョブのログ内で隠されます。対象は、値そのもの、その標準のbase64表現(パディング付きで、末尾の改行の有無を問わず、base64 が76桁で折り返した形も含みます)、そしてそのJSON文字列の本体です。このマスキングは、ログが書き込まれる場所で、どのチャンクが切り出されたりアップロードされたりするよりも前に、そのシークレットを参照する最初のステップがそれを取得した時点から実行されます。また、セルフヒーリングが読み取ってランナーの外部へ送るものすべてにも、同じマスキングが適用されます。28バイト未満の値は、隠すことができないため、決して渡されません。それでも現れうるのは、複数行の値のうち単独で出力された1行、値の一部、または別のエンコーディングで表された値です。

デプロイはLatchkey CIで実行され、ジョブのLatchkeyのIDトークンを使ったOIDCによるロール引き受けでAWSに認証します。まだGitHub Actionsで実行されるワークフローは、GitHubのトークンで同じ方法で認証します。CIに長期間有効なAWSアクセスキーは存在しません。MCP連携用のAPIキーはSHA-256ハッシュとしてのみ保存され、平文のキーは作成時に一度だけ表示され、永続化されることはありません。

暗号化#

データ保存時転送中
ランナーのルートディスク暗号化されたEBS(gp3)、終了時に削除該当なし
ビルドキャッシュ(S3)SSE-S3(AES-256)、14日で失効TLS
アーティファクト(S3)SSE-S3(AES-256)、7日で失効TLS
アプリケーションデータベース暗号化されたストレージ、パブリックにアクセス不可TLS
キャッシュ / キューレイヤー保存時および転送中の暗号化を有効化TLS
アプリの鍵Parameter StoreのSecureStringTLS
ランナー構成と登録トークン(S3)SSE-S3(AES-256)、読み取り時に削除、1日で失効TLS
APIトラフィック該当なしAPIドメインでTLS 1.2以上

ビルドキャッシュの隔離#

キャッシュオブジェクトは、あなたの組織IDから導出されたキープレフィックスの下にS3へ保存され、テナントIDはジョブリクエストからコントロールプレーンによって注入されます: ジョブが環境変数を設定して別のテナントを名乗ることはできません。オブジェクトは14日後に失効します。組織の中でも、キャッシュに書き込めるジョブは読み取れるジョブより限られます。GitHub Actions では、push、pull_request、schedule、workflow_dispatch、merge_group で始まった実行のジョブだけがキャッシュに保存し、フォークからのプルリクエストのジョブや、Dependabot が開始または再実行した実行のジョブが保存することはありません。それ以外のジョブはキャッシュから復元しますが、保存はできません。Latchkey CI では、ジョブが依存関係のキャッシュを保存するのは自分のブランチ、プルリクエスト、タグの分だけで、ほかのブランチはデフォルトブランチが保存したものを読み取り、フォークからのプルリクエストのジョブにはキャッシュが提供されません。

ランナーから外部に出るもの#

2種類のデータがマシンから外部に出ます。2つ目については正確に述べる価値があります。

  • 実行およびジョブのメタデータ: 名前、タイミング、ステータス、ラベル、そしてワークフローファイル。ダッシュボードとAI Insightはこれらから作られます。
  • 失敗したステップの出力。 ステップが失敗すると、セルフヒーリングはその標準出力と標準エラーを取得し、それぞれ最大1 MiBを修復の記録に90日間保持します。これにより、失敗の診断と、必要に応じた修正案の作成ができます。AIのステージが動くと、その出力の末尾が、読み取ったジョブのファイルとともに当社のAIモデルプロバイダーに送られます。失敗したテストステップからは、ランナーは失敗したテストの名前とファイル、およびそのステップのテスト件数も、下に示すものを取り除いたうえで送信し、Latchkeyはそれらを90日間保持します。Latchkey CI では、名前とファイルは、不安定なテストと壊れたテストを見分けるために保持します。

セルフヒーリングが出力を送信・保持する前にランナーが取り除くもの#

  • ステップがbash(run:ステップの既定のシェル)で実行中に::add-mask::(または古い##[add-mask])で登録した値と、GitHub Actionsでは、失敗したステップより前にJavaScriptアクションがcore.setSecretまたは::add-mask::で登録した値。***と表示されます。そのbase64の形とエスケープした形(引用符付き、JSON、パーセントエンコード、XML)も取り除かれ、取得した出力の端で途切れた値の断片も、8文字の長さになれば取り除かれます。
  • 既知の形式のシークレット。[REDACTED:<type>]と表示されます: 秘密鍵、GitHub、GitLab、Anthropic、OpenAI、Google、Stripe、AWS、Slack、SendGrid、npm、RubyGems、Square、Docker Hub、Shopify、DigitalOcean、NuGet、Mailgun、Vaultのトークンとキー、JWT、Bearer、Token、Basicの認証値、接続文字列内のパスワード、コマンドライン上のAWSシークレットアクセスキー、署名付きURLの署名、Azureストレージアカウントキー、Sentry DSNのキー。接続文字列内のテスト用パスワードやJWTの形をしたテストフィクスチャなど、これらのいずれかに似ているだけのテキストも取り除かれます。
  • Latchkey CIでは、ジョブが使うシークレットの値。
  • GitHub Actionsでは、ワークフローファイルがワークフロー、ジョブ、ステップのいずれかのレベルのenv:のエントリで、固定のテキストだけを前後に置いた1つの${{ secrets.NAME }}の参照として失敗したステップの環境に割り当てた、各シークレットの値。***と表示されます。そのbase64の形とエスケープした形も取り除かれます。
  • ステップの出力に、JSONドキュメントの2つのフィールドにまたがって分かれた登録済みの値が含まれる場合、そのドキュメント全体が取り除かれます。
  • 修復PRの内容が変更されることはありません。提案された変更に、ジョブのLatchkey CIのシークレット、またはジョブが::add-mask::で隠したか、ワークフローファイルがシークレットからステップのenv:に割り当てた8文字以上の値が、書かれたままの形で、またはbase64やエスケープした形で含まれる場合、Latchkeyはプルリクエストを開きません。唯一の例外は、productionのような、数字を含まない24文字未満の値です。書かれたままの形の値がプルリクエストを止めるのは、その両端のどちらにもASCIIの英字、数字、アンダースコアが接していない場合だけで、エンコードした形はどこにあってもプルリクエストを止めます。また、変更が書き込む行にこれらのプレースホルダーが含まれる場合も、その行がプレースホルダー以外の内容も含み、かつワークフローファイルのいずれかの行にそのまま含まれている場合を除き、Latchkeyはプルリクエストを開きません。
  • ジョブが::add-mask::で10,000を超える値を隠した場合、ランナーが保持できないほど長い値を隠した場合、出力がランナーからセルフヒーリングに渡される64 MiBを超えた場合、ステップが隠した値を失ったことをランナーが検知した場合、または出力のマスクに失敗した場合、セルフヒーリングはそれを診断しません。当社のAIモデルプロバイダーには何も送られず、何も保持されません。Latchkey CIでは、ジョブがランナーの修復サービスで隠す必要のある値(シークレット、28バイト以上のサービスの設定、Latchkeyがステップに渡す認証情報)を64個より多く持った後に開始するステップでセルフヒーリングは実行されないため、そのステップについては当社のAIモデルプロバイダーに何も送られず、セルフヒーリングが保持するものもありません。ジョブのログでは、それらの値はすべて引き続き隠されます。GitHub Actionsでは、ワークフローファイルがそのトップレベルまたは失敗したジョブで、単純なenv:の割り当て以外の場所(run:のスクリプト、with:の入力、if:以外のキー、またはより大きな式の中)でシークレットを使う場合、割り当てた値がファイルと一致しない場合、ファイルが再利用可能なワークフローを呼び出す場合、失敗したステップがコンポジットアクションの中で動き、ファイルがGITHUB_TOKEN以外のシークレットをenv:に割り当てている場合、ジョブ内でそのステップより前に並ぶステップ、またはそのステップが動くコンポジットアクションのいずれかのステップが、コンテナアクションである場合、bash以外のシェル(shell: python、sh、pwsh、またはnode {0}のようなカスタムシェル)で動く場合、/usr/bin/bashのようにbashをパスで呼び出す場合、またはセルフヒーリングがファイルを読み取れないアクションを使う場合(前に並ぶステップはif:でスキップされた場合も数えられ、ジョブの開始時にpre-entrypointを実行するコンテナアクションはどこに並んでいても数えられ、セルフヒーリングは、リポジトリ内のアクションをワークフローが実行されたコミットにあるそのファイルで、別のリポジトリのアクションをステップが失敗した時点でランナー上にあるそのファイルで判定します)、または実行されたときのファイル全体をランナーが読み取れない場合(リポジトリをチェックアウトしていないジョブ、ファイルが1 MiBを超える、有効なYAMLでない、またはそのジョブを含まない場合)も、失敗したステップを診断しません。
  • 取り除かれないもの: 既知の形式を持たないシークレットを、ステップが::add-mask::で隠さずに出力したもののうち、ワークフローファイルのenv:を通さずにステップに渡ったもの(前のステップが$GITHUB_ENV、ステップの出力、ファイルに書いたものなど)、別のシェル(shell: python、sh、pwsh、またはnode {0}のようなカスタムシェル)で動くステップ、/usr/bin/bashをパスで呼び出すステップ、またはコンテナアクション(独自のDockerコンテナで動くアクション)でのみ隠された値(このため、セルフヒーリングは、そのようなステップとして読み取るステップの後に失敗したステップを診断しません)、ジョブの実行前にGitHubのランナーソフトウェアを自ら更新したランナー上で、JavaScriptアクションによってのみ隠された値(ランナーがこの更新を行うのは、起動元のLatchkeyのランナーイメージにあるものより新しいバージョンをGitHubがリリースしているときです。GitHub自身のログでは引き続き隠されます)、ワークフローファイルがステップのenv:に割り当てていないGITHUB_TOKENのエンコードした形、その後に別のシェルで動くステップ、/usr/bin/bashをパスで呼び出すステップ、またはアクションが、ジョブの一時ディレクトリにある、ランナーが隠した値を保管するファイルを削除したか、ディスクの空き容量不足やディスクのエラーで失われた値についてのランナーの記録を削除したために、ランナーが見つけられなくなった値、そして16進数やURLセーフなbase64など、別のエンコードでのみ出力された値。

セルフヒーリングエージェントに課された制約#

セルフヒーリングは、実行中のジョブを変更する唯一のコンポーネントであるため、レビュアーが最も強く精査すべき部分です。ここでは、それが何をできるのかを正確に説明します。

  • systemdサービスとして、rootではなく runner ユーザーで動作します。
  • グループに制限されたパーミッションを持つUnixドメインソケットでリッスンします。TCPリスナーもネットワーク面の攻撃対象もありません。
  • ランナーエージェント自身のステップスクリプトに対するシムを介してのみ呼び出され、それ以外のコマンドはすべて、手を加えられずにそのまま通過します。ただし例外が2つあります。GitHub Actionsでは、シムはランナーがJavaScriptアクション用に持つNode.jsの代わりにも置かれ、アクションが出力する::add-mask::コマンドを保持し、アクションの出力はバイト単位でそのまま渡します。このときエージェントは呼び出されません。またすべてのランナーで、セルフヒーリングがステップを再実行する前に、シムはそのステップがジョブの作業ディレクトリに残したテストレポートとテスト出力のファイル(Playwrightのスクリーンショットやトレースなど)をジョブの一時ディレクトリにコピーします。コピーを読めるのはジョブのユーザーだけです。エージェント自身がステップを再実行するときは、ジョブのユーザーとしてシムを呼び出してこのコピーを行います。
  • フェイルオープンします: エージェントがタイムアウト、拒否、またはエラーになった場合でも、失敗したコマンドは失敗のままです。壊れたヒーラーがあなたのビルドを壊すことはできません。

実行できる特権操作はフィルタリングではなく、許可リスト方式です:

制御その意味
sudo許可リスト許可されるのはアンカーされたパターン1つだけです: 単一パッケージの非対話的な apt-get install です。sudo で始まるそれ以外のものは、プロセスが生成される前に拒否されます。
パッケージ許可リストインストール可能なパッケージはコンパイル時のリストから取られ、2つの段階で独立して強制されます。一方の段階は信頼できないビルド出力からコマンドを組み立てるためです。
環境の安全下限LD_PRELOAD、LD_LIBRARY_PATH、PATH、BASH_ENV、ENV の設定は拒否されます。シェルのメタ文字とコマンド置換も同様です。
機密パスの拒否/etc、/root、/proc、/sys、/var/log、~/.ssh、~/.aws、~/.config/gh 配下の読み取りは拒否されます。
AIツールのサンドボックスステージ3のツールは、bubblewrapベースのサンドボックス内で実行されます。このサンドボックスはデフォルト拒否(ネットワークなし、書き込みパスなし)から始まり、ツールごとに必要最小限の範囲まで緩和されます。
常駐AIキーなしLatchkey CIとGitHub Actionsのランナーでは、推論ステップはコントロールプレーンがその1回の修復のために発行するモデルの認証情報を使用するため、あなたのコードを実行するマシン上に長期間有効なモデルAPIキーが置かれることはありません。
キルスイッチセルフヒーリングはworkspaceごとに無効化できます。

GitHub Appがアクセスできるもの#

以下の権限は、付与の理由がすぐ隣で分かるよう、フラットなリストではなく用途ごとにグループ化しています。最後の2行は、アプリが保持しているものの、現在Latchkeyのどの機能でも使用されていない権限です。

目的アクセス権限
Latchkeyランナーでジョブを実行する読み取りと書き込み組織のセルフホストランナー
リポジトリの基本情報を読み取る読み取りメタデータ
実行とログを読み取り、あなたまたはあなたのコーディングエージェントの求めに応じてワークフローをディスパッチし、無効化したリポジトリで待機している実行をキャンセルする読み取りと書き込みActions
Latchkeyがリポジトリに作成したwebhookを削除する読み取りと書き込みリポジトリのフック
ワークフロー、ドキュメント、ファイルと、プルリクエスト自体およびそのプルリクエストが変更するファイルの一覧を読み取り、修正をPRとして提案する読み取りと書き込みワークフロー、コード、プルリクエスト
コミットにLatchkey CIのチェックを書き込む読み取りと書き込みチェック
マージキューが作る各グループを確認し、ワークフローファイルが実行されるグループをLatchkey CIでビルドできるようにする読み取りマージキュー
組織のGitHubプランと、使用したActionsの分数を記録する読み取り組織のプラン、組織管理
組織のメンバーを確認する読み取りメンバー
現在、Latchkeyのどの機能でも使用されていません読み取りと書き込み管理、組織のフック
現在、Latchkeyのどの機能でも使用されていません読み取りアーティファクトのメタデータ

リポジトリへの変更#

Latchkeyがデフォルトブランチにプッシュすることは決してありません。すべての変更はあなたがレビューするプルリクエストであり、書き込み経路は3つの方法でゲートされています:

  1. ファイルパスは、リポジトリごとのマニフェストに照らして編集可能と解決される必要があります。一致しないパスはデフォルトで編集不可となります: このチェックはフェイルクローズです。
  2. フォークを起点とするプルリクエストは拒否されます。また、フォークかどうかのシグナルが欠落している場合も、安全であると仮定せずに拒否されます。
  3. 提案された修正は、取得済みのログ内の失敗シグネチャと一致する必要があり、一致しない場合は抑制されます。

運用上のセキュリティ#

  • ランナーイメージは、Latchkeyのリリースでその中身が変わるときに、最新のUbuntu 24.04イメージから、保留中のOSの更新をすべて適用して再ビルドされます。決まったスケジュールはなく、実行中のランナーがOSの更新を自分で取り込むこともありません。
  • どのランナーもAWSインスタンスロールを持ちません。Latchkeyがランナーに発行する唯一のAWSセッションは短命で、ビルドキャッシュとコンテナイメージだけを対象とするため、どのインスタンスのタグも読み取れず、ランナーの認証情報の保存先にもアクセスできません。また、どのランナーもほかのランナーの認証情報を読み取れません。
  • ダッシュボードとAPIへのアクセスは、APIゲートウェイのJWTオーソライザーによって認証されます。workspaceのロールはOwner、Admin、Memberであり、オーナーは削除や降格から保護されています。

データの保持#

Latchkeyが保存するものと、その保持期間です。

データ保持期間
ランナー上のあなたのソースコードジョブ終了時にインスタンスとともに破棄されます
ビルドキャッシュのオブジェクト最終書き込みから14日
latchkey artifact でジョブがアップロードしたアーティファクトアップロードから7日
Latchkey CIのジョブが outputs: に記録する値 (その実行とその再実行で、そのジョブを必要とするジョブが読むもの)workspaceを削除するまで保持されます
Latchkey CIのジョブとCLIジョブのログ7日
ジョブを開始するために latchkey run がアップロードする作業ツリージョブの終了時に削除されます。その削除に失敗した場合は、2日での失効により削除されます。セルフヒーリングが読み取った部分は、修復の記録に90日間残ります
診断のために取得された失敗ステップの出力90日
同じコミットでワークフローがLatchkey CIでは失敗し、GitHub Actionsでは成功したときの、失敗したステップのコマンドの1行目と、出力の最後の最大20行180日
セルフヒール試行の記録90日
修正案の記録365日
失敗したテストステップで失敗したテストの名前とファイル、およびそのステップのテスト件数90日
Latchkey CIで失敗したテストが不安定だと判明した頻度と、その名前とファイルそのテストが最後に失敗してから90日
プルリクエストが変更するファイルのパス90日
プルリクエストのジョブのうち、どの変更も届かないもの90日
ナレッジベースのために索引付けした、リポジトリのドキュメントとCI設定リポジトリが有効な間は保持され、無効化すると削除されます。それ以外の形でLatchkeyから利用できなくなった場合は、その90日後以降の最初の週次クリーンアップで削除されます。ただし、表の下に示す場合を除きます
ナレッジベースにアップロードしたドキュメントドキュメントまたはworkspaceを削除するまで保持されます
ダッシュボードを支える実行およびジョブのメタデータworkspaceを削除するまで保持されます

リポジトリから索引付けしたナレッジベースのドキュメント。 リポジトリは、GitHub Appのアクセス対象から外されたとき(GitHubで削除されたリポジトリも、Latchkeyにはこの形で見えます)、またはGitHub Appがアンインストールされたときに、Latchkeyから利用できなくなります。90日はそうした最初の停止から数えられ、数え直しになるのは、リポジトリがGitHub Appのアクセス対象に戻されたときだけです。戻されたものの再び有効化されていないリポジトリは、戻された日、またはLatchkeyがそのリポジトリについて記録した最後の変更(名前の変更やGitHub Appのアンインストールなど)の方が後であればその日から90日を数えます。GitHub Appの一時停止だけでは90日の期間は始まりません。リポジトリから削除されたファイルは、Latchkeyが次にそのリポジトリを索引付けしてファイルがなくなったことを確認してから90日後以降の最初の週次クリーンアップで、またはそれより先にリポジトリが削除される場合はリポジトリとともに削除されます。停止したリポジトリのドキュメントは、Latchkeyがファイルがなくなったことを確認したものを除き、そのドキュメントを索引付けしたときの名前と大文字・小文字まで一致する名前を同じworkspaceの有効なリポジトリが持つ間、90日を過ぎても保持されます。ただし、その有効なリポジトリ自身のそのファイルのコピーをLatchkeyが保持するか、停止したリポジトリの90日が始まった後にその有効なリポジトリをLatchkeyが完全に索引付けするまでです。リポジトリが停止したことをLatchkeyの記録から示せない場合、そのドキュメントはリポジトリを無効化するかworkspaceを削除するまで保持されます。各ドキュメントがどのリポジトリから来たかをLatchkeyが記録する前に索引付けしたドキュメントは、ドキュメントまたはworkspaceを削除するまで、あるいは索引付けしたときの名前と大文字・小文字まで一致する名前を持つリポジトリを無効化するまで保持されます。Latchkeyがリポジトリを索引付けしている間に停止が起きると、そのドキュメントの一部がすぐに削除され、その数分間に書き込まれた少数のドキュメントは、書き込まれた時点から90日を数えることがあります。

リポジトリを無効化すると、そのリポジトリの収集が停止します。workspaceを削除すると、そのデータが削除されます。組織として特定の保持期間が必要な場合は、お問い合わせいただければご相談に応じます。

脆弱性の報告#

security@latchkey.dev までメールでご連絡ください。セキュリティ報告のためにパブリックなGitHub issueを作成しないでください。

Q.01ジョブの後、ソースコードはランナー上に残りますか?

いいえ。ジョブが終了すると、インスタンスとその暗号化されたルートボリュームは破棄されます。明示的に利用を選択したビルドキャッシュのエントリ(14日後に失効します)、ジョブが latchkey artifact でアップロードしたアーティファクト(アップロードから7日後に失効します)、ジョブが成功したときに記録する出力(ワークスペースを削除するまで保持されます)、セルフヒーリングが読み取ったファイルの内容(修復の記録に90日間残ります)、修正案のファイル内容(365日間保持されます)を除き、チェックアウトしたものは何も残りません。

Q.02他の顧客のジョブが自分のジョブを見ることはできますか?

いいえ。各ジョブは独自の仮想マシン上で実行され、単一のworkspaceに登録され、その1つのジョブの後に破棄されます。ランナーにはインバウンドのネットワークアクセスがありません。

Q.03セルフヒーリングエージェントは、自分のビルド上で任意のコマンドを実行できますか?

いいえ。特権的なアクションはフィルタリングではなく許可リスト方式です: 許可されたsudoパターンは1つのみ、パッケージリストは固定、コード注入を可能にする環境変数は拒否、AIツールのステージはデフォルト拒否のサンドボックスです。エージェントが何らかの理由で失敗した場合でも、失敗したコマンドは失敗のままです。

Q.04自分のビルドのシークレットはLatchkeyから見えますか?

見える場合があります。Latchkeyランナーは、ほかのランナーと同じく、ジョブが参照するGitHub Actionsのシークレットを受け取ります。シークレットは実行時にGitHubによって注入され、ランナーはジョブの終了時に破棄されます。LatchkeyがGitHubのAPIを呼び出してその値を求めることはありません。セルフヒーリングが失敗したステップを診断するとき、そのステップの出力はGitHubがマスクする前に取得されます。その末尾は当社のAIモデルプロバイダーに送られ、出力のうち最大1 MiBが90日間保持されます。ランナーはまず、bashのステップが::add-mask::で隠した値、既知の形式のシークレット、そしてワークフローファイルがステップのenv:に割り当てたすべてのシークレットを取り除き、ワークフローファイルがそれ以外の方法でシークレットを使うステップはセルフヒーリングが診断しません。そのため、既知の形式を持たないシークレットがその両方に含まれるのは、それが別の経路でステップに渡り、ステップが隠さずに出力した場合だけです。既知のシークレットのパターンは、その出力を提供するときにもう一度取り除かれます。