defines that access to characteristic(s) require an encrypted link without MITM Protection. More...

#include <bluetoe/encryption.hpp>

Detailed Description

defines that access to characteristic(s) require an encrypted link without MITM Protection.

Can be used on server, service or characteristic level to define that the access to a characteristic value or CCCD, requires an encrypted link. If the link is not encrypted, when accessing the characteristic, Bluetoe replies with an ATT Insufficient Authorization error, if the requesting device is not paired and ATT Insufficient Encryption, if the device is paired, but the link is not encrypted. (see table 10.2 Vol 3, Part C, 10.3.1)

If applied to a server or service definition, this definition applies to all containing characteristics, where it can be overridden.

Example

char simple_value = 0;
constexpr char name[] = "This is the name of the characteristic";
 
using server = bluetoe::server<
    // By default, require encryption for all characteristics of
    // all services.
    bluetoe::requires_encryption,
    // Service A
    bluetoe::service<
        // But for this service, no encryption is required
        bluetoe::no_encryption_required,
        service_uuid_a,
        ...
    >,
    // Service B
    bluetoe::service<
        service_uuid_b,
        bluetoe::characteristic<
            char_uuid,
            // For all characteristics of this service, but this characteristic,
            // encryption is required
            bluetoe::no_encryption_required
        >,
        ...
    >,
    // Service C
>;

See also: characteristic; service; server; no_encryption_required; may_require_encryption

The documentation for this struct was generated from the following file:

bluetoe/encryption.hpp