2.12 Remplacer les informations d'abonnement SSL

2.12.1 Informations sur l’API

Environnement de test
Environnement réel	https://portal.racent.com/ssl/replace
Méthode de requête	POST
content-type	multipart/form-data
Description	Cette interface est utilisée pour remplacer les informations d’abonnement SSL. Uniquement liée aux certificats SSL. Le remplacement des informations d’abonnement SSL n’est autorisé que lorsque l’état de l’abonnement SSL est « émis ».

2.12.2 Définition des paramètres

Nom du paramètre	Type de paramètre	Requis	Description
api_token	String	Y	Identifiant d’authentification. Pour générer un token, veuillez contacter le support technique de Racent.
certId	String	Y	ID de certificat Racent
refId	String	N	Numéro de commande unique fourni par le client
domainVerificationPic	File	N	Lorsque la méthode de validation de domaine est : VERIFY_DOCUMENT, cet élément est Y. Utilisé pour la validation du contrôle de domaine (DCV) (actuellement pris en charge uniquement par CFCA).
params	String	Y	Informations de remplacement, décrites en détail ci-dessous
csr	String	Y	Remarque : Le domaine dans les informations CSR doit être identique au domaine du CSR dans l’abonnement SSL d’origine.
uniqueValue	String	N	Uniquement lié aux produits Sectigo. 1 à 20 caractères (a-z A-Z 0-9) pour que le distributeur génère lui-même la valeur de vérification.
dcvMethod	String	N	Définir de manière unifiée la méthode de validation du domaine de la demande. Doit être l’une des quatre méthodes suivantes : EMAIL (validation par e-mail) HTTP_CSR_HASH (validation par fichier) CNAME_CSR_HASH (validation DNS) HTTPS_CSR_HASH (validation par fichier https) VERIFY_DOCUMENT (preuve de certificat de domaine, prise en charge uniquement par CFCA) Pour CFCA, cet élément est Y
domainInfo	String	Y	Informations sur le domaine. Exemple : [ { "dcvEmail": "admin@xxx.com", "dcvMethod": "EMAIL", "domainName": "www.xxx.com" }, { "dcvEmail": "admin@aaa.com", "dcvMethod": "EMAIL", "domainName": "aaa.com" }, "dcvEmail": "admin@racent.com", "dcvMethod": "EMAIL", "domainName": "racent.com" } ] Description détaillée comme suit :
dcvMethod	String	Y	Méthode de validation du contrôle de domaine (DCV). Doit être l’une des quatre méthodes suivantes : EMAIL (validation par e-mail) HTTP_CSR_HASH (validation par fichier) CNAME_CSR_HASH (validation DNS) HTTPS_CSR_HASH (validation par fichier HTTPS) Lorsque le dcvMethod de niveau supérieur n’existe pas, cet élément est Y. Lorsque le dcvMethod de niveau supérieur existe et que cet élément existe également, le dcvMethod de niveau supérieur est utilisé en priorité.
dcvEmail	String	N	E-mail de validation du contrôle de domaine (DCV). Lorsque cet élément est N, les valeurs par défaut sont les suivantes racent.com : admin@racent.com www.racent.com : admin@racent.com *.racent.com : admin@racent.com
domainName	String	Y	Domaine
organizationInfo	String	N	Lorsque vous devez modifier les informations de l’entreprise, ce paramètre est Y.
organizationCity	String	N	Ville où se trouve l’entreprise.
organizationName	String	N	Nom de l’entreprise.
organizationMobile	String	N	Téléphone de l’entreprise.
organizationAddress	String	N	Adresse de l’entreprise.
organizationCountry	String	N	Pays où se trouve l’entreprise (code à deux lettres conforme à la norme ISO 3166-1).
organizationPostCode	String	N	Code postal du lieu où se trouve l’entreprise.

Retour de la fonction

Nom du paramètre	Type du paramètre	Obligatoire	Description
code	Int	O	Statut de retour, voir l’annexe 3.1 pour plus de détails
errors	Objet ou chaîne	N	En cas d’erreur, contient le message d’erreur détaillé.
data	Objet	N	En cas de succès, ce paramètre est O. Description détaillée ci-dessous :
certId	Chaîne	N	ID de certificat Racent. À conserver précieusement, il s’agit de l’identifiant unique de l’instance Racent.
vendorId	Chaîne	N	Numéro de commande de l’autorité de certification (CA).
vendorCertId	Chaîne	N	Numéro de certificat de l’autorité de certification (CA).
DCVfileName	Chaîne	N	Nom du fichier pour la validation de contrôle de domaine (DCV)
DCVfileContent	Chaîne	N	Contenu du fichier pour la validation de contrôle de domaine (DCV)
DCVdnsHost	Chaîne	N	Valeur de l’hôte pour la validation DNS
DCVdnsValue	Chaîne	N	Valeur de l’enregistrement pour la validation DNS
DCVdnsType	Chaîne	N	Type d’enregistrement pour la validation DNS
DCVfilePath	Chaîne	N	Chemin du fichier pour la validation de contrôle de domaine (DCV)
dcvInfo	Object	N	Lorsque la valeur de vérification diffère pour chaque domaine lors de la demande de certificat, cette valeur est Y. Chaque élément est de type Object, et le nom de chaque objet correspond au domaine demandé, par exemple : racent.com. Le détail de chaque élément est le suivant :
DCVfileName	String	N	Contenu du fichier pour la validation par fichier
DCVfileContent	String	N	Contenu du fichier pour la validation par fichier
DCVdnsHost	String	N	Valeur de l’hôte pour la validation DNS
DCVdnsValue	String	N	Valeur de l’enregistrement pour la validation DNS
DCVdnsType	String	N	Type d’enregistrement pour la validation DNS
DCVfilePath	String	N	Chemin du fichier pour la validation par fichier