リソース要求

サービスからリソースを要求する設定方法を説明します。現在の Platform では、Link v1 向けのリソース要求も Link v2 のサービス詳細画面にある「リソース要求」タブで管理します。

サービスからリソース要求を行う

PocketSign Platform の Link v2 画面で対象サービスを開き、「リソース要求」タブをクリックします。この画面では、サービスがデフォルトで要求するリソースと、OIDC の authorization_details で要求できるリソースを確認できます。

リソース要求一覧画面

デフォルト要求リソースは、サービスが認可時に既定で要求するリソース権限です。新たに追加する場合は、「追加する」をクリックし、リソースと権限を選択して「保存する」をクリックします。

デフォルト要求リソース追加モーダル。氏名の読み取り権限を設定している

権限の設定では、読み取り、書き込み、呼び出しのうち、リソース定義側で許可されている権限だけを選択できます。「事前格納を要求」をオンにすると、読み取り対象の値が事前に格納されていることを要求します。

独自に作成したリソース定義だけでなく、PocketSign Platform にデフォルトで用意されているリソース定義も追加できます。例えば、プッシュ通知を送るための権限をデフォルト要求リソースに追加できます。

「要求可能リソース一覧」には、このサービスが authorization_details で要求できるリソースが表示されます。リソース定義側の要求許可設定で許可されていないリソースや権限は要求できません。

検索欄でリソース名やエイリアスを絞り込み、必要なリソースのエイリアスと付与可能な権限を確認してください。上の画面例では「署名用」で絞り込んでいます。

リソース要求はサービスごとに設定されるため、サービス ID は画面上で明示的に入力しません。

要求するリソース定義の ID です。実装では、必要に応じてリソース定義 ID またはエイリアスを参照します。

要求する権限の内容です。読み取り、書き込み、呼び出しのうち、リソース定義側で許可された権限のみ要求できます。

サービスが要求できる範囲は、リソース定義ごとの要求許可設定で決まります。要求許可設定はリソース定義から管理します。