メインコンテンツまでスキップ
プレビュー版
PocketSign Link v2 は現在プレビュー版です。正式提供までに仕様が変更される可能性があります。

pocketsign-manifest.json

pocketsign-manifest.json は、ミニアプリブラウザ(WebView)の動作に関する設定を配信するためのマニフェストファイルです。

配置場所

pocketsign-manifest.json は、PocketSign Platform で指定した URL から解決されるパスに配置してください。 解決のアルゴリズムは、URL コンストラクタと同様のものが利用されます。

例:

  • Platform で指定した URL が https://example.com/app/ の場合:
    • https://example.com/app/pocketsign-manifest.json
  • Platform で指定した URL が https://example.com/app の場合:
    • https://example.com/pocketsign-manifest.json

形式

例:

{
"version": 1,
"allowOrigins": ["https://example.com"]
}
  • version: マニフェストのスキーマバージョン(必須)
  • allowOrigins: 別オリジンの URL をミニアプリブラウザ内で開くことを許可するオリジンの配列(任意)

allowOrigins

ミニアプリは、原則として Platform で指定した URL と同一のオリジンの URL のみ、ミニアプリブラウザ内で遷移できます。 allowOrigins を設定すると、指定した別オリジンの URL もミニアプリブラウザ内で開けるようになります。

注意

allowOrigins には信頼できるオリジンのみを追加してください。 不要なオリジンを追加すると、意図しないページがミニアプリブラウザ内で表示される可能性があります。

マッチ条件

allowOrigins は、オリジン(scheme + host + port)の完全一致で判定されます。

例:

  • allowOriginshttps://example.com が含まれる場合:
    • https://example.com/ok/ は OK
    • https://ng.example.com は NG