ory / ory/docs

Documentation of Session extension incomplete

Open
#1,743 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug
Dominant language
TypeScript
Stars
161
Forks
1.9k
PR merge metrics
No merged PRs in 30d

Description

Preflight checklist
Ory Network Project

No response

Describe the bug

If you extend a kratos session using the admin API,
the next call to the public toSession()/Whoami REST API will then return a new cookie.

This new cookie must be returned to the UI and used for future UI requests;
I believe the cookie contains an expiry data as part of its encrypted payload.

This is not explained in the kratos documentation and if this is not done,
UI requests start to fail when the original session expires even though the
session in the database has been updated.

Reproducing the bug

Not really relevant

Relevant log output
not relevant
Relevant configuration
not relevant
Version

kratos 1.1.0

On which operating system are you observing this issue?

Linux

In which environment are you deploying?

Docker Compose

Additional Context

No response

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by locating the Kratos documentation for the admin session extension API and the public toSession()/Whoami REST API. Document that the refreshed cookie must be returned to the UI and used for subsequent requests, and confirm that the explanation covers session expiry behavior.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.