Files
scadaproj/nam_ad_requests.md
T

69 lines
5.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 |