docs(ldap): NAM AD request list — new accounts, new groups, groups to confirm, by env and app

Claude-Session: https://claude.ai/code/session_01GT67AFKC45MBz1wPZnVbX8
This commit is contained in:
Joseph Doherty
2026-11-17 11:01:33 -05:00
parent b8cecf309d
commit 74db4db08b
+68
View File
@@ -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 |