Get Installed Certificate Ids

Source: OCPP 2.0.1 Part 2 — Specification (Edition 2, 2022-12-15) — Section 1.22 (Messages); Use Case M03 — Retrieve list of available certificates from a Charging Station (Functional Block M. ISO 15118 CertificateManagement)

Overview

The CSMS sends GetInstalledCertificateIdsRequest to ask the Charging Station for an overview of installed certificates. Multiple certificate types can be requested in a single message; when certificateType is omitted, all types are returned.

OCPP 2.0.1 returns full certificate chains (certificateHashDataChain) — leaf + sub-CAs + root.

Sequence Diagram

CSMS  ──── GetInstalledCertificateIdsRequest ────▶  Charging Station
            (certificateType[]?)
CSMS  ◀─── GetInstalledCertificateIdsResponse ────  Charging Station
            (status, certificateHashDataChain[]?, statusInfo?)

Initiator

CSMS → Charging Station

Fields

GetCertificateIdUseEnumType values

• V2GRootCertificate
• MORootCertificate (eMobility Operator)
• CSMSRootCertificate
• V2GCertificateChain
• ManufacturerRootCertificate

GetInstalledCertificateStatusEnumType values

Accepted, NotFound.

Examples

{
  "certificateType": ["CSMSRootCertificate", "V2GRootCertificate"]
}

{
  "status": "Accepted",
  "certificateHashDataChain": [
    {
      "certificateType": "CSMSRootCertificate",
      "certificateHashData": {
        "hashAlgorithm": "SHA256",
        "issuerNameHash": "3d2e6c9f...e1",
        "issuerKeyHash": "9aa1b6f3...22",
        "serialNumber": "0a1b2c3d4e5f"
      }
    }
  ]
}

Schema

Source: schemas/GetInstalledCertificateIdsRequest.json, schemas/GetInstalledCertificateIdsResponse.json (OCPP 2.0.1 FINAL)