[gnutls-devel] GnuTLS | Update docs for session ticket key rotation (!768)

[Development of GNU's TLS library]

Nikos Mavrogiannopoulos commented on a discussion on doc/cha-gtls-app.texi:

>  A server supporting session tickets must generate ticket encryption
>  and authentication keys using @funcref{gnutls_session_ticket_key_generate}.
>  Those keys should be associated with the GnuTLS session using
> - at funcref{gnutls_session_ticket_enable_server}, and should be rotated regularly
> -(e.g., every few hours), to prevent them from becoming long-term keys which
> -if revealed could be used to decrypt all previous sessions.
> + at funcref{gnutls_session_ticket_enable_server}.
> +
> +GnuTLS will rotate these keys regularly. The key rotation interval can be specified with
> + at funcref{gnutls_db_set_cache_expiration}. Every such interval, new keys will be generated from the initial keys
> +that were first established using @funcref{gnutls_session_ticket_enable_server}. This is

LGTM. I'd avoid saying twice the `The key rotation interval` in the 2nd and third sentence, and connect them instead. E.g
```
The key rotation interval can be changed with @funcref{gnutls_db_set_cache_expiration} and will be
three times the ticket expiration time (ie. three times the value given in that function).
```

-- 
Reply to this email directly or view it on GitLab: https://gitlab.com/gnutls/gnutls/merge_requests/768#note_108195271
You're receiving this email because of your account on gitlab.com.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.gnupg.org/pipermail/gnutls-devel/attachments/20181011/738b6663/attachment.html>