Skip to main content

Module security

Module security 

Source
Expand description

Security model: security suites (0/1/2), security policy (protection level) and the HLS/LLS authentication mechanisms (0..10), including the GOST profile of Р 1323565.1. DLMS/COSEM security model.

This module gathers the three orthogonal security concepts:

  • crate::security::SecuritySuite — the cryptographic suite (0, 1 or 2) selecting the authenticated-encryption, signature, key-agreement and hash algorithms (IEC 62056-5-3, 5.3.7 / DLMS Green Book Table 19).
  • crate::security::SecurityPolicy — the protection level applied to APDUs (none, authentication, encryption or authenticated encryption).
  • crate::security::AuthMechanism — the authentication mechanism negotiated when opening an application association (mechanism_id 0..10), including the Russian GOST profile of Р 1323565.1, §7.5.

The four-pass HLS handshake computations live in crate::security::hls.

Modules§

access_rights
Access rights model for DLMS/COSEM (IEC 62056-5-3, 5.3.7).
agreement
Elliptic-curve key agreement for security suites 1 and 2 (IEC 62056-5-3, 5.3.4 / DLMS Green Book Annex C).
gost3410
GOST R 34.10-2018 (256-bit) digital signatures — HLS mechanism 10.
hls
Four-pass HLS handshake computations for every supported mechanism.
signature
Digital-signature HLS mechanisms.

Enums§

AuthMechanism
An HLS/LLS authentication mechanism (mechanism_id 0..10).
SecurityPolicy
The protection level applied to an APDU. Together with the security suite it determines the security control byte (SC) of a ciphered APDU.
SecuritySuite
A DLMS/COSEM security suite (IEC 62056-5-3, 5.3.7).