Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.narrativebanking.com/llms.txt

Use this file to discover all available pages before exploring further.

This page describes public security controls and integration expectations for external SDK consumers.

Trust signals

Tenant isolation enforced JWT bearer auth Token rotation enabled Request tracing available

Authentication baseline

JWT access and refresh tokens are used for protected API sessions.
Refresh token rotation supports revoke and revoke-all controls.
Bearer token enforcement is required on protected endpoints.

Embedded integration security

https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/server.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=4a767cfdcb6585e74810e5c286495132

Backend-only secrets

Connected app secrets stay in tenant backend secret stores only.
https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/timer.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=218100a8011939edb626ef3480a13724

Short-lived embed tokens

Embed Tokens are short-lived and should not be persisted in browser storage.
https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/link-handoff.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=710c716f96a2cf04ebe7fa38257b5ea1

Safe token handoff

Token handoff to embedded UI avoids URL query-string exposure.
https://mintcdn.com/narrative-b13c445c/qi6sqKB_OLTe8ty2/SVG/lock.svg?fit=max&auto=format&n=qi6sqKB_OLTe8ty2&q=85&s=be29c8f389110e9dd5032501c0e8f00b

Transport security

HTTPS is required end-to-end across tenant and NSDK boundaries.

Tenant isolation

Identity resolution and session issuance are tenant-scoped by design.
API access is bounded by authenticated user and tenant context.
Cross-tenant data access is disallowed by policy and enforcement controls.

v1.5.7 security update

v1.5.7 includes both standard web application security review and AI-specific security review work. The release focuses on practical risk reduction: tenant isolation, safer assistant behaviour, sensitive-data handling, clearer error reporting, and privacy-aware session review tooling. High-priority findings from the reviews were addressed before release.

Operational controls

ControlPurposeExternal signal
Runtime error captureDetect and triage integration issues quickly.Stable error payloads with request_id
Request tracingCorrelate incidents across API and orchestration paths.Traceable request lifecycle for support
Guardrail messagingInform users about known risk or uncertain states.Explicit in-product safety messaging
Release-note governanceTrack externally visible behaviour changes.Public release notes and version policy