SSL Certificates Quick Start This document describes the steps you need to use to purchase and use SSL certificaters with the enom API.
Copyright 2014 enom, Inc. No portion of this document may be copied, modified, reproduced, or distributed without the express written permission of enom Inc.. enom SSL Certificates Quick Start - v1.0 Last modified: October, 2014 - ii -
Contents Overview 1 Step 1 - Purchase 2 Real-time 2 Shopping cart 2 Step 2 - Configure 3 Get a certificate list and detail 3 Prepare CSR 3 Configure certificate 4 Step 3 - Submit 7 Post-Issuance Commands 8 - iii -
Overview This document is designed to provide resellers with a step-by-step guide about the processes for purchasing, configuring and submitting SSL to the Certificate Authority, including actions or commands to maintain post-issuance SSL. - 1 -
Step 1 - Purchase Purchase Certificate in our system. Use PurchaseServices command or combination of AddToCart and InsertNewOrder command. Real-time PurchaseServices Command=PurchaseServices&UID=ResellID &PW=resellpw&ProductType=Certificate-RapidSSL-RapidSSL &Quantity=1&EndUserIP=123.123.123.123&ResponseType=XML Shopping cart AddToCart Command=AddToCart&UID=ResellID&PW=resellpw &ProductType=Certificate-RapidSSL-RapidSSL&Quantity=1 &EndUserIP=123.123.123.123&ResponseType=XML InsertNewOrder Command=InsertNewOrder&UID=ResellID&PW=resellpw &EndUserIP=123.123.123.123&ResponseType=XML - 2 -
Step 2 - Configure Configure a new or non-submitted Certificate in our system. Get a certificate list and detail CertGetCerts - retrieve a list of certificate for this login ID. Command=CertGetCerts&UID=ResellID&PW=resellpw &EndUserIP=123.123.123.123&ResponseType=XML CertGetCertDetail - retrieve configuration information on a specific certificate. Command=CertGetCertDetail&UID=ResellID&PW=resellpw &EndUserIP=123.123.123.123&ResponseType=XML&CertID=1234 Prepare CSR CertParseCSR - determine CSR (Certificate Signing Request) of the domain name and other information associated with this cert. Command=CertParseCSR&UID=ResellID&PW=resellpw &EndUserIP=123.123.123.123&ResponseType=XML&CSR=%2D %2D%2D%2D%2DBEGIN+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D %2D%0D%0AMIIEQzCCAysCAQAwYzEVMBMGA1UEAxMMYnVkaXRlc3Qu Y29tMQ4wDAYDVQQLEwVB%0D%0AZG1pbjENMAsGA1UEChME ZU5vbTERMA8GA1UEBxMIQmVsbGV2dWUxCzAJBgNVBAgT%0D %0AAldBMQswCQYDVQQGEwJVUzCCASIwDQYJKoZIhvcNAQEBBQ ADggEPADCCAQoCggEB%0D%0AAKZ7JqfRdGouYMXj84ex3zJxfL - 3 -
Step 2 - Configure thilr8sdnsekzwxt1ik6accx%2fro23jcrdxpretp%0d%0a9rx BUTjczSw3or9vDavtf0R16cddExKPL0AAOJup%2FtggQoD 8G380O1TVvt3vULW9%0D%0A9iZfwdBvcG8ia6OJUmea%2F Ot9M9c44ktXh5vlNXUzWvFeRNqbWJzL6HmlHO5SRV48%0D%0A wuvwlo5f12ileolhyif10u09k7fpc%2blitymck2gqvnzhp75r4c kwsajo9davo4bwq%0d%0ahttz89y%2btcdhxjyj8r7%2fhccoen waym9wtgnvanmz2%2baorveoavizi2%2b5le0dimrcz%0d%0aws 3lRrkZcl%2B4c6wzzuP5N7ECAwEAAaCCAZkwGgYKKwYBBA GCNw0CAzEMFgo1LjEu%0D%0AMjYwMC4yMHsGCisGAQQBgjcCA Q4xbTBrMA4GA1UdDwEB%2FwQEAwIE8DBEBgkqhkiG%0D%0A9w0B CQ8ENzA1MA4GCCqGSIb3DQMCAgIAgDAOBggqhkiG9w0DBAIC AIAwBwYFKw4D%0D%0AAgbcwCgYIKoZIhvcNAwcwEwYDVR0lBAwwCg YIKwYBBQUHAwEwgf0GCisGAQQBgjcN%0D%0AAgIxge4wgesCAQEe WgBNAGkAYwByAG8AcwBvAGdYAdAAgAFIAUwBBACAAUwBDAGgA%0D %0AYQBuAG4AZQBsACAAQwByAHkAgcAB0AG8AZwByAGEAcABoAGkA YwAgAFAAcgBvAHYA%0D%0AaQBkAGUAcgOBiQBsgjVOseKzhp %2FD7Bsutkg5h7VuhqBfdA3Ic2PiSmS1HIGAgW3p%0D%0Aah 9DWdcrpNeakCbb8CZjbT%2BH5rUZnX%2B%2BfsQTMdw1B%2BO8e hjkfvjtkxo8fwzk8yzn%0d%0a%2f92wuvhfsjjyqfcjxn09bpcx GhiNQoG%2BLshEmd9tZulAohlLB5uUQo3UhgAAAAAA%0D%0AAAA AMA0GCSqGSIb3DQEBBQUAA4IBAQAcbhPLccV9JZGwfeh0%2F qsrmvbsyftrhsoj%0d%0apbuhi8hkk0imehllmebckkqngj3 tu%2f8wetwkimso0cmgifcqk9z3tshks2ybgabh%0d%0azce31d 8hA0R9bKt14rLVBhy7xGbXEADUg1uE%2B6oGO9EgZvZ2jB0Ju MT1GOBTZN8d%0D%0AfDFfB1hSS4suiBZNkoHGs9q0%2FyfqQnr d5gowpfsebu7x4uynjue15%2bvxybocfw6p%0d%0ammixsxw7mo Vk2f2yMaFTarTJnR39cbOja5DHibfjfjir9YLz75SW4WnMc9 9BgZMa%0D%0AYzkqGyC4J64Y5cSexT11J8NpZ5%2FZ9t0HJGZc 9F4Rj4%2BmMLFz4SAJ%0D%0A%2D%2D%2D%2D%2D END+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D &CertID=1234 Configure certificate CertConfigureCert - add/update all necesary information required for a specific certificate. Command=CertConfigureCert&AdminAddress1=AdminAddress1 &AdminAddress2=&AdminCity=AdminCity&AdminCountry=US& AdminEmailAddress=mine@email.com&AdminFName=AdminFName &AdminJobTitle=&AdminLName=AdminLName &AdminOrgName=AdminOrg&AdminPhone=+1.1234567890 &AdminPostalCode=98003&AdminProvince=&AdminState=WA - 4 -
Step 2 - Configure &AdminStateProvinceChoice=S&BillingAddress1=123456 &BillingAddress2=&BillingCity=Seattle&BillingCountry=US &BillingEmailAddress=mine@email.com&BillingFName=BillingFNa me &BillingJobTitle=&BillingLName=BillingLName &BillingOrgName=BillingOrg&BillingPhone=+1.1234567890 &BillingPostalCode=98005&BillingProvince=&BillingState=WA &BillingStateProvinceChoice=S&CSR=%2D%2D%2D%2D%2D BEGIN+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D%0D%0AMIIE QzCCAysCAQAwYzEVMBMGA1UEAxMMYnVkaXRlc3QuY29tMQ4w DAYDVQQLEwVB%0D%0AZG1pbjENMAsGA1UEChMEZU5vbTERMA8GA 1UEBxMIQmVsbGV2dWUxCzAJBgNVBAgT%0D%0AAldBMQswCQYDV QQGEwJVUzCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCgg EB%0D%0AAKZ7JqfRdGouYMXj84ex3zJxfLthIlr8sdnsekZwxt1 Ik6accx%2FRO23jCrDXpREtP%0D%0A9rxBUTjczSw3or9vDav tf0r16cddexkpl0aaojup%2ftggqod8g380o1tvvt3vulw9%0d%0a 9iZfwdBvcG8ia6OJUmea%2FOt9M9c44ktXh5vlNXUzWvFeRNqbWJz L6HmlHO5SRV48%0D%0AwUVwlo5f12IleOlhYIf10U09K7 fpc%2blitymck2gqvnzhp75r4ckwsajo9davo4bwq%0d%0ahttz89y %2BtcDHXJYJ8R7%2FHcCoEnwaYm9WtgnVAnMZ2%2BaOrVEoavIzi2 %2B5LE0dIMrCz%0D%0Aws3lRrkZcl%2B4c6wzzuP5N7ECAwEA AaCCAZkwGgYKKwYBBAGCNw0CAzEMFgo1LjEu%0D%0AMjYwMC4 ymhsgcisgaqqbgjccaq4xbtbrma4ga1uddweb%2fwqeawie8dbebg kqhkig%0d%0a9w0bcq8enza1ma4gccqgsib3dqmcagiagdaobggqh kig9w0dbaicaiawbwyfkw4d%0d%0aagbcwcgyikozihvcn AwcwEwYDVR0lBAwwCgYIKwYBBQUHAwEwgf0GCisGAQQBgjcN%0D %0AAgIxge4wgesCAQEeWgBNAGkAYwByAG8AcwBvAGdYAdAAgAFIAU wbbacaauwbdagga%0d%0ayqbuag4azqbsacaaqwbyahkagcab0ag 8AZwByAGEAcABoAGkAYwAgAFAAcgBvAHYA%0D%0AaQBkAGUAcgO BiQBsgjVOseKzhp%2FD7Bsutkg5h7VuhqBfdA3Ic2PiSmS1H IGAgW3p%0D%0Aah9DWdcrpNeakCbb8CZjbT%2BH5rUZnX%2B%2BfsQTM dw1b%2bo8ehjkfvjtkxo8fwzk8yzn%0d%0a%2f92wuvhfsjjyqfcj xn09bpcxghinqog%2blshemd9tzulaohllb5uuqo3uhgaaaaaa%0d %0AAAAAMA0GCSqGSIb3DQEBBQUAA4IBAQAcbhPLccV9JZGw feh0%2fqsrmvbsyftrhsoj%0d%0apbuhi8hkk0imehllmebckk qngj3tu%2f8wetwkimso0cmgifcqk9z3tshks2ybgabh%0d%0az ce31d8ha0r9bkt14rlvbhy7xgbxeadug1ue%2b6ogo9egzvz2jb0 JuMT1GOBTZN8d%0D%0AfDFfB1hSS4suiBZNkoHGs9q0%2FyfqQnrd 5goWpfsebu7X4UyNjUE15%2BVxYbOcFW6P%0D%0AMmIXSxw 7MoVk2f2yMaFTarTJnR39cbOja5DHibfjfjir9YLz75SW 4WnMc99BgZMa%0D%0AYzkqGyC4J64Y5cSexT11J8NpZ5%2FZ9t 0HJGZc9F4Rj4%2BmMLFz4SAJ%0D%0A%2D%2D%2D%2D%2D END+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D&CertID=1234 &PW=resellpw&ResponseType=XML&TechAddress1=TechAddress1 &TechAddress2=&TechCity=TechCity&TechCountry=US - 5 -
Step 2 - Configure &TechEmailAddress=mine@email.com&TechFName=TechFName &TechJobTitle=&TechLName=TechLName&TechOrgName=TechOrg &TechPhone=+1.123456789&TechPostalCode=98004 &TechProvince=&TechState=WA&TechStateProvinceChoice=S &UID=ResellID&WebServerType=13-6 -
Step 3 - Submit Send configured certificate to the Certificate Authority. CertGetApproverEmail - retrieve the email addresses of qualified approvers for the domain name embedded in a CSR. Command=CertGetApproverEmail&UID=ResellID&PW=resellpw &ResponseType=XML&EndUserIP=123.123.123.123 &Domain=mydomain.com&CertID=1234 CertPurchaseCert - send the cert configuration to its Certificate Authority for final approval and issuance. command=certpurchasecert&uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP=123.123.123.123 &CertID=1234&ApproverEmail=admin@mydomain.com &CSROrganization=MyOrganization&CSROrganizationUnit=Dev &CSRAddress1=1st+Ave&CSRAddress2=Unit+A &CSRLocality=Kirkland&CSRStateProvince=WA &CSRPostalCode=98000&CSRCountry=US - 7 -
Post-Issuance Commands Additional support commands for issued certificate. Commands with asterisk (*) are exclusive for Symantec, Verisign and GeoTrust products. CertModifyOrder - cancel a certificate configuration order while the status is in 'Approval Email Sent' or 'Processing'. Command=CertModifyOrder&UID=ResellID&PW=resellpw &ResponseType=XML&EndUserIP=123.123.123.123& CertID=1234 CertChangeApproverEmail* - change approver email for a GeoTrust certificate. command=certchangeapproveremail&uid=resellid &PW=resellpw&ResponseType=XML&EndUserIP=123.123.123.123 &CertID=1234&ApproverEmail=webmaster@mydomain.com CertResendApproverEmail* - resend approver email for a GeoTrust certificate. command=certresendapproveremail&uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP=123.123.123.123&CertID=1234 CertResendFulfillmentEmail* - resend fulfillment email of an issued certificate to the approver email. command=certresendfulfillmentemail&uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP=123.123.123.123&CertID=1234-8 -
Post-Issuance Commands CertReissueCert* - reissue an existing GeoTrust certificate. command=certreissuecert&uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP=123.123.123.123&CertID=1234 &CSR=%2D%2D%2D%2D%2DBEGIN+NEW+CERTIFICATE+REQUEST %2D%2D%2D%2D%2D%0D%0AMIIEQzCCAysCAQAwYzEVMBMGA1UEA xmmynvkaxrlc3quy29tmq4wdaydvqqlewvb%0d%0azg1pbjenma sga1uechmezu5vbterma8ga1uebxmiqmvsbgv2dwuxczajbgnvb AgT%0D%0AAldBMQswCQYDVQQGEwJVUzCCASIwDQYJKoZIhvcNAQE BBQADggEPADCCAQoCggEB%0D%0AAKZ7JqfRdGouYMXj84ex3zJxf LthIlr8sdnsekZwxt1Ik6accx%2FRO23jCrDXpREtP%0D%0A9r xbutjczsw3or9vdavtf0r16cddexkpl0aaojup%2ftggqo D8G380O1TVvt3vULW9%0D%0A9iZfwdBvcG8ia6OJUmea%2FOt 9M9c44ktXh5vlNXUzWvFeRNqbWJzL6HmlHO5SRV48%0D%0AwUV wlo5f12ileolhyif10u09k7fpc%2blitymck2gqvnzhp75r4c kwsajo9davo4bwq%0d%0ahttz89y%2btcdhxjyj8r7%2fhccoen waym9wtgnvanmz2%2baorveoavizi2%2b5le0dimrcz%0d%0aws 3lRrkZcl%2B4c6wzzuP5N7ECAwEAAaCCAZkwGgYKKwYBBAGCNw0 CAzEMFgo1LjEu%0D%0AMjYwMC4yMHsGCisGAQQBgjcCAQ4xbTBr MA4GA1UdDwEB%2FwQEAwIE8DBEBgkqhkiG%0D%0A9w0BCQ8ENz A1MA4GCCqGSIb3DQMCAgIAgDAOBggqhkiG9w0DBAICAIAwBwY FKw4D%0D%0AAgbcwCgYIKoZIhvcNAwcwEwYDVR0lBAwwCgYI KwYBBQUHAwEwgf0GCisGAQQBgjcN%0D%0AAgIxge4wgesCAQE ewgbnagkaywbyag8acwbvagdyadaagafiauwbbacaauwbdag ga%0d%0ayqbuag4azqbsacaaqwbyahkagcab0ag8azwbyage AcABoAGkAYwAgAFAAcgBvAHYA%0D%0AaQBkAGUAcgOBiQBsgj VOseKzhp%2FD7Bsutkg5h7VuhqBfdA3Ic2PiSmS1HIGAgW3p%0D %0Aah9DWdcrpNeakCbb8CZjbT%2BH5rUZnX%2B%2BfsQTMd w1b%2bo8ehjkfvjtkxo8fwzk8yzn%0d%0a%2f92wuvhfsjj yqfcjxn09bpcxghinqog%2blshemd9tzulaohllb5uuqo3uh gaaaaaa%0d%0aaaaama0gcsqgsib3dqebbquaa4ibaqacbh PLccV9JZGwfeh0%2FqsrMvBsYFtrHSOj%0D%0APbUhi8HKK0 imehllmebckkqngj3tu%2f8wetwkimso0cmgifcqk9 z3tshks2ybgabh%0d%0azce31d8ha0r9bkt14rlvbhy7x GbXEADUg1uE%2B6oGO9EgZvZ2jB0JuMT1GOBTZN8d%0D%0 AfDFfB1hSS4suiBZNkoHGs9q0%2FyfqQnrd5goWpfsebu7X4 UyNjUE15%2BVxYbOcFW6P%0D%0AMmIXSxw7MoVk2f2yMaFT artjnr39cboja5dhibfjfjir9ylz75sw4wnmc99bgzma%0d%0 AYzkqGyC4J64Y5cSexT11J8NpZ5%2FZ9t0HJGZc9F4Rj4%2Bm MLFz4SAJ%0D%0A%2D%2D%2D%2D%2D END+NEW+CERTIFICATE+REQUEST%2D%2D%2D%2D%2D - 9 -