Services API

Services APIは、学認クラウドゲートウェイサービスが利用者に対して提示するページと同等の情報を学認参加機関が取得するためのAPIです。

認証は学認におけるIdPメタデータに記載されている証明書を用いたTLSクライアント証明書認証により行います。証明書の extended Key Usage (eKU) に clientAuth が記載されていなければなりません。
また、学認クラウドゲートウェイサービスが提示する証明書も学認におけるIdPメタデータに記載されているものとなりますので、IdP側で適切に検証してください。

リクエストURL

機関所属の利用者が利用可能なサービスを取得

https://cg.gakunin.jp/api/services/@me

利用者の所属機関と所属グループで利用可能なサービスを取得

https://cg.gakunin.jp/api/services/利用者ID(ePPN)

機関所属の利用者が利用可能なサービスを取得

@meを指定した場合は、当該機関所属の利用者として利用可能なサービスの一覧を応答します。

利用者の所属機関と所属グループで利用可能なサービスを取得

利用者ID(ePPN)を指定した場合は、当該利用者の所属機関と所属グループで利用可能なサービスの一覧を応答します。

学認クラウドゲートウェイサービスのアカウントが作成されていない利用者のIDを指定した場合には、@meを指定した場合と同等の内容を応答します。

レスポンス

[
    {
        "name": "<サービス名称>",
        "service_url": <サービスURL>
        "logo": "<ロゴURL>",
        "introduction": "<紹介文>",
        "public_tags": [
            "<公開タグ>",
            ...
        ],
        "private_tags" : [
            "<プライベートタグ>",
            ...
        ],
        "groups": [
            {
                name: "<グループ名称>",
                url: "<グループURL>"
            },
            ...
        ]
    },
    ...
]

フィールド名		内容	備考

フィールド名		内容	備考
name		サービスの名称
service_url		サービスのURL	optional
logo		サービスのロゴイメージのURL
introduction		紹介文	optional
public_tags		公開タグの配列	optional
private_tags		プライベートタグの配列	optional
groups		グループ情報の配列	optional
	name	グループの名称
	url	グループに接続されたサービスのURL

備考欄にoptionalと記載のあるフィールドは、値がない場合には含まれません。

エラーレスポンス

HTTPステータス	原因

HTTPステータス	原因
403	クライアント認証に失敗した場合
403	認証したIdPのスコープと指定したePPNのScopeが異なる場合