Skip to main content

6) Definition of SKMS Response Status Codes

Definition of SKMS Response Status Codes

Description

Definition of Code for SKMS Response Status
Reference:https://wiki.softcamp.co.kr/x/5w2DB

Response Code

Status Code	Status Message	Description
200	OK	Request successful
400	Bad Request	Client request is incorrect (e.g. missing required value)
401	Unauthorized	Not approved (authentication failed)
403	Forbidden	Not permitted (when the request is not authorized for the user, although authentication has been completed)
404	Not Found	Resource not found
500	Internal Server Error	An internal server error occurred while processing the request.

Response Error JSON format

Name	Required	Type	Description
code	required	int	Error Code (Refer to Error Code Definition)
message	required	string	Error Message
detail		string	Error details (the specifics may vary depending on the error)

Error Code

Error Code Definition

error code	message	Description	Status Code
40003	Failed create header	Header creation failed	400
40004	Failed extract header	Header extraction failed	400
40005	Batch/Scheduler Failed	Batch/Scheduler Failure	400
40006	oAuth connection failed	Authentication connection failed	400
40007	Integrated Log Service Failed	Integrated Log Service Failure	400
40008	Key Vault Service Failed	Keybolt Service Failure	400
40009	Service Linker Key Manager is not used	Key data integration failure	400
40011	Unable to AzureInfo	Failed to retrieve Azure information	400
40012	Relay client accessToken Failed	Relay token renewal failed	400
40013	Key not found in the keyVault	Failed to retrieve key from Keybolt	400

40101	Invalid token	Invalid token	401
40102	No matching company ID found	No matching company_id	400
40103	Failed Duplicate domain	Duplicate Domain	400
40104	No matching domains found	No matching domain	400
40105	Required value is missing	No required value	400
40107	No matching license found	No matching license	400
40108	Unavailable License	Unavailable License	400
40110	HeaderKey is Empty	No matching header key	400
40111	EncryptionKey is Empty	No matching encryption key - DS_KEY_ENCRYPTION_KEY	400
40112	No matching SCI ServerID found	No matching SCI server ID found	400

40301	You don't have permission this service	Access Denied	401

50001	An unexpected error has occurred in the internal system	Internal Service Error	500
50002	SCI Connection failed	Failed to connect to SCI server	500
50003	Service Linker Name is Not Exist	The SHIELDRM service name does not exist.	500
50004	Service Linker is Unused	Unused SHIELDRM service	500
50005	SCI Service Linker registration Failed	Failed to register SCI server integration system	500

Examples

Response

Status code : 400 Bad Request

{
    "code": 40013,
    "message": "Key not found in the keyVault",
    "detail": "keyId : 0000009"
}

{
    "code": 40003,
    "message": "Failed create header",
    "detail": "4020"
}

Status code : 500 INTERNAL_SERVER_ERROR

{
    "code": 50001,
    "message": "An unexpected error has occurred in the internal system",
    "detail": "I/O error on GET request for \"https://devkms.softcamp.co.kr:8080/drm/7FDKQsEK-QVGKyXA2-fx1LxIzy-SNIre0s9/key/0000003\": Connect to devkms.softcamp.co.kr:8080 [devkms.softcamp.co.kr/10.14.10.171] failed: Connection timed out: connect; nested exception is org.apache.http.conn.HttpHostConnectException: Connect to devkms.softcamp.co.kr:8080 [devkms.softcamp.co.kr/10.14.10.171] failed: Connection timed out: connect"
}

Definition of SKMS Response Status Codes