Eve library

phase-146.md

Tracker

Revision 1

On this page

Historical task source. The Eve task board holds current task state.

Phase 146: Sovereign Identity Provider — Okta / Auth0 / Azure AD (Entra ID) / AWS Cognito / Ping / OneLogin Replacement#

Closes the identity-provider sovereignty gap. Phase 137 (platform identity) is game-console focused. Phase 139.1.2.10 and Phase 145.12.10 consume SSO / SAML / OIDC / SCIM — meaning every Oshun product is a relying party to a third-party IdP. No phase currently delivers the IdP itself. Without it, every Oshun deployment is hostage to Okta, Microsoft Entra ID (Azure AD), Auth0, AWS Cognito, Ping Identity, OneLogin, JumpCloud, Duo, Google Workspace Identity, ForgeRock, Keycloak (OSS reference), WSO2, or Authelia.

This phase ships a complete sovereign IdP (B2B workforce, B2C customer, machine identity, federation, lifecycle, privileged access, compliance) so every Oshun workspace, vendor, customer, and downstream SaaS can authenticate and authorize against Oshun-owned identity infrastructure.


146.1 @neith/idp-core — Directory & Account Store#

146.1.1 Directory Schema#

  • 146.1.1.1 User entity (id, external-id, emails, phones, attributes)
  • 146.1.1.2 Group / role / team entity
  • 146.1.1.3 Organization / tenant / sub-tenant hierarchy
  • 146.1.1.4 Organizational units / OU tree
  • 146.1.1.5 Service account / machine identity
  • 146.1.1.6 Device identity (managed endpoint)
  • 146.1.1.7 Workload identity (SPIFFE SVID-compatible)
  • 146.1.1.8 Application / relying-party entity
  • 146.1.1.9 Entitlement / license / seat tracking
  • 146.1.1.10 Custom-attribute schema per tenant

146.1.2 Storage#

  • 146.1.2.1 Postgres primary with logical replication
  • 146.1.2.2 Column-level encryption for PII
  • 146.1.2.3 Soft-delete with tombstone retention
  • 146.1.2.4 Audit-history per record
  • 146.1.2.5 Multi-region active-active option
  • 146.1.2.6 Per-tenant data-residency routing
  • 146.1.2.7 Key-rotation with re-encrypt pipeline
  • 146.1.2.8 Online schema migration
  • 146.1.2.9 Hot + cold backup with verified restore drills
  • 146.1.2.10 Horizontal shard by tenant-id

146.2 @neith/idp-authn — Authentication Protocols#

146.2.1 Credentials#

  • 146.2.1.1 Password (Argon2id / bcrypt / scrypt)
  • 146.2.1.2 Breached-password check (Have I Been Pwned k-anon API + offline)
  • 146.2.1.3 Passkey / WebAuthn (FIDO2, resident keys, passkey sync)
  • 146.2.1.4 TOTP (RFC 6238) with enrolment QR
  • 146.2.1.5 Push MFA (out-of-band approve)
  • 146.2.1.6 SMS / voice OTP (fraud-aware, OTP spray defense)
  • 146.2.1.7 Email magic link
  • 146.2.1.8 Backup / recovery codes
  • 146.2.1.9 Hardware security key (YubiKey, TKey, sovereign)
  • 146.2.1.10 Smart-card / CAC / PIV
  • 146.2.1.11 Biometric (fingerprint, Face ID) attestation
  • 146.2.1.12 Risk-based step-up (impossible travel, new device)
  • 146.2.1.13 Adaptive MFA based on signal score
  • 146.2.1.14 Single-use bootstrap enrolment token
  • 146.2.1.15 mTLS client-cert authentication

146.2.2 Protocol Endpoints#

  • 146.2.2.1 OpenID Connect 1.0 (core + discovery + dynamic registration)
  • 146.2.2.2 OAuth 2.1 authorization server (PKCE mandatory)
  • 146.2.2.3 OAuth 2 device-authorization-grant
  • 146.2.2.4 OAuth 2 token-exchange (RFC 8693)
  • 146.2.2.5 OAuth 2 refresh-token rotation + reuse detection
  • 146.2.2.6 DPoP / mutual-TLS sender-constrained tokens
  • 146.2.2.7 SAML 2.0 IdP (SP-init + IdP-init)
  • 146.2.2.8 SAML 2.0 SP (for federated IdP consumption)
  • 146.2.2.9 WS-Federation / WS-Trust
  • 146.2.2.10 CAS 3.0
  • 146.2.2.11 Kerberos / SPNEGO integrated Windows auth
  • 146.2.2.12 LDAP / LDAPS server compatible with AD schema
  • 146.2.2.13 RADIUS server for VPN / WiFi auth
  • 146.2.2.14 Sign-in-with-Apple / Google / Microsoft social IdP
  • 146.2.2.15 Passkey auto-fill with CTAP2 / ClientToAuthenticator

146.3 @neith/idp-authz — Authorization, RBAC & ABAC#

146.3.1 Policy Model#

  • 146.3.1.1 Roles (basic, scoped, hierarchical, inherited)
  • 146.3.1.2 Permissions catalog per application
  • 146.3.1.3 Resource-scoped assignment (org / group / project / resource)
  • 146.3.1.4 ABAC policy with CEL / Cedar / Rego
  • 146.3.1.5 Conditional-access policy (device, geo, time, risk)
  • 146.3.1.6 Relationship-based access (ReBAC / Zanzibar-style)
  • 146.3.1.7 Attribute propagation (user → group → role → policy)
  • 146.3.1.8 Temporal access (just-in-time privilege)
  • 146.3.1.9 Emergency break-glass role
  • 146.3.1.10 Separation-of-duty (SoD) rule enforcement

146.3.2 Decision Runtime#

  • 146.3.2.1 Policy-decision point (PDP) with sub-millisecond latency
  • 146.3.2.2 Policy-information point (PIP) for dynamic attributes
  • 146.3.2.3 Policy-enforcement-point (PEP) SDK
  • 146.3.2.4 Policy-administration-point (PAP) console
  • 146.3.2.5 Policy simulation (who-can-do-what)
  • 146.3.2.6 Policy coverage / gap detector
  • 146.3.2.7 Deny-by-default vs. allow-by-default mode
  • 146.3.2.8 Policy versioning + rollback
  • 146.3.2.9 Policy-testing DSL (unit + integration)
  • 146.3.2.10 Per-tenant policy isolation

146.4 @neith/idp-federation — External IdP Federation#

  • 146.4.1 Social login (Google, Apple, Microsoft, GitHub, Facebook, LinkedIn, X, Discord)
  • 146.4.2 Enterprise federation (Okta, Azure AD, Google Workspace, Auth0, Ping, OneLogin, ADFS)
  • 146.4.3 Generic SAML 2.0 SP-init consumption
  • 146.4.4 Generic OIDC federation
  • 146.4.5 JIT provisioning on first federated login
  • 146.4.6 Attribute mapping DSL per federation
  • 146.4.7 Home-realm discovery by email domain
  • 146.4.8 Identity-hub pattern (IdP-in-front-of-IdP)
  • 146.4.9 Cross-tenant sharing (B2B) with guest-user model
  • 146.4.10 External-user expiry and re-verification

146.5 @neith/idp-scim — Lifecycle & Provisioning#

146.5.1 SCIM 2.0#

  • 146.5.1.1 SCIM 2.0 server endpoints (Users, Groups, Schemas, ResourceTypes)
  • 146.5.1.2 PATCH with path / replace / remove / add
  • 146.5.1.3 Bulk operations
  • 146.5.1.4 Search filter expression (eq, ne, co, sw, ew, pr, gt, ge, lt, le)
  • 146.5.1.5 SCIM discovery
  • 146.5.1.6 Custom extension schemas per tenant
  • 146.5.1.7 SCIM client to provision downstream SaaS
  • 146.5.1.8 Replay-safe provisioning with idempotency keys
  • 146.5.1.9 Just-in-time vs. ahead-of-time provisioning
  • 146.5.1.10 SCIM API conformance test suite

146.5.2 Lifecycle Automation#

  • 146.5.2.1 HR-system-of-record connector (Workday, BambooHR, Rippling, sovereign)
  • 146.5.2.2 Joiner flow (onboarding automation, hardware provisioning trigger)
  • 146.5.2.3 Mover flow (transfer / role-change)
  • 146.5.2.4 Leaver flow (immediate deprovisioning, data preservation)
  • 146.5.2.5 Contractor / intern time-boxed access
  • 146.5.2.6 Birthright-entitlement assignment
  • 146.5.2.7 Dynamic group based on attribute
  • 146.5.2.8 Delegated-admin access-request approvals
  • 146.5.2.9 Access-certification / attestation campaigns
  • 146.5.2.10 Dormant account detection + auto-disable

Verification (2026-07-13): package-scoped TypeScript and ESLint gates pass; the SCIM and lifecycle Vitest suite passes 18 tests across two files, including tenant isolation, ETags, bulk references, extension validation, replay safety, connector boundaries, access-source reconciliation, certification, and expiry.


146.6 @neith/idp-mfa — Strong Authentication Stack#

  • 146.6.1 FIDO2 / WebAuthn (platform + roaming)
  • 146.6.2 Passkey sync with iCloud / Google / sovereign
  • 146.6.3 TOTP / HOTP
  • 146.6.4 Push approve (out-of-band via Neith Mobile app)
  • 146.6.5 Number-matching push (block push-spray)
  • 146.6.6 Hardware OTP tokens (RSA-compatible seed import)
  • 146.6.7 Smart card / PIV / CAC
  • 146.6.8 Biometric-only step-up
  • 146.6.9 Risk-based / adaptive MFA
  • 146.6.10 Geo-velocity / impossible-travel
  • 146.6.11 Device-trust posture (EDR / MDM signal)
  • 146.6.12 Phishing-resistant policy enforcement
  • 146.6.13 MFA reset workflow with identity proofing
  • 146.6.14 Recovery factor rotation
  • 146.6.15 Emergency break-glass codes printed + sealed

Verification (2026-07-13): strict TypeScript and ESLint gates pass for both the MFA orchestrator and its authentication-primitives dependency. Vitest passes 13 MFA orchestration tests and 27 underlying authentication tests, covering platform and roaming WebAuthn, all sync providers, OTP replay defense, mobile number matching, encrypted atomic seed import, signed PIV and biometric proof, posture and geo-risk decisions, proofed reset, recovery rotation, and sealed dual-custodian break-glass use.


146.7 @neith/idp-b2c — Customer Identity (CIAM)#

  • 146.7.1 Self-service sign-up with progressive profile
  • 146.7.2 Passwordless-first default
  • 146.7.3 Social-login with account-linking on email match
  • 146.7.4 Email / phone verification
  • 146.7.5 Pre-registration flags (consent, marketing opt-in)
  • 146.7.6 Profile self-service + preferences
  • 146.7.7 Account-deletion (GDPR) workflow
  • 146.7.8 Anonymous-to-authenticated merge (Phase 142.2)
  • 146.7.9 Family / parental-consent flows
  • 146.7.10 Age-gate / KYC / e-ID verification (eIDAS, VOICE, etc.)
  • 146.7.11 Fraud signal (velocity, device, proxy, disposable email)
  • 146.7.12 Bot-defense (challenge, hCaptcha-class, turnstile)
  • 146.7.13 Login-throttle / lock-out
  • 146.7.14 Progressive MFA (opt-in → nudge → require)
  • 146.7.15 Per-brand / per-region UI theming

Verification (2026-07-13): strict TypeScript and ESLint gates pass, and the CIAM Vitest suite passes 10 tests. Coverage includes passwordless ordering, progressive profile and consent history, verified social linking, one-time email/phone verification, anonymous merge, deletion erasure, guardian and e-ID proof, fraud/bot defenses, distributed lockout, progressive MFA, and regional theme fallback with cardless composition, restrained/reduced motion, and WCAG AA color validation.


146.8 @neith/idp-workload — Machine & Service Identity#

  • 146.8.1 SPIFFE ID / SVID (x509 + JWT) issuance
  • 146.8.2 SPIRE-compatible node + workload attestation
  • 146.8.3 Short-lived workload tokens with automatic rotation
  • 146.8.4 Mutual-TLS PKI integrated
  • 146.8.5 Kubernetes projected service-account token (TokenRequest)
  • 146.8.6 Cloud-metadata-IMDS compatibility layer
  • 146.8.7 GitHub-Actions / GitLab / Neith CI OIDC federation (Phase 145.6.5)
  • 146.8.8 Secret-less deploy via OIDC to AWS / GCP / Azure
  • 146.8.9 HashiCorp Vault agent sidecar compatibility
  • 146.8.10 Cert-manager / cert-bot integration

Verification (2026-07-13): strict TypeScript and ESLint gates pass, and the workload identity Vitest suite passes 11 tests. Coverage includes node and workload attestation, bounded X.509 and JWT SVID issuance and rotation, mTLS authorization, projected Kubernetes service-account token exchange, hop-limited IMDS adapters, replay-resistant GitHub/GitLab/Neith CI federation, temporary AWS/GCP/Azure deployment credentials, Vault agent injection, and rotating cert-manager/certbot plans.


146.9 @neith/idp-priv — Privileged-Access Management (PAM)#

  • 146.9.1 Just-in-time privileged elevation
  • 146.9.2 Approval-required elevation flow
  • 146.9.3 Session recording (kbd / pty / display)
  • 146.9.4 Credential vaulting for shared accounts
  • 146.9.5 Ephemeral-credential injection (SSH cert, DB cert)
  • 146.9.6 Bastion / jump-host with zero-trust
  • 146.9.7 Break-glass with dual-control
  • 146.9.8 Privileged-task auditor
  • 146.9.9 Dormant-privileged-account flagger
  • 146.9.10 Integration with Neith CI/CD deploy gates (Phase 145.7)

Verification (2026-07-13): strict TypeScript and ESLint gates pass, and the PAM Vitest suite passes 10 tests. Coverage includes independent hardware-MFA JIT approval, automatic expiry, dual-control break-glass, tamper-evident keyboard, PTY, and display recording with redaction, envelope-vaulted shared accounts, bounded SSH/database certificates, zero-trust bastion routing, privileged-task audit integrity, dormant account detection, and production deployment gates.


146.10 @neith/idp-monitor — Audit, Risk & Detection#

  • 146.10.1 Immutable audit log (hash-chained)
  • 146.10.2 SIEM export (syslog, CEF, OCSF, OTEL)
  • 146.10.3 Per-user activity timeline
  • 146.10.4 Risk-score engine (geo, device, velocity, anomaly)
  • 146.10.5 Compromised-credential alerts
  • 146.10.6 Phishing-campaign detector
  • 146.10.7 Honey-credential / honey-token seeding
  • 146.10.8 Identity-threat detection response (ITDR) playbooks
  • 146.10.9 UEBA (user + entity behaviour analytics) baseline
  • 146.10.10 Insider-threat dashboard
  • 146.10.11 MFA bypass / fatigue detector
  • 146.10.12 Token-theft / replay detector (DPoP-aware)
  • 146.10.13 Brute-force / credential-stuffing defense
  • 146.10.14 Regulator-export report (SOX, HIPAA, SOC2, ISO27001, FedRAMP)
  • 146.10.15 Integration with Neith Metron (Phase 142) for admin analytics

Verification (2026-07-13): strict TypeScript and ESLint gates pass, and the identity-monitoring Vitest suite passes 14 tests. Coverage includes hash-chain integrity, per-user timelines, syslog/CEF/OCSF/OTEL exports, regulator evidence, Metron metrics, multi-signal risk, UEBA and insider ranking, compromised and phishing alerts, honey credentials and allowlisted ITDR actions, MFA fatigue, DPoP replay, and successful credential-stuffing detection.


146.11 @neith/idp-console — Admin & User Experience#

  • 146.11.1 Admin console (multi-tenant)
  • 146.11.2 Delegated-admin UI (per-OU)
  • 146.11.3 Bulk import / export
  • 146.11.4 Dry-run policy change with impact preview
  • 146.11.5 Self-service end-user portal
  • 146.11.6 Access-request / approval chat flow
  • 146.11.7 Access-review (attestation) UI
  • 146.11.8 Access-certification campaign runner
  • 146.11.9 Recovery / account-unlock UI
  • 146.11.10 Configurable-branded login
  • 146.11.11 Mobile authenticator app (iOS + Android)
  • 146.11.12 Desktop companion app (push + hardware-key helper)
  • 146.11.13 Chrome / Safari / Firefox / Neith Browser extension
  • 146.11.14 Terminal CLI (neith-idp login, neith-idp impersonate)
  • 146.11.15 Accessibility (WCAG 2.2 AA) on every flow

Verification (2026-07-13): strict TypeScript and ESLint gates pass, 10 console domain tests pass, and three Playwright tests pass. Browser coverage exercises keyboard-operated policy, approval, review, and recovery flows, a 390 px mobile layout, and automated WCAG 2.2 AA checks with no serious or critical axe violations. Domain coverage includes tenant/OU isolation, bulk dry runs, self-service, certification, biometric number-match push, hardware-key helpers, cross-browser extension policy, and audited CLI impersonation.


146.12 @neith/idp-sdk — Relying-Party SDKs#

  • 146.12.1 TypeScript / JavaScript SDK (browser + Node)
  • 146.12.2 React / Vue / Svelte helpers
  • 146.12.3 Swift (iOS / macOS / visionOS / watchOS / tvOS)
  • 146.12.4 Kotlin / Java (Android / JVM server)
  • 146.12.5 Rust / Go / Python / Ruby / PHP / .NET server
  • 146.12.6 Neith Engine / Unity / Unreal session helper
  • 146.12.7 WASM-based universal client
  • 146.12.8 CLI SDK for automation
  • 146.12.9 Keyrock-compatible Kubernetes operator
  • 146.12.10 Terraform / Pulumi provider
  • 146.12.11 REST + gRPC + GraphQL API parity
  • 146.12.12 Webhooks (signed) for downstream consumers
  • 146.12.13 Event stream (Kafka / NATS) for identity events
  • 146.12.14 Mock-IdP test harness
  • 146.12.15 Sample apps per language

Verification (2026-07-13): strict TypeScript and ESLint gates pass, and the relying-party SDK Vitest suite passes 9 tests. Coverage includes the universal client and mock IdP, React/Vue/Svelte and CLI bindings, all requested native and server language plans, engine and WASM ABIs, Keyrock and infrastructure providers, transport parity, replay-bounded webhooks, Kafka/NATS fanout, and issuer/audience-validating sample applications.


146.13 Migration & Interop#

  • 146.13.1 Okta tenant import (users, groups, apps, policies)
  • 146.13.2 Auth0 tenant import
  • 146.13.3 Entra ID / Azure AD tenant import (Graph API)
  • 146.13.4 AWS Cognito user pool import
  • 146.13.5 Keycloak realm export/import
  • 146.13.6 JumpCloud / Ping / OneLogin import
  • 146.13.7 LDAP / AD bulk sync
  • 146.13.8 Password-hash migration (salt-rehash on first login)
  • 146.13.9 Zero-downtime cutover checklist
  • 146.13.10 Dual-issuance period (old + new) with fallback

Verification (2026-07-13): strict TypeScript and ESLint gates pass, and the identity-migration Vitest suite passes 12 tests. Coverage includes normalized users, groups, applications, and policies for every listed SaaS provider, paged LDAP/AD cursors, legacy-hash verification and first-login replacement, evidence-backed cutover readiness, bounded dual issuance, legacy outage tolerance, and automatic fallback shutdown.