이 섹션의 다중 페이지 출력 화면임. 여기를 클릭하여 프린트.

Key Management Service

1: CLIs

1.1: Change Rotate Info

1.1.1: 1.1
1.1.2: 1.0

1.2: Change State Of Key

1.2.1: 1.1
1.2.2: 1.0

1.3: Check Duplicate Name

1.3.1: 1.1
1.3.2: 1.0

1.4: Create Datakey

1.4.1: 1.1
1.4.2: 1.0

1.5: Create Key

1.5.1: 1.1
1.5.2: 1.0

1.6: Decrypt Data

1.6.1: 1.1
1.6.2: 1.0

1.7: Delete Key

1.7.1: 1.1
1.7.2: 1.0

1.8: Encrypt Data

1.8.1: 1.1
1.8.2: 1.0

1.9: List Keys

1.9.1: 1.1
1.9.2: 1.0

1.10: List Users

1.10.1: 1.1
1.10.2: 1.0

1.11: Make hmac

1.11.1: 1.1
1.11.2: 1.0

1.12: Rewrap Data

1.12.1: 1.1
1.12.2: 1.0

1.13: Rotate Key

1.13.1: 1.1
1.13.2: 1.0

1.14: Show Key

1.14.1: 1.1
1.14.2: 1.0

1.15: Sign Data

1.15.1: 1.1
1.15.2: 1.0

1.16: Update Description

1.16.1: 1.1
1.16.2: 1.0

1.17: Verify Data

1.17.1: 1.1
1.17.2: 1.0

1.18: Verify hmac with input

1.18.1: 1.1
1.18.2: 1.0

Overview

SCP에서 제공하는 IaaS/PaaS 상품을 프로그램적으로 이용할 수 있도록 지원하는 명령 줄 인터페이스(Command-line interface, CLI)를 제공합니다.

본 가이드는 Key Management Service(KMS)에 대한 간략한 설명 및 CLI를 호출하는 방법을 제공합니다.

Version

Version	Status	Supported Until
1.0	DEPRECATED	20251231
1.1	CURRENT	-

1 - CLIs

1.1 - Change Rotate Info

1.1.1 - 1.1

scpcli kms kms change rotate info
--key_id <value>
--rotate_cycle <value>
--auto_rotate <value>

Description

키 회전정보를 변경한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
rotate_cycle required	integer	회전 주기	`7`
auto_rotate required	string	자동회전 Y 또는 N	`Y`

1.1.2 - 1.0

scpcli kms kms change rotate info
--key_id <value>
--rotate_cycle <value>
--auto_rotate <value>

Description

키 회전정보를 변경한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
rotate_cycle required	integer	회전 주기	`7`
auto_rotate required	string	자동회전 Y 또는 N	`Y`

1.2 - Change State Of Key

1.2.1 - 1.1

scpcli kms kms change state
--key_id <value>
--state <value>

Description

키 상태를 변경한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
state required	string	State of key(Active, Stop)	`Active`

1.2.2 - 1.0

scpcli kms kms change state
--key_id <value>
--state <value>

Description

키 상태를 변경한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
state required	string	State of key(Active, Stop)	`Active`

1.3 - Check Duplicate Name

1.3.1 - 1.1

scpcli kms kms check duplicate name
--name <value>

Description

키 이름 중복을 체크한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
name required	string	키 이름	`testkey`

Responses

Name	Description	Example
isDuplicateName		True

1.3.2 - 1.0

scpcli kms kms check duplicate name
--name <value>

Description

키 이름 중복을 체크한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
name required	string	키 이름	`testkey`

Responses

Name	Description	Example
isDuplicateName		True

1.4 - Create Datakey

1.4.1 - 1.1

scpcli kms kms datakey
--key_id <value>
--key_type <value>

Description

새 데이터키를 생성하고, 키(용도:암호화/복호화)로 암호화된 값을 생성합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
key_type required	string	Key type( plaintext or wrapped )	`plaintext`

Responses

Name	Description	Example
ciphertext	암호화된 데이터 키	vault:v283:YiUpW1bpF2fMY0VR33aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK
key_version	KMS 키 버전	1
plaintext	데이터키 (base64로 인코딩된)	oTvvEkE7q0WM2S5yfGFz5nqe32QMlrCVnqssmDPu6fA=

1.4.2 - 1.0

scpcli kms kms datakey
--key_id <value>
--key_type <value>

Description

새 데이터키를 생성하고, 키(용도:암호화/복호화)로 암호화된 값을 생성합니다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
key_type required	string	Key type( plaintext or wrapped )	`plaintext`

Responses

Name	Description	Example
ciphertext	암호화된 데이터 키	vault:v283:YiUpW1bpF2fMY0VR33aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK
key_version	KMS 키 버전	1
plaintext	데이터키 (base64로 인코딩된)	oTvvEkE7q0WM2S5yfGFz5nqe32QMlrCVnqssmDPu6fA=

1.5 - Create Key

1.5.1 - 1.1

scpcli kms kms create
--rotate_cycle <value>
--purpose <value>
--name <value>
--description <value>
--auto_rotate <value>
[--key_type <value>]
[--tags <value>]

Description

키를 생성한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
rotate_cycle required	integer	회전 주기	`7`
purpose required	string	키 용도	`rsa-2048`
name required	string	키 이름	`testkey`
description required	string	키 설명	`description1`
auto_rotate required	string	자동회전 Y 또는 N	`Y`
key_type optional	string	기본 또는 고급	`advanced`
tags optional	array	Tag List'	`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.5.2 - 1.0

scpcli kms kms create
--rotate_cycle <value>
--purpose <value>
--name <value>
--description <value>
--auto_rotate <value>
[--key_type <value>]
[--tags <value>]

Description

키를 생성한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
rotate_cycle required	integer	회전 주기	`7`
purpose required	string	키 용도	`rsa-2048`
name required	string	키 이름	`testkey`
description required	string	키 설명	`description1`
auto_rotate required	string	자동회전 Y 또는 N	`Y`
key_type optional	string	기본 또는 고급	`advanced`
tags optional	array	Tag List'	`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.6 - Decrypt Data

1.6.1 - 1.1

scpcli kms kms decrypt
--key_id <value>
--ciphertext <value>

Description

키(용도:암호화/복호화)를 사용하여 제공된 암호문을 해독합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
ciphertext required	string	KMS에 의해 암호화된 데이터	`vault:v283:YiUpW1bpF2fMY0VR332Qpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK`

Responses

Name	Description	Example
plaintext	데이터키 (base64로 인코딩된 )	dGhlIHF1aWNrIGJyb3duIGZveAo=

1.6.2 - 1.0

scpcli kms kms decrypt
--key_id <value>
--ciphertext <value>

Description

키(용도:암호화/복호화)를 사용하여 제공된 암호문을 해독합니다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
ciphertext required	string	KMS에 의해 암호화된 데이터	`vault:v283:YiUpW1bpF2fMY0VR332Qpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK`

Responses

Name	Description	Example
plaintext	데이터키 (base64로 인코딩된 )	dGhlIHF1aWNrIGJyb3duIGZveAo=

1.7 - Delete Key

1.7.1 - 1.1

scpcli kms kms delete
--key_id <value>
[--is_directly <value>]

Description

키를 지금 또는 나중에 삭제한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
is_directly optional	boolean	즉시삭제 여부	`True`

1.7.2 - 1.0

scpcli kms kms delete
--key_id <value>
[--is_directly <value>]

Description

키를 지금 또는 나중에 삭제한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
is_directly optional	boolean	즉시삭제 여부	`True`

1.8 - Encrypt Data

1.8.1 - 1.1

scpcli kms kms encrypt
--key_id <value>
--plaintext <value>

Description

제공된 일반 텍스트(base64 인코딩)를 키(용도:암호화/복호화)를 사용하여 암호화합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
plaintext required	string	Data(base64 encoded) to encrypt	`dGhlIHF1aWNrIGJyb3duIGZveAo=`

Responses

Name	Description	Example
ciphertext	KMS에 의해 암호화된 데이터	vault:v283:YiUpW1bpF2fMY0VRh3aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK
key_version	KMS 키 버전	1

1.8.2 - 1.0

scpcli kms kms encrypt
--key_id <value>
--plaintext <value>

Description

제공된 일반 텍스트(base64 인코딩)를 키(용도:암호화/복호화)를 사용하여 암호화합니다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
plaintext required	string	Data(base64 encoded) to encrypt	`dGhlIHF1aWNrIGJyb3duIGZveAo=`

Responses

Name	Description	Example
ciphertext	KMS에 의해 암호화된 데이터	vault:v283:YiUpW1bpF2fMY0VRh3aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK
key_version	KMS 키 버전	1

1.9 - List Keys

1.9.1 - 1.1

scpcli kms kms list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]

Description

키 리스트 조회하기

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	키 이름	`testkey`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.9.2 - 1.0

scpcli kms kms list
[--size <value>]
[--page <value>]
[--sort <value>]
[--name <value>]

Description

키 리스트 조회하기

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
name optional	string	키 이름	`testkey`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.10 - List Users

1.10.1 - 1.1

scpcli kms kms list users
--key_id <value>

Description

키를 사용한 사람 목록을 보여준다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`

Responses

Name	Description	Example
user_id	사용자 id	138c2fc8c29a449dbfa8681f8f1d78e2
user_name	사용자 이름	kimsamsung

1.10.2 - 1.0

scpcli kms kms list users
--key_id <value>

Description

키를 사용한 사람 목록을 보여준다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`

Responses

Name	Description	Example
user_id	사용자 id	138c2fc8c29a449dbfa8681f8f1d78e2
user_name	사용자 이름	kimsamsung

1.11 - Make hmac

1.11.1 - 1.1

scpcli kms kms generate hmac
--key_id <value>
--input <value>

Description

HMAC 키를 사용해 생성합니다.( 용도: 생성/확인 )

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
input required	string	Data(base64 encoded) for verification	`dGVzdCBpbnB1dA==`

Responses

Name	Description	Example
hmac	HMAC 데이터	vault:v1:/IHSD+Rg9BHNkmIiEunAPVj6IVaJqkjSO4GGvALHcVQ=

1.11.2 - 1.0

scpcli kms kms generate hmac
--key_id <value>
--input <value>

Description

HMAC 키를 사용해 생성합니다.( 용도: 생성/확인 )

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
input required	string	Data(base64 encoded) for verification	`dGVzdCBpbnB1dA==`

Responses

Name	Description	Example
hmac	HMAC 데이터	vault:v1:/IHSD+Rg9BHNkmIiEunAPVj6IVaJqkjSO4GGvALHcVQ=

1.12 - Rewrap Data

1.12.1 - 1.1

scpcli kms kms rewrap
--key_id <value>
--ciphertext <value>

Description

최신 버전의 키(용도:암호화/복호화)를 사용하여 제공된 암호문을 다시 래핑합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
ciphertext required	string	KMS에 의해 암호화된 데이터	`vault:v283:YiUpW1bpF2fMY0VR33aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK`

Responses

Name	Description	Example
ciphertext	KMS에 의해 암호화된 재래핑할 데이터	vault:v283:YiUpW1bpF2fMY0VR33aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK
key_version	KMS 키 버전	1

1.12.2 - 1.0

scpcli kms kms rewrap
--key_id <value>
--ciphertext <value>

Description

최신 버전의 키(용도:암호화/복호화)를 사용하여 제공된 암호문을 다시 래핑합니다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
ciphertext required	string	KMS에 의해 암호화된 데이터	`vault:v283:YiUpW1bpF2fMY0VR33aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK`

Responses

Name	Description	Example
ciphertext	KMS에 의해 암호화된 재래핑할 데이터	vault:v283:YiUpW1bpF2fMY0VR33aQpik781Ul2gFPsfdwsypwouccHtPSfRaE40wTHHl4a5AK
key_version	KMS 키 버전	1

1.13 - Rotate Key

1.13.1 - 1.1

scpcli kms kms rotate
--key_id <value>

Description

키를 회전한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.13.2 - 1.0

scpcli kms kms rotate
--key_id <value>

Description

키를 회전한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.14 - Show Key

1.14.1 - 1.1

scpcli kms kms show
--key_id <value>

Description

키 정보를 보여준다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.14.2 - 1.0

scpcli kms kms show
--key_id <value>

Description

키 정보를 보여준다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	계정 id	3265ab469f0d406d83073da3e11e7a6c
auto_rotate	자동회전 Y 또는 N	Y
created_at	생성 시간	2024-05-17T00:23:17Z
created_by	생성자	90dddfc2b1e04edba54ba2b41539a9ac
current_version	KMS키 현재 버전	7
delete_at	Date of deletion	20251008
delete_target_yn	키 삭제예정 여부	Y
description	키 설명	description1
key_type	기본 또는 고급	advanced
modified_at	수정 시간	2024-05-17T00:23:17Z
modified_by	수정자	90dddfc2b1e04edba54ba2b41539a9ac
name	키 이름	testkey
next_rotate_at	다음 회전일	20241008
order_ref	오더 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
purpose	키 용도	rsa-2048
region	리즌 이름	kr-west1
rotate_cycle	회전 주기	7
secret_ref	시크릿 참조	0e1bfdf8-a7da-43d3-8e8c-c9f34024ba01
state	키 상태(Creating, Active, Error, Stop, To_Be_Terminated)	Active
use_count	KMS키 사용횟수	1004

1.15 - Sign Data

1.15.1 - 1.1

scpcli kms kms sign
--key_id <value>
--input <value>

Description

키(용도:서명/검증)를 사용하여 주어진 데이터의 암호화 서명을 반환합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
input required	string	Data(base64 encoded) for Signature	`dGVzdCBpbnB1dA==`

Responses

Name	Description	Example
key_version	KMS 키 버전	1
signature	확인을 위한 시그니쳐	vault:v142:MEUCIQDt+iM27ZENLTxFCKH2krlvn2xRRuoqt8aU+xP/RYEJpgIgN6V6QjhpK4dA/vwgX95UW140ge167ECnLjccXDPbZAg=

1.15.2 - 1.0

scpcli kms kms sign
--key_id <value>
--input <value>

Description

키(용도:서명/검증)를 사용하여 주어진 데이터의 암호화 서명을 반환합니다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
input required	string	Data(base64 encoded) for Signature	`dGVzdCBpbnB1dA==`

Responses

Name	Description	Example
key_version	KMS 키 버전	1
signature	확인을 위한 시그니쳐	vault:v142:MEUCIQDt+iM27ZENLTxFCKH2krlvn2xRRuoqt8aU+xP/RYEJpgIgN6V6QjhpK4dA/vwgX95UW140ge167ECnLjccXDPbZAg=

1.16 - Update Description

1.16.1 - 1.1

scpcli kms kms update description
--key_id <value>
--description <value>

Description

설명을 업데이트한다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
description required	string	키 설명	-

1.16.2 - 1.0

scpcli kms kms update description
--key_id <value>
--description <value>

Description

설명을 업데이트한다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
description required	string	키 설명	-

1.17 - Verify Data

1.17.1 - 1.1

scpcli kms kms verify
--key_id <value>
--signature <value>
--input <value>

Description

제공된 서명이 서명 데이터 중 하나에서 지정된 데이터에 대해 유효한지 여부를 키(용도:서명/검증)를 사용해 반환합니다.

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
signature required	string	확인을 위한 시그니쳐	`vault:v142:MEUCIQDt+iM27ZENLTxFCKH2krlvn2xRRuoqt8aU+xP/RYEJpgIgN6V6QjhpK4dA/vwgX95UW140ge167ECnLjccXDPbZAg=`
input required	string	Data(base64 encoded) for verification	`dGVzdCBpbnB1dA==`

Responses

Name	Description	Example
valid	확인결과	True

1.17.2 - 1.0

scpcli kms kms verify
--key_id <value>
--signature <value>
--input <value>

Description

제공된 서명이 서명 데이터 중 하나에서 지정된 데이터에 대해 유효한지 여부를 키(용도:서명/검증)를 사용해 반환합니다.

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
signature required	string	확인을 위한 시그니쳐	`vault:v142:MEUCIQDt+iM27ZENLTxFCKH2krlvn2xRRuoqt8aU+xP/RYEJpgIgN6V6QjhpK4dA/vwgX95UW140ge167ECnLjccXDPbZAg=`
input required	string	Data(base64 encoded) for verification	`dGVzdCBpbnB1dA==`

Responses

Name	Description	Example
valid	확인결과	True

1.18 - Verify hmac with input

1.18.1 - 1.1

scpcli kms kms verify hmac
--key_id <value>
--input <value>
--hmac <value>

Description

INPUT이 유효한지 아닌지 키를 사용해 확인합니다(용도: 생성/확인)

상태 ACTIVE (CURRENT)

버전	최소 지원 보장일
1.1	-

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
input required	string	Data(base64 encoded) for verification	`dGVzdCBpbnB1dA==`
hmac required	string	확인을 위한 시그니쳐	`vault:v142:MEUCIQDt+iM27ZENLTxFCKH2krlvn2xRRuoqt8aU+xP/RYEJpgIgN6V6QjhpK4dA/vwgX95UW140ge167ECnLjccXDPbZAg=`

Responses

Name	Description	Example
valid	확인결과	True

1.18.2 - 1.0

scpcli kms kms verify hmac
--key_id <value>
--input <value>
--hmac <value>

Description

INPUT이 유효한지 아닌지 키를 사용해 확인합니다(용도: 생성/확인)

상태 ACTIVE (DEPRECATED)

버전	최소 지원 보장일
1.0	20251231

Parameters

Name	Type	Description	Example
key_id required	string	KMS 키 자원 아이디	`138c2fc8c29a449dbfa8681f8f1d78e2`
input required	string	Data(base64 encoded) for verification	`dGVzdCBpbnB1dA==`
hmac required	string	확인을 위한 시그니쳐	`vault:v142:MEUCIQDt+iM27ZENLTxFCKH2krlvn2xRRuoqt8aU+xP/RYEJpgIgN6V6QjhpK4dA/vwgX95UW140ge167ECnLjccXDPbZAg=`

Responses

Name	Description	Example
valid	확인결과	True