From 74db4db08bc317fa3f05502e751f732b07e43edd Mon Sep 17 00:00:00 2001 From: Joseph Doherty Date: Tue, 17 Nov 2026 11:01:33 -0500 Subject: [PATCH] =?UTF-8?q?docs(ldap):=20NAM=20AD=20request=20list=20?= =?UTF-8?q?=E2=80=94=20new=20accounts,=20new=20groups,=20groups=20to=20con?= =?UTF-8?q?firm,=20by=20env=20and=20app?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Claude-Session: https://claude.ai/code/session_01GT67AFKC45MBz1wPZnVbX8 --- nam_ad_requests.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 nam_ad_requests.md diff --git a/nam_ad_requests.md b/nam_ad_requests.md new file mode 100644 index 0000000..2f56ee1 --- /dev/null +++ b/nam_ad_requests.md @@ -0,0 +1,68 @@ +# NAM AD requests: accounts and groups + +Everything the family needs **created or confirmed in NAM Active Directory** (`nam.zimmer.com`) for the NAM LDAP +cutover and the related issues, broken out by environment and app. Use this file when raising ServiceNow/IT tickets. + +- Plan: [`docs/plans/2026-11-15-nam-ldap-cutover.md`](docs/plans/2026-11-15-nam-ldap-cutover.md) +- Matrix: [`ldap_mapping.md`](ldap_mapping.md) +- Umbrella: scadaproj#6 + +**Status as of 2026-11-17: nothing requested yet.** Names marked *(proposed)* are our suggestion; IT's naming +convention wins. + +## 1. New accounts + +| # | Account | Type | Env | Used by | Purpose | Required access | Password and policy | Blocks | Issue | +|---|---|---|---|---|---|---|---|---|---| +| A1 | `svc_zbmomww` *(proposed)* | Service account (LDAP lookup) | DEV + QA, one shared account (per-tier only if IT prefers) | OtOpcUa, ScadaBridge, MxAccessGateway, HistorianGateway | Service bind for user search and group reads at login; ScadaBridge group refresh (#46) | **Read-only** search of users (`sAMAccountName`, `userPrincipalName`, `displayName`, `memberOf`) and `UG_WW_*` groups. No interactive or RDP logon. LDAPS 636 to nam1/nam2 | Non-expiring, or managed rotation with notice. **No lockout**, or a very high threshold: one bad secret costs 2 binds per login across 4 apps × 2 tiers | QA cutover (all apps). DEV can run on `svc_igntadmin` as an interim, **only with the Ignition team's agreement** | scadaproj#58 | +| A2 | `svc_zbmomww_auto_dev` *(proposed)* | **User-type** identity (interactive sign-in) | DEV | ScadaBridge CLI, deploy scripts, drills; OtOpcUa scripts if DEV AdminUI login is on | Replaces the login-off dev user once DEV login turns on | Member of `UG_WW_APP_ADMIN_DEV`, `UG_WW_APP_IDE_DEV` and `UG_WW_APP_DEPLOY_DEV` | Non-expiring or managed; stored in the Mac Keychain only | DEV ScadaBridge step (plan D3). Interim: a named admin's own account | scadaproj#6 (D3) | +| A3 | `svc_zbmomww_auto_qa` *(proposed)* | **User-type** identity (interactive sign-in) | QA | Same as A2 | Replaces the GLAuth `multi-role` user on QA | Member of `UG_WW_APP_ADMIN_QA`, `UG_WW_APP_IDE_QA` and `UG_WW_APP_DEPLOY_QA` | As A2 | QA ScadaBridge step (plan D3) | scadaproj#6 (D3) | +| A4 | `svc_zbhistgw` *(proposed)* | Service account (**AVEVA Historian**, not LDAP) | DEV + QA, one shared account or one per tier | HistorianGateway → Historian gRPC (`wonder-sql-vd03`, `wonder-sql-vq03`) | Replaces the personal `NAM\dohertj2` that DEV and QA use today | Historian read/write on both SQL/Historian hosts | Non-expiring or managed; stored as `${secret:}` in HG's store | Not the cutover. A personal-account outage breaks DEV and QA historian access together | historiangw#134 | + +A1 is lookup-only and must not double as a login (A2/A3) unless IT agrees. + +## 2. New groups + +| # | Group | Env | App | Role granted | Why it's needed | Initial members | Blocks | Issue | +|---|---|---|---|---|---|---|---|---| +| G1 | `UG_WW_APP_DEPLOY_DEV` *(proposed)* | DEV | ScadaBridge | `Deployer` | One group = one role, and ScadaBridge `Administrator` does **not** include `Deployer`. Without it, no NAM user can deploy | Deployers on DEV + A2 | DEV ScadaBridge cutover | scadaproj#6 (D6) | +| G2 | `UG_WW_APP_DEPLOY_QA` *(proposed)* | QA | ScadaBridge | `Deployer` | Same as G1 | Deployers on QA + A3 | QA ScadaBridge cutover | scadaproj#6 (D6) | + +## 3. Existing groups to confirm (membership and exact name) + +These existed as of 2026-08-12 (unverified since). **Confirm the exact spelling and case** (HistorianGateway matches +case-sensitively until historiangw#136 ships) and **who is in each**. A user in none of them can't log in to any app. + +| Group | Env | OtOpcUa | ScadaBridge | MxAccessGateway | HistorianGateway | Last seen (members) | +|---|---|---|---|---|---|---| +| `UG_WW_APP_ADMIN_DEV` | DEV | Administrator | Administrator | Administrator | Administrator | 7 | +| `UG_WW_APP_ADMIN_QA` | QA | Administrator | Administrator | Administrator | Administrator | unverified | +| `UG_WW_APP_IDE_DEV` | DEV | Designer | Designer | Viewer | — | 6 | +| `UG_WW_APP_IDE_QA` | QA | Designer | Designer | Viewer | — | unverified | +| `UG_WW_APP_IDE_RO_DEV` | DEV | Viewer | Viewer | Viewer | Viewer | unverified | +| `UG_WW_APP_IDE_RO_QA` | QA | Viewer | Viewer | Viewer | Viewer | unverified | +| `UG_WW_HIST_ADMIN_DEV` | DEV | Viewer | — | — | Administrator | 7 | +| `UG_WW_HIST_ADMIN_QA` | QA | Viewer | — | — | Administrator | unverified | +| `UG_WW_BTMGR_RO_QA` | QA | — | Viewer | — | Viewer | **0 (empty)** | + +`UG_WW_CITRIX_*` is never mapped. Plant-floor, site and batch groups (`*_OPERATOR`, `*_ENGINEER`, `SITE_ADMIN_*`, …) +are out of scope for this cutover (`ldap_mapping.md` §4.2). + +To check one person or a group family: `tools/LdapProbe` (plan §5 D7), for example `-g 'UG_WW_*'`. + +## 4. Summary by environment + +| Env | New accounts | New groups | Groups to confirm | +|---|---|---|---| +| **DEV** (vd03) | A1 (shared), A2, A4 (shared or DEV-only) | G1 | `APP_ADMIN_DEV`, `APP_IDE_DEV`, `APP_IDE_RO_DEV`, `HIST_ADMIN_DEV` | +| **QA** (vq03/vq04) | A1 (shared), A3, A4 (shared or QA-only) | G2 | `APP_ADMIN_QA`, `APP_IDE_QA`, `APP_IDE_RO_QA`, `HIST_ADMIN_QA`, `BTMGR_RO_QA` | + +## 5. Summary by app + +| App | Accounts it uses | Groups it maps | +|---|---|---| +| **OtOpcUa** (AdminUI) | A1; A2/A3 for scripts if login is on | `APP_ADMIN`, `APP_IDE`, `APP_IDE_RO`, `HIST_ADMIN` | +| **ScadaBridge** (Central UI, CLI) | A1 (login + group refresh); A2/A3 (CLI and automation) | `APP_ADMIN`, `APP_IDE`, **`APP_DEPLOY` (new)**, `APP_IDE_RO`, `BTMGR_RO` (QA) | +| **MxAccessGateway** (dashboard) | A1 | `APP_ADMIN`, `APP_IDE`, `APP_IDE_RO` | +| **HistorianGateway** (dashboard + Historian) | A1 (dashboard login); A4 (Historian data access) | `APP_ADMIN`, `APP_IDE_RO`, `HIST_ADMIN`, `BTMGR_RO` (QA) | +| Overview | none (no login by design) | none |