API Method- createCertificatesByIdWithMultipleCsrData

Purpose

Use the “createCertificatesByIdWithMultipleCsrData” method for creating Certificates with multiple CSR data.

Type of Method

POST

Request URL

http://www.example.com/emCAServices/rest/createX509CertificatesByIdWithMultipleCsrData

Request Input Parameters

Parameter

Presence

Data Type

Description

applicationId

M

string

Pass the Application ID.

profileID

M

string

Pass the Profile Id to be used to create the Certificate.

subscriberId

M

string

Pass the Subscriber ID.

validFrom

O

string

Pass the validFrom in the form of (Days : Months :Years Hours : Minutes : Second).

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 minute Seconds - 59 max second

to create certificate with the given validity.

signature

M

String

Pass Signed data you want to validate or verify.

Refer section 6.29 for the signature generation.

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.

Sample JSON Object

{
"applicationId": "XXX", "profileID": "XX", "subscriberId": "XXX", "validFrom": "XXXX", "validity": "XXXX"
"signature" : "MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwGggCSABIGLQ049
dGh1bGFzaSxTRVJJQUxOVU1CRVI9QVZBUEc0MjAxQSxFPXRodWxhc2kuZ0BlbXVkaHJhLmNvbSxPPWVtd WRocmEsUz1LQSxDPUlOLFBvc3RhbENvZGU9NTYwMTAzLEtleUFsb2dpcnRobUFuZFNpemU9UlNBLTEwMj QsUGFzc3dvcmQ9MTIzNAAAAAAAAKCAMIIDpjCCAo6gAwIBAgIDTEtBMA0GCSqGSIb3DQEBCwUAMHQxJTA
jBgNVBAMMHENlcnRpZmljYXRlTWFuYWdlciBSb290IDIwMTYxGDAWBgNVBAoMD2VNdWRocmEgTGltaXRl ZDEQMA4GA1UECwwHZW11ZGhyYTESMBAGA1UECAwJQmFuZ2Fsb3JlMQswCQYDVQQGEwJJTjAeFw0xODA1M DMwNTUyNDNaFw0yMDA1MDIwNTUyNDNaMCgxFzAVBgNVBA8MDkF1dGhlbnRpY2F0aW9uMQ0wCwYDVQQDDA
RyYWNhMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAm4k/r47G8+eRm/zftRSwxg8koTXLEHG JF5MKJZjUsPweASFbxxcj1RwixCHaAP75n3u0JCOFBuOVDMlPMu47j9w+x6jig3IMdVhPo6/rU7Z75Gtw FQDvhLZhoz2VMrSThfjvhaYEiOYy4uhC7sXOVedCw3rFylFtbljgwgnPC6Rp75TesIKj1l+9dZY08OxyI CNUNluztcMOXDqk68rtzbZfPvtfH4msDpyUoJL7XmBwbXF7UMiISlCiSvqpjYyBsu+tPxuOpgxlGbyJGm Wfi9D7Nzg4a8SBW6NrRWhtGASUj+/SaJpH0LI5wTrmMri8vJ2r2LHyi0zdpk+9S8u3vwIDAQABo4GMMIG JMAwGA1UdEwEB/wQCMAAwIgYDVR0jAQH/BBgwFoAUgrVRaCBCfAEiYlkr6rtaEbNDgsEwIAYDVR0OAQH/ BBYEFJ4vM/W+gFWsqBapUx9p7OSBQfDbMA4GA1UdDwEB/wQEAwIEsDAjBgNVHSUEHDAaBggrBgEFBQcDA QYIKwYBBQUHAwIGBFUdJQAwDQYJKoZIhvcNAQELBQADggEBAENZq6xWQGZE+cwOD0CigiZYQqDRBpeMW1
hhtlo7isiKWAlllAZ60aHZ2pMAO30VVwvifEjDv2QvCe+IA5d6x/SIBt0f/FypZj6T4vY6h6Hcaks7zI3 gozMCCuHBeBS/wA7LPwyxkxxFwUzDeJkLYfmkFQH6HN2OT3BqY3cA2Qon/NHRdCc5vvY9pbSR0j4y/2wX qzROIyYjXt3U2z/IL1pkDlmpDmYzbafdIlCJ6xyFOKNRoLp6QiGTZNs5UaVPnxMOvsh2sA1EirFFsRiDB J6ycrAjff9ls4oIc5gpgp7TArXbogFP1lw5j8nj50se46Bv0aQ0D4WdThCljcC6xQMAADGCAhEwggINAg EBMHswdDElMCMGA1UEAwwcQ2VydGlmaWNhdGVNYW5hZ2VyIFJvb3QgMjAxNjEYMBYGA1UECgwPZU11ZGh yYSBMaW1pdGVkMRAwDgYDVQQLDAdlbXVkaHJhMRIwEAYDVQQIDAlCYW5nYWxvcmUxCzAJBgNVBAYTAklO AgNMS0EwDQYJYIZIAWUDBAIBBQCgaTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJB
TEPFw0xODA4MDgxMDU3NDFaMC8GCSqGSIb3DQEJBDEiBCCRCU2QQn8vWt9lA+SkB/8weIKlUaHaSgmDqE
4GCgQZ0TANBgkqhkiG9w0BAQEFAASCAQAIjlSTHf+7EXSUuFV7S57vDdYyu5AhE5iJ2dJl03zo/Bc62yM RgWGPpLSTFBjo8102VQIACxfudcCNoV1pfPkTxTyhe/rMv/VnWaMcLLrJZ0JRu7WZgrfHkBZ7p1eIv6LR t/nja93Fuc2M8Jl8B00DeQDNkyjnIN3gVS+0Hr8/ZIfClYa3huxfm8h1PeQHupaZ53UZKONLe7rRVVJGI A2IZwRkXcxk/2Z47qw1hUFvtXokQBbqOj1rDhL3Dh6pOsU9XbXTKGXzmcs0I6RXSB3DHbwQtsPK7neEyJ BbxS0IpiKxY7IZtF2+m+WXmjWQyg7ZIYK0/X96XkYA7W7rcEPjAAAAAAAA",
"userName" : "username" "password" : "password "
}

Sample base64 encoded CSR pdf data

IENTUkRBVEEgDQp7IA0KIjEwMDEiOiAiTUlJQ2NUQ0NBVmtDQVFBd0d6RVpNQmNHQTFVRUF4TVFUWFYwY kd4cFkzTnlRMlZ5ZEc5dVpUQ0NBU0l3RFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURDQ0FRb0NnZ0VCQU xCOEJ5UkhoWXVFVFNWRWthMkpTbDNRYjN3azQ1cWJOWmNuM0tKcE1jVkRpUVFEM09ISTIxK1JQZmNGYTd
FYUtlZDZLTHRHZm43YzJoZUgzRjdvOXlXWm5jYkEzOWRKMWI0Y0plRlUrRk1Gd1praUVXT05iNERFbjFC R2hvRGRua3BML0RGd3g5aGM2SnR3NEwwbURGN1FFVEN6MlZFdGdYWGdzMjlGQTdOYkhocHVKTlhWN1lEZ 2FuUW5SM3dEMSs2aEhENWlNUGxGSDFBYkFWSjUyQmRTNXdZaWxPamFhT0c5RUdQbnQrcTdFV0tsSTkxVT FQWURBRGVrUlQrOWpxcXFpaUNuTFllaXdGVWJTTzhYLzhjRVU4WUJGdUNxNUtuTDZtbFprQ01CbitOM0N rN1FyUURGVmxLa3lYNmtQSGNSdW9mejAranNqeFBGTllkaTVUY0NBd0VBQWFBUk1BOEdDU3FHU0liM0RR RUpEakVDTUFBd0RRWUpLb1pJaHZjTkFRRUxCUUFEZ2dFQkFFMkdBK01mMkdqNmxqZGxMVTNabkZ0ZjdEe mdzZkh6RmpNRFhTQjYzNnF1YVRaWjdvV2VjbEVRcG9ZRlQvTEJQVEh2Mm9zQ24xZ0tPaXBoK0NjdEhYNl dOQ2NZVEhlNlVibVdweHVjSktFYWJFL2tRZUdsV0N6bWRMc2tQVklZRnAvNDdNUWdSdUhIejJweWMzWWp pSzM0bDlVREszaEJnSjVDRXNqekhyOW5pSVFZQ2RNdU1xRGtJck4zOHBlSjl0R3dUSnpGWGpZaEZXemo0 SEVoVVh4L2RaamgwV1FCMm9ldk96ajFPa1UrUTJLSERTamRNdXlBYXhWaEdTalYrWExicUxrOHYzQlZUM G9hQnJiQmNISGdjbzYzN0RSM3J3Zno5azFvaG0zR1RzUnJaZlNJSDV2QXJ5Umppc3FtOE11a1IxOVZRUl VWcmdadmdIdGEwU0E9IiwgDQoiMTAwMiI6ICJNSUlDY0RDQ0FWZ0NBUUF3R2pFWU1CWUdBMVVFQXhNUGJ YVnNkR2xqYzNKalpYSjBWSGR2TUlJQklqQU5CZ2txaGtpRzl3MEJBUUVGQUFPQ0FROEFNSUlCQ2dLQ0FR
RUFyZzFWVXVadGpNZnN5Z2RPZ2JpeU5FSTFObnpVbEppMGtpYmZqd1ozelJ4dENTbjY5ZWZxdUtiQ1JqY WdQL1dYdUZyY1FTRHdqYzc0UDVsbkVySEJxdzQ5cjRMZTRHVjdxQThrbDVBc1h3dk5pc2owU3hYdUpxUW FlMEY3NmowSS9DOXhmUUNQdUlqY2lsMjBJNHlGc2dRVWRNNnJheUpPVG94YXo3dWJqRmlacGlmUy9oa2c 5MFVkMlFIMEdXS3VzSHdzcjUyYVFoMnYyNUtzeEFqQks2TDRjZjd0STNpbGVuRjU0WmtieWh1MDhpc0Zs WkpuZ0hKR09yek1MQTc2SDk4b2RFemJzVzcvNEJjS0RwaCtkdVJzOTdITHQyODV2d2wyU05HUTh3cW1jc lVBMG9hUWViZ1BkczhvZHZKRDZBOXdqWDVJUXJocWsrWmJYWkhPK1FJREFRQUJvQkV3RHdZSktvWklodm NOQVFrT01RSXdBREFOQmdrcWhraUc5dzBCQVFzRkFBT0NBUUVBRW1yZDRyY3ZTTThTc0ZNNm9OTmlOd3B
3NHAyQmN5UU82SGNNSjBaV3gxcDRnUlNOWmtjZjlNWGtaVjF0Zndxa1dPbGxIUmVrMWdwMCtJUmJKS2lQ UlBiMTlCdjM1cWpSZ3Bob1hKT2RvS2w4WEQvRXNybXIwcUFvL2pObHFHQ2RRNmFsT1MycWpvVDQ0RUpPa 2htZlljbi9NWFRvQ2ZiS2plbkRlUzd2YVVHRll1alcxbC80NnpNdlNEMERGRTdmU2lpYWRLV2Z1OXowUV Vtcy9ab0orUXgvTEwxNlB0WlZNd2lnbHA4VTI3Nkd3RzFhUGJGakl3N09JQWQxTjZwUDl2akg1RU9Eb3d QZVFEWURRdkVLaE5mbGNpd0FzRTlLOGNLYU41NTQ2LzRIUWxlM0loWFFHa05XZTZOR2lLdm54c0hPQTd6 RlhBem5BNnBqbS8wR1ZRPT0iLCANCiIxMDAzIjogIk1JSUJSRENCNndJQkFEQ0JpREVoTUI4R0NTcUdTS WIzRFFFSkFSWVNZVzUxY0M1clFHVnRkV1JvY21FdVkyOXRNUkl3RUFZRFZRUVVFd2sxTmpjNE9UQTBNek l4R0RBV0JnTlZCQWNURDAxaGVtRnlhU0JVWVd0b1lYbHBiREVQTUEwR0ExVUVBeE1HVG1scmFHbHNNUTB 3Q3dZRFZRUUlFd1JJWVdsc01SVXdFd1lEVlFRR0V3eFRZWFZrYVNCQmNtRmlhV0V3V1RBVEJnY3Foa2pP
UFFJQkJnZ3Foa2pPUFFNQkJ3TkNBQVJKZVZFVzliNGFVUTkvZjBac2ticlRYVHpwLy9ZUlFXOGlHdlNpc k0zRlRlVzRWd0ozUVJTMTZuYlJpQktnaGhxSklyb0U4bTliY2hYbURjd1ZrMk13b0FBd0NnWUlLb1pJem owRUF3SURTQUF3UlFJZ0lJd1dEMFpJbVBqTEVTS3VydGx1eEZBS0p4SE5KRmluVklkbHJ2QUt1a1lDSVF
DMWcvZFpXS3dRK21JUS9tZ0Jna2ROUUlrckcrQTdDYXJsRk9walNOM2J2QT09Ig0KfQ==
IENTUkRBVEEgDQp7IA0KIjEwMDEiOiAiTUlJQ2NUQ0NBVmtDQVFBd0d6RVpNQmNHQTFVRUF4TVFUWFYwY kd4cFkzTnlRMlZ5ZEc5dVpUQ0NBU0l3RFFZSktvWklodmNOQVFFQkJRQURnZ0VQQURDQ0FRb0NnZ0VCQU xCOEJ5UkhoWXVFVFNWRWthMkpTbDNRYjN3azQ1cWJOWmNuM0tKcE1jVkRpUVFEM09ISTIxK1JQZmNGYTd

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.

Header Details

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).

Sample Request Data

Header:
Content-Type : application/json
emKey	: 47b54594063957de22fce0aeddd51a6adf4a80aa
Request Body:
{
"requestData" : "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 UnzdTIA=="
"userName":"username"
 

Process

  • When request is received by emCA service, the request JSON Object will be decrypted with same AES key that is shared to the client.

  • After successful decryption, request JSON object (Signed CSR data + Username + Password+ Profile Id+ Application ID+ Subscriber ID+ Validity + Valid From) is retrieved.

  • First emCA service validates the username and password and verifies if the IP Address used for request and registered with the user are same.

  • If request is registered with the same user, then the system checks if the Certificate is already created for the requested applicationId.

  1. If certificate is already created for the applicationId, then return existing certificate.

  2. If certificate is not created for applicationId, then we create the certificate using next step.

  • If it is same then the 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)

Response Parameters

Parameter

Data Type

Description

response

String

Returns JSON Object

JSON Object Contains below parameters

Parameter

Data Type

Description

status

String

Returns Status of the request – “Success‟ if CSR is signed by selected certificate profile id and generates x509 certificate.

Returns status of the request – “Failure‟ when authentication fails or unregistered user tries to call the API

result

String

Returns

In case of success: base 64 encoded pdf data for x509 certificates data

In case of failure: Error message will be displayed.

subscriberId

String

Returns Subscriber Id

requestId

String

This is used in another API where “Is ManualAuthorization Enabled” is checked from emCA application. In this case one request ID will be generated that user has to provide to create certificate from another API.

OR

This is used in another API where “Is Manual Authorization Enabled” is checked from emCA application. In this case one application ID will be passed by user while user requests for certificate creation through another API.

Note: If there is more than one CSR, it will receive multiple request IDs that are separated by "~".

Example : ID1|requestId1~ID2|requestId2 etc.

ID in the above example reference to input csr id which is shown in signature parameter.

Response JSON Format

Sample:
Success:
Response Body(Is Manual Authorization Enabled is “not“ checked from
emCA)
{
"status":"success",
"result":"base 64 encoded pdf data of list x509 Certificate data",
“subscriberId”:”XXX”
"requestId": null
}

Response Body (Is Manual Authorization Enabled is checked from emCA )
{
"status": "Success",
"result": " your request proceded sucssusfully", "subscriberId": "XXXX",
"requestId": null
}
Failure:
{
"status":"failure", "result":"<Error message>" “subscriberId”:null "requestId": null
}

Sample for Base64 encoded PDF (list of x509 certificates Base64 encoded data)

“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 SL1R5cGUvUGFnZS9SZXNvdXJjZXM8PC9Qcm9jU2V0IFsvUERGIC9UZXh0IC9JbWFnZUIgL0ltYWdlQyAvS
W1hZ2VJXS9Gb250PDwvRjEgMSAwIFI+Pj4+L1BhcmVudCAzIDAgUi9NZWRpYUJveFswIDAgNTk1IDg0Ml0
+PgplbmRvYmoKNSAwIG9iago8PC9GaWx0ZXIvRmxhdGVEZWNvZGUvTGVuZ3RoIDYyNT4+c3RyZWFtCnicb ZLNjqJAFIX3PoXLnpCJFNAgi1lUQYHIjyAUgjsFC6RFLUBLTebdx+nVTMLu5uTc79ycXDZByURWp3NRnSb lRJz+BPO/w8wCUyBNEzr5MF57kZg96A92q3yBMhuqFWKlUS4oDDON4SJsHS4QQgnqETmfcwt4Z3R0iRpcL 8pejHLhIKtd/yNp3gHifzkf65yRRk4Tolc+DNS1FWrSijHmOm4x1KoH0/XgaA86e/B18qjwRnG7L1bc2S5 tI4fbVJELNxmMAfqj/HRDWLKkLJqXD1utZ2Girp4hnhNQS94p4I4JI4gu4MI3JlyiKkgXax/DBkIf9jYEp DR5NErGkDuLyoT0eyn2sW3CTYXWmD56gQLcGHzfH47ZCuTbW58zsGhg+e2NFGxVEbGJtjh0o2z51DWZrDw Cg5q6UkN+sEKHm1G+dC9bp74XAYywhyJoVhVG0Mh28QBjD6cluumFfFp4pS6BZSeMny5xUxUQdBsYXoUjZ vouuqDsFuPwqQxs7dJhIc1EFAQpMVnaN9pp2RrwOQviJ9nrpmXHKdgU+iCxUXxc0cJw2PYuPMVdes6vt8/ HuWmzSC585ylTuS2GMz4nXMCt76e7boc6dlZB+EqGo2LaBss1gHCKcjDKf0nS6bqnva0YhxCE3l2YE+bGS LlD/Yq3c97K72rF4Uuq9oqBO8v/PF7uAhDbrPWXWSQdPTdBBFA+il9d5a+a9ajWu9VK1ekyeH3G+avJ3Qu Vn7Jm8yV+zMy61U7dcd8o3kG9vXzdPGmhdXDf3Pm7Sn4Nu3ioOnE2/pa7rkBZtvVSIvNfo5bpqPr7HxUnk 2jyB4ZOGH4KZW5kc3RyZWFtCmVuZG9iago2IDAgb2JqCjw8L0NvbnRlbnRzIDUgMCBSL1R5cGUvUGFnZS9 SZXNvdXJjZXM8PC9Qcm9jU2V0IFsvUERGIC9UZXh0IC9JbWFnZUIgL0ltYWdlQyAvSW1hZ2VJXS9Gb250P
DwvRjEgMSAwIFI+Pj4+L1BhcmVudCAzIDAgUi9NZWRpYUJveFswIDAgNTk1IDg0Ml0+PgplbmRvYmoKMSA wIG9iago8PC9TdWJ0eXBlL1R5cGUxL1R5cGUvRm9udC9CYXNlRm9udC9IZWx2ZXRpY2EvRW5jb2RpbmcvV 2luQW5zaUVuY29kaW5nPj4KZW5kb2JqCjMgMCBvYmoKPDwvS2lkc1s0IDAgUiA2IDAgUl0vVHlwZS9QYWd lcy9Db3VudCAyL0lUWFQoNS4wLjYpPj4KZW5kb2JqCjcgMCBvYmoKPDwvVHlwZS9DYXRhbG9nL1BhZ2VzI DMgMCBSPj4KZW5kb2JqCjggMCBvYmoKPDwvTW9kRGF0ZShEOjIwMjEwOTE0MTEwMDMyKzA1JzMwJykvQ3J
lYXRpb25EYXRlKEQ6MjAyMTA5MTQxMTAwMzIrMDUnMzAnKS9Qcm9kdWNlcihpVGV4dCA1LjAuNiBcKGNcK SAxVDNYVCBCVkJBKT4+CmVuZG9iagp4cmVmCjAgOQowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDI4MjY gMDAwMDAgbiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAyOTE0IDAwMDAwIG4gCjAwMDAwMDE4MjAgM DAwMDAgbiAKMDAwMDAwMTk3NyAwMDAwMCBuIAowMDAwMDAyNjY5IDAwMDAwIG4gCjAwMDAwMDI5ODMgMDA
wMDAgbiAKMDAwMDAwMzAyOCAwMDAwMCBuIAp0cmFpbGVyCjw8L0luZm8gOCAwIFIvSUQgWzxiNTNhNzQ0O DU4NjU0YmFlZjk2ZjY2ZDdhMjUzN2Q1OT48NTU3OWNkODE5OWQzMmIxNTUwZGQwMGVjYzZlNWQ2MjY+XS9 Sb290IDcgMCBSL1NpemUgOT4+CnN0YXJ0eHJlZgozMTU4CiUlRU9GCg==”
 

Error Messages

Error Message

Description

<profile id> 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

Last updated