Créer un certificat | Goodflag Docs

curl -X POST https://lp7signbox.example.com/LP7SignBox/pki/createCertificate \
     -H "Content-Type: application/json" \
     -d '{
  "certificationRequestInfo": {
    "signatureActivationProtocol": "OTP",
    "validityPeriod": 60,
    "transactionId": "tx-7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "PKCS10": {
      "attributes": {
        "subscriber": {
          "emailAddress": "marie.dupont@example.com",
          "phoneNumber": "+33612345678"
        },
        "extensionRequest": {
          "subjectAlternativeName": {
            "generalName": [
              {
                "RFC822Name": "marie.dupont@example.com"
              }
            ]
          }
        }
      },
      "subject": {
        "country": "FR",
        "commonName": "Marie Dupont",
        "organizationName": "Goodflag",
        "givenName": "Marie",
        "serialNumber": "tx-7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "surName": "Dupont"
      }
    }
  },
  "certificateFormat": "PKCS_7_WITH_CHAIN",
  "requestID": "cert-2026-09-11-0001",
  "signerData": {
    "digest": [
      {
        "id": "contract",
        "digestAlgOID": "2.16.840.1.101.3.4.2.1",
        "digestValue": "n4bQgYhMfWWaL+qgxVrQFaO/TxsrC4Is0V1sFbDwCgg="
      }
    ]
  }
}'

{
  "keyReference": {
    "reference": "8F2A61C0D94B7E3A55F1C2D8B6A0E9F4C3D2B1A0",
    "authToken": "eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiI4RjJBNjFDMCJ9.QmxhY2tzdG9uZQ",
    "password": "482913",
    "transactionId": "tx-7c9e6679-7425-40de-944b-e07fc1f90ae7"
  },
  "certificate": "MIIFkzCCA3ugAwIBAgIIZ8p6L2Q5TmEwDQYJKoZIhvcNAQELBQAwYzELMAkGA1UEBhMCRlIxFDASBgNVBAoMC0xleCBQZXJzb25hMRcwFQYDVQQLDA4wMDAyIDQ4MDYyMjI1NzElMCMGA1UEAwwcU3VubnlzdGFtcCBOYXR1cmFsIFBlcnNvbnMgQ0E=",
  "requestID": "cert-2026-09-11-0001",
  "result": {
    "minorCode": 0,
    "majorCode": 0,
    "message": "OK"
  },
  "name": "CN=Marie Dupont,GN=Marie,SN=Dupont,O=Goodflag,C=FR",
  "certificateFormat": "PKCS_7_WITH_CHAIN"
}

Crée une clé sur le serveur et émet son certificat pour une transaction de signature. Le sujet est soit dérivé d’un JSON Web Token, soit fourni explicitement. Retourne la référence de clé à utiliser dans les opérations de signature et le certificat émis.

Authentification : TLS mutuel (certificat client).

Requête

This endpoint expects an object.

certificationRequestInfoobjectRequis

Les informations utilisées pour construire le certificat.

certificateFormatenumRequis

Le format du certificat émis.

requestIDstringOptionnel

L’identifiant de la requête, choisi par l’appelant. Renvoyé tel quel dans la réponse.

signerDataobjectOptionnel

Les empreintes des documents à signer avec la clé : les données d’activation de signature (SAD) liées à la clé.

Réponse

L’opération a été traitée. Le résultat est donné par le champ result, renseigné aussi lorsque l’opération a échoué pour une raison métier.

keyReferenceobjectOptionnel

La référence de la clé créée, à utiliser dans les opérations sign et checkKey.

certificatestringOptionnel

Le certificat émis, encodé en base64, dans le format demandé.

requestIDstringOptionnel

L’identifiant de la requête, choisi par l’appelant. Renvoyé tel quel dans la réponse.

resultobjectOptionnel

Les codes et le message de retour du serveur.

namestringOptionnel

Le nom distinctif (DN) du certificat émis.

certificateFormatenumOptionnel

Le format du certificat émis.

Erreurs

400

Bad Request Error