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 Name	Field Type	Card.	Description
certificateType	InstallCertificateUseEnumType	1..1	Required. Type of certificate sent.
certificate	string [0..5500]	1..1	Required. 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-----"
}

{
  "status": "Accepted"
}

Schema

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

Request schema (JSON Schema)

Response schema (JSON Schema)

Field Name	Field Type	Card.	Description
status	InstallCertificateStatusEnumType	1..1	Required. Whether installation succeeded.
statusInfo	StatusInfoType	0..1	Optional. Detailed status information.