メインコンテンツまでスキップ

Site Profile

Site Profile は Website Profile を特定のドメインに紐づけるために利用するデータです。

用語​

本文書に説明のない用語については、用語を参照してください。

  • Originator Profile Set (OPS)
  • Core Profile (CP)
  • Profile Annotation (PA)
  • Web Media Profile (WMP)
  • Website Profile (WSP)
  • Site Profile (SP)

Site Profile​

Site Profile は OPS と WSP をまとめた次のような JSON です。

  • originators: REQUIRED. OPS です。
  • sites: REQUIRED. WSP の配列です。
注記

sites プロパティには同じサブジェクトの WSP を含めてください。つまり、配列に2つ以上のWSPを持つ場合は国際化を目的としているはずです。

非規範的な例を示します。

{
  "originators": [
    {
      "core": "eyJ...",
      "annotations": ["eyJ...", "eyJ..."],
      "media": ["eyJ..."]
    },
    {
      "core": "eyJ...",
      "annotations": ["eyJ..."],
      "media": ["eyJ..."]
    }
  ],
  "sites": ["eyJ..."]
}

方法​

クライアントがオリジンの /.well-known/sp.json にアクセスすると Site Profile が得られるようにしてください。

リクエスト​

あるドメインの WSP を得たいときは、そのドメインの /.well-known/sp.json に HTTP GET リクエストを送ります。

次の例は example.com の Site Profile を得るリクエストです。

GET /.well-known/sp.json HTTP/1.1
Host: example.com

次の例はそのレスポンスです。

HTTP/1.1 200 OK
Content-Type: application/json
...: ...

...
注記

実装者は Accept-Language リクエストヘッダーがユーザーにとってプライベートな性質があると考える情報が明らかになる (ユーザーがどの民族に属しているかなど) ことを加味してプライバシーに配慮した実装をしなければなりません。 具体的には、ログとして収集する範囲に Accept-Language を含めない、ログを保持する期間を定める、プライバシーポリシーによって Accept-Language の取扱いを明示するなどです。

レスポンス​

Site Profile の　well-known パスへの GET リクエストに対して Site Profile を返す場合、ステータスコードは200で、ボディーを Site Profile にしてください (MUST)。 サーバーはリクエストに Accept-Language ヘッダーが含まれる場合、 RFC 4647 セクション 3 に従って WSP および OPS の言語を選択しなければなりません (MUST)。

国際化​

Site Profile 配布者は、アプリケーションがロケールに応じて VCs を抽出できるように、sites プロパティに異なる言語が指定された 2 つ以上の VCs を含めて配布することができます (MAY)。

VCs への言語の指定方法は OP VC Data Model の国際化に準じます。

originators プロパティの国際化方法は Originator Profile Set の国際化に準じます。

検証プロセス​

このセクションは非規範的です。

@originator-profile/verify において実装されている検証処理は次のプロセスでおこなわれます。

検証プロセスで扱うデータの構造については次のリファレンスを確認してください。

  • SiteProfileInvalid
  • SiteProfileVerifyFailed
  • 検証済み SP

OPS の検証プロセスの詳細は OPS の検証 に準じます。また、WSP の検証プロセスの詳細は WSP の検証 に準じます。