This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Certificate Manager

1: CLIs

1.1: Check duplicate name

1.1.1: 1.1
1.1.2: 1.0

1.2: Create a certificate

1.2.1: 1.1
1.2.2: 1.0

1.3: Delete a certificate

1.3.1: 1.1
1.3.2: 1.0

1.4: Detail a certificate

1.4.1: 1.1
1.4.2: 1.0

1.5: List certificates

1.5.1: 1.1
1.5.2: 1.0

1.6: Self-sign a certificate

1.6.1: 1.1
1.6.2: 1.0

1.7: Validate a certificate

1.7.1: 1.1
1.7.2: 1.0

Overview

Provides a Command-line Interface (CLI) that supports programmatic use of IaaS/PaaS products provided by SCP.

This guide provides a brief description of Certificate Manager service and how to call CLI. The output is formatted as a JSON string

Version

Version	Status	Supported Until
1.0	SUPPORTED	20260531
1.1	CURRENT	-

1 - CLIs

1.1 - Check duplicate name

1.1.1 - 1.1

scpcli certificatemanager certificate check
--name <value>

Description

Check duplication name

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
name required	string	Certificate Name	-

Responses

Name	Description	Example
result	True, False Check	True

1.1.2 - 1.0

scpcli certificatemanager certificate check
--name <value>

Description

Check duplication name

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
name required	string	Certificate Name	-

Responses

Name	Description	Example
result	True, False Check	True

1.2 - Create a certificate

1.2.1 - 1.1

scpcli certificatemanager certificate create
--timezone <value>
--region <value>
--private_key <value>
--name <value>
--cert_body <value>
[--cert_chain <value>]
[--recipients <value>]
[--tags <value>]

Description

Create a Certificate

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
timezone required	string	Timezone	`Asia/Seoul`
region required	string	Name of region	`west1`
private_key required	string	Private key	`<encoded private key data>`
name required	string	Certificate Name	`test-certificate`
cert_body required	string	Certificate body	`<encoded certificate body data>`
cert_chain optional	string	Certificate chain	`<encoded certificate chain data>`
recipients optional	array	Expired certificates Recipients	`'{"region": "", "user_id": "", "user_name": ""}'`
tags optional	array	Tag List'	`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	Account ID	b82909b3576449fda984fb25c3123542da
cert_body	Certificate body
cert_chain	Certificate chain
cert_kind	Certificate type	PRD
cert_type	Certificate type	pem
cert_version	Certificate Version	2
cn	Certificate Common Name	test.go.kr
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
key_bit_size	key bits size	2048
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
organization	Certificate Organization Name	samsungSDS
private_key	Private key
recipients	Expired certificates Recipients	[{‘region’: ‘’, ‘user_id’: ‘sdaFDQSDADZ2488e195c0e97d9b9eb’, ‘user_name’: ‘kildong.hong’}]
state	Certificate State	VALID
tags	Tag List’
user_name	User Name	kildong@samsung.com

1.2.2 - 1.0

scpcli certificatemanager certificate create
--timezone <value>
--region <value>
--private_key <value>
--name <value>
--cert_body <value>
[--cert_chain <value>]
[--recipients <value>]
[--tags <value>]

Description

Create a Certificate

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
timezone required	string	Timezone	`Asia/Seoul`
region required	string	Name of region	`west1`
private_key required	string	Private key	`<encoded private key data>`
name required	string	Certificate Name	`test-certificate`
cert_body required	string	Certificate body	`<encoded certificate body data>`
cert_chain optional	string	Certificate chain	`<encoded certificate chain data>`
recipients optional	array	Expired certificates Recipients	`'{"region": "", "user_id": "", "user_name": ""}'`
tags optional	array	Tag List'	`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	Account ID	b82909b3576449fda984fb25c3123542da
cert_body	Certificate body
cert_chain	Certificate chain
cert_kind	Certificate type	PRD
cert_type	Certificate type	pem
cert_version	Certificate Version	2
cn	Certificate Common Name	test.go.kr
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
key_bit_size	key bits size	2048
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
organization	Certificate Organization Name	samsungSDS
private_key	Private key
recipients	Expired certificates Recipients	[{‘region’: ‘’, ‘user_id’: ‘sdaFDQSDADZ2488e195c0e97d9b9eb’, ‘user_name’: ‘kildong.hong’}]
state	Certificate State	VALID
tags	Tag List’
user_name	User Name	kildong@samsung.com

1.3 - Delete a certificate

1.3.1 - 1.1

scpcli certificatemanager certificate delete
--certificate_id <value>

Description

Delete a Certificate

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
certificate_id required	string	Certificate ID	-

1.3.2 - 1.0

scpcli certificatemanager certificate delete
--certificate_id <value>

Description

Delete a Certificate

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
certificate_id required	string	Certificate ID	-

1.4 - Detail a certificate

1.4.1 - 1.1

scpcli certificatemanager certificate detail
--certificate_id <value>

Description

Detail a Certificate

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
certificate_id required	string	Certificate ID	-

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	Account ID	b82909b3576449fda984fb25c3123542da
cert_body	Certificate body
cert_chain	Certificate chain
cert_kind	Certificate type	DEV
cert_type	Certificate type	pem
cert_version	Certificate Version	2
cn	Certificate Common Name	test.go.kr
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
key_bit_size	key bits size	2048
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
organization	Certificate Organization Name	samsungSDS
private_key	Private key
state	Certificate State	VALID
user_name	User Name	2048

1.4.2 - 1.0

scpcli certificatemanager certificate detail
--certificate_id <value>

Description

Detail a Certificate

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
certificate_id required	string	Certificate ID	-

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	Account ID	b82909b3576449fda984fb25c3123542da
cert_body	Certificate body
cert_chain	Certificate chain
cert_kind	Certificate type	DEV
cert_type	Certificate type	pem
cert_version	Certificate Version	2
cn	Certificate Common Name	test.go.kr
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
key_bit_size	key bits size	2048
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
organization	Certificate Organization Name	samsungSDS
private_key	Private key
state	Certificate State	VALID
user_name	User Name	2048

1.5 - List certificates

1.5.1 - 1.1

scpcli certificatemanager certificate list
[--size <value>]
[--page <value>]
[--sort <value>]
[--ismine <value>]
[--name <value>]
[--cn <value>]
[--state <value>]

Description

List Certificates

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
ismine optional	boolean	Is it my certificate	-
name optional	string	Certificate Name	`test-certificate`
cn optional	string	Certificate Common Name	`test.go.kr`
state optional	array	Certificate State	`V`

Responses

Name	Description	Example
id	Certificate ID
cert_kind	Certificate type	PRD
cn	Certificate Common Name	test.go.kr
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
state	Certificate State	VALID

1.5.2 - 1.0

scpcli certificatemanager certificate list
[--size <value>]
[--page <value>]
[--sort <value>]
[--ismine <value>]
[--name <value>]
[--cn <value>]
[--state <value>]

Description

List Certificates

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
size optional	integer	size	`20`
page optional	integer	page	`0`
sort optional	string	sort	`created_at:desc`
ismine optional	boolean	Is it my certificate	-
name optional	string	Certificate Name	`test-certificate`
cn optional	string	Certificate Common Name	`test.go.kr`
state optional	array	Certificate State	`V`

Responses

Name	Description	Example
id	Certificate ID
cert_kind	Certificate type	PRD
cn	Certificate Common Name	test.go.kr
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
state	Certificate State	VALID

1.6 - Self-sign a certificate

1.6.1 - 1.1

scpcli certificatemanager certificate selfSign
--timezone <value>
--region <value>
--organization <value>
--not_before_dt <value>
--not_after_dt <value>
--name <value>
--cn <value>
[--recipients <value>]
[--tags <value>]

Description

Self-sign a Certificate

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
timezone required	string	Timezone	`Asia/Seoul`
region required	string	Name of region	`west1`
organization required	string	Certificate Organization Name	`samsungSDS`
not_before_dt required	string	Certificate Start Date	`20250101`
not_after_dt required	string	Certificate Expire Date	`20251212`
name required	string	Certificate Name	`test-certificate`
cn required	string	Certificate Common Name	`test.go.kr`
recipients optional	array	Expired certificates Recipients	`'{"region": "", "user_id": "", "user_name": ""}'`
tags optional	array	Tag List'	`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	Account ID	b82909b3576449fda984fb25c3123542da
cert_body	Certificate body
cert_chain	Certificate chain
cert_kind	Certificate type	DEV
cert_type	Certificate type	pem
cert_version	Certificate Version	2
cn	Certificate Common Name	test.go.kr
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
key_bit_size	key bits size	2048
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
organization	Certificate Organization Name	samsungSDS
private_key	Private key
state	Certificate State	VALID
user_name	User Name	2048

1.6.2 - 1.0

scpcli certificatemanager certificate selfSign
--timezone <value>
--region <value>
--organization <value>
--not_before_dt <value>
--not_after_dt <value>
--name <value>
--cn <value>
[--recipients <value>]
[--tags <value>]

Description

Self-sign a Certificate

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
timezone required	string	Timezone	`Asia/Seoul`
region required	string	Name of region	`west1`
organization required	string	Certificate Organization Name	`samsungSDS`
not_before_dt required	string	Certificate Start Date	`20250101`
not_after_dt required	string	Certificate Expire Date	`20251212`
name required	string	Certificate Name	`test-certificate`
cn required	string	Certificate Common Name	`test.go.kr`
recipients optional	array	Expired certificates Recipients	`'{"region": "", "user_id": "", "user_name": ""}'`
tags optional	array	Tag List'	`'{"key": "", "value": ""}'`

Responses

Name	Description	Example
id	ID	0fdd87aab8cb46f59b7c1f81ed03fb3e
account_id	Account ID	b82909b3576449fda984fb25c3123542da
cert_body	Certificate body
cert_chain	Certificate chain
cert_kind	Certificate type	DEV
cert_type	Certificate type	pem
cert_version	Certificate Version	2
cn	Certificate Common Name	test.go.kr
created_at	Created At	2024-05-17T00:23:17Z
created_by	Created By	90dddfc2b1e04edba54ba2b41539a9ac
key_bit_size	key bits size	2048
modified_at	Modified At	2024-05-17T00:23:17Z
modified_by	Modified By	90dddfc2b1e04edba54ba2b41539a9ac
name	Certificate Name	test-certificate
not_after_dt	Certificate Expire Date	2026-02-07T18:07:59
not_before_dt	Certificate Start Date	2025-02-08T18:07:00
organization	Certificate Organization Name	samsungSDS
private_key	Private key
state	Certificate State	VALID
user_name	User Name	2048

1.7 - Validate a certificate

1.7.1 - 1.1

scpcli certificatemanager certificate validate
--private_key <value>
--cert_body <value>
[--cert_chain <value>]

Description

Validate a Certificate

State ACTIVE (CURRENT)

Version	Supported Until
1.1	-

Parameters

Name	Type	Description	Example
private_key required	string	Private key	`<encoded private key data>`
cert_body required	string	Certificate body	`<encoded certificate body data>`
cert_chain optional	string	Certificate chain	`<encoded certificate chain data>`

Responses

Name	Description	Example
validate_check

1.7.2 - 1.0

scpcli certificatemanager certificate validate
--private_key <value>
--is_need_cert_chain <value>
--cert_body <value>
[--cert_chain <value>]

Description

Validate a Certificate

State ACTIVE (SUPPORTED)

Version	Supported Until
1.0	20260531

Parameters

Name	Type	Description	Example
private_key required	string	Private key	`<encoded private key data>`
is_need_cert_chain required	boolean	Is needed Certificate chain	`True`
cert_body required	string	Certificate body	`<encoded certificate body data>`
cert_chain optional	string	Certificate chain	`<encoded certificate chain data>`

Responses

Name	Description	Example
result	True, False Check	True