void/ZeroTierOne
2
0
Fork 0
mirror of https://github.com/zerotier/ZeroTierOne.git synced 2025-06-07 21:13:44 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

added more documentation

Browse source
This commit is contained in:
monica 2023-01-03 16:55:21 -05:00
parent 046ddbaf33
commit 2233f8c535
1 changed files with 10 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

10
zssp/src/applicationlayer.rs
View file

@ -67,6 +67,16 @@ pub trait ApplicationLayer: Sized {
/// On success a tuple of local session ID, static secret, and associated object is returned. The /// On success a tuple of local session ID, static secret, and associated object is returned. The
/// static secret is whatever results from agreement between the local and remote static public /// static secret is whatever results from agreement between the local and remote static public
/// keys. /// keys.
///
/// When `accept_new_session` is called, `remote_static_public` and `remote_metadata` have not yet been
/// authenticated. As such avoid mutating state until OkNewSession(Session) is returned, as the connection
/// may be adversarial.
///
/// When `remote_static_public` and `remote_metadata` are eventually authenticated, the zssp protocol cannot
/// guarantee that they are unique, i.e. `remote_static_public` and `remote_metadata` may be duplicates from
/// an old attempt to establish a session, and may even have been replayed by an adversary. If your use-case
/// needs uniqueness for reliability or security, consider either including a timestamp in the metadata, or
/// sending the metadata as an extra transport packet after the session is fully established.
fn accept_new_session( fn accept_new_session(
&self, &self,
receive_context: &ReceiveContext<Self>, receive_context: &ReceiveContext<Self>,