gemstone-nexus · Phase 6
Phase 5 — Penetration Test Engagement Brief
Metadata
| id | doc_id | title | category | source_path | summary | content_hash | indexed_at |
|---|---|---|---|---|---|---|---|
| 13 | DOC-PENTEST-ENGAGEMENT-BRIEF | Phase 5 — Penetration Test Engagement Brief | reference | DevResources/docs/DOC-PenTest-Engagement-Brief.md | - Independent third-party assessment covering OWASP Top 10 at minimum. - All Critical and High findings remediated and re-tested before production. - Medium findings: documented remediation plan with owner + date (DOC12 / punchlist). | 882de38c41eb0c9c2d5eb54e3db4d535c96adb9d | 2026-07-22 18:33:18 |
Content
# Phase 5 — Penetration Test Engagement Brief *DOC16 companion. Agent cannot execute a third-party pen test — this brief is the handoff package.* **Initiative:** GemStone v2.0 · **Date:** 2026-07-21 · **Status:** Ready for vendor engagement (Auth0 live tenant optional) ## 1. Objectives - Independent third-party assessment covering OWASP Top 10 at minimum. - All Critical and High findings remediated and re-tested before production. - Medium findings: documented remediation plan with owner + date (DOC12 / punchlist). ## 2. Scope (in) | Surface | Notes | | --- | --- | | REST ` /api/*` | Dashboard, packs, Didymus, mobility, gemstone ops | | WebSocket `/ws/*` | Session manager, reconnect/grace, org isolation | | Capacitor WebView origins | `com.nextech.gemstone` web assets under `/app` | | RLS / `org_id` isolation | Cross-org under concurrent load | | TierGuard | Sole enforcement; immutability of session tier | | Didymus approval gate | RUNNING requires `approved_by` + `approved_at` | ## 3. Scope (out / deferred) | Item | Reason | | --- | --- | | Production Auth0 social IdP misconfig deep-dive | Live tenant not required for Phase 0–4 engineering close; include when Auth0 provisioned | | Physical device jailbreak / rooted Android | Device UAT is practitioner (DOC20) | | Social engineering of NEXTECH staff | Separate engagement | ## 4. Staging access (practitioner fills) | Field | Value | | --- | --- | | Staging URL | `_TBD_` (e.g. `https://GemStone.DataRight.net` or dedicated staging) | | Auth0 test tenant | `_TBD_` — no production secrets in ticket | | Test org IDs | `_TBD_` | | Contact | NEXTECH principal | | Freeze tag | After Phase 5 engineering green: annotate tip SHA | **Engineering prep status (2026-07-21):** Brief ready for vendor send. Staging IP currently `https://18.116.188.14` (self-signed). Auth0 live tenant deferred on punchlist — mark Auth0 deep-dive out-of-scope or schedule follow-on. SBOM path: `DevResources/security/sbom-latest.json`. Rollback path documented in playbook / `make rollback`. ## 5. Standing absolute rules (must not be violated in testing) Per DOC16: no session transcripts or raw audio to external APIs; AES-256 at rest; TLS 1.3 in transit; human approval before any Didymus RUNNING. ## 6. Deliverables expected from vendor 1. Executive summary + detailed findings with CVSS/severity. 2. Reproduction steps for Critical/High. 3. Re-test attestation after remediation. 4. Medium remediation plan template (owner, date, residual risk). ## 7. Engineering pre-flight checklist (complete before kickoff) - [ ] Release candidate tag frozen and recorded in DOC12 - [ ] Staging URL reachable; `/healthz` green - [ ] Auth0 test tenant credentials in secrets vault (not repo) - [ ] Backup / rollback path verified (`make rollback`) - [ ] SBOM artifact present (`DevResources/security/sbom-latest.json`) --- NEXTECH Business Technology Management LLC · nex-tech.biz · (941) 499-5505