Services API
Services APIは、CloudGatewayが利用者に対して提示するページと同等の情報を学認参加機関が取得するためのAPIです。APIは、クラウドゲートウェイが利用者に対して提示するページと同等の情報を学認参加機関が取得するためのAPIです。
認証は学認におけるIdPメタデータに記載されている証明書を用いたTLSクライアント証明書認証により行います。証明書の extended Key Usage (eKU) に clientAuth が記載されていなければなりません。
また、mAPが提示する証明書も学認におけるIdPメタデータに記載されているものとなりますので、IdP側で適切に検証してください。また、クラウドゲートウェイが提示する証明書も学認におけるIdPメタデータに記載されているものとなりますので、IdP側で適切に検証してください。
リクエストURL
- 機関所属の利用者が利用可能なサービスを取得
...
利用者ID(ePPN)を指定した場合は、当該利用者の所属機関と所属グループで利用可能なサービスの一覧を応答します。
CloudGatewayのアカウントが作成されていない利用者のIDを指定した場合には、@meを指定した場合と同等の内容を応答します。クラウドゲートウェイのアカウントが作成されていない利用者のIDを指定した場合には、@meを指定した場合と同等の内容を応答します。
レスポンス
コード ブロック | ||
---|---|---|
| ||
[ { "name": "<サービス名称>", "service_url": <サービスURL> "logo": "<ロゴURL>", "introduction": "<紹介文>", "public_tags": [ "<公開タグ>", ... ], "private_tags" : [ "<プライベートタグ>", ... ], "groups": [ { name: "<グループ名称>", url: "<グループURL>" }, ... ] }, ... ] |
...