mirror/btstack
1
0
Fork 0
mirror of https://github.com/bluekitchen/btstack.git synced 2025-04-16 17:42:51 +00:00
Code Issues Packages Projects Releases Wiki Activity

gatt_client: improve gatt_client_set_required_security_level description

Browse Source
This commit is contained in:
Matthias Ringwald 2020-12-02 17:58:35 +01:00
parent 77da83a6e0
commit b11289a818
1 changed files with 6 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
src/ble/gatt_client.h
View File

@ -234,10 +234,12 @@ void gatt_client_init(void);
/**
* @brief Set minimum required security level for GATT Client
* @note The Bluetooth specification makes the GATT Server responsible to check for security.
* This allows an attacker to spoof existing devices with GATT Servers, but skip the authentication part
* If your application is exchanging sensitive data from a remote device, you would need to manually check
* the security level before sending/receive such data. This function allows to have the GATT Client post-pone
* any exchange until the required security level is established.
* This allows an attacker to spoof an existing device with a GATT Servers, but skip the authentication part.
* If your application is exchanging sensitive data with a remote device, you would need to manually check
* the security level before sending/receive such data.
* With level > 0, the GATT Client triggers authentication for all GATT Requests and defers any exchange
* until the required security level is established.
* gatt_client_request_can_write_without_response_event does not trigger authentication
* @pram level, default LEVEL_0 (no encryption required)
*/
void gatt_client_set_required_security_level(gap_security_level_t level);