クライアント・アプリケーションでの OAuth 2.0 ベース認証の使用

OAuth 2.0 /token エンドポイントを使用して、クライアント資格情報 (クライアント ID とクライアント秘密鍵) およびサービス資格情報 (ユーザー名とパスワード) を含むアクセス・トークンを取得します。 例:

curl -k -v -X POST -H 'content-type: application/x-www-form-urlencoded' 
-d grant_type=password -d client_id=<clientId> -d client_secret=<clientSecret>
-d username=<serviceCredId> -d password=<svcCredSecret>
https://www.bpm.ibmcloud.com/mga/sps/oauth/oauth20/token

この呼び出しは、後続のクラウド操作 API 呼び出しで使用されるアクセス・トークン、アクセス・トークンをリフレッシュするためのリフレッシュ・トークン、およびアクセス・トークンの有効期間を返します。 アクセス・トークンは通常、分単位または時間単位で有効であるのに対し、リフレッシュ・トークンは日単位で有効であることに注意してください。 スコーピングはサポートされません。

{"access_token":"CJ7yDymDAfSRz03W7zdX","refresh_token":"fGAv2qzuLnM030Brs8KFaIuY1Kd2P87sLFXI85lH","scope":"","token_type":"bearer","expires_in":1799}*

呼び出しが成功すると、HTTP 応答コード 201 が返されます。 クライアントまたはサービス資格情報が無効な場合、呼び出しは HTTP 応答コード BAD_REQUEST (400)を返します。

前のステップで返されたアクセス・トークンを、クラウド操作 API 呼び出しの許可ヘッダーに組み込みます。 例:

curl -k -v -H "Authorization: Bearer CJ7yDymDAfSRz03W7zdX" https://<tenantHost>/baw/dev/rest/bpm/wle/v1/user/current

アクセス・トークンが無効であるか有効期限が切れている場合、呼び出しは HTTP 応答コード 302 を返します。

OAuth 2.0 /token エンドポイントを使用します。

curl -k -v -X POST -H 'content-type: application/x-www-form-urlencoded' 
-d grant_type=refresh_token -d refresh_token=fGU3UjAHG0XKTdnInU8ihqTLf48XJIzQtRUjNFVo
-d client_id=<clientId> -d client_secret=<clientSecret>
https://www.bpm.ibmcloud.com/mga/sps/oauth/oauth20/token

呼び出しは、新しいトークン・セットを返します。

{"access_token":"DkhN7gg7mk2gsBjGi8ay","refresh_token":"ToY13V2yfoYaeVbBjTwFLhzwX7GiKd7Y801VfjGC","scope":"","token_type":"bearer","expires_in":1799}

リフレッシュ・トークンが無効であるか既に使用されている場合、またはクライアント資格情報が削除されたなどの理由で無効である場合、この呼び出しは HTTP BAD_REQUEST (400) 応答コードを返します。

例えば、次の呼び出しを使用してリフレッシュ・トークンを取り消します。

curl -k -v -X POST -H 'content-type: application/x-www-form-urlencoded' 
-d client_id=<clientId> -d client_secret=<clientSecret>
-d token=ToY13V2yfoYaeVbBjTwFLhzwX7GiKd7Y801VfjGC
https://www.bpm.ibmcloud.com/mga/sps/oauth/oauth20/revoke

呼び出しは、常に正常な HTTP 応答コード (200 など) を返します。