amend 3.0 migration guide

randombit · Oct 19, 2022 · 7571118 · 7571118
1 parent a66393b
commit 7571118
Showing 1 changed file with 15 additions and 0 deletions.
diff --git a/doc/migration_guide.rst b/doc/migration_guide.rst
@@ -36,6 +36,21 @@ Functionality removed from the TLS implementation includes
 * AES-128 OCB ciphersuites
 * DHE_PSK ciphersuites
 
+TLS 1.3 API adaptions
+---------------------
+
+Sessions
+^^^^^^^^
+
+Old (pre-Botan 3.0) sessions won't load in Botan 3.0 anymore and should be
+discarded.
+
+``Session::session_id()`` is equal to the "session ticket" for TLS 1.3 sessions.
+This ticket might be longer than a typical ID (up to 64kB). If your application
+depends on a short ID for each session, it is safe to just hash the returned
+buffer.
+
+
 Algorithms Removed
 -------------------