Skip to content

Address Patterns

This page lists the canonical pattern for each identifier type. All patterns follow the prv-{team}-{type}-{qualifier} structure. In email contexts, append @{domain}.

CategoryPatternExample
Departmentprv-{dept}-deptprv-eng-dept
Teamprv-{dept}-team-{teamslug}prv-eng-team-apps
People rosterprv-{scope}-people-{audience}prv-org-people-w2-active
Identity rosterprv-{scope}-ident-{audience}prv-org-ident-auto-active
Roleprv-{owner}-role-{system}[-{scope}][-{env}]-{perm}prv-plt-role-aws-idc-prd-admin
Mailprv-{audience}-mail[-{topic}]prv-team-mail-engineering-updates
Intakeprv-{owner}-intake-{source}[-{topic}]prv-sec-intake-wks-dlp
Alertsprv-{owner}-alerts-{system}[-{scope}][-{env}]prv-plt-alerts-aws-prd
Infraprv-{owner}-infra-{system}[-{scope}][-{env}]-{purpose}prv-plt-infra-gl-ci-router
Automationprv-{owner}-auto-{system}-{purpose}prv-plt-auto-wks-sync
Admin accountprv-{owner}-admin-{vendor}prv-plt-admin-aws
Customer umbrellaprv-{owner}-cus-{cusslug}-{audience}prv-ops-cus-slope-collab
Projectprv-{owner}-prj-{cusslug}-{prjslug}-{audience}prv-eng-prj-slope-mod-team
Vendorprv-{owner}-vendor-{extorg}prv-ops-vendor-acme
Partnerprv-{owner}-partner-{extorg}[-{function}]prv-sal-partner-aws-alliance
Fleetprv-flt-{qualifier}prv-flt-monitoring-prd

People rosters track who is in a lifecycle state. They carry no privileges — they’re membership lists that other groups reference.

prv-{scope}-people-{audience}@{domain}
prv-{scope}-ident-{audience}@{domain}

Examples:

PatternPurpose
prv-org-people-execs-activeActive executive team members
prv-org-people-w2-activeActive W-2 employees
prv-org-people-contractors-eng-activeActive engineering contractors
prv-org-people-all-activeRollup: all active humans
prv-org-ident-auto-activeActive automation accounts

Departments are durable organizational units. Teams are working groups within departments.

prv-{dept}-dept@{domain}
prv-{dept}-team[-{teamslug}]@{domain}

Examples:

PatternPurpose
prv-eng-deptEngineering department
prv-eng-team-appsApps team within Engineering
prv-eng-team-sreSRE team within Engineering
prv-plt-team-wksWorkspace team within Platform
prv-sec-team-grcGRC team within Security

Roles grant access to systems. The owner (second octet) is the team that manages the role, not necessarily the team that uses it.

prv-{owner}-role-{system}[-{scope}][-{env}]-{perm}@{domain}

Examples:

PatternPurpose
prv-plt-role-wks-adminGoogle Workspace admin, managed by Platform
prv-plt-role-aws-idc-prd-adminAWS Identity Center prod admin
prv-eng-role-gl-maintainerGitLab maintainer, managed by Engineering
prv-plt-role-tf-cloud-adminTerraform Cloud admin

Four pipe types, each for a different purpose. See Mail Pipelines for the full guide.

prv-{audience}-mail[-{topic}]@{domain}

Distribution lists and shared inboxes for human readers.

PatternPurpose
prv-team-mail-allAll-hands distribution
prv-team-mail-eng-updatesEngineering updates
prv-collab-mail-supportExternal support inbox
prv-{owner}-intake-{source}[-{topic}]@{domain}

Where machines send reports, audit feeds, and automated notifications.

PatternPurpose
prv-sec-intake-wks-dlpWorkspace DLP scan results
prv-plt-intake-aws-billingAWS billing reports
prv-sec-intake-dmarcDMARC aggregate reports
prv-{owner}-alerts-{system}[-{scope}][-{env}]@{domain}

Urgent notifications routed to on-call personnel.

PatternPurpose
prv-plt-alerts-aws-prdAWS production alerts
prv-sec-alerts-op-breach1Password breach alerts
prv-plt-alerts-wks-adminWorkspace admin alerts
prv-{owner}-infra-{system}[-{scope}][-{env}]-{purpose}@{domain}

Machine-to-machine routing. No humans as direct members.

PatternPurpose
prv-plt-infra-gl-ci-routerGitLab CI event router
prv-plt-infra-tf-plan-notifyTerraform plan notifications
prv-sec-infra-wks-dlp-classifierWorkspace DLP finding classifier
prv-{owner}-auto-{system}-{purpose}@{primary_domain}

Bot and service account identifiers.

PatternPurpose
prv-plt-auto-wks-syncWorkspace sync bot
prv-eng-auto-gl-ci-runnerGitLab CI runner account
prv-sec-auto-op-rotation1Password credential rotation

Shared admin accounts for platform services:

prv-plt-admin-{vendor}@{domain}
PatternPurpose
prv-plt-admin-awsShared AWS admin
prv-plt-admin-glShared GitLab admin
prv-plt-admin-tfShared Terraform admin

Customer infrastructure fleet identifiers:

prv-flt-{qualifier}
PatternPurpose
prv-flt-monitoring-prdProduction fleet monitoring
prv-flt-dns-mgmtFleet DNS management
prv-flt-cert-rotationFleet certificate rotation
prv-{owner}-cus-{cusslug}-{audience}@{domain}
prv-{owner}-prj-{cusslug}-{prjslug}-{audience}@{domain}
PatternPurpose
prv-ops-cus-slope-collabSlope Clinical — external collaboration
prv-ops-cus-slope-teamSlope Clinical — internal team
prv-ops-cus-slope-strictSlope Clinical — restricted/sensitive
prv-eng-prj-slope-mod-teamSlope Modernization project — internal
prv-{owner}-vendor-{extorg}@{domain}
prv-{owner}-partner-{extorg}[-{function}]@{domain}
PatternPurpose
prv-ops-vendor-acmeAcme vendor engagement
prv-sal-partner-aws-allianceAWS alliance partnership
prv-eng-partner-gl-prosrvGitLab professional services