Skip to content

Commit e8dca34

Browse files
committed
docs: improve clarity on session-cookie hardening and bearer token authentication
1 parent 966ec7c commit e8dca34

1 file changed

Lines changed: 8 additions & 8 deletions

File tree

doc/sphinx-guides/source/installation/config.rst

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -3961,16 +3961,16 @@ After changing these settings, restart Payara and re-check the response headers.
39613961

39623962
Session-Cookie Hardening vs Bearer Token Auth
39633963

3964-
- Session-cookie auth and bearer-token auth use different trust models:
3965-
- Session cookie (``JSESSIONID``) is automatically sent by browsers.
3966-
- Bearer token is sent only when the client explicitly includes it.
3967-
- Because of browser auto-send behavior, session-cookie auth requires anti-CSRF controls for state-changing API calls.
3964+
- Session-cookie auth and bearer-token auth use different trust models. Session cookie
3965+
(``JSESSIONID``) is automatically sent by browsers, while bearer token is sent only when the
3966+
client explicitly includes it.
3967+
- Because of browser auto-send behavior, session-cookie auth requires anti-CSRF controls for
3968+
state-changing API calls.
39683969
With this hardening track enabled, Dataverse enforces Origin/Referer and CSRF token checks, which brings session-cookie browser usage into a security posture comparable to bearer for first-party, same-origin UI calls.
39693970
- Bearer remains preferable for non-browser and cross-origin API clients.
3970-
- Neither model protects against stolen credentials by itself:
3971-
- session hijack (stolen ``JSESSIONID``),
3972-
- bearer-token theft.
3973-
For both, use HTTPS, secure cookie/token handling, short lifetimes where possible, and strong XSS prevention.
3971+
- Neither model protects against stolen credentials by itself (session hijack via stolen
3972+
``JSESSIONID`` or bearer-token theft). For both, use HTTPS, secure cookie/token handling, short
3973+
lifetimes where possible, and strong XSS prevention.
39743974

39753975
.. _dataverse.feature.api-bearer-auth:
39763976

0 commit comments

Comments
 (0)