Ordina GeoTrust DV SSL

POST
https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex

Usa questo endpoint per richiedere un certificato GeoTrust DV SSL.

Questo certificato GeoTrust DV SSL più flessibile consente di ricevere più facilmente il certificato GeoTrust DV per adattarsi alle tue esigenze. Questo certificato sostituisce i prodotti GeoTrust Standard DV, GeoTrust Cloud DV e GeoTrust Wildcard DV.

cURL
curl -X POST \
  'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex' \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}' \
  -d '{
    "certificate": {
        "common_name": "example.com",
        "dns_names": [
        	"sub.example.com",
        	"log.example.com"
        ],
        "csr": "<csr>",
        "server_platform": {
            "id": 2
        }
    },
    "custom_expiration_date": "",
    "comments": "Message for the approver.",
    "container": {
        "id": 69748
    },
    "custom_renewal_message": "Renew me.",
    "skip_approval": true,
    "disable_ct": 0,
    "validity_years": 1,
    "custom_fields": [
        {
            "metadata_id": 12,
            "value": "Invoice #12345"
        }
    ],
    "payment_method": "balance",
    "dcv_method": "email",
    "dcv_emails": [
    	{
    		"dns_name": "example.com",
    		"email_domain": "example.com",
    		"email": "admin@example.com"
    	},
    	{
    		"dns_name": "sub.example.com",
    		"email_domain": "example.com",
    		"email": "jim.smith@example.com"
    	},
    	{
    		"dns_name": "log.example.com",
    		"email_domain": "example.com",
    		"email": "it@example.com"
    	}
    ],
    "locale": "en",
    "technical_contact": {
        "first_name": "Jim",
        "last_name": "Smith",
        "telephone": "555-555-5555",
        "job_title": "IT Admin",
        "email": "jim.smith@example.com"
    }
}'
Python
import requests

url = "https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex"

payload = "{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\n    }\n}"
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("POST", url, data=payload, headers=headers)

print(response.text)
Go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex"

	payload := strings.NewReader("{\n    \"certificate\": {\n        \"common_name\": \"example.com\",\n        \"dns_names\": [\n        \t\"sub.example.com\",\n        \t\"log.example.com\"\n        ],\n        \"csr\": \"<csr>\",\n        \"server_platform\": {\n            \"id\": 2\n        }\n    },\n    \"custom_expiration_date\": \"\",\n    \"comments\": \"Message for the approver.\",\n    \"container\": {\n        \"id\": 69748\n    },\n    \"custom_renewal_message\": \"Renew me.\",\n    \"skip_approval\": true,\n    \"disable_ct\": 0,\n    \"validity_years\": 1,\n    \"custom_fields\": [\n        {\n            \"metadata_id\": 12,\n            \"value\": \"Invoice #12345\"\n        }\n    ],\n    \"payment_method\": \"balance\",\n    \"dcv_method\": \"email\",\n    \"dcv_emails\": [\n    \t{\n    \t\t\"dns_name\": \"example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"admin@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"sub.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"jim.smith@example.com\"\n    \t},\n    \t{\n    \t\t\"dns_name\": \"log.example.com\",\n    \t\t\"email_domain\": \"example.com\",\n    \t\t\"email\": \"it@example.com\"\n    \t}\n    ],\n    \"locale\": \"en\",\n    \"technical_contact\": {\n        \"first_name\": \"Jim\",\n        \"last_name\": \"Smith\",\n        \"telephone\": \"555-555-5555\",\n        \"job_title\": \"IT Admin\",\n        \"email\": \"jim.smith@example.com\"\n    }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
NodeJS
var request = require("request");

var options = { method: 'POST',
  url: 'https://www.digicert.com/services/v2/order/certificate/ssl_dv_geotrust_flex',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' },
  body: 
   { certificate: 
      { common_name: 'example.com',
        dns_names: [ 'sub.example.com', 'log.example.com' ],
        csr: '<csr>',
        server_platform: { id: 2 } },
     custom_expiration_date: '',
     comments: 'Message for the approver.',
     container: { id: 69748 },
     custom_renewal_message: 'Renew me.',
     skip_approval: true,
     disable_ct: 0,
     validity_years: 1,
     custom_fields: [ { metadata_id: 12, value: 'Invoice #12345' } ],
     payment_method: 'balance',
     dcv_method: 'email',
     dcv_emails: 
      [ { dns_name: 'example.com',
          email_domain: 'example.com',
          email: 'admin@example.com' },
        { dns_name: 'sub.example.com',
          email_domain: 'example.com',
          email: 'jim.smith@example.com' },
        { dns_name: 'log.example.com',
          email_domain: 'example.com',
          email: 'it@example.com' } ],
     locale: 'en',
     technical_contact: 
      { first_name: 'Jim',
        last_name: 'Smith',
        telephone: '555-555-5555',
        job_title: 'IT Admin',
        email: 'jim.smith@example.com' } },
  json: true };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
201 201 Created (email)
{
  "id": 6484932,
  "certificate_id": 6079436
}
201 201 Created (dns-txt-toke or http-token)
{
  "id": 6484932,
  "certificate_id": 6079436
  "dcv_random_value": "icru1984rnekfj"
}

Parametri richiesta

Per informazioni sui valori consentiti per i campi del certificato, consulta Certificati pubblici – Dati inseriti che violano gli standard di settore.

Nome Rich/Opz Tipo Descrizione
certificate obbligatorio object Dettagli certificato.
.. common_name obbligatorio string Dominio da proteggere.
.. dns_names facoltativo array Altri domini da proteggere.
Può prevedere costi aggiuntivi. (Consulta  Best practice — Richiedi gratuitamente entrambe le versioni di un dominio.)
.. csr obbligatorio* string Richiesta di firma certificato (CSR).
.. organization_units facoltativo array Reparto dell’organizzazione a cui è rivolto il certificato.
.. server_platform facoltativo object Tipo di piattaforma server.
Impostazione predefinita: -1 (altro)
.. .. id obbligatorio int ID piattaforma server.
Consulta  Glossario — Piatteforme server.
renewed_thumbprint facoltativo string Se un ordine prevede un rinnovo, inserisci l’identificazione personale SHA-1 del certificato primario dell’ordine precedente.
validity_years obbligatorio int Numero di anni in cui è valido il certificato.
Può essere sostituito da validity_days o custom_expiration_date.
Valori consentiti: 12.
validity_days facoltativo int Numero di giorni in cui il certificato è valido dopo l’emissione.
Sostituisce validity_years.
custom_expiration_date facoltativo string Data di scadenza personalizzata per il certificato.
La data deve essere inferiore a 825 giorni nel futuro.
Sostituisce validity_days e validity_years
Formato: yyyy-MM-dd
comments facoltativo string Commenti sull’ordine per l’approvatore.
auto_renew facoltativo int Specifica se il certificato deve rinnovarsi automaticamente.
Impostazione predefinita: 0
Valori consentiti: 0 (disabilitato), 1 (abilitato)
custom_renewal_message facoltativo string Messaggio personalizzato da includere nelle notifiche di rinnovo.
disable_renewal_notifications facoltativo bool Specifica se le e-mail di notifica rinnovo devono essere disabilitate.
Impostazione predefinita: false
additional_emails facoltativo array Altri indirizzi e-mail per ricevere e-mail di notifica certificato (ad es. emissione del certificato, certificato duplicato, rinnovi certificato, ecc.).
renewal_of_order_id facoltativo int Se un ordine prevede un rinnovo, inserisci l’ID dell’ordine precedente.
payment_method facoltativo string Specifica il metodo di pagamento da usare.
Valori consentiti: balancecardprofile
Impostazione predefinita: balance
dcv_method obbligatorio string Metodo DCV da usare quando si verifica il controllo dominio.
Consulta  Glossario — Metodi DCV.
dcv_emails facoltativo array Elenco che specifica l’ambito e-mail quando si inviano delle e-mail DCV.
Puoi aggiungere una voce per ciascun nome DNS che viene protetto dal certificato.
.. dns_name obbligatorio string Nome DNS riportato sul certificato a cui si applica questo ambito.
.. email_domain obbligatorio string Record di dominio WHOIS da usare per verificare gli indirizzi e-mail.
Questo valore  deve  corrispondere al dominio base  dns_names .
.. email facoltativo string Indirizzi e-mail da usare quando si inviano delle e-mail DCV.
Questo indirizzo e-mail  deve  comparire sul record WHOIS per il dominio specificato nel parametro  email_domain .
locale facoltativo string Lingua che l’e-mail DCV deve usare.
Consulta  Glossario — Codici luogo.
skip_approval facoltativo bool Specifica se l’ordine deve saltare la fase di approvazione ed essere inviato immediatamente per la convalida ed emesso se completato.
Impostazione predefinita: false
disable_ct facoltativo bool Specifica se la registrazione CT per il certificato deve essere disabilitata.
La registrazione CT specifica dell’ordine deve essere abilitata oppure verrà ignorata.
Consulta  Consenti agli utenti di conservare i certificati fuori dai registri CT.
Impostazione predefinita: false
container facoltativo object Se necessario, specificare il contenitore in cui deve essere posizionato l’ordine.
.. id obbligatorio int ID contenitore.
custom_fields facoltativo* array Campi personalizzati specifici dell’account.
*L’obbligatorietà di questi campi dipende dalle impostazioni dei campi personalizzati.
.. metadata_id obbligatorio int ID campo personalizzato.
.. value obbligatorio string Valore per il campo personalizzato.
Il tipo di convalida dati dipende dalle impostazioni dei campi personalizzati.
technical_contact facoltativo object Dettagli contatto tecnico.
.. first_name obbligatorio string
.. last_name obbligatorio string
.. telephone obbligatorio string
.. job_title facoltativo string
.. email obbligatorio string

Parametri di risposta

Nome Tipo Descrizione
id int ID ordine.
certificate_id int ID certificato.
dcv_random_value string Valore casuale usato per il controllo dominio convalida.
Riportato solo quando si usa dns-txt-token o http-token  come metodo DCV.