ローカル設定

Failproof AI は、ポリシーの選択とマシン・デーモンの設定を分離しています。これにより、リポジトリのポリシー選択を審査可能な状態に保ちつつ、認証情報やデーモンの状態をリポジトリの外に置くことができます。

ポリシースコープの選択

ダッシュボード
CLI

引数なしで failproofai を実行するとローカルポリシーダッシュボードが開きます。ポリシーを有効にする前に、user・project・local のいずれかのスコープを選択することで、変更が意図した設定ファイルに書き込まれます。

User はこのマシン上のすべてのプロジェクトに適用されます。
Project はリポジトリに紐づき、コミットに含めることができます。
Local は特定プロジェクトを特定ユーザー向けにオーバーライドするもので、gitignore に追加しておく必要があります。

failproofai policy add block-rm-rf --scope user
failproofai policy add block-force-push --scope project
failproofai policy add warn-large-file-write --scope local
failproofai policies

すべてのハーネスが local スコープに対応しているわけではありません。選択したハーネスが表現できないスコープを指定した場合、CLI はエラーを返します。

スコープ	ポリシー設定ファイル
Project	`<project>/.failproofai/policies-config.json`
Local	`<project>/.failproofai/policies-config.local.json`
User	`~/.failproofai/policies-config.json`

有効化されたポリシーは和集合としてマージされます。ポリシーパラメータは、そのポリシーのパラメータを定義している最初のスコープが使用され、適用順は project → local → user の順となります。明示的なカスタムポリシーパスも、それを定義している最初のスコープが使用されます。

ポリシーパラメータの設定

ダッシュボード
CLI

ローカルダッシュボードでポリシーを開き、サポートされているパラメータを編集して、選択したスコープで保存します。条件に一致するエージェントアクションと一致しないエージェントアクションをそれぞれ実行し、Observe → policy で判定結果を確認します。

選択したスコープの policies-config.json を編集してから、failproofai policies を実行して不明なポリシー名やパラメータキーを検出します。

{
  "enabledPolicies": ["block-rm-rf", "block-force-push"],
  "policyParams": {
    "block-rm-rf": {
      "allowPaths": ["/tmp/build-output"]
    }
  }
}

failproofai policies

マシンファイルの概要

~/.failproofai には、信頼境界ごとに分かれたファイルが格納されています。

パス	用途
`config.json`	機密情報を含まないデーモン・監査・テレメトリ設定
`credentials.json`	クラウド認証情報。オーナーのみ読み取り可能なパーミッションで保存
`policies-config.json`	ユーザースコープの組み込みポリシー選択、パラメータ、および明示的なカスタムパス
`policies/`	ユーザー規約ポリシーおよびクラウド管理のポリシーアーティファクト
`hook-activity/`	ローカルポリシー判定ログ
`state/`	デーモンスプール、ヘルス、一時停止、およびランタイム状態

コンテナや隔離されたテスト環境向けにマシン全体のレイアウトを移動する場合は FAILPROOFAI_HOME を使用してください。個別の状態ディレクトリを独立して移動しないようにしてください。

credentials.json は絶対にコミットしないでください。プロジェクトのポリシー設定およびプロジェクト規約ポリシーは、執行コードとしてレビューした上でのみコミットしてください。

Connect your agents

Reference

ポリシースコープの選択

ポリシーパラメータの設定

マシンファイルの概要

​ポリシースコープの選択

​ポリシーパラメータの設定

​マシンファイルの概要

ポリシースコープの選択

ポリシーパラメータの設定

マシンファイルの概要