API Method -createPKCS12

Purpose

Use the “createPKCS12” method for creating the PFX certificate based on the profile selection.

Type of Method

POST

Request URL

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

Request Input Parameters

Sample JSON Object

Header:
Content-Type : application/json
Request JSON Data:

{
"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 "
"	profileName" : "Class2IndividualEncryption-Oneyear" " subscriberId " : "XXX"
"applicationId" : "XXX"
}
//parameter :- signature //
“CN=test~SERIALNUMBER=AVAPG4201A~E=test@emudhra.com~O=emudhra~S=KA~C=IN~PostalCod e=560103~KeyAlgorithmAndSize=RSA-2048~Password=1234”

Header Details

Sample Request Data

Header:

Request Body:
 
Content-Type : application/json
emKey	: 47b54594063957de22fce0aeddd51a6adf4a80aa


{
 
"requestData":"Q/5rvKIZvoMfuZQnysxcGawX4wC1xRttkCHEExreOwUCltgPG0FmsAbEmNHgHvdM2A 7Vadyks2IDACydZDRG9rS/uq93IO3KMAyazof7IJXz31c3LiXorwiRksUFOrH2IqYbqI1q88Sf3rnxoTd q8oaOzYB2LoNPh8dZihJyDIR33BccF1Dg/sS/UAwxJ3fjbPzRJpFcqhi2FX1IS8TxyW2PZtPyLtSddyDF xliryGv8RMmVem6NdJYeNHcYo82qHtszdepvIWCi/DLCqs1alR9TcOsKQ8skBTUQY5xfiuONm68zytXBl F+MIAB40Wsw/12zywoCe2z14wqA/mvzF6Jd/Cw3059NfW8FtmBS502ty4l+kSDallVUCSFP9b9Drsh4q/ giwT+zHa/SQ3LWCFkjDLaB/OMzMaZfAFwm27/mDB4mSWVMPzMo8CDBvNNNekeV6lSeKSJ7rEbR2JJYIeL zQFp++Dvnp0KZHZu5r+muXAPFCnsDj3MbLrpvbdl3VYKjtDCu0MXi/LX787pStPvr9coMmHTCwja5p7Rw I7Ji/nbOnVpT8f2ylx/Rq7vTFRGAqnFmEK5HAkN6Owdf/dKaKUtifXzJqgjYft0NS7uoXbEJWbb4I86Aq LhsPbqqN2zlOXZIaYLvkoleo//gAcevv6ZS3jk5rkhueR44ablyv5nhgQ25Fhg5cqu4hxUBOi1MRXk5Rp A6RZkaz+DPGSsJJ4+yKzTEnxhUZvnqzeFEf1cvIU3Fx9PLmvrQ50cE28AdNu749WOUyjq/eZCFC1rmY6K yThU4ng49S+iqCrUiIIF+McgjbuVPRvy0M9eYi9HpVOduV7XEI2zrRLpID0ueVwo/j6XePsofLvk/5J/x T9S8Ge6wgVNQzkO47eLi2VEPf5OXRopBaSLFZ1SPIgBVumlSnPgLfdNVOirJjhqMyADZrXgoAw3c+YTqR hsRDAhtPKx90Qtw643eLEi/1ujz9ZxB6yzTvFYnh05eaM+N08QVlEJcS+z84vqnY6/+8746T6Ct/tDrLd FCNVvveSEPVCujbE6LI6pzAnNuHWZoFYoDjANRTDuS8m3LY3mcC24cTJnNTt7a/hF6IsUj0ygfVctkpAT XvW9p1m4p6BpYmXFSP6w0nMvKnHd+Uy2R3qykk/1R6YoZbaG9dM3LrAqqAILkYNucL32xZCbSSKX6HIQt Z0WMAfTubYXLsDnAZCLeph1P+fjnkbgrpizkQg==",
"userName":"username"
}

Process

  • When request is received by 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 (Subject DN details, Key algorithm & Size, PFX password) + Username + Password + Profile Name + Subscriber ID + Application ID) is retrieved.

  • First the emCA service will validate username and password and check the IP Address used to make the request is registered with the same user

  • If request is registered with the same user, then we check if the certificate is already created for requested applicationId or not.

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

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

  • If it is same then (signature data) is validated by checking whether user info i.e. (Subject DN details, key algorithm & size, pfx password) is signed by same pfx 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.

Response Parameters

JSON Object Contains below parameters

Response JSON Format

Sample:
Success:
Response Body(Is Manual Authorization Enabled is “not“ checked from emCA)
{
"status":"success",
"result":" base 64 encoded PFX	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": “XXXX” 
}
Failure:
{
"status":"failure", "result":"<Error message>" “subscriberId”:null "requestId": null

}

Sample Base64 encoded PFX data

"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 0k7ILVQuwldPnGHT7Ko+lGDDK0="

Last updated