API Method - createeSignCustomCertificateById
Last updated
Last updated
Note:
This API is used only in specific cases where the External application needs to validate CSR data from their end for certificate generation to achieve maximum throughput.
Manual authorization profiles are not applicable for this API.
Be aware that all templates and keys required for the API to function are loaded statically to increase throughput.
Understand that any changes made to the templates or CA keys will require a server restart to update the API and ensure that it functions properly with the new information.
Purpose
Use the “createeSignCustomCertificateById” method for creating the X509 certificate and p7B certificate based on the ID selection.
POST
http://www.example.com/emCAServices/rest/createeSignCustomerCertificateById
Sample JSON Object
When request is received by the emCA service, we will decrypt the request JSON Object with the same AES key that is shared with the client.
After successful decryption, request JSON object (Signed CSR data + Username+ Password + Profile Id + SubjectDNiods + Validity + SAN Values + Valid From + Subscriber ID + Application ID + isP7BRequest) is retrieved.
First emCA service will validate username and password and check if the IP Address used for request and registered with the user are same.
If request is registered with same user, then we check if the certificate is already created for the requested applicationId or not.
if certificate is already created for applicationId then return existing certificate.
if certificate is not created for applicationId then we create certificate using next step.
If it is same then signed CSR data (signature) is validated by checking whether CSR is signed by the same PFX file which is registered for the specific user.
If validation fails at any point in processing the request, the emCA service will throw error/failure message. (Refer error messages section)
JSON Object Contains below parameters
Response JSON Format
Sample for base 64 encoded x509 certificate data
Parameter
Presence
Data Type
Description
signature
M
String
CSR file has to be generated and signed with PFX shared by us.
Pass Signed CSR data i.e., PKCS#7 data.
userName
M
String
You need to pass username that is registered with emCA for API process.
password
M
String
You need to pass the password that is registered with emCA for API process.
profileId
M
String
Pass Certificate profile Id to be used to create x509Certificate and CreateP7BCertById.
subscriberId
M
String
Pass the Subscriber ID.
Validity
O
String
Pass the validity in the form of (Days : Hours : Minutes : Seconds)
Days – 36135 (maximum days)
Hours - 23 (max hours)
Minutes - 59 (max minutes)
Seconds - 59 (max seconds)
to create certificate with the given validity.
validFrom
O
String
Pass the validityFrom in the form of (Days : Months : Years Hours : Minutes : Second)
sANValues
M
String
Pass sANValues to be used to create
subjectDNOids
M
String
Pass subjectDNOids to be used to create x509Certificate and CreateP7BCertById.
Example: “2.5.4.3|Test~2.5.4.6|India~2.5.4.8|Delhi~2.5.4.7|te st~2.5.4.5|77686868687~2.5.4.10|Personal~1.2.84
0.113549.1.9.1|test@gmail.com~2.5.4.12|test”
isP7BRequest
M
String
Pass “true” for p7b Certificate and “false” for .cer Certificate
applicationId
M
String
Pass application ID.
Parameter
Presence
Data Type
Description
requestData
M
String
All the request input parameters mentioned above should be converted to JSON object and encrypted with AES 256 key shared with you by the emCA team.
Pass Encrypted JSON Object.
userName
M
String
You need to pass username that is registered with emCA for API process.
Key
Presence
Value
Description
Application / JSON
M
Content-Type
Type of request should be in JSON Format.
Authentication Key
M
emKey
emKey is an encoded key (Refer section 4 for generating Authentication Key using command prompt).
Parameter
Data Type
Description
response
String
Returns JSON Object
Parameter
Data Type
Description
status
String
Returns Status of the request as success if CSR is signed by selected certificate profile id and generates x509 certificate.
Returns status of the request as failure when authentication fails or unregistered user tries to call the API
result
String
Returns
In case of success: base 64 encoded x509 certificate data
In case of failure: Error message will be displayed.
subscriberId
String
Returns Subscriber Id
Error Message
Description
<profileId> profile does not exist
If the given certificate profile Id is invalid
Please enter valid data
If the signature parameter (CSR) contains an invalid CSR or if the CSR does not contain the required details of the selected certificate profile.
Signature verification failed
If signature parameter (CSR) is not signed by the pfx shared by eMudhra
Invalid validity
validity should be in proper format dd:hh:mm:ss e.g: 120:23:45:54
Invalid From Date
Invalid Input: From Date should be in proper format dd:MM:YYYY hh:mm:ss e.g: 12:12:2019 00:00:00
isP7BRequest
enter true for p7bCertificate and false for .cer certificate