EVerest API definition for evse_security consumer 1.0.0

API for EVerest API clients that use the EvseSecurity module.

  • #EVerest
  • #OCPP

Servers

  • mqtt://localhost:1883/everest_api/1/evse_security_consumer/{module_id}mqttdefault

    default local MQTT

    object
    module_id
    required
    string

    The ID of the module as defined in the EVerest config file.

Operations

  • REQUEST m2e/is_ca_certificate_installed

    Command that indicates if the given CA certificate type is installed

    Operation IDsend_request_is_ca_certificate_installed

    Available only on servers:

    Accepts the following message:

    Command that indicates if the given CA certificate type is installedsend_request_is_ca_certificate_installed

    Command that indicates if the given CA certificate type is installed

    Message IDsend_request_is_ca_certificate_installed
    object

    Examples

    REPLY INFORMATION

    REPLY CHANNEL INFORMATION

    Reply will be directed to the address specified at this location: $message.header#/replyTo

    REPLY address information

    REPLY will be sent to the address provided in:$message.header#/replyTo
  • RECEIVE

    Operation IDreceive_reply_is_ca_certificate_installed

    Available only on servers:

    Accepts the following message:

    Reply to is ca certificate installed requestreceive_reply_is_ca_certificate_installed

    Reply to is ca certificate installed

    Message IDreceive_reply_is_ca_certificate_installed
    Payload
    boolean

    True if CA certificate is installed, else false

    Examples

  • REQUEST m2e/get_leaf_certificate_info

    Command to get the paths of the certificate and the respective key

    Operation IDsend_request_get_leaf_certificate_info

    Available only on servers:

    Accepts the following message:

    Command to get the paths of the certificate and the respective keysend_request_get_leaf_certificate_info

    Command to get the paths of the certificate and the respective key

    Message IDsend_request_get_leaf_certificate_info
    object

    Examples

    REPLY INFORMATION

    REPLY CHANNEL INFORMATION

    Reply will be directed to the address specified at this location: $message.header#/replyTo

    REPLY address information

    REPLY will be sent to the address provided in:$message.header#/replyTo
  • RECEIVE

    Operation IDreceive_reply_get_leaf_certificate_info

    Available only on servers:

    Accepts the following message:

    Reply to get leaf certificate info requestreceive_reply_get_leaf_certificate_info

    Reply to get leaf certificate info

    Message IDreceive_reply_get_leaf_certificate_info
    object

    Response to the command get_leaf_certificate_info

    Examples

  • REQUEST m2e/get_verify_location

    Command to get the file path of the CA root directory that can be used for verification. Will also invoke c_rehash for that directory

    Operation IDsend_request_get_verify_location

    Available only on servers:

    Accepts the following message:

    Command to get the file path of the CA root directory that can be used for verification. Will also invoke c_rehash for that directorysend_request_get_verify_location

    Command to get the file path of the CA root directory that can be used for verification. Will also invoke c_rehash for that directory

    Message IDsend_request_get_verify_location
    object

    Examples

    REPLY INFORMATION

    REPLY CHANNEL INFORMATION

    Reply will be directed to the address specified at this location: $message.header#/replyTo

    REPLY address information

    REPLY will be sent to the address provided in:$message.header#/replyTo
  • RECEIVE

    Operation IDreceive_reply_get_verify_location

    Available only on servers:

    Accepts the following message:

    Reply to get verify location requestreceive_reply_get_verify_location

    Reply to get verify location

    Message IDreceive_reply_get_verify_location
    Payload
    string

    The path of the CA certificates directory

    Examples

  • RECEIVE e2m/heartbeat

    Operation IDreceive_heartbeat

    Available only on servers:

    Accepts the following message:

    Receive heartbeatreceive_heartbeat

    Heartbeat produced by EVerest as configured via cfg_heartbeat_interval_ms in the EVerest configuration

    Message IDreceive_heartbeat
    Payload
    integer

    64bit unsigned integer. The id of every heartbeat increases by 1 and overflows when the maximum representable value is reached

    Examples

  • SEND m2e/communication_check

    Operation IDsend_communication_check

    Available only on servers:

    Accepts the following message:

    Send communication checksend_communication_check

    Signal to EVerest that communication is good or check shall be stopped

    Message IDsend_communication_check
    Payload
    boolean

    Send 'true' at least every 'cfg_communication_check_to_s' seconds to signal module is alive. Send 'false' to stop communication check

    Examples

Messages

  • #1Command that indicates if the given CA certificate type is installedsend_request_is_ca_certificate_installed

    Command that indicates if the given CA certificate type is installed

    Message IDsend_request_is_ca_certificate_installed
    object
  • #2Reply to is ca certificate installed requestreceive_reply_is_ca_certificate_installed

    Reply to is ca certificate installed

    Message IDreceive_reply_is_ca_certificate_installed
    Payload
    boolean

    True if CA certificate is installed, else false

  • #3Command to get the paths of the certificate and the respective keysend_request_get_leaf_certificate_info

    Command to get the paths of the certificate and the respective key

    Message IDsend_request_get_leaf_certificate_info
    object
  • #4Reply to get leaf certificate info requestreceive_reply_get_leaf_certificate_info

    Reply to get leaf certificate info

    Message IDreceive_reply_get_leaf_certificate_info
    object

    Response to the command get_leaf_certificate_info

  • #5Command to get the file path of the CA root directory that can be used for verification. Will also invoke c_rehash for that directorysend_request_get_verify_location

    Command to get the file path of the CA root directory that can be used for verification. Will also invoke c_rehash for that directory

    Message IDsend_request_get_verify_location
    object
  • #6Reply to get verify location requestreceive_reply_get_verify_location

    Reply to get verify location

    Message IDreceive_reply_get_verify_location
    Payload
    string

    The path of the CA certificates directory

  • #7Receive heartbeatreceive_heartbeat

    Heartbeat produced by EVerest as configured via cfg_heartbeat_interval_ms in the EVerest configuration

    Message IDreceive_heartbeat
    Payload
    integer

    64bit unsigned integer. The id of every heartbeat increases by 1 and overflows when the maximum representable value is reached

  • #8Send communication checksend_communication_check

    Signal to EVerest that communication is good or check shall be stopped

    Message IDsend_communication_check
    Payload
    boolean

    Send 'true' at least every 'cfg_communication_check_to_s' seconds to signal module is alive. Send 'false' to stop communication check

Schemas

  • CaCertificateType
    string

    Enum specifies the type of a CA certificate

      Allowed values:
    • "V2G"
    • "MO"
    • "CSMS"
    • "MF"
  • LeafCertificateType
    string

    Enum specifies the type of a leaf certificate

      Allowed values:
    • "CSMS"
    • "V2G"
    • "MF"
    • "MO"
  • EncodingFormat
    string

    Enum specifies the encoding of certificates or keys

      Allowed values:
    • "DER"
    • "PEM"
  • object
  • GetCertificateInfoStatus
    string

    Status indicates the result of the attempt to retrieve a certificate

      Allowed values:
    • "Accepted"
    • "Rejected"
    • "NotFound"
    • "NotFoundValid"
    • "PrivateKeyNotFound"
  • HashAlgorithm
    string

    Enum specifies a hash algorithm

      Allowed values:
    • "SHA256"
    • "SHA384"
    • "SHA512"
  • object

    Type specifies the hash data of a certificate

  • object

    OCSP data related to requested the certificates

  • object

    Type that specifies the paths of a certificate and the respective private key

  • object

    Response to the command get_leaf_certificate_info

  • HeartBeatId
    integer

    64bit unsigned integer. The id of every heartbeat increases by 1 and overflows when the maximum representable value is reached

  • CommunicationCheck
    boolean

    Send 'true' at least every 'cfg_communication_check_to_s' seconds to signal module is alive. Send 'false' to stop communication check