Skip to content
Documentation Menu

Install Certificate

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.30 (Messages); Use Case M05 — Install CA certificate in a Charging Station (Functional Block M. ISO 15118 CertificateManagement)

Overview

The CSMS sends InstallCertificateRequest to install a root/CA certificate (V2G, MO, CSMS, or Manufacturer root) into the Charging Station's trust store.

NOTE (from spec): This message is not for installing a TLS client certificate in the Charging Station. The CertificateSignedRequest mechanism is used for that.

Sequence Diagram

CSMS  ──── InstallCertificateRequest ────▶  Charging Station
            (certificateType, certificate)
CSMS  ◀─── InstallCertificateResponse ────  Charging Station
            (status, statusInfo?)

Initiator

CSMS → Charging Station

Fields

Field NameField TypeCard.Description
certificateTypeInstallCertificateUseEnumType1..1Required. Type of certificate sent.
certificatestring [0..5500]1..1Required. PEM-encoded X.509 certificate.

InstallCertificateUseEnumType values

V2GRootCertificate, MORootCertificate, CSMSRootCertificate, ManufacturerRootCertificate.

InstallCertificateStatusEnumType values

Accepted, Rejected, Failed.

Examples

{
  "certificateType": "CSMSRootCertificate",
  "certificate": "-----BEGIN CERTIFICATE-----\nMIIE...\n-----END CERTIFICATE-----"
}

Schema

Source: schemas/InstallCertificateRequest.json, schemas/InstallCertificateResponse.json (OCPP 2.0.1 FINAL)

Request schema (JSON Schema)
Response schema (JSON Schema)