Secure Key Manager는 사용자 데이터에 접근할 수 있는 다양한 API를 제공합니다. 클라이언트는 키 저장소에 설정한 인증을 통과한 후 Secure Key Manager에 저장한 데이터를 사용할 수 있습니다.
https://api-keymanager.gov-nhncloudservice.com
Method | URI | 설명 |
---|---|---|
GET | /keymanager/v1.0/appkey/{appkey}/confirm | API를 호출한 클라이언트 정보를 제공합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/secrets/{keyid} | Secure Key Manager에 저장한 기밀 데이터를 조회합니다. |
POST | /keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/encrypt | Secure Key Manager에 저장한 대칭 키로 데이터를 암호화합니다. |
POST | /keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/decrypt | Secure Key Manager에 저장한 대칭 키로 데이터를 복호화합니다. |
POST | /keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/create-local-key | 클라이언트가 로컬 환경에서 데이터 암/복호화에 사용할 수 있는 ARIA-256 대칭 키를 생성합니다. |
GET | /keymanager/{v1.0|v1.1}/appkey/{appkey}/symmetric-keys/{keyid}/symmetric-key | Secure Key Manager에 저장한 대칭 키를 조회합니다. |
POST | /keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/sign | Secure Key Manager에 저장한 비대칭 키로 데이터를 서명합니다. |
POST | /keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/verify | Secure Key Manager에 저장한 비대칭 키로 데이터와 서명을 검증합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/privateKey | Secure Key Manager에 저장한 개인 키를 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/publicKey | Secure Key Manager에 저장한 공개 키를 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores | Secure Key Manager에 저장된 키 저장소들을 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId} | Secure Key Manager에 저장된 키 저장소를 상세 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/keys | Secure Key Manager에 저장된 키 저장소의 키들을 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/keys/{keyId} | Secure Key Manager에 저장된 키 저장소의 키를 상세 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/ips | Secure Key Manager에 저장된 키 저장소의 IPv4 인증 정보들을 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/ips?value={ipv4Value} | Secure Key Manager에 저장된 키 저장소의 IPv4 인증 정보를 상세 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/macs | Secure Key Manager에 저장된 키 저장소의 MAC 인증 정보들을 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/macs?value={macValue} | Secure Key Manager에 저장된 키 저장소의 MAC 인증 정보를 상세 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/certificates | Secure Key Manager에 저장된 키 저장소의 인증서 인증 정보들을 조회합니다. |
GET | /keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/certificates?value={certificateName} | Secure Key Manager에 저장된 키 저장소의 인증서 인증 정보를 상세 조회합니다. |
[API 요청의 HTTP 헤더]
Secure Key Manager의 MAC 주소 인증을 사용하려면 HTTP 헤더에 클라이언트 MAC 주소를 설정해서 요청해야 합니다.
X-TOAST-CLIENT-MAC-ADDR: {MAC 주소}
[API 요청의 경로 변수]
이름 | 타입 | 설명 |
---|---|---|
appkey | String | 사용하려는 데이터를 저장하고 있는 NHN Cloud 프로젝트의 앱키 |
keyid | String | 사용하려는 데이터의 식별자 |
[API 응답의 데이터 공통 헤더]
{
"header": {
"resultCode": 0,
"resultMessage": "success",
"isSuccessful": true
},
"body": {
...
}
}
이름 | 타입 | 설명 |
---|---|---|
resultCode | Number | API 호출 결과 코드값 |
resultMessage | String | API 호출 결과 메시지 |
isSuccessful | Boolean | API 호출 성공 여부 |
API를 호출한 클라이언트 정보를 조회할 때 사용합니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/confirm
[Response Body]
{
"header": {
...
},
"body": {
"clientIp": "0.0.0.0",
"clientMacHeader": "00:00:00:00:00:00",
"clientSentCerfificate": false
}
}
이름 | 타입 | 설명 |
---|---|---|
clientIp | String | API를 호출한 클라이언트의 IP 주소 |
clientMacHeader | String | API를 호출한 클라이언트의 MAC 주소 헤더값 |
clientSentCertificate | Boolean | API를 호출한 클라이언트가 인증서를 사용하고 있는지 여부 |
Secure Key Manager에 저장한 기밀 데이터를 조회할 때 사용합니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/secrets/{keyid}
[Response Body]
{
"header": {
...
},
"body": {
"secret": "data"
}
}
이름 | 타입 | 설명 |
---|---|---|
secret | String | 기밀 데이터 조회 결과 |
Secure Key Manager에 생성한 대칭 키로 데이터를 암호화할 때 사용합니다. 사용자는 32KB 이하의 텍스트 데이터를 전달해서 Secure Key Manager에 저장한 대칭 키로 암호화할 수 있습니다.
POST https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/encrypt
[Request Body]
{
"plaintext": "data"
}
이름 | 타입 | 설명 |
---|---|---|
plaintext | String | 대칭 키로 암호화할 데이터 |
[Response Body]
{
"header": {
...
},
"body": {
"ciphertext": "AAAAABzGwQniNneKXmcOLhWnxEqC1rNY+UdVb3lyeX/4wSrP",
"keyVersion": 1
}
}
이름 | 타입 | 설명 |
---|---|---|
ciphertext | String | 대칭 키로 데이터를 암호화한 결과 |
keyVersion | Number | API 요청 처리에 사용한 대칭 키 버전 |
Secure Key Manager에 생성한 대칭 키로 데이터를 복호화할 때 사용합니다. 사용자는 암호화된 텍스트를 전달해서 Secure Key Manager에 저장한 대칭 키로 복호화할 수 있습니다.
POST https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/decrypt
[Request Body]
{
"ciphertext": "AAAAABzGwQniNneKXmcOLhWnxEqC1rNY+UdVb3lyeX/4wSrP"
}
이름 | 타입 | 설명 |
---|---|---|
ciphertext | String | 대칭 키로 복호화할 데이터 |
[Response Body]
{
"header": {
...
},
"body": {
"plaintext": "data",
"keyVersion": 1
}
}
이름 | 타입 | 설명 |
---|---|---|
plaintext | String | 대칭 키로 데이터를 복호화한 결과 |
keyVersion | Number | API 요청 처리에 사용한 대칭 키 버전 |
클라이언트가 로컬 환경에서 사용할 수 있는 ARIA-256 대칭 키를 생성할 때 사용합니다. localKeyPlaintext는 생성한 대칭 키를 Base64 인코딩한 형태이며 Base64 디코딩 후 바로 사용할 수 있습니다. localKeyCiphertext는 생성한 대칭 키를 Secure Key Manager에 저장한 대칭 키로 암호화한 후 Base64 인코딩한 형태이며 스토리지에 저장할 때 사용합니다. 스토리지에 저장한 대칭 키는 복호화 API를 사용해서 복호화한 후 사용할 수 있습니다.
POST https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/create-local-key
[Response Body]
{
"header": {
...
},
"body": {
"localKeyPlaintext": "srV7MWkYIfYBknkASzwSEK1Z1y9Nx0f/RMZ3MSVIjm8=",
"localKeyCiphertext": "v1s1WkiIj3KR+AafnupNv9xcX/JhL4GUzUr8mzLRpjbGuoAwU/GgboM/6QdRRY24",
"keyVersion": 1
}
}
이름 | 타입 | 설명 |
---|---|---|
localKeyPlaintext | String | Base64 인코딩한 ARIA-256 대칭 키 |
localKeyCiphertext | String | Secure Key Manager에 저장한 대칭 키로 암호화한 후 Base64 인코딩한 ARIA-256 대칭 키 |
keyVersion | Number | API 요청 처리에 사용한 대칭 키 버전 |
Secure Key Manager에 저장한 대칭 키(ARIA-256)를 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/symmetric-keys/{keyid}/symmetric-key
[Response Body]
{
"header": {
...
},
"body": {
"symmetricKey": "0x00, 0x20, 0x00, 0x41, 0x00, 0x20, 0x00, 0x73, 0x00, 0x69, 0x00, 0x6d, 0x00, 0x70, 0x00, 0x6c, 0x00, 0x65, 0x00, 0x20, 0x00, 0x4a, 0x00, 0x61, 0x00, 0x76, 0x00, 0x61, 0x00, 0x2e, 0x00, 0x20"
}
}
이름 | 타입 | 설명 |
---|---|---|
symmetricKey | String | 대칭 키 데이터(16진수 문자열 형태) |
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.1/appkey/{appkey}/symmetric-keys/{keyid}/symmetric-key?keyVersion={keyVersion}
[Request Parameter]
이름 | 타입 | 설명 |
---|---|---|
keyVersion | Number | 조회하려는 대칭 키 버전 |
[Response Body]
{
"header": {
...
},
"body": {
"symmetricKey": "0x00, 0x20, 0x00, 0x41, 0x00, 0x20, 0x00, 0x73, 0x00, 0x69, 0x00, 0x6d, 0x00, 0x70, 0x00, 0x6c, 0x00, 0x65, 0x00, 0x20, 0x00, 0x4a, 0x00, 0x61, 0x00, 0x76, 0x00, 0x61, 0x00, 0x2e, 0x00, 0x20",
"keyVersion": 1
}
}
이름 | 타입 | 설명 |
---|---|---|
symmetricKey | String | 대칭 키 데이터(16진수 문자열 형태) |
keyVersion | Number | API 요청 처리에 사용한 대칭 키 버전 |
Secure Key Manager에 생성한 비대칭 키로 데이터를 서명할 때 사용합니다. 사용자는 245 Byte 이하의 텍스트 데이터를 전달해서 Secure Key Manager에 저장한 비대칭 키로 서명할 수 있습니다.
POST https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/sign
[Request Body]
{
"plaintext": "data"
}
이름 | 타입 | 설명 |
---|---|---|
plaintext | String | 비대칭 키로 서명할 데이터 |
[Response Body]
{
"header": {
...
},
"body": {
"signature": "AAAAAGI9zf831DX...",
"keyVersion": 1
}
}
이름 | 타입 | 설명 |
---|---|---|
signature | String | 비대칭 키로 데이터를 서명한 서명값 |
keyVersion | Number | API 요청 처리에 사용한 비대칭 키 버전 |
Secure Key Manager에 생성한 비대칭 키로 데이터를 검증할 때 사용합니다. 사용자는 데이터와 서명값을 전달해서 Secure Key Manager에 저장한 비대칭 키로 데이터가 위변조되지 않았음을 검증할 수 있습니다.
POST https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/verify
[Request Body]
{
"plaintext": "data",
"signature": "AAAAAGI9zf831DX..."
}
이름 | 타입 | 설명 |
---|---|---|
plaintext | String | 비대칭 키로 검증할 데이터 |
signature | String | 비대칭 키로 데이터를 서명한 서명값 |
[Response Body]
{
"header": {
...
},
"body": {
"result": true,
"keyVersion": 1
}
}
이름 | 타입 | 설명 |
---|---|---|
result | Boolean | 비대칭 키로 데이터와 서명값을 검증한 결과 |
keyVersion | Number | API 요청 처리에 사용한 비대칭 키 버전 |
Secure Key Manager에 저장한 비대칭 키 중 개인 키를 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/privateKey?keyVersion={keyVersion}
[Request Parameter]
이름 | 타입 | 설명 |
---|---|---|
keyVersion | Number | 조회하려는 비대칭 키 버전 |
[Response Body]
{
"header": {
...
},
"body": {
"keyType": "PrivateKey",
"key": "0x30, 0x82, 0x04, 0xbe, 0x02, 0x01, 0x00, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01, 0x05, 0x00, 0x04, 0x82, 0x04, 0xa8, 0x30, 0x82, 0x04, 0xa4, 0x02, 0x01, 0x00, 0x02, 0x82, 0x01, 0x01, 0x00, 0x8b, 0x07, 0x8e, 0xda, 0xc7, 0x83, 0x95, 0xc8, 0x43, 0xa7, 0xb8, 0x31, 0x6f, 0xf6, 0x25, 0x36, 0x89, 0x64, 0xc5, 0x38, 0x75, 0x4b, 0xa6, 0x80, 0xfe, 0x7c, 0xc5, 0x6a, 0x94, 0xf2,
... 후략 ...",
"encodedKey": "MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCLB47ax4OVyEOnuDFv9iU2iWTFOHVLpoD+fMVqlPJiiuJSwi5x/zd3LojWuUyr+dZ9Icxl23Alu4GwwKgUi4DL8qo8jD14THJoeUgIZ56wmYMvN+CkNnmkyqcGn6yT+AXtBJVGqS/2lssHLIGELi8XXkWdf6OBfig6HgsJAnix8Z+T/QdikEFUI5ZiuUWyHw2Bag9B4CoPF2EgXfu5HcW4GA4KH2PI92O4vNg8AmFVDk2E+ma2quSau7LjS3KY9s3Sq+JqvTPZmqHQJudv9ZYcnbyDG/
... 후략 ...",
"keyVersion": 0
}
}
이름 | 타입 | 설명 |
---|---|---|
keyType | String | 비대칭 키 형태 |
key | String | 개인 키 데이터(16진수 문자열 형태) |
encodedKey | String | 개인 키 데이터(Base64 인코딩 형태) |
keyVersion | Number | API 요청 처리에 사용한 비대칭 키 버전 |
Secure Key Manager에 저장한 비대칭 키 중 공개 키를 조회할 수 있습니다. 인증에 상관없이 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/asymmetric-keys/{keyid}/publicKey?keyVersion={keyVersion}
[Request Parameter]
이름 | 타입 | 설명 |
---|---|---|
keyVersion | Number | 조회하려는 비대칭 키 버전 |
[Response Body]
{
"header": {
...
},
"body": {
"keyType": "PublicKey",
"key": "0x30, 0x82, 0x01, 0x22, 0x30, 0x0d, 0x06, 0x09, 0x2a, 0x86, 0x48, 0x86, 0xf7, 0x0d, 0x01, 0x01, 0x01, 0x05, 0x00, 0x03, 0x82, 0x01, 0x0f, 0x00, 0x30, 0x82, 0x01, 0x0a, 0x02, 0x82, 0x01, 0x01, 0x00, 0x8b, 0x07, 0x8e, 0xda, 0xc7, 0x83, 0x95, 0xc8, 0x43, 0xa7, 0xb8, 0x31, 0x6f, 0xf6, 0x25, 0x36, 0x89, 0x64, 0xc5, 0x38, 0x75, 0x4b, 0xa6, 0x80, 0xfe, 0x7c, 0xc5, 0x6a, 0x94, 0xf2, 0x62, 0x8a, 0xe2, 0x52, 0xc2,
... 후략 ...",
"encodedKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAiweO2seDlchDp7gxb/YlNolkxTh1S6aA/nzFapTyYoriUsIucf83dy6I1rlMq/nWfSHMZdtwJbuBsMCoFIuAy/KqPIw9eExyaHlICGeesJmDLzfgpDZ5pMqnBp+sk/gF7QSVRqkv9pbLByyBhC4vF15FnX+jgX4oOh4LCQJ4sfGfk/0HYpBBVCOWYrlFsh8NgWoPQeAqDxdhIF37uR3FuBgOCh9jyPdjuLzYPAJhVQ5NhPpmtqrkmruy40tymPbN0qviar0z2Zqh0Cbnb/WWHJ28gxv+d+iJCXJvm+fIg7hRYJ5C+mun/N6FB8QHv/
... 후략 ...",
"keyVersion": 0
}
}
이름 | 타입 | 설명 |
---|---|---|
keyType | String | 비대칭 키 형태 |
key | String | 공개 키 데이터(16진수 문자열 형태) |
encodedKey | String | 공개 키 데이터(Base64 인코딩 형태) |
keyVersion | Number | API 요청 처리에 사용한 비대칭 키 버전 |
Secure Key Manager에 생성한 키 저장소의 ID 목록을 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores
[Response Body]
{
"header": {
...
},
"body": {
"keyStoreIdList": [
1,
2,
...
]
}
}
이름 | 타입 | 설명 |
---|---|---|
keyStoreIdList | List | 키 저장소 ID 목록 |
Secure Key Manager에 생성한 키 저장소 정보를 상세 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}
[Response Body]
{
"header": {
...
},
"body": {
"keyStoreId": 1,
"name": "키 저장소 이름",
"description": "키 저장소 설명",
"ip4AuthUse": "Y",
"macAuthUse": "N",
"certificateAuthUse": "Y",
"creationUser": "SECURE_KEY_MANAGER",
"creationDatetime": "2025-01-25T12:00:00",
"lastChangeUser": "SECURE_KEY_MANAGER",
"lastChangeDatetime": "2025-01-30T15:00:00.000"
}
}
이름 | 타입 | 설명 |
---|---|---|
keyStoreId | Number | 키 저장소 ID |
name | String | 키 저장소 이름 |
description | String | 키 저장소 설명 |
ip4AuthUse | String | 키 저장소 IPv4 인증 사용 여부(Y/N) |
macAuthUse | String | 키 저장소 MAC 인증 사용 여부(Y/N) |
certificateAuthUse | String | 키 저장소 인증서 인증 사용 여부(Y/N) |
creationUser | String | 키 저장소 생성 유저 |
creationDatetime | String | 키 저장소 생성 일시 |
lastChangeUser | String | 키 저장소 마지막 수정 유저 |
lastChangeDatetime | String | 키 저장소 마지막 수정 일시 |
Secure Key Manager에 생성한 키의 ID 목록을 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/keys
[Response Body]
{
"header": {
...
},
"body": {
"keyIdList": [
"035a0ffa16a64bbf8171c4bdcea37bbf",
"04fde6d8ee604cbe8fa7abe135a7dc3e",
...
]
}
}
이름 | 타입 | 설명 |
---|---|---|
keyIdList | List | 키 ID 목록 |
Secure Key Manager에 생성한 키 정보를 상세 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/keys/{keyId}
[Response Body]
{
"header": {
...
},
"body": {
"keyId": "035a0ffa16a64bbf8171c4bdcea37bbf",
"name": "키 이름",
"description": "키 설명",
"keyType": "SYMMETRIC_KEY",
"currentKeyValueVersion": 2,
"autoRotationPeriod": 0,
"nextAutoRotationDate": null,
"lastAccessDatetime": "2021-12-13T15:13:13.377",
"deletionDatetime": null,
"creationUser": "SECURE_KEY_MANAGER",
"creationDatetime": "2025-01-25T12:00:00",
"lastChangeUser": "SECURE_KEY_MANAGER",
"lastChangeDatetime": "2025-01-30T15:00:00.000"
}
}
이름 | 타입 | 설명 |
---|---|---|
keyId | Number | 키 ID |
name | String | 키 이름 |
description | String | 키 설명 |
keyType | String | 키 타입(SECRET/SYMMETRIC_KEY/ASYMMETRIC_KEY) |
currentKeyValueVersion | String | 현재 키 버전 |
autoRotationPeriod | String | 키 회전 주기 |
nextAutoRotationDate | String | 다음 키 회전일 |
lastAccessDatetime | String | 키 마지막 사용 일시 |
creationUser | String | 키 생성 유저 |
creationDatetime | String | 키 생성 일시 |
lastChangeUser | String | 키 마지막 수정 유저 |
lastChangeDatetime | String | 키 마지막 수정 일시 |
Secure Key Manager에서 설정한 키 저장소의 IPv4 인증 정보 목록을 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/ips
[Response Body]
{
"header": {
...
},
"body": {
"ipv4List": [
"127.0.0.1",
"127.0.0.2",
...
]
}
}
이름 | 타입 | 설명 |
---|---|---|
ipv4List | List | IPv4 인증 정보 목록 |
Secure Key Manager에서 설정한 키 저장소의 IPv4 인증 정보를 상세 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/ips?value={ipv4Value}
[Request Parameter]
이름 | 타입 | 설명 |
---|---|---|
ipv4Value | String | 조회하려는 IPv4 주소 |
[Response Body]
{
"header": {
...
},
"body": {
"ipv4List": [
{
"value": "127.0.0.1",
"description": "IPv4 설명",
"lastAccessDatetime": "2025-01-25T13:00:00",
"deletionDatetime": null,
"creationUser": "SECURE_KEY_MANAGER",
"creationDatetime": "2025-01-25T12:00:00",
"lastChangeUser": "SECURE_KEY_MANAGER",
"lastChangeDatetime": "2025-01-30T15:00:00.000"
}
]
}
}
이름 | 타입 | 설명 |
---|---|---|
ipv4List | List | IPv4 인증 정보 목록 |
value | String | IPv4 값 |
description | String | IPv4 설명 |
lastAccessDatetime | String | IPv4 마지막 사용 일시 |
deletionDatetime | String | IPv4 삭제 예정 일시 |
creationUser | String | IPv4 생성 유저 |
creationDatetime | String | IPv4 생성 일시 |
lastChangeUser | String | IPv4 마지막 수정 유저 |
lastChangeDatetime | String | IPv4 마지막 수정 일시 |
Secure Key Manager에서 설정한 키 저장소의 MAC 인증 정보 목록을 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/macs
[Response Body]
{
"header": {
...
},
"body": {
"macList": [
"aa:aa:aa:aa:aa:aa",
"bb:bb:bb:bb:bb:bb",
...
]
}
}
이름 | 타입 | 설명 |
---|---|---|
macList | List | MAC 인증 정보 목록 |
Secure Key Manager에서 설정한 키 저장소의 MAC 인증 정보를 상세 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/macs?value={macValue}
[Request Parameter]
이름 | 타입 | 설명 |
---|---|---|
macValue | String | 조회하려는 MAC 주소 |
[Response Body]
{
"header": {
...
},
"body": {
"macList": [
{
"value": "aa:aa:aa:aa:aa:aa",
"description": "MAC 설명",
"lastAccessDatetime": "2025-01-25T13:00:00",
"deletionDatetime": null,
"creationUser": "SECURE_KEY_MANAGER",
"creationDatetime": "2025-01-25T12:00:00",
"lastChangeUser": "SECURE_KEY_MANAGER",
"lastChangeDatetime": "2025-01-30T15:00:00.000"
}
]
}
}
이름 | 타입 | 설명 |
---|---|---|
macList | List | MAC 인증 정보 목록 |
value | String | MAC 값 |
description | String | MAC 설명 |
lastAccessDatetime | String | MAC 마지막 사용 일시 |
deletionDatetime | String | MAC 삭제 예정 일시 |
creationUser | String | MAC 생성 유저 |
creationDatetime | String | MAC 생성 일시 |
lastChangeUser | String | MAC 마지막 수정 유저 |
lastChangeDatetime | String | MAC 마지막 수정 일시 |
Secure Key Manager에서 설정한 키 저장소의 인증서 인증 정보 목록을 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/certificates
[Response Body]
{
"header": {
...
},
"body": {
"certificateList": [
"certificate1",
"certtificate2",
...
]
}
}
이름 | 타입 | 설명 |
---|---|---|
certificateList | List | 인증서 인증 정보 목록 |
Secure Key Manager에서 설정한 키 저장소의 인증서 인증 정보를 상세 조회할 수 있습니다.
GET https://api-keymanager.gov-nhncloudservice.com/keymanager/v1.0/appkey/{appkey}/keystores/{keyStoreId}/certificates?value={certificateName}
[Request Parameter]
이름 | 타입 | 설명 |
---|---|---|
certificateName | String | 조회하려는 인증서 이름 |
[Response Body]
{
"header": {
...
},
"body": {
"certificateList": [
{
"name": "certificate1",
"password": "password1",
"description": "인증서 설명",
"expirationDate": "2029-07-21T10:26:47",
"lastAccessDatetime": "2025-01-25T13:00:00",
"deletionDatetime": null,
"creationUser": "SECURE_KEY_MANAGER",
"creationDatetime": "2025-01-25T12:00:00",
"lastChangeUser": "SECURE_KEY_MANAGER",
"lastChangeDatetime": "2025-01-30T15:00:00.000"
}
]
}
}
이름 | 타입 | 설명 |
---|---|---|
certificateList | List | 인증서 인증 정보 목록 |
name | String | 인증서 이름 |
password | String | 인증서 비밀번호 |
description | String | 인증서 설명 |
lastAccessDatetime | String | 인증서 마지막 사용 일시 |
deletionDatetime | String | 인증서 삭제 예정 일시 |
creationUser | String | 인증서 생성 유저 |
creationDatetime | String | 인증서 생성 일시 |
lastChangeUser | String | 인증서 마지막 수정 유저 |
lastChangeDatetime | String | 인증서 마지막 수정 일시 |