Part 5 · Policies & Governance

Vendor Groups

Vendor Groups are how PRA segments third-party access from internal users: a dedicated account container, tied to exactly one Group Policy, with its own expiration rules, notification routing, network restrictions, and — optionally — a branded self-registration portal that still requires an admin's approval before anyone gets in. This module walks through building one end to end using United Intelligence's two vendors, Tardis Tech and Torchwood Tech, as the running example.

Why vendors get their own construct

Third-party support staff are structurally different from internal reps: they need to be provisioned and de-provisioned quickly, their access should expire on its own if nobody renews it, and an organization typically wants a lightweight audit trail (who approved this vendor account, and when). A Vendor Group at Users & Security > Vendors bundles all of that into a single object rather than making an admin reinvent expiration and approval logic every time a new vendor shows up. PRA supports up to 500 vendor groups per site — plenty of headroom for even a large multi-vendor environment.

Creating a Vendor Group

Every Vendor Group needs a unique Name and, critically, a Group Policy selection in its Authorization Settings — that single Group Policy defines the permissions, memberships, and settings for every user who authenticates through that vendor, and those settings cannot be overridden per vendor user. (One guardrail worth remembering: Group Policies that grant administrative permissions are not selectable for a Vendor Group at all — vendors can never be handed admin rights this way.)

Beyond authorization, a Vendor Group configures its own account lifecycle, independent of whatever Account Expiration setting exists on the linked Group Policy:

Vendor Group creation form: Users and Teams for notifications set to Josh Carter, with notification checkboxes and approval checkboxes visible
Lab 27 — configuring notification recipients and approval requirements while creating the Torchwood-Tech vendor group. Approval settings here are what later force Jack Harkness (the vendor admin) to wait on a PRA admin before new registrants activate.

After the first save, PRA insists that every Vendor Group have at least one Vendor Group Administrator — a designated vendor-side user who can manage the other vendor users in that group (and some self-registration portal settings) but who cannot create other vendor admins. You can add that admin immediately via the Proceed prompt or come back to it later from the Vendors page.

All Vendor Groups must have at least 1 admin user pop-up with Proceed button highlighted, followed by adding Jack Harkness as the Torchwood Tech vendor admin
Lab 27 — the mandatory-admin prompt, followed by adding Jack Harkness as the Vendor Group Administrator for Torchwood Tech. A Vendor Group is unusable without at least one admin assigned.

Adding vendor users directly

Once the group exists, a PRA admin can add vendor users the direct way — no portal involved — from Users & Security > Vendors > [group] > Users > Add. Interestingly, a Vendor Group Administrator can do this too: logging in as a vendor admin shows a deliberately reduced left navigation (no PRA Administrator functions like Management are visible at all), and the vendor admin lands directly on the Vendors section scoped to their own group.

Vendor Group Administrator's reduced navigation bar, landing on Users & Security > Vendors > Torchwood-Tech, with the Add button for Users highlighted
Lab 28 — logged in as vendor admin Jack Harkness, the navigation is reduced to Consoles & Downloads, My Account, Vault, Users & Security, and Reports. No configuration or management functions are exposed — the vendor admin can only manage their own vendor group's users.
Add User form for a vendor user: Username gcooper, Display Name Gwen Cooper, Email, Password
Lab 28 — adding vendor user Gwen Cooper directly, the same way a PRA admin would. This bypasses self-registration entirely; it's the right approach when the vendor relationship is small or tightly managed.

The Vendor Portal: self-registration with an approval gate

For larger or more dynamic vendor relationships, PRA can expose a branded self-registration portal instead of requiring an admin to manually add every user. The registration flow has a fixed shape, and it's worth memorizing because it spans three different actors:

Vendor User registers, confirms email Vendor Admin notified, may approve Delegated PRA Admin optional approval step Vendor Group applies Group Policy Access Console / login

Enabling the portal requires a Group Policy already selected on the vendor group; only then does the Enable Vendor Portal checkbox under Vendor Portal Settings become usable. From there, admins can customize a logo, two accent colors and a background color, portal instructions text, the confirmation email's subject and body, the portal's URL, an optional Email Domain Allow List to restrict who's even allowed to register, and a Configurable Slug for the portal's URL path.

Editing the Torchwood-Tech vendor group to enable the vendor portal, with the registration workflow diagram shown
Lab 29 — Torchwood Tech negotiates self-registration with United Intelligence, on the condition that PRA-admin approval is still required to activate new users. Note the documented known issue: in PRA 26.1, the Vendor Admin notification email doesn't reliably send.
Require approval to activate users checked, Enable Vendor Portal checked, and branding color options for the portal
Lab 29 — both approval checkboxes enabled (activate, and extend/reactivate) before turning on Enable Vendor Portal, plus the branding controls for logo and accent/background colors that shape what registrants see.

Walking through registration

From the vendor user's side, registering through the portal triggers a confirmation email before anything else happens — the vendor admin (or delegated PRA admin, if approval is required) cannot even review the request until the registrant confirms their own email address. Clicking the confirmation link marks the email verified and tells the registrant to wait for the admin's decision.

Thunderbird mail client showing the Torchwood-Tech Portal Confirmation Email in Toshiko Sato's inbox
Lab 30 — registrant Toshiko Sato receives a "Torchwood-Tech Portal Confirmation Email" with a one-time confirmation link. Nothing is approvable until this step completes.
Confirmation email body with the verification link, followed by the Your Email is Verified confirmation page
Lab 30 — following the link verifies the email and displays "Your Email is Verified... You will be notified once your account request is processed by the admin," making the approval-gate explicit to the registrant.
Why it matters

The email-confirmation step and the approval step are two separate gates, not one. A malicious or mistyped registration can't even reach a human's inbox for approval until the registrant proves control of that email address — and even after that, nothing activates until a PRA admin (or delegated vendor admin, if allowed) explicitly approves it. Disabling both checkboxes turns the portal into pure self-service; leaving them on, as United Intelligence requires for Torchwood Tech, keeps a human in the loop for every new vendor account.

Common pitfall

Assuming a Vendor Group is just "a Group Policy with a different name." It isn't — the Group Policy only supplies permissions and settings; the Vendor Group layers on account expiration, deletion timers, notification routing, network restrictions, and the entire portal/approval workflow. Two different vendors can point at the same Group Policy (identical permissions) while having completely different expiration windows and approval requirements, because those live on the Vendor Group object, not the Group Policy.