Software inventory

Keep a searchable register of the applications and components your organisation runs — each with its vendor, version, status and licence type — inside the Aegis CMDB.

The CMDB (Configuration Management Database — the record of the technology you operate) holds several separate registers. This one is for software: every application, package or component you want compliance and audit work to see. When an auditor asks which version of your finance system was running last March, the answer should come from this page rather than from a spreadsheet on someone's laptop.

Most of the register is built by hand: each entry is typed into a short form, and each correction is made in the same form. Aegis does not scan your network for installed software. There is one automatic source: when the Entra ID connector syncs and the CMDB module is on, it adds your organisation's enterprise applications from Microsoft Entra ID (Microsoft's own first-party apps are left out). The GRC Coach's List what you use step can also add software rows on your behalf.

Who uses it

Reading the register and changing it are separate permissions.

The page also sits behind the CMDB module, which your operator switches on; if it is off, opening the page sends you back to the dashboard. The screenshot below was captured as a Contributor (the demo user Emma Claes), so the add action and the per-row Edit buttons are visible in it.

What's on this screen

The page opens straight onto the full register — there is no dashboard in front of it. The heading reads Software Inventory, with the line "Track and manage software assets, applications, components and versions in your CMDB." beneath it and the primary action Add Software at the far right of that same row. Under the heading sits a two-control filter bar: a Search software... box and an All Statuses dropdown. That is the whole of it — no date range, owner picker or tag filter.

Below that is the table, sorted by name. The captured screen shows nine demo entries, from Adobe Acrobat Pro to Microsoft SQL Server, covering every status from Active to Retired. The columns are Name (with the description in small grey type beneath it, cut short when it is long), Vendor, Version, Status as a coloured badge, License, Owner, End of Life, and — only for roles that can edit — Actions, holding one Edit button per row. An empty value shows as an em dash (—), as in the licence and owner of the first row. Rows are not clickable: software has no detail page and no side panel, so Edit is the only way into a record.

Under the table (below the part of the page in the capture), a "Showing … of … software assets" line sits opposite Previous, the page numbers and Next; twenty rows fit on a page. On a narrow window the table scrolls sideways, with a soft shadow at the edge that still has columns hidden. Around it is the standard Aegis frame: the sidebar, with ASSETS (CMDB) collapsed in the capture, and the top bar with the language picker, theme toggle, help, user guide, notifications and your name. The numbered steps below match the callouts on the figure.

  1. Open the ASSETS (CMDB) group in the sidebar to reach this register. It expands to show Software alongside the other registers — CMDB (machines), Information Assets, CMDB Services, External Services and SBOM, which each have their own chapter.
  2. Select the book icon in the top bar to open this user guide at the chapter for the page you are on. The question-mark icon beside it opens the slide-in help panel instead.
  3. Your account name sits at the top right. If Add Software and the Edit buttons are missing for you, check your role here — a Viewer gets the read-only table.
  4. Select Edit at the right-hand end of the first row. A dialog titled Edit Software Asset opens over the list with the stored values filled in.
  5. Every row carries its own Edit button — this one opens the Retired entry Ivanti Connect Secure, version 22.6. Clicking the row itself does nothing; the button is the way in.
The Software Inventory with demo entries in every status, the add action, the filter bar and the per-row Edit buttons — /cmdb/software.
The Software Inventory with demo entries in every status, the add action, the filter bar and the per-row Edit buttons — /cmdb/software.

Add a software asset

Recording a piece of software takes one short form. Three fields identify the entry and are required; the rest is optional context you can add later. The steps below run through the fields in the order they appear on the form.

  1. Select Add Software at the top right. A dialog titled Add New Software Asset opens over the list, its fields in two columns.
  2. Enter the Name of the application or component — the placeholder reads "e.g., Acme CRM". Required, and capped at 255 characters.
  3. Enter the Vendor / Publisher — who supplies it; the placeholder reads "e.g., Acme Corp". Required when you add an entry, capped at 255 characters, and free text: it is not linked to Vendors.
  4. Enter the Version in use, such as 4.2.1. Required, up to 100 characters. Name and version together identify the entry.
  5. Set Status from the dropdown. It starts on Active; the other choices are Inactive, Deprecated, Retired and Unknown.
  6. Optionally add a License Type (the placeholder suggests "Perpetual, Subscription, Open Source"), comma-separated Tags, and a Description in the wide box below. Each tag can be up to 50 characters, and an entry holds at most 50 tags.
  7. Select Add Software inside the dialog to save. A blank required field is flagged beneath itself and nothing is sent; on success the dialog closes and the table redraws with the new row in its alphabetical place. You become the entry's owner.

Correct an existing entry

Versions change and licences get renegotiated, so entries are meant to be revised. The edit dialog shows the same seven fields, pre-filled with what is stored.

  1. Find the row and select Edit in the Actions column. A dialog titled Edit Software Asset opens with the stored values already in place.
  2. Change what you need. Name and Version must still hold a value, or the dialog flags the empty field and refuses to save. Vendor / Publisher is optional here: an entry imported from Entra ID may arrive without a publisher, so you can save it with the vendor blank, and the table then shows an em dash.
  3. Select Save Changes to save. The dialog closes and the row redraws with the new values; the change is written to the audit log as a CMDB software update, recording who made it and when.
Clearing the tags field removes the stored tags

Emptying Tags and saving sends an empty list rather than leaving the previous tags in place, so retype the whole comma-separated list to correct one tag. On an entry imported from Entra ID, removing the entra-id tag also stops that row following Entra ID at the next sync.

Entries imported from Entra ID

If your organisation uses the Entra ID connector, each sync brings your organisation's enterprise applications into this register when the CMDB module is on. You will recognise these rows by a few traits:

Rows that the import created follow Entra ID: at each sync their name, vendor and status are set again from Entra ID, so a correction to those three fields here does not last. Correct them in Entra ID instead, or use this page for the fields the import leaves alone, such as licence type and description. If an app's name matches an entry you registered by hand, the import links to that entry rather than creating a duplicate, and your entry keeps its own values.

Find something in the register

Two controls narrow the table, and they apply together.

  1. Type into Search software.... The list refreshes shortly after you stop typing and matches on name, vendor or version, ignoring capitalisation — not on the description or the tags.
  2. Open the All Statuses dropdown and pick one value to show only software in that state. Choosing All Statuses again clears it and the full list returns.
  3. Use Previous, the page numbers and Next beneath the table for registers longer than twenty rows. Changing either filter returns you to page one.
  4. If a filter matches nothing, the table is replaced by "No software assets match your search criteria." Clear the search box or reset the status to bring the rows back.

If the register cannot be loaded, a banner above the table reads "Failed to load software assets. Please try again." Reload the page; if it persists, see Getting help.

What the status values mean

The Status column shows a coloured badge recording where a piece of software sits in its life. Agree with your team what each value means before filling the register in — Aegis never moves software between these states on its own. The one exception is an entry imported from Entra ID, which the sync sets to Active or Inactive to match the app in Entra ID.

Status Badge Use it for
Active Green In use and supported. The default for a new entry.
Inactive Grey Recorded and installed, but not currently in use.
Deprecated Yellow Still running but being phased out; plan a replacement.
Retired Red No longer in use; the entry is kept for the record.
Unknown Grey The state has not been established yet.

Starting from an empty register

On a new organisation the table is replaced by "No software assets registered. Add your first software asset to get started." That first-run wording differs from the filtered one, so the screen tells you which situation you are in.

A workable way to fill it is to start with the software inside your compliance scope: anything holding personal data, anything an auditor has asked about, and anything from a supplier you assess in Vendors. A short, accurate register beats a long, stale one and can grow as questions arrive. If you use Entra ID, connecting it first fills in your enterprise applications, and you then add what Entra ID does not know about.

Tips and limits

Where this connects