External Services
A hand-kept register of the third-party, SaaS and supplier-delivered services your organisation depends on, held inside the configuration database alongside your own machines.
An external service (a piece of software or infrastructure that someone else runs for you — a hosted email platform, a payments provider, a payroll SaaS) is part of your real attack surface even though you do not operate the server. This page is the corner of the CMDB (Configuration Management Database — the record of the technology your organisation runs) that tracks those services, so an auditor can see in one place which outside systems your work depends on and where their data is held.
The page is deliberately slim: each row records a name, a provider, a status, where the data sits and the vendor it belongs to. It is a governance view for the compliance team, not a replacement for an IT-operations CMDB.
Who uses it
The page sits behind the CMDB module gate, so it appears only when
your operator has enabled that module for your organisation. Within the module,
the buttons you see follow your role:
-
Viewer holds
EXTERNAL_SERVICE_READonly, so a Viewer may read every row, search the register and filter it by status, and neither theAdd Servicebutton nor theEditlinks are drawn. TheExternal Serviceslink in the sidebar is shown to every role, Viewer included. -
Contributor adds
EXTERNAL_SERVICE_CREATEandEXTERNAL_SERVICE_UPDATE, so theAdd Servicebutton appears in the header and anEditlink appears at the end of every row. The capture below is a Contributor account. -
Manager and
Admin hold the same rights plus
EXTERNAL_SERVICE_DELETE, and the wider asset-management rights described in the main CMDB chapter.
What's on this screen
The figure below is the register signed in as a Contributor account in the fictional demo organisation. Read it in three bands.
The header band runs across the top of the content area. At its left is the
heading
External Services with the one-line description "Track third-party,
SaaS, and supplier-delivered services in your CMDB." At the far right of that
same line is the dark blue Add Service button — on screen only
because this account holds EXTERNAL_SERVICE_CREATE.
The filter band sits under the heading and holds two controls side by side: a
search box,
Search external services..., and a status list that opens on
All Statuses. Both apply on their own — there is no
Apply button. There is no provider filter, no date range and no
sort control.
The register itself is one bordered panel holding a five-column table —
Name, Provider, Status,
Data Residency and Vendor — followed by an unlabelled
column of blue Edit links. The captured screen shows the demo
register ordered by name, with more rows below the fold than fit on screen (the
page draws at most the first 20; see "Tips and limits"). It mixes all five
statuses: most rows are Active, and among the others are a
Decommissioned fax gateway, an Inactive payments
service, a Deprecated SMS service and a trial whose status is
Unknown. Data residency is written in several styles ("EU
(Frankfurt)", "EU Data Boundary", "BE", "EU/CH", "US") — a reminder that the
field is free text. Most rows name a vendor; a few show an em dash because no
vendor record is attached. Rows highlight on hover but are not links: the row
itself opens nothing, and there is no checkbox, no row menu and no detail page
behind it. The only row action is Edit. Before anything is
registered the panel reads "No external services registered. Add your first
service to get started." instead.
Around all that sits the usual workspace furniture. On the left is the sidebar,
with every group folded in this capture — Governance,
Risks, Compliance, Audit,
Documents, Privacy & Whistleblowing,
Security Incidents, Assets (CMDB), AI,
Reporting and Administration — and
User Guide and Help links at its foot. A group stays
open or folded as you last left it; being on one of its pages does not unfold
it. Unfolded, Assets (CMDB) holds
External Services beside its siblings CMDB,
Software, Information Assets,
CMDB Services and SBOM. Along the top run your
organisation's name, global search, the language switch, the dark-mode toggle,
the Help "?" button, the User Guide book icon, the notification bell, your
initials and name, and Sign out.
Open the register and check what you may do
The numbered steps below match the callouts on the figure that follows, working from the top bar down the left-hand menu and into the table.
-
Select the book icon in the top bar. The User Guide opens inside Aegis at
this chapter: the address
/cmdb/external-serviceshas its own entry, so you land here rather than on the main CMDB chapter. The "?" button beside it is different — it opens the slide-in Help panel with short topics for the page and a search box. -
Read your name at the top right to confirm which account you are signed in
as. That account's role decides whether
Add Serviceand theEditlinks are drawn, so check here first if they are missing. -
Select the
Risksheading in the sidebar. A sidebar heading is a toggle, not a link: it unfolds to show the pages beneath it, and you pick one from there. The risk register is where an external service usually ends up next — a provider outside the EU, say, or one with no exit plan. -
Select the
Complianceheading to unfold that group in the same way, when you need the frameworks a service may fall in scope for and the obligations it touches. -
Select the
Assets (CMDB)heading, thenExternal Servicesbeneath it. The register loads with its search box, its status filter, its five-column table and — with the right permission — theAdd Servicebutton. -
Find the row you want to correct and select
Editat its right-hand end. TheEdit External Servicedialogue opens with that row's values already filled in, as described under "Correct a service" below.
Register a service
Add Service opens a dialogue titled
Add External Service. Two fields are required —
Name and Provider — and everything else is optional.
The guide has no capture of this dialogue, so work through it top to bottom as
described.
-
Select
Add Service. TheAdd External Servicedialogue opens over the register, withCancelandAdd Servicein its footer. -
Enter the
Nameyou know the service by, prompted with "e.g. Stripe". Required, and capped at 255 characters. -
Enter the
Providerthat runs it, prompted with "e.g. Stripe Inc.". Also required and also capped at 255 characters. The two fields are separate on purpose: the product you use and the company behind it are not always the same words. -
Add a
Descriptionif a colleague who does not know the service would need one. Optional. -
Choose a
Statusfrom the list. It opens onActive; the five values are described in the table below. -
Enter
Data Residency, prompted with "e.g. EU, US". This is free text with no picker and no validation, so agree a house style first — otherwise "EU", "eu" and "Europe" all sit in the same column meaning the same thing. -
Add
Tagsas a comma-separated list, andNotesfor anything an auditor would want in writing. Both optional. Tags are split on the commas and saved as separate labels. -
Select
Add Servicein the footer. The record is saved, the dialogue closes and the table reloads with the new row in it. You are recorded as the service's owner, and the create is written to the audit log naming you as the actor.Cancelcloses without saving and discards what you typed.
The Add Service button in the footer stays available while
Name or Provider is blank. Select it with either
one empty and the dialogue stays open with "Name is required" or "Provider
is required" under the field concerned. If the save itself fails, the
server's message appears in a red band above the fields and your entries are
kept, so you can correct and retry. The same rules apply in the edit
dialogue.
The Status values, which appear in the dialogue, in the status
filter and in the table column:
| Status | Use it for |
|---|---|
Active |
The service is in use today. This is the value the dialogue starts on. |
Inactive |
Registered, but not in use at the moment. |
Deprecated |
Still running, but on the way out — no new use should be made of it. |
Decommissioned |
Switched off, and kept in the register as a record that it once existed. |
Unknown |
Nobody has established the current state yet. |
Aegis attaches no behaviour to the status: nothing is hidden, archived or
re-scored when you change it, and a Decommissioned service stays in
the default list. It is a label for the people reading the register, and the
status filter is how you read one group of them at a time.
Correct a service
Each row's Edit link opens the same form as
Add Service, filled with that row's current values. It needs
EXTERNAL_SERVICE_UPDATE, so it is drawn for
Contributor and above. The
guide has no capture of this dialogue.
-
Select
Editat the end of the row. TheEdit External Servicedialogue opens withName,Provider,Description,Status,Data Residency,TagsandNotesalready filled in. -
Change what is wrong — a typo in the name, a status that has moved on (an
Activeservice you have now switched off becomesDecommissioned), a residency you have since confirmed. -
Select
Save Changesin the footer. The dialogue closes, the table reloads with the corrected row, and the change is written to the audit log as an update naming you as the actor and listing the fields that were sent.Cancelcloses without saving.
Vendor has its own column, but neither the create nor the edit
dialogue offers it, so a service created here is always saved with
Vendor empty, and Save Changes leaves whatever
vendor a row already has untouched. Attaching a
vendor record means setting
vendorId through the API — on
POST /api/cmdb/external-services at creation, or on
PATCH /api/cmdb/external-services/<id> afterwards. There
is likewise no delete control on this screen: removing a retired row means
DELETE on that same address, which only
Manager and
Admin may call and which
soft-deletes the row (hides it from the register while keeping the record).
If none of that is work you do yourself, it is a job for your operator.
Short of that, setting the status to Decommissioned is the
on-screen way to mark a service as gone.
In the edit dialogue, clearing Description,
Data Residency or Notes and saving empties that
field. Tags behaves differently: a blank Tags box
is not sent at all, so the row keeps its existing tags. To change tags, type
the full list you want in their place; to remove every tag, ask your
operator.
Find a service
-
Type any part of a service's name, provider or description into
Search external services...(upper or lower case makes no difference). The register is re-queried on the server a moment after you stop typing (about a third of a second), not on every keystroke, and a loading skeleton shows briefly while the list reloads. -
Pick a value in the status list — say
Deprecated— to show only the services with that status. It applies as soon as you choose it and combines with the search text. - Read the narrowed table. If nothing matches, the table is replaced by the line "No external services match your search criteria."
-
Empty the search box and set the status list back to
All Statusesto bring the whole register back. There is no separate "clear" control — resetting the two fields is what resets the view.
Aegis does not scan your network or your cloud accounts to find external services on its own. Every row here is one a person has registered. Treat it as a maintained record: add services as you adopt them, and read the register through before an audit so it still reflects what you actually use.
Tips and limits
- This is a register, not an asset-relationship map. For machines, software and the wider inventory, use CMDB and its sibling pages Software, Information Assets and CMDB Services.
-
Data ResidencyandVendorshow an em dash when empty. Empty does not mean "none" — it means nobody has recorded a value, so do not read a blank cell as a settled answer. - The table has no sorting and no pagination controls. The screen asks for the first page only, so it shows at most the first 20 services in name order; anything after that is not drawn at all. The underlying API supports sorting and further pages, but this screen does not surface them. Once the register passes 20 services, use the search box and the status filter to reach the rest.
-
If the list fails to load, the panel shows "Failed to load external
services." with a
Retrybutton. Select it to re-fetch rather than reloading the whole page. -
If Aegis cannot look up your role, a banner above the heading says so,
because every role-dependent control —
Add Serviceand theEditlinks — is hidden until it can. SelectRetryin the banner to look the role up again; if the banner stays, contact your administrator. -
If the
Assets (CMDB)heading unfolds without anExternal Servicesentry under it, the CMDB module is not enabled for your organisation; the entry does not depend on your role. The module is a matter for your operator, not something you can switch on from Settings.
Where this connects
- CMDB and asset inventory — the wider asset register this page belongs to, and the machines the services run beside.
- Vendors — the supplier behind a service, and the due diligence held on them.
- Risks — where to raise and track a risk about a service whose data residency, status or provider is a concern.
- Connectors — where live integrations to outside systems are configured and run, as opposed to this hand-kept record.
- Onboarding a new vendor — the end-to-end journey in which registering the service is one step.