API情報#
API一覧#
認証
項番 | API名 | メソッド | URL | 説明 |
---|---|---|---|---|
1 | アクセストークン取得 | POST | https://auth-api.jp-east-1.paas.cloud.global.fujitsu.com/API/paas/auth/token | API認証用のトークンの取得を行う。 |
利用者管理
項番 | API名 | メソッド | URL | 説明 |
---|---|---|---|---|
1 | ユーザー追加 | POST | https://k5-apiportal.paas.cloud.global.fujitsu.com/API/v1/api/users | 利用者の新規登録を行う。 |
2 | ユーザー変更 | PUT | https://k5-apiportal.paas.cloud.global.fujitsu.com/API/v1/api/users | 契約者および利用者の情報の更新を行う。 |
3 | ユーザーパスワード変更 | PUT | https://k5-apiportal.paas.cloud.global.fujitsu.com/API/v1/api/userspassword | 契約者および利用者のパスワード変更を行う。 |
4 | ユーザー削除 | DELETE | https://k5-apiportal.paas.cloud.global.fujitsu.com/API/v1/api/users/?login_id={ユーザー名} | 利用者の削除を行う。 |
5 | ユーザー認証方式情報更新 | PUT | https://k5-apiportal.paas.cloud.global.fujitsu.com/API/v1/api/usersauthenticationmethod | 契約者および利用者の認証方式を変更する。 |
各APIの文字コードは「UTF-8」です。
ロール別操作権限について#
FJcloudポータルの各ユーザーには、「ロール」と呼ばれる権限情報が設定され、FJcloudポータルでの操作が制御されます。(詳しくは「FJcloudポータルユーザーズガイド」をご参照ください。)
APIの利用においても、ロールごとに下表に示すとおり権限が設定されています。
API呼び元のロール | 契約者 | 管理者 | 開発者 | |||||
---|---|---|---|---|---|---|---|---|
API操作対象のロール | 自分自身 | 利用者 | 自分自身 | 契約者 | 利用者 | 自分自身 | 契約者 | 利用者 |
ユーザー追加API | × | ○ | × | × | ○ | × | × | × |
ユーザー変更API | △ | ○ | ○ | △ | ○ | ○ | × | × |
ユーザーパスワード変更API | ○ | × | ○ | × | × | ○ | × | × |
ユーザー削除API | × | ○ | × | × | ○ | × | × | × |
ユーザー認証方式情報更新API | ○ | × | ○ | × | × | ○ | × | × |
※利用者:管理者および開発者の両方
○:可能 ×:不可 △:制限付きで可能 (下記[ユーザー変更]の説明を参照)
API名ごとに、実行が許可されているロールを以下に説明します。
[ユーザー追加]
- 契約者、管理者は契約者以外のロールを持つユーザーを追加可能。
[ユーザー変更]
- 管理者、開発者は自分自身の情報(パスワード含む)を変更することが可能。
- 管理者が契約者に対して変更できる情報はパスワードのみ。
- 契約者は自分自身の情報(ユーザー状態以外)を変更することが可能。
- 契約者、管理者による利用者(管理者/開発者)の情報更新は可能
[ユーザーパスワード変更]
- ユーザーはロールに関係なく、自分自身のパスワードのみ変更可能。
[ユーザー削除]
- 契約者、管理者は契約者以外のロールを持つユーザーを削除可能。
[ユーザー認証方式情報更新]
- 自分自身の認証方式のみ更新可能
用語集#
用語 | 説明 |
---|---|
ユーザー | 機能を利用する人、管理する人。(またはシステム、サービス) |
ユーザー名 | ユーザーを一意的に識別するための名称。 |
ロール | 人やグループに権限を割り当てるための情報。ロールを用いて、ユーザーが使用できるAPIを区別する。 |
ロールコード | ロールを一意的に識別するためのID。 |
トークン | 認証した証として発行される期限付きの認証情報。 |