API를 사용하여 속성 값으로 자격증명 구성

Automation Anywhere Automation 360

콘텐츠 닫기

콘텐츠

콘텐츠 열기

PDF 다운로드

API를 사용하여 속성 값으로 자격증명 구성

표준 속성으로 자격증명을 생성하고 사용자 입력 값을 사용하여 두 개의 추가 속성을 추가합니다.

전제 조건

주: Community Edition에서 Control Room APIs을 볼 수 있지만, API 기능은 제한됩니다. API의 전체 기능에 액세스하려면 라이선스가 인가된 Automation 360 에디션이 필요합니다.

인증 API를 이용하여 JSON 웹 토큰을 생성합니다. 인증 API를 참고하십시오.
모든 역할은 자격 증명 및 속성을 구성하는 데 필요한 내 자격증명 및 로커 관리를 가지고 있습니다. 이 엔드포인트를 사용하는 데 추가 권한은 필요하지 않습니다.

이 예시에서는 이메일 호스트 이름, 사용자 이름, 비밀번호를 유지하기 위해 3개의 속성으로 자격증명을 구성합니다.

프로시저

요청 헤더에 인증 토큰을 추가합니다.
자격증명을 생성합니다. POST 메소드 및 엔드포인트 URL 이용: <your_control_room_url>/v2/credentialvault/credentials.
요청 본문: 이 예시 요청에는 다음과 같은 필수 매개변수가 포함되어 있습니다.
- userProvided: 속성에 사용자 입력이 필요한지(true) 아니면 모든 사용자에 대한 표준인지(false)를 구성하는 부울 값입니다.
- masked: 속성값이 별표로 마스킹되는지(true) 아니면 사용자가 볼 수 있는지(false)를 구성하는 부울 값입니다.
```
{
  "name": "Email",
  "attributes": [
  	{
      "name": "hostname",
      "userProvided": false,
      "masked": false
    } 	
  ]
}
```

요청 전송.

응답 본문: 요청이 성공적인 경우 이 엔드포인트는 다음 데이터를 반환합니다.

id: 자격증명에 대한 고유한 숫자 식별자입니다.
attributes:id: 속성에 대한 고유한 숫자 식별자입니다.

{
    "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"
}

REST API는 HTTP 응답 코드를 이용하여 각 요청에 응답합니다. 응답 코드는 API 응답 코드를 참고하십시오.

이 자격증명에 대한 hostname 속성에 표준 값을 할당합니다. 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"
    }
  ]
}

이메일 자격증명에 사용자 이름 및 비밀번호 속성을 추가합니다. 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
    }	
  ]
}
```

요청 전송.

응답 본문: 응답 본문은 세 가지 속성의 세부 정보와 함께 자격증명을 반환합니다.

{
    "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"
}

다음 단계

단계를 따라 Credential Vault를 구성하고 있다면 다음 작업(locker에 자격증명 지정 API)을 수행하십시오.

피드백을 보내주십시오