SSL Certificates Quick Start. This document describes the steps you need to use to purchase and use SSL certificaters with the enom API.

Transcription

1 SSL Certificates Quick Start This document describes the steps you need to use to purchase and use SSL certificaters with the enom API.

2 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, ii -

3 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 -

4 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

5 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= &ResponseType=XML Shopping cart AddToCart Command=AddToCart&UID=ResellID&PW=resellpw &ProductType=Certificate-RapidSSL-RapidSSL&Quantity=1 &EndUserIP= &ResponseType=XML InsertNewOrder Command=InsertNewOrder&UID=ResellID&PW=resellpw &EndUserIP= &ResponseType=XML - 2 -

6 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= &ResponseType=XML CertGetCertDetail - retrieve configuration information on a specific certificate. Command=CertGetCertDetail&UID=ResellID&PW=resellpw &EndUserIP= &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= &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 -

7 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& Admin Address=mine@ .com&AdminFName=AdminFName &AdminJobTitle=&AdminLName=AdminLName &AdminOrgName=AdminOrg&AdminPhone= &AdminPostalCode=98003&AdminProvince=&AdminState=WA - 4 -

8 Step 2 - Configure &AdminStateProvinceChoice=S&BillingAddress1= &BillingAddress2=&BillingCity=Seattle&BillingCountry=US &Billing Address=mine@ .com&BillingFName=BillingFNa me &BillingJobTitle=&BillingLName=BillingLName &BillingOrgName=BillingOrg&BillingPhone= &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 -

9 Step 2 - Configure &Tech Address=mine@ .com&TechFName=TechFName &TechJobTitle=&TechLName=TechLName&TechOrgName=TechOrg &TechPhone= &TechPostalCode=98004 &TechProvince=&TechState=WA&TechStateProvinceChoice=S &UID=ResellID&WebServerType=13-6 -

10 Step 3 - Submit Send configured certificate to the Certificate Authority. CertGetApprover - retrieve the addresses of qualified approvers for the domain name embedded in a CSR. Command=CertGetApprover &UID=ResellID&PW=resellpw &ResponseType=XML&EndUserIP= &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= &CertID=1234&Approver =admin@mydomain.com &CSROrganization=MyOrganization&CSROrganizationUnit=Dev &CSRAddress1=1st+Ave&CSRAddress2=Unit+A &CSRLocality=Kirkland&CSRStateProvince=WA &CSRPostalCode=98000&CSRCountry=US - 7 -

11 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 Sent' or 'Processing'. Command=CertModifyOrder&UID=ResellID&PW=resellpw &ResponseType=XML&EndUserIP= & CertID=1234 CertChangeApprover * - change approver for a GeoTrust certificate. command=certchangeapprover &uid=resellid &PW=resellpw&ResponseType=XML&EndUserIP= &CertID=1234&Approver =webmaster@mydomain.com CertResendApprover * - resend approver for a GeoTrust certificate. command=certresendapprover &uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP= &CertID=1234 CertResendFulfillment * - resend fulfillment of an issued certificate to the approver . command=certresendfulfillment &uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP= &CertID=

12 Post-Issuance Commands CertReissueCert* - reissue an existing GeoTrust certificate. command=certreissuecert&uid=resellid&pw=resellpw &ResponseType=XML&EndUserIP= &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 -