diff options
-rw-r--r-- | doc/credentials_manager.rst | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/doc/credentials_manager.rst b/doc/credentials_manager.rst index 57d262c45..b9718bf59 100644 --- a/doc/credentials_manager.rst +++ b/doc/credentials_manager.rst @@ -113,13 +113,25 @@ servers for SRP authentication. Preshared Keys ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +TLS and some other protocols support the use of pre shared keys for +authentication. + +.. cpp:function:: SymmetricKey psk(const std::string& type, \ + const std::string& context, \ + const std::string& identity) + + Return a symmetric key for use with *identity* + .. cpp:function:: std::string psk_identity_hint(const std::string& type, \ const std::string& context) + Returns an identity hint which may be provided to the client. This + can help a client understand what PSK to use. + .. cpp:function:: std::string psk_identity(const std::string& type, \ const std::string& context, \ const std::string& identity_hint) -.. cpp:function:: SymmetricKey psk(const std::string& type, \ - const std::string& context, \ - const std::string& identity) + Returns the identity we would like to use given this *type* and + *context* and the optional *identity_hint*. Not all servers or + protocols will provide a hint. |