sensitive-browser

機密情報を扱うブラウザー操作

認証情報の処理、支払い、フォームへの入力を、コンテキストが分離された専用のサブプロセスに委任することで、機密情報を扱うブラウザー操作を安全に実行します。

使用する場面

• ユーザーから、認証情報を使ってウェブサイトにログインするよう依頼された場合
• ユーザーがチェックアウトページで支払い情報を入力する必要がある場合
• ユーザーが個人情報や機密情報を含むフォームに入力する必要がある場合
• ブラウザーの自動化で認証情報の引き継ぎが必要な場合

前提条件

LLM にアクセスするには、ATXP_CONNECTION 環境変数を定義する必要があります。この変数には、ATXP プラットフォームへの接続文字列を設定します。

設定されていない場合は、設定方法について ATXP CLI を参照してください。

ワークフロー

1. 機密データファイルを準備する

ユーザーの機密データを含む JSON ファイルを作成します。必要な値をユーザーに確認してください。

{
  "credentials": {
    "username": "[email protected]",
    "password": "secret"
  },
  "payment": {
    "cardNumber": "4111111111111111",
    "expiry": "12/28",
    "cvv": "123",
    "billingZip": "94102"
  },
  "personal": {
    "fullName": "Jane Doe",
    "phone": "+1-555-0123",
    "address": "123 Main St"
  }
}

タスクに必要なフィールドのみを含めてください。安全に保管し、使用後に削除してください。

2. 機密情報を扱う操作を実行する

npx sensitive-browser "<task>" \
  --sensitive-data ./creds.json \
  --url <target-url> \
  --state ./session.json \
  --output ./session.json

オプション：

オプション	説明
<task>	自然言語によるタスク（例：「認証情報を使ってログインする」）
-d, --sensitive-data <path>	機密データ JSON のパス（必須）
-u, --url <url>	移動先の URL
-s, --state <path>	読み込む Playwright のストレージ状態
-o, --output <path>	更新後の状態の出力先

3. agent-browser と連携する

agent-browser と併用する場合は、セッション状態を引き渡します。

# Save current session
agent-browser --session myapp state save ./session.json

# Hand off to sensitive-browser for login
npx sensitive-browser "log in with credentials" \
  --state ./session.json \
  --sensitive-data ./creds.json

# Resume agent-browser with authenticated session
agent-browser --session myapp state load ./session.json

セキュリティに関する注意事項

• 機密データの値は、ログに記録されたり表示されたりすることはありません
• ツールには使用するフィールドが表示されますが、その値は表示されません
• 使用後は機密データファイルを削除してください
• 本番環境では、環境変数やシークレットマネージャーの利用を検討してください

機密データのスキーマ

サポートされているフィールドのカテゴリ：

• credentials：ユーザー名、パスワード、メールアドレス
• payment：カード番号、有効期限、セキュリティコード、請求先郵便番号、カード名義人
• personal：氏名、名、姓、電話番号、住所、市区町村、州、郵便番号、国、生年月日
• カスタムフィールド：必要に応じて、その他の key: value ペア