API を使用して属性値を持つ資格情報を構成する
標準属性を持つ資格情報を作成し、ユーザー入力値を持つ 2 つの属性を追加します。
前提条件
注: Community Edition で Control Room APIs を表示できますが、API 機能は制限されています。API のすべての機能にアクセスするには、Automation 360 のライセンス版が必要です。
- 認証 API を使用して JSON Web トークンを生成します。認証 API をご覧ください。
- すべてのロールには、資格情報と属性の設定に必要な [資格情報と
ロッカーの管理] 権限があります。このエンドポイントの使用には、追加の権限は必要ありません。
手順
- リクエスト ヘッダーに認証トークンを追加します。
-
認証情報を作成します。POST メソッドとエンドポイント URL:
<your_control_room_url>/v2/credentialvault/credentials
。リクエスト本文: このリクエストの例には、次の必須パラメーターが含まれています。masked
:属性値をアスタリスク(true)でマスクするか、ユーザーに表示するか(false)を設定するブール値。
{ "name": "Email", "attributes": [ { "name": "hostname", "userProvided": false, "masked": false } ] }
-
リクエストを送信します。
レスポンス本文: 正常にリクエストされた場合、このエンドポイントは次のデータを返します。
attributes:id
:属性の一意の数値識別子。
REST API は、HTTP レスポンス コードで各リクエストに応答します。 レスポンス コードについては、API レスポンス コード を参照してください。{ "id": "1630", "name": "Email", "description": "", "ownerId": "1508", "attributes": [ { "id": "3335", "name": "hostname", "description": "", "userProvided": false, "masked": false, "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366448Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:04:41.366450Z", "version": "0", "passwordFlag": false } ], "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366460Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:04:41.366464Z", "version": "0" }
-
ホスト名属性に標準値を認証情報に割り当てます。POST メソッドとエンドポイント URL:
<your_control_room_url>/v2/credentialvault/credentials/{credentialId}//attributevalues
{ "list": [ { "credentialAttributeId": "3335", "value": "mail.example.com" } ] }
-
リクエストを送信します。
レスポンス本文:
{ "list": [ { "id": "1630", "credentialAttributeId": "3335", "value": "mail.example.com", "userId": "1508", "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366460Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:04:41.366464Z", "version": "0" } ] }
-
ユーザー名とパスワード
の
属性をE メール
認証情報に追加します。PUT メソッドとエンドポイント URL:<your_control_room_url>/v2/credentialvault/credentials
/{credentialId}リクエスト本文: リクエスト URL で資格情報 ID を指定しているため、リクエスト本文に資格情報 ID または名前を含める必要はありません。この例では、リクエスト本文のユーザー名とパスワードの
属性は、各ユーザーから異なる入力を受け入れる値で構成されます。また、パスワード属性は、入力された値をアスタリスクでマスクするように構成されています。
{ "attributes": [ { "name": "username", "userProvided": true, "masked": false }, { "name": "password", "userProvided": true, "masked": true } ] }
-
リクエストを送信します。
レスポンス本文: レスポンス本文は、3 つの属性の詳細を含む資格情報を返します。
{ "id": "1630", "name": "Email", "description": "", "ownerId": "1508", "attributes": [ { "id": "3335", "name": "hostname", "description": "", "userProvided": false, "masked": false, "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366448Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:04:41.366450Z", "version": "0", "passwordFlag": false }, { "id": "3336", "name": "username", "description": "", "userProvided": true, "masked": false, "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366450Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:04:41.366450Z", "version": "0", "passwordFlag": false }, { "id": "3337", "name": "password", "description": "", "userProvided": true, "masked": true, "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366450Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:04:41.366450Z", "version": "0", "passwordFlag": false } ], "createdBy": "1508", "createdOn": "2020-12-28T22:04:41.366460Z", "updatedBy": "1508", "updatedOn": "2020-12-28T22:06:35.366464Z", "version": "2" }