Content Attestation Server Playground
Content Attestation Server Playground は、Content Attestation の発行からブラウザ拡張機能での検証までのワークフローをテストできる環境です。
warning
Playground はテスト専用の環境です。Playground で発行した Content Attestation や Site Profile は本番環境では使用できません。
Playground の使い方
画面の説明
画面は「左」「中央」「右」の3つのペイン (列) で構成されています。
- 左ペイン: ナビゲーション (Sidebar): APIエンドポイントの目次です。目的のエンドポイントを検索・選択できます。
- 中央ペイン: ドキュメント (Documentation): 左ペインで選択されたAPIの詳細な仕様が表示されます。エンドポイントのURL、機能の概要文、必須および任意のパラメータ (Query、Path、Headers)、リクエストボディのデータ構造 (Schema) が記載されています。
- 右ペイン: APIクライアント (API Client): ドキュメント上で直接APIリクエストを実行できるテスト環境です。各種プログラミング言語 (Node.js、Pythonなど) やコマンドラインツール (cURL) に対応した実装用のコードスニペットが自動生成され、コピーして開発に活用できます。
APIの動作確認を行う方法は以下の通りです。
- APIの選択: 画面上部の検索バーを利用するか、左ペインのナビゲーションから、確認したいAPIエンドポイントを選択します。
- パラメーターの入力: 中央ペインで仕様を確認しながら、右ペイン (または中央ペイン下部) の「Test Request」ボタンをクリックし、必要なパラメーターを入力できます。リクエストボディに必要なJSON形式でデータを入力することが可能です。
- リクエストの送信: 「Send」ボタンをクリックし、対象のサーバーへAPIリクエストを送信します。
- レスポンスの確認:
リクエスト送信後、画面上にレスポンスのステータスコード (例:
200 OK) や、サーバーから返却されたデータ (JSON形式など) が表示されます。想定通りの結果が得られているかを確認できます。
Site Profile の発行
Playground の /sp エンドポイントに POST リクエストを送信します。
curl -X POST https://playground.originator-profile.org/sp \
-H content-Type:application/json \
-u Basic認証ユーザー名:Basic認証パスワード \
-d '{ ... }'
リクエストボディの各プロパティの詳細は Website Profile (WSP) データモデル および Site Profile (SP) をご確認ください。
検証方法
ブラウザ拡張機能をインストールした状態で、Site Profile を配置したウェブサイトにアクセスすることで検証を行えます。 検証するにはテストビルド版のブラウザー拡張機能が必要です。
warning
テストビルド版の拡張機能は Playground 環境専用です。本番環境の Content Attestation を検証できません。また、Playground で発行した Content Attestation や Site Profile は通常ビルド版の拡張機能で検証できません。
GitHub Releases (canary) からブラウザ拡張機能 (テストビルド) をダウンロードし、インストールできます。
| ブラウザ | ファイル名 |
|---|---|
| Chrome | _testing_profile_web_extension-chromium-canary.zip |
| Firefox | _testing_profile_web_extension-firefox-desktop-canary.zip |