POST /platform/v1/key

Creates or imports an encryption key for bring your own key (BYOK) for TDE. Data at Rest Encryption is a prerequisite for this feature.

NameTypeDescription
x-request-idstringHeader parameter: Request ID for the request. Default Format: 52e3ca33-c54a-4bbe-824c-419ff9a46860.
x-mccs-user-contextstringHeader parameter: Indicates the MCCS user context. Example: EID=111;MID=111;EmployeeId=111.
x-mccs-keystore-providerstringHeader parameter: Specify a key store provider to use for an ImportKey or WrappingKey request. Examples: kms, keysecure, database. Default: keysecure.
x-mccs-macstringHeader parameter: Specify the message authentication code for the request.
NameTypeDescription
keyNamestringRequiredundefined
keyIdstringFormat: GUID.
keyVersionintegerFormat: int32.
keyTypestringRequiredundefined
midintegerRequiredFormat: int64.
eidintegerFormat: int64.
keySizeintegerRequiredFormat: int32.
keyStatestringundefined
exportablebooleanundefined
createdDatestringundefined
employeeIdintegerFormat: int32.
modifiedDatestringundefined
modifiedByintegerFormat: int32.
keyData.wrappedRsaBytesstringundefined
keyData.digitalSignaturestringundefined
keyData.initializationVectorstringIV may be required when you wrap with an AES key.
keyData.wrappedAesBytesstringundefined
StatusNameTypeDescription
201  Encryption key is successfully imported
 keyNamestringundefined
 keyIdstringFormat: GUID.
 keyVersionintegerFormat: int32.
 keyTypestringundefined
 midintegerFormat: int64.
 eidintegerFormat: int64.
 keySizeintegerFormat: int32.
 keyStatestringundefined
 exportablebooleanundefined
 createdDatestringundefined
 employeeIdintegerFormat: int32.
 modifiedDatestringundefined
 modifiedByintegerFormat: int32.
 keyData.wrappedRsaBytesstringundefined
 keyData.digitalSignaturestringundefined
 keyData.initializationVectorstringIV may be required when you wrap with an AES key.
 keyData.wrappedAesBytesstringundefined
    
400  Invalid keystore provider name in the request header
 typestringundefined
 titlestringundefined
 statusintegerFormat: int32.
 detailstringundefined
 instancestringundefined
 additionalPropertiesobjectundefined
    
500  Unable to process request
 statusCodeintegerFormat: int32.
 requestIdstringundefined
 messagestringundefined
 messageCodestringundefined
    
503  System is unavailable to process request
 statusCodeintegerFormat: int32.
 requestIdstringundefined
 messagestringundefined
 messageCodestringundefined

Example Request

Example Response