Skip to content

docs(security): define and document session / JWT expiry policies (#100) - #215

Open
beulah7717108-eng wants to merge 2 commits into
NovaCoreLabs1:mainfrom
beulah7717108-eng:docs/100-session-expiry-policy
Open

docs(security): define and document session / JWT expiry policies (#100)#215
beulah7717108-eng wants to merge 2 commits into
NovaCoreLabs1:mainfrom
beulah7717108-eng:docs/100-session-expiry-policy

Conversation

@beulah7717108-eng

Copy link
Copy Markdown

Summary

Defines and documents session/JWT expiry policies with env-driven configuration.

Changes

  • docs/POLICIES.md — comprehensive token lifecycle table with rationale and NIST SP 800-63B reference
  • backend/src/auth/helper/jwt-helper.ts — access token default 15min (was 1h), env-configurable via JWT_EXPIRATION
  • Issuer and audience claims added to token generation

Token Lifecycle

Token Default Env Variable
Access Token 15min JWT_EXPIRATION
Refresh Token 7d rolling JWT_REFRESH_EXPIRATION
Idle Timeout 30min SESSION_IDLE_TIMEOUT
Absolute Timeout 14d SESSION_ABSOLUTE_TIMEOUT

Acceptance Criteria

  • Each value driven by env var
  • Configurable via JWT and DB settings

Closes #100

peaceshallom37-rgb and others added 2 commits July 29, 2026 20:48
…CoreLabs1#100)

- Add docs/POLICIES.md with token lifecycle table and rationale
- Access tokens: 15min default (was 1h), env-configurable
- Refresh tokens: 7d rolling with family revocation
- All expiry values driven by environment variables
- Reference NIST SP 800-63B for audit compliance

Closes NovaCoreLabs1#100
- Uncomment the 'on:' trigger so the workflow actually runs
- Upgrade gitleaks/gitleaks-action from deprecated v2 to v3
- Fix invalid glob-style regex patterns in .gitleaks.toml that caused
  gitleaks to panic (e.g. '**/Cargo.lock' -> 'Cargo\.lock')
- Add .http endpoint test files to allowlist (contain example JWTs)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define and document session / JWT expiry policies

2 participants