devguard

Mandates

Run compliance for several client organizations from one place, see which client needs you first, and show each client your brand instead of devguard's.

A mandate is the account of a consultancy, a vCISO practice or an MSP (managed service provider) that runs compliance for its clients. Each client is its own organization under the mandate, with its own register (its controls, policies, risks and evidence), its own people and its own audit log. Your team gets one list of all clients, one queue of their open tasks and one portfolio report.

What a mandate gives you as a partner:

  • Your clients see your logo in the app, not devguard's.
  • devguard bills you, not your clients. Your clients never get an invoice or a payment reminder from devguard.
  • If a payment of yours fails, your clients keep working until 14 days after the paid period ends.
The Acme AG app with the Northwind IT logo at the top of the sidebar, above the organization switcher.
Acme AG works in its own organization, but the sidebar shows the partner's logo.

You set up once:

Then, in the daily work:

Scripts and integrations: see For developers below.

Get a mandate

You cannot switch on a mandate in the app. devguard support turns one of your organizations into a mandate. To ask for it, book a consultation. The offer starts at five licenses.

Buy licenses

Each client uses one license, and a demo client uses none; it still works on the mandate's Business plan. You pay for every license you hold, whether a client uses it or not.

  1. In the sidebar, open Billing.
  2. Choose Monthly or Yearly and complete the payment.
  3. Under How many licences, set the number with the minus and plus buttons, then choose Save.
The Licences panel: 10 licenses, 3 in use, and What you pay with one line per client, 7 unused licenses and the monthly total.
Unused licenses are listed with their price, because you pay for them too.

More licenses take effect at once and are prorated. A lower number takes effect at the end of the billing period, never below the licenses in use. From the moment you schedule it, you can add clients only up to the lower number. To add more, choose Keep the current licences, which cancels the reduction.

Put your brand on it

Do this before the first client, so the client sees your brand from the first day.

  1. Open Branding. Upload your Full logo and set the Primary color and Secondary color.
  2. Open Settings. Under Support, enter a Support email and a Help URL, then choose Save.
The Branding page: the Northwind IT logo, a dark blue primary color and a teal secondary color.
The logo also shows in every client's app.

Your Company links replace devguard's legal links in your clients' footer. Without them, the footer keeps devguard's site notice, privacy policy and terms. The report uses your mandate's name, logo and colors. Support in your clients' user menu opens your Help URL. If you leave it empty, it opens devguard support.

Add a client

  1. Open Clients and choose Add client.
  2. For a new client, choose New organization in the Add client menu. Enter the Name and choose Create.
  3. For an organization that exists already, choose Attach existing organization, choose it and then Attach. It keeps all its data.
The Add client dialog with the name Bergsicht Immobilien AG entered.
You manage the new client in your mandate role: a mandate admin becomes its admin.

Each client uses one license, a demo client none. You can attach only an organization that you own, that is under no other mandate, and that pays for no subscription of its own.

A new organization has no people of its own. Invite the client's staff to it, so they can take it over if you ever detach it.

Copy one client's setup into another

  1. Open Templates.
  2. Under Client to copy from, choose a client and then Download template. You get a JSON file.
  3. Under Client to copy into, choose the new client. Choose Choose file and select the file.
  4. Check the preview, then choose Copy into and confirm.
The template preview for a second copy of the Acme AG template into Seeblick Treuhand GmbH: every section shows 0 under Would be created and the existing count under Already here.
Seeblick Treuhand GmbH got this template before, so a second copy would create nothing.

The copy brings:

  • frameworks and their coverage links
  • policies, as drafts
  • risks, treatment actions, assets and vendors
  • evidence requirements, record categories and record templates
  • processes, trainings, tasks and questionnaires
  • business roles, without their members
  • definitions, acronyms, labels, locations, variables, schedules and the asset, threat and vulnerability classes

It leaves behind members, files, images, comments, reviews, assessments and all history. It also leaves out a questionnaire condition that cannot be read or names an id the questionnaire does not have, since it has no effect.

Watch out: you cannot remove copied entries from this page. Existing entries, archived ones too, are never overwritten.

How your team reaches the clients

Your colleagues work in each client with the role they have in the mandate. You do not invite them into each client.

Role in the mandateClients they reachRole in the client
Owner, adminEvery clientSame role
Member, auditorOnly the clients switched on under AccessSame role
Employee, externalNoneNone

A change in the mandate (invite, role change, deactivation, removal) applies in every client the person reaches. The client cannot remove your team or change their roles.

For people who had a role in a client before it joined, see Earlier roles in a client.

Give your team access to clients

  1. Open People and invite the person to the mandate as Member or Auditor.
  2. Open the person and go to the Access tab.
  3. Under Client Access, switch on each client they work for.
The Access tab of Lea Brunner, a member of the mandate: Client access with Seeblick Treuhand GmbH switched on and Acme AG and Rheintal Logistik AG off.
Lea Brunner works only in Seeblick Treuhand GmbH.

Switch a client off to take access away. The person leaves the client at once. Their tokens and app connections for that client stop working. This does not apply if they had their own role there before. Only owners and admins of the mandate change access.

See which client needs attention

  1. Open Clients. Clients with overdue tasks come first and show Needs attention.
  2. Read Coverage, Overdue and Due soon (the next 30 days) for each client.
  3. Click a client's name to open its dashboard.
The Clients list of Northwind IT AG: Acme AG with 77% coverage, 6 overdue and 9 due-soon tasks and Needs attention, Seeblick Treuhand GmbH at 8%, and the new client Rheintal Logistik AG without frameworks.
Acme AG has overdue tasks, so it comes first.

The figures are kept for five minutes. After a change in a client, choose Refresh.

Work through the open tasks

  1. Open Work queue. It lists the open tasks of all clients, grouped by client, with the most urgent client first.
  2. Start at the top. Overdue dates are red. Tasks without a deadline come last.
  3. Click a task. devguard switches to that client and opens the task.
The Work queue: Acme AG with 6 overdue and 19 open tasks, each with its deadline, the overdue dates in red.
The counts in the header include tasks the list does not show.
A click on an overdue Acme AG task switches to Acme AG and opens the task.

The queue shows the 50 most urgent tasks across all clients. Some clients have no tasks in those 50, or no open tasks at all. Their group is collapsed, and its header still shows the counts.

Send the portfolio report

  1. Open Report and choose Generate Report.
  2. If you want, enter a Custom Footer and choose Save. It is not kept for the next report.
  3. Choose Download PDF.
The cover of the portfolio report: Portfolio report, mandate Northwind IT AG, 3 clients, 1 client needs attention, prepared by Northwind IT AG.
The cover names your mandate and uses your colors.

The report has an executive summary, one row per client (coverage, open work, next audit, last activity), the clients with overdue work and the upcoming audits.

Detach a client

Detaching ends your team's access and frees the license. The organization keeps its data and moves to the free plan.

  1. Open Clients. In the client's row, open the menu and choose Detach from this mandate.
  2. Turn on Hand it to the client if the client continues with devguard on its own. The client's own admins and members then get an email with a link. If the organization has no owner left, one of them can become its owner and pay devguard directly.
  3. Choose Detach.
The Detach dialog for Seeblick Treuhand GmbH with the Hand it to the client switch turned off.
Despite the hint, nothing is locked: the data stays, on the free plan.

The client's own owners, admins and members get an email either way.

The detach is refused if nobody of the client's own would be left to open the organization, or, with Hand it to the client on, to take it over (an auditor cannot). Invite someone into the client and have them accept the invitation first, or export its data. If you attached your own organization, you are removed from it.


Reference

Who can open the mandate pages

Owners, admins, members and auditors of the mandate. A person in no mandate is sent to their dashboard, and a deactivated person cannot open the pages. Opening a mandate page makes the mandate your active organization, and the sidebar shows the Mandates section.

Earlier roles in a client

A person may already have a role in a client before it joins the mandate:

Earlier role in the clientWhile they are in the mandateWhen the mandate role ends
Member, auditor, employee or externalThe higher of the two rolesThe earlier role comes back
Owner or admin, and owner or admin in the mandateThe mandate roleRemoved from the client
Owner or admin, and member or auditor in the mandateTheir own roleTheir own role

Permissions

ActionOwner, adminMember, auditor
Clients, Work queue, ReportYes (all clients)Yes (their clients)
Read the mandate's Audit LogYesYes
Add, attach, detach clientsYesNo
Templates, Branding, Billing, SettingsYesNo (hidden, changes refused)
Change client accessYesNo (can see own)

Billing

  • One license per client; a demo client uses none.
  • Clients work on the mandate's Business plan.
  • After a failed payment, clients keep the plan until 14 days after the paid period ends. After a cancellation there is no grace. Then the clients fall back to the free plan.

Limits

  • A client cannot be a mandate itself.
  • A mandate that still has clients cannot be deleted.
  • A template carries at most 5,000 entries per section. An import counts against the receiving client's plan limits. When the plan has too little room, the preview names each section over its limit, with what the template adds and what the plan still allows, and the copy is refused until the client's plan has room.

Audit log

The mandate's Audit Log lists added and detached clients, access changes and license changes. Access changes and template copies also appear in the client's audit log.

For developers

Mandates have no public API. The mandate pages use internal endpoints with the user's session; they are not in the API reference.

  • A connected app (OAuth grant) or an API token scoped to one organization cannot read the Clients list or the Work queue.
  • An API token that is not scoped reaches every client its owner reaches, in the same role.
  • To work inside a client, call the normal API with the client's organizationId. It is in the client's Settings under Organization UUID.
List a client's overdue evidence
F='{"nextReviewAt":{"type":"date","preset":"overdue"}}'

curl -sS -G "https://app.devguard.ch/api/evidence/" \
  -H "Authorization: Bearer $DG_TOKEN" \
  --data-urlencode "organizationId=$CLIENT_ORG" \
  --data-urlencode "filters=$F"

DG_TOKEN is an unscoped API token of a person who reaches the client. CLIENT_ORG is the client's Organization UUID.

How is this guide?

On this page