Overview
SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.
본 가이드는 Secret Vault에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.
Version
| Version | Status | Supported Until |
|---|---|---|
| 1.0 | CURRENT | - |
이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.
Secret Vault
- 1: CLIs
- 1.1: Create Secret Vault
- 1.1.1: 1.0
- 1.2: Delete Secret Vault
- 1.2.1: 1.0
- 1.3: List Secret Vaults
- 1.3.1: 1.0
- 1.4: Show Secret Vault
- 1.4.1: 1.0
1 - CLIs
1.1 - Create Secret Vault
1.1.1 - 1.0
scpcli secretvault sv create
--vault_token_ttl_ndays <value>
--temporary_key_ttl_nhours <value>
--name <value>
--acl_cidr <value>
--access_key_id <value>
[--description <value>]
[--tags <value>]
Description
시크릿볼트 생성.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| vault_token_ttl_ndays required | integer | 볼트 토큰 유효시간 | 720 |
| temporary_key_ttl_nhours required | integer | 임시키 유효 시간 | 3 |
| name required | string | 시크릿볼트 아이디 | name |
| acl_cidr required | string | 접근제한을 위한 CIDR | 192.168.1.1/24, 10.0.0.1/16 |
| access_key_id required | string | Access key ID | b754b12b39da4ce29a40c5e324650bd0 |
| description optional | string | Description | description |
| tags optional | array | Tag List' | '{"key": "", "value": ""}' |
Responses
| Name | Description | Example |
|---|---|---|
| id | ID | 0fdd87aab8cb46f59b7c1f81ed03fb3e |
| access_key_id | Access key ID | 0e3dffc50eb247a1adf4f2e5c82c4f99 |
| access_key_type | access key 유형 | Temporary |
| account_id | 계정 id | 3265ab469f0d406d83073da3e11e7a6c |
| acl_cidr | 접근제한을 위한 CIDR | 192.168.1.1/24, 10.0.0.1/16 |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| delete_at | Date of deletion | 2025-02-25 03:07:17.000 |
| description | Description | description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 키 이름 | vaultkey |
| temporary_key_ttl_nhours | 임시키 유효 시간 | 36 |
| user_name | 사용자명 | username |
| vault_token_expired_at | 볼트 토큰 만료일 | 2025-02-25 03:07:17.000 |
| vault_token_id | 볼트토큰 아이디 | aace85da-965e-d95a-b4ed-8d32b5d6079 |
| vault_token_secret_value | 볼트토큰 시크릿 | 6171392c-5fd9-43db-9e15-e14af0068f96 |
| vault_token_ttl_ndays | 볼트 토큰 유효시간 | 10 |
| vaultkey_state | 키 상태(Creating, Active, Error, Stop, To_Be_Terminated) | Active |
| vaultkey_type | 볼트키 타입 | SCP Open API Key |
| waiting_time_ndays | 삭제까지 남은 일수 | 10 |
1.2 - Delete Secret Vault
1.2.1 - 1.0
scpcli secretvault sv delete
--secret_vault_id <value>
--waiting_time_ndays <value>
Description
시크릿볼트 상태는 To be terminated 가 아닙니다.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| secret_vault_id required | string | 시크릿볼트 아이디 | 3265ab469f0d406d83073da3e11e7a6c |
| waiting_time_ndays required | integer | 삭제까지 남은 일수 | 7 |
1.3 - List Secret Vaults
1.3.1 - 1.0
scpcli secretvault sv list
Description
시크릿볼트 리스트 조회
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Responses
| Name | Description | Example |
|---|---|---|
| id | ID | 0fdd87aab8cb46f59b7c1f81ed03fb3e |
| access_key_id | Access key ID | 0e3dffc50eb247a1adf4f2e5c82c4f99 |
| access_key_type | access key 유형 | Temporary |
| account_id | 계정 id | 3265ab469f0d406d83073da3e11e7a6c |
| acl_cidr | 접근제한을 위한 CIDR | 192.168.1.1/24, 10.0.0.1/16 |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| delete_at | Date of deletion | 2025-02-25 03:07:17.000 |
| description | Description | description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 키 이름 | vaultkey |
| temporary_key_ttl_nhours | 임시키 유효 시간 | 36 |
| user_name | 사용자명 | username |
| vault_token_expired_at | 볼트 토큰 만료일 | 2025-02-25 03:07:17.000 |
| vault_token_id | 볼트토큰 아이디 | [AES] SZtB6RasvLypCv4soJlQO3ZmYpUPjFblz7pstjBeTQJXcz/d5KB9TUR3gMY08mga4fxWaF6IfUzTMBh6j/CAaw== |
| vault_token_secret_value | 볼트토큰 시크릿 | [AES] 91/kdnK4NDfs2HGWgNH/EYNnqD7OcM1unXWs0ZAuaFttIqgP8xMUx0dOaRfD6kOD7uuujFxF2nzx35D9Gz9nwQ== |
| vault_token_ttl_ndays | 볼트 토큰 유효시간 | 10 |
| vaultkey_state | 키 상태(Creating, Active, Error, Stop, To_Be_Terminated) | Active |
| vaultkey_type | 볼트키 타입 | SCP Open API Key |
| waiting_time_ndays | 삭제까지 남은 일수 | 10 |
1.4 - Show Secret Vault
1.4.1 - 1.0
scpcli secretvault sv show
--secret_vault_id <value>
Description
시크릿볼트 조회.
상태 ACTIVE (CURRENT)
| 버전 | 최소 지원 보장일 |
|---|---|
| 1.0 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| secret_vault_id required | string | 시크릿볼트 아이디 | 3265ab469f0d406d83073da3e11e7a6c |
Responses
| Name | Description | Example |
|---|---|---|
| id | ID | 0fdd87aab8cb46f59b7c1f81ed03fb3e |
| access_key | 삼성 클라우드 플랫폼 포털에서 발급받은 Access Key | [‘0e3*****************************’] |
| access_key_id | Access key ID | 0e3dffc50eb247a1adf4f2e5c82c4f99 |
| access_key_type | access key 유형 | [‘Temporary’, ‘Permanent’] |
| account_id | 계정 id | 3265ab469f0d406d83073da3e11e7a6c |
| acl_cidr | 접근제한을 위한 CIDR | 192.168.1.1/24, 10.0.0.1/16 |
| created_at | 생성 시간 | 2024-05-17T00:23:17Z |
| created_by | 생성자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| delete_at | Date of deletion | 2025-02-25 03:07:17.000 |
| description | 키 설명 | description |
| modified_at | 수정 시간 | 2024-05-17T00:23:17Z |
| modified_by | 수정자 | 90dddfc2b1e04edba54ba2b41539a9ac |
| name | 키 이름 | [‘vaultkey’] |
| temp_key_expired_at | 임시키 만료일 | 2025-02-25 03:07:17.000 |
| temporary_key_ttl_nhours | 임시키 유효 시간 | [‘36’] |
| vault_token_expired_at | 볼트 토큰 만료일 | 2025-02-25 03:07:17.000 |
| vault_token_id | 볼트토큰 아이디 | aace85da-965e-d95a-b4ed-8d32b5d6079 |
| vault_token_secret_value | 볼트토큰 시크릿 | 6171392c-5fd9-43db-9e15-e14af0068f96 |
| vault_token_ttl_ndays | 볼트 토큰 유효시간 | [‘10’] |
| vaultkey_state | 키 상태(Creating, Active, Error, Stop, To_Be_Terminated) | Active |
| vaultkey_type | 볼트키 타입 | [‘SCP Open API Key’] |
| waiting_time_ndays | 삭제까지 남은 일수 | 10 |