Security and data handling: sign-in, regions, subprocessors, retention
Security & Rate Limiting
#security#mfa#sso#saml#data residency#subprocessors#gdpr#dpa#encryption#soc 2#iso 27001
What SHDWsdk stores, where it's stored, who processes it, how access is controlled, and how long it's kept.
How It Works Under the Hood
- •Data collected: model ids, vendor and hosting, token counts, timing, grid region, energy and cost estimates, and your own pseudonymous customer, matter and trace ids. SHDWsdk never receives prompts, completions or documents, and rejects emails in attribution fields.
- •Sign-in: two-factor authentication with any authenticator app, and SAML 2.0 single sign-on (Okta, Microsoft Entra ID, Google Workspace and others). An organization can require MFA, SSO or both; the database enforces it on every request, including the API. The owner keeps password access as a break-glass account.
- •Isolation: every table is protected by PostgreSQL row-level security scoped to the organization; API keys are stored only as SHA-256 digests; the audit log is append-only and hash-chained.
- •Regions: United States (AWS us-west-2, Oregon) or European Union (AWS eu-central-1, Frankfurt). Data is encrypted in transit (TLS 1.2+) and at rest (AES-256).
- •Subprocessors: Supabase (database, authentication, functions; in your data region), Vercel (web hosting and API routing; global edge), Resend (transactional email; US), Stripe (billing; US, billing data only). The current list is published at shdwsdk.ai/docs/security-and-data-handling.
- •Retention: keep everything, or 13 months to 10 years with a verifiable audit log; legal hold; export at any time; deletion 30 days after the owner schedules it.
- •Attestations: SHDWsdk does not yet hold a SOC 2 report or ISO 27001 certificate. A data processing agreement and our controls documentation are available on request at security@shdwsdk.ai.
How to Use It Step-by-Step
- 1Turn on two-factor in Settings → Security, then require it for your organization.
- 2To use SSO, send your IdP's SAML metadata URL to security@shdwsdk.ai, then enter your domain in Settings → Security.
- 3Set retention and legal hold in Settings → Data.
Related guides
- API Key Encryption, Sliding-Window Rate Limiting & Constant-Time Webhooks
- Data retention, legal hold, export and deletion
- Interactive CLI Setup Wizard (npx @shdwsdk/sdk init / npx shdw-init)
- Non-Blocking Client Wrapper (shdw.wrapClient) & Fail-Silent Guarantee
- Layer 1: Zero-Touch Runtime AI-BOM Auto-Discovery & Zero-Knowledge Prompt Hashing
- Layer 2: RAG & Vector Database Auto-Instrumentation (shdw.wrapVectorStore)
- Layer 3: Static Manifest & CI/CD Auto-Scanner (@shdwsdk/sdk/scanner)
- Layer 4: Model Integrity & CycloneDX / SPDX Exporters
