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:

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.

  1. Select the book icon in the top bar. The User Guide opens inside Aegis at this chapter: the address /cmdb/external-services has 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.
  2. Read your name at the top right to confirm which account you are signed in as. That account's role decides whether Add Service and the Edit links are drawn, so check here first if they are missing.
  3. Select the Risks heading 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.
  4. Select the Compliance heading 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.
  5. Select the Assets (CMDB) heading, then External Services beneath it. The register loads with its search box, its status filter, its five-column table and — with the right permission — the Add Service button.
  6. Find the row you want to correct and select Edit at its right-hand end. The Edit External Service dialogue opens with that row's values already filled in, as described under "Correct a service" below.
The External Services register with the search box, the status filter, the Add Service button and an Edit link on every row — /cmdb/external-services.
The External Services register with the search box, the status filter, the Add Service button and an Edit link on every row — /cmdb/external-services.

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.

  1. Select Add Service. The Add External Service dialogue opens over the register, with Cancel and Add Service in its footer.
  2. Enter the Name you know the service by, prompted with "e.g. Stripe". Required, and capped at 255 characters.
  3. Enter the Provider that 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.
  4. Add a Description if a colleague who does not know the service would need one. Optional.
  5. Choose a Status from the list. It opens on Active; the five values are described in the table below.
  6. 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.
  7. Add Tags as a comma-separated list, and Notes for anything an auditor would want in writing. Both optional. Tags are split on the commas and saved as separate labels.
  8. Select Add Service in 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. Cancel closes without saving and discards what you typed.
Validation happens when you submit, not as you type

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.

  1. Select Edit at the end of the row. The Edit External Service dialogue opens with Name, Provider, Description, Status, Data Residency, Tags and Notes already filled in.
  2. Change what is wrong — a typo in the name, a status that has moved on (an Active service you have now switched off becomes Decommissioned), a residency you have since confirmed.
  3. Select Save Changes in 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. Cancel closes without saving.
Neither dialogue has a vendor field, and there is no delete control on this page

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.

Emptying the Tags box does not remove tags

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

  1. 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.
  2. 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.
  3. Read the narrowed table. If nothing matches, the table is replaced by the line "No external services match your search criteria."
  4. Empty the search box and set the status list back to All Statuses to bring the whole register back. There is no separate "clear" control — resetting the two fields is what resets the view.
This list is curated, not discovered

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

Where this connects