Appendix C — Getting help
How to reach a person, what the help screens inside Aegis actually contain, and how to work through the problems people hit most often.
Compliance work throws up questions no manual can fully anticipate — a regulator asks something unexpected, a deadline moves, or a screen does not behave the way you thought it would. This appendix has three parts. First, the help surfaces built into Aegis and how to open each one. Second, what to send us so that one reply solves the problem. Third, a run through the common problems, each with the likely cause, how to confirm it is the cause in your case, and what to do about it. We would rather hear from you early than have you stuck.
The three help surfaces, and which one to use
Aegis has three separate help surfaces. They look similar but do different things, and they open in different ways.
| Surface | How to open it | What it gives you |
|---|---|---|
Need Help? dialog |
The Help button at the foot of the left menu (its
tooltip reads Get help (Press ? to open)), or the
? key while you are not typing in a field and no other
dialog is open.
|
Your organisation's support contacts — email, phone, portal, help centre — plus support hours and a link into the User Guide. |
| User Guide (this document) |
The book icon labelled User Guide in the top bar, which
opens /help at the chapter for the screen you were on.
The User Guide link at the foot of the left menu,
directly above Help, opens the same page at the
contents.
|
The full guide inside the application, with a printable version and an open-in-a-new-tab link. |
Help Center panel |
The circled question-mark icon in the top bar (its tooltip reads
Open help), or Ctrl / (⌘
/ on a Mac) unless the keyboard-shortcuts feature is
switched on for your workspace.
|
A slide-in panel of short built-in articles with a search box and an
On this page list for the screen you are on.
|
The bare ? key is reserved for the
Need Help? contact dialog, and Ctrl
/ opens the Help Center panel. The
? key does nothing while your cursor is in a text box or while
another dialog is open, so you can type a question mark into a field without
an overlay appearing.
When the keyboard-shortcuts feature is switched on for your workspace,
Ctrl / opens the list of keyboard shortcuts
instead. The Help Center panel is then reached through the
circled question-mark icon in the top bar, which works in every workspace.
Reaching Euraika directly
Whatever your workspace has configured, two routes always reach the Euraika team.
-
Write to
support@euraika.net. Aegis does not put this address on a button for you: the contact cards in theNeed Help?dialog show whatever your administrator has configured, which may be an internal service desk rather than Euraika. -
Open the support portal at
https://support.euraika.netfor guides, known issues, and to raise and follow a ticket. Use it when you want to track the progress of a request rather than trade emails.
Flag anything time-sensitive in the subject line. If you are working through a live security incident or a regulatory deadline, say so — it is far easier for us to prioritise a request that is marked clearly than one we have to infer.
What's on this screen
The Need Help? dialog is the screen most people reach first, so it
is worth knowing what is in it. It opens as a small panel over whatever you were
doing, and it is built from your workspace's own configuration — which means it
will not look identical in every organisation.
-
The header reads
Need Help?and carries a support-tier badge on the right:Basic Support,Standard Support,Priority SupportorPremium Support. The badge is read-only and is worked out from your licence tier, not set by hand. -
The first card is always there.
Browse the User Guide, with the lineSearchable help for every screen, opens this guide inside Aegis. It appears even when no support contact has been configured, so the dialog is never a dead end. -
Then the contact cards, one for each detail your
administrator has filled in:
Email Support(opens a new message),Phone Support(dials the number),Support Portal(opens the site in a new tab) andHelp Center, labelledDocumentation & Guides. Cards for details that have not been set are not shown at all. -
A
Support Hoursgrid at the foot lists the configured days and times, with the timezone in the heading. It appears only when hours have been configured. -
The dialog footer carries the reminder
Press ? to open this dialogand aClosebutton.
If your workspace has not configured any support details, the dialog shows
Support contact information has not been configured. and
Please contact your system administrator. in place of the
contact cards. That is the honest empty state, not a fault — the
Browse the User Guide card still works, and you can always
write to support@euraika.net.
If the contact details could not be fetched at all, the dialog shows
Failed to load support info in that space instead. That is a
loading fault, not a missing configuration: close the dialog and open it
again, and the details are requested afresh.
Opening the User Guide for the screen you are on
The top-bar help icon is context-aware: it opens the guide at the chapter for your current screen rather than at the contents page.
-
Select the book icon labelled
User Guidein the top bar, between the circled question-mark icon and the notification bell. Aegis navigates to/helpwith the chapter for your current screen already loaded, under a header bar titledUser Guide, and the left menu and top bar stay where they are. - Read the guide in the embedded panel. It follows the light or dark theme you have chosen, so it matches the rest of the application.
-
Select
Printable versionin the header bar above the embedded guide to open every chapter as one long page in a new tab. From there, use your browser's print dialog and choose to save as a PDF — there is no separate download file. -
Select
Open in new tabto read the chapter in a full window while you carry on working in Aegis in the original tab. The link follows you as you move around inside the guide, so it always opens the chapter that is on screen, not the one you started from.
Searching the built-in articles
The Help Center panel holds short built-in articles, separate from
this guide, and is the quickest route when you want an answer without leaving
the screen.
-
Select the circled question-mark icon in the top bar. The panel slides in
from the right with the cursor already in the search box, which reads
Search documentation.... If a built-in article is matched to the screen you are on, the panel opens straight at that article. Alternatively, pressCtrl/(⌘/on a Mac) to open the panel at its list of topics. While the chord is available, the search box carries aCtrl+/reminder; the chord, and that reminder, are absent when the keyboard-shortcuts feature is on. - Type a few words. Results replace the category list as you type; if nothing matches, the panel says so and suggests different keywords or browsing the categories.
-
With the search box empty, look at
On this pageat the top of the panel. Those are the articles matched to the screen you were on when you opened it. Below them sit the general categories. - Select an article to read it in the panel. The arrow in the panel header takes you back to the category list.
-
When a documentation portal has been configured for your workspace, an
Open Documentation Portallink sits at the foot of the panel and opens it in a new tab. The panel has no contact link of its own: when the built-in articles do not have the answer, use theNeed Help?dialog to reach a person. PressEscapeto close the panel.
Setting your organisation's support contacts
The contact cards in the Need Help? dialog come from a settings
form. Only an Admin sees this
section.
-
Open
Settingsand choose theSystemtab. Scroll to theSupport Contactcard, subtitledConfigure how users can reach support. -
Fill in the fields you want your colleagues to see:
Support Email,Support Phone,Support Portal URLandHelp Center / Documentation URL. Leave any of them blank and its card is left out of the dialog. Aegis rejects a malformed email address or a link that does not start withhttps://orhttp://, and says so:Check the support contact details: use a valid email address, and links that start with https:// or http://. -
Note the
Support Tierrow beneath the fields, markedBased on your license type. It is read-only — anESSENTIALSlicence showsBasic Support,PROFESSIONALshowsPriority Support, andENTERPRISEshowsPremium Support. -
Select
Previewin the card header to see the dialog with the contact cards and support-tier badge your colleagues will see, then close the preview. -
Select
Save Changes. The confirmationSettings saved successfully.appears, and the next person to press?sees the new contacts.
The Support Contact card has no fields for support hours, and
its preview leaves the Support Hours grid out. Hours that were
configured for your workspace by other means still appear in the real
dialog; ask Euraika support if you need them changed.
What to include when you report a problem
A good report turns a slow back-and-forth into a single reply. Try to include:
- Your workspace (tenant) name — the organisation name shown at the left of the top bar.
-
Your role — Viewer,
Contributor,
Manager or
Admin. Read it on the
Accounttab ofSettings, in theRolerow. -
What you were doing, the page you were on (the address helps — for example
/policies), and what you expected to happen instead. - The exact wording of any error message and the time it occurred. Changes are written to the audit log, so a timestamp lets us trace the action.
- A screenshot, if the screen looked wrong. It tells us more than a description alone.
Common problems
Each of the following names the likely cause, how to confirm it, and what to do. They are grouped by the part of Aegis they affect.
Sign-in: my credentials are rejected
The email address or the password does not match what the system holds. The two usual reasons are a typo in the email, or an account created through single sign-on (SSO), which has no password of its own.
- Copy and paste your email from another application to rule out a keyboard-layout slip, then try again.
-
Look below the email-and-password form for a single sign-on button — it
names your provider, for example
Continue with Microsoft. If it is there, your account most likely has no password of its own; use that button instead of the form. - Check that browser autofill is not inserting an old, stale password.
-
If you still cannot get in, select
Forgot password?on the sign-in screen and reset from the link sent to your inbox. The link is time-limited, so use it as soon as it arrives and request a fresh one if it no longer works. If nothing arrives within five minutes, look in your spam folder — and note that the reset email only goes out when your deployment has email configured.
The full walkthrough is in Signing in.
Sign-in: I landed on the first-time setup wizard, not the dashboard
SSO creates your Aegis account the first time you sign in. The wizard appears when you are the first user in a brand-new workspace, or when your SSO identity was matched to a different workspace from your colleagues'.
- Ask a colleague who already reaches the dashboard which workspace they are in, and compare it with the organisation name in your top bar.
- If you are in the wrong one, your administrator needs to re-invite you to the correct workspace. SSO group mapping decides which identity-provider groups land where, so your identity-provider administrator may also need to adjust your group membership.
See First-time setup for the wizard itself and Signing in with Microsoft Entra ID for the group mapping.
Sign-in: the setup wizard reappears every time I sign in
The wizard is meant to show once. Aegis stamps your account as finished only when you reach the final confirmation screen. Close the browser partway through and that stamp is never written, so you are routed back to the wizard on the next sign-in.
- Work through every step and select the button on the final screen rather than closing the tab once it looks done. Only that last action records completion.
- If it keeps returning for someone who has definitely finished it, ask an Admin to look in the audit log for the user-update entry that records completion. If it is absent, the wizard was never submitted in full and a clean run-through will settle it.
Sign-in: my session keeps expiring
Sessions last for a period your platform operator sets — seven days by default, configurable between one and ninety. If yours ends sooner than expected, the operator has probably shortened it.
- Ask your platform operator to confirm the configured session lifetime on your deployment.
- If it is too short for your way of working, ask them to lengthen it. If the short lifetime is a deliberate security choice, there is no workaround — you will need to sign in at that interval.
Navigation: I opened a link and landed on an Access denied page
A full-page 403 headed Access denied means you reached
a route your role is not allowed to enter — from a bookmark, a link someone sent
you, or a typed address. Beneath the heading it reads
You don't have permission to access this page. If you think this is a
mistake, contact your administrator., and a Go to Dashboard button takes you back.
-
Open
Settingsand read theRolerow on theAccounttab, then check your role against What each role can do for the section you were trying to reach. -
If you need access, ask your administrator to raise your role under
Settings → Users, saying which section you need and why. Role changes take effect at once — you do not have to sign out — but reload the page so the gate is re-evaluated.
The left menu does not show sections you cannot use. An item gated by role,
by an operator-provisioned module or by your licence is left out of the menu
entirely, so an absent entry — rather than a disabled one — is the normal
signal. A padlock appears only inside a page you can already open: a
licence-gated feature renders a centred padlock card with the feature name,
the line
This feature is not available on your current plan. Upgrade to enable
this feature.
and a View Plans button.
Navigation: a menu item I expect is missing entirely
A missing item means one of three things, and they are fixed by different people.
| Gate | What it controls | Who changes it |
|---|---|---|
| Your role | Whether the section is offered to you at all, on an otherwise identical workspace. | Your own administrator, under Settings → Users. |
| Licence tier |
Which modules your subscription includes (ESSENTIALS →
PROFESSIONAL → ENTERPRISE).
|
Your Euraika account manager. |
| Module provisioning | Whether an included module is switched on for your workspace at the platform level. | Euraika support or your platform operator. |
- Ask a colleague on a higher role whether they can see the item. If they can, it is a role gate and your administrator can settle it.
-
Open
/settings/licenseand read the features listed for your current tier. If the feature shows as not included, this is a licence matter — contact your account manager about a tier upgrade. - If it should already be in your tier but is still absent, the module is probably not provisioned. Ask Euraika support or your operator to enable it. Provisioning changes go through the control plane and usually take effect within minutes.
An account manager can change your licence tier but cannot switch on an operator-provisioned module, and an operator cannot change your tier. Ask the wrong person and the answer will be "that is not mine to change". Anomaly detection, some connector types and SBOM management are provisioned this way even on the right tier.
Dashboard: a figure reads zero when I know there is data
The dashboard is rendered on the server and its result is cached for one minute, so a count can lag the underlying records by up to that long. A genuine zero, that caching lag, or a connector that has not finished syncing are the usual reasons.
-
Go to the module the figure represents —
/risksif the open-risk count looks wrong — and check whether records exist there. -
If the module has data but the figure still reads zero, wait a minute and do
a hard refresh (
CtrlShiftRin most browsers). - If a connector feeds the figure — an anomaly count from a security tool, say — open Connectors and check that connector's last sync time and status.
Figures do not update live while you watch them; there is no auto-refresh. The Dashboard chapter explains each widget.
Policies: I cannot approve a policy
Two things gate approval. The policy must be in InReview — it can
never be approved straight from Draft — and your account must be
allowed to approve it.
-
Check the policy's status. If it is still
Draft, it has to be submitted for review first; there is nothing to approve yet. -
Check the
Rolerow on theAccounttab ofSettings. A Viewer or Contributor cannot approve policies — ask your administrator to raise your role if approving is part of your job. - If your role should be enough, your workspace may use the optional multi-approver setting. That is configured per policy category and can require several approvals from named users or specific roles. Ask your administrator who the configured approvers are for that category.
Policies: one keeps showing as overdue for review even after I edited it
Editing a policy body does not reset its review timer. The next review date
shown on the register, the detail page and the dashboard's
Upcoming Reviews list is worked out the same way: a
Review Date you have set by hand wins, and only when it is blank
does Aegis use the Effective Date plus the
Review Cycle. The dashboard's Pending Reviews count
and the register's needs-review filter work differently: they take every policy
in InReview, plus every Approved policy whose
Effective Date plus Review Cycle has passed, and
ignore Review Date. None of these fields changes when you edit the
text, so the policy stays due until one of them moves. That is deliberate — an
edit on its own is not a formal review.
-
Open the policy and look at its
Review Datefirst. If one is set and has passed, it is what makes the policy overdue, whatever the cycle says. Once the review has happened, move it to the next date the policy is due, or clear it to let the cycle decide. -
Read the
Effective Date. If the review really has happened, move that date to the date the reviewed version took effect; the cycle-based due date shifts with it. This is the only change that takes the policy out of thePending Reviewscount, because that count ignoresReview Date. -
Check the
Review Cyclevalue. The create form pre-selects 90 days, and a policy saved without a cycle uses 365; a shorter cycle brings the policy round again sooner than you may expect.
Review cycles are covered in Policies.
AI assistant: the answer is generic and seems not to know my organisation
The assistant works from the context in your prompt plus a little workspace metadata. It does not read every policy and risk on its own — you supply the material. A rate-limited or fallback response can also look thin.
- Check that your prompt contained the content you want the answer to draw on. Paste in the control requirement, regulatory text or risk scenario rather than naming it.
- Look for a warning banner at the top of the AI panel. If the model is unavailable, Aegis shows a fallback message rather than a tailored answer.
- Try again with more specific context. The more concrete the input, the more useful the draft.
The assistant assists; a person reviews and decides. See The AI assistant for what it can and cannot do.
Connectors: Test connection fails
Usually an expired credential (API key, OAuth token or client secret), a changed endpoint, a firewall blocking the outbound connection from Aegis, or a required field filled in wrongly.
- Open the connector's configuration and read the error in the test response — it often names the field or step that failed.
- Check whether the credential has expired. If so, rotate it in the external system and paste the new value into Aegis.
- Ask your platform operator to confirm that the Aegis cluster can reach the external endpoint on the required port.
-
Save the fresh values and select
Test connectionagain. A successful test moves the connector toConnected.
Connectors covers setup for each connector type.
Email and notifications are not arriving
Email goes out over SMTP. Aegis takes its SMTP settings from the deployment's
own configuration first, and falls back to the SMTP connector you set up in the
application. If notifications are on but nothing arrives, SMTP is probably not
configured at all, the connector is in an
Error state, or messages are caught by a spam filter.
- Open Connectors and look for the SMTP connector. If there is none, ask your platform operator whether SMTP is set at the deployment level — it may be configured there instead, in which case nothing appears on this page.
-
If the connector exists, check its status.
Errormeans the last send failed; selectTest connectionto read the current error, then update the credentials. -
Open the recipient under
Settings → Usersand check theEmail Verifiedrow in their detail panel, and ask them to look in spam or junk. - If the message landed in spam, add the connector's from-address to the recipient's allowed senders.
Audit log: an entry I expected is not there
The audit log records changes, not ordinary reading. Browsing, searching and opening records create no entries — creates, updates, deletes, status changes, AI-generated changes, and sign-in or sign-out do. A few deliberate read actions are logged as well, including exports and generated reports, because those take data out of the system.
- Confirm the action was a change or an export. If you only viewed a page, no entry is expected.
- Use the search and filters to narrow by actor (your own name), action type, and the time it happened.
- If the action was a second or two ago, refresh the page.
- If a confirmed, successful change genuinely produced no entry, treat it as a bug and write to support with the action, object, timestamp and user account.
Filtering and exporting the log is covered in The audit log.
Exports: the export is refused or comes out empty
Two different things are called "export", and they fail for different reasons.
Selecting rows in a list and exporting them produces a CSV file,
not a PDF, and needs the export permission — a
Contributor does not have it,
while a Viewer,
Manager and
Admin do. Two lists differ: a
Contributor who maintains the machine inventory can export it, and the risk
register can be exported only by a
Manager or
Admin — a Viewer reads it on screen
but cannot download it. Exporting one record from its own page is a separate
action with its own format.
-
If the export is refused outright, check the
Rolerow on theAccounttab ofSettings. A Contributor cannot export from most lists; ask your administrator if exporting is part of your job. - If a file downloads but holds nothing you expected, check the list filters and the rows you actually selected — the export follows the selection, not the whole module.
- Export a single record from its own page to separate a selection problem from a generation problem, then try a batch of ten to twenty rather than everything at once.
- If even a single export fails, ask your operator to check the application and worker logs for document-generation errors.
Things that work the way they are meant to
Some behaviour surprises people but is a deliberate design choice rather than a fault. Knowing about it before an audit or an onboarding session saves time.
- AI outputs always need human review. The assistant drafts and suggests; it cannot check its own work against your live systems, and language-model output is not repeatable word for word. Every AI-generated item is labelled, and a qualified person must review and approve it before it enters your compliance record.
-
There are four built-in roles.
Viewer,
Contributor,
Manager and
Admin cover every workspace, and
the boundaries between them are fixed in the application — an Admin cannot
redraw them. The
Rolestab inSettingsshows the permission matrix for reference only. Where you need a different cut, an Admin can build a permission group underSettings → Permission Groups; that tab is Admin-only but is not tied to a licence tier. - Delete is a soft delete. Deleting a record hides it from normal views but keeps it, and its audit history, in the database. Ordinary module screens offer no way to erase it for good, so a deletion cannot quietly destroy evidence. Permanent removal of personal data is handled as a GDPR erasure request; see GDPR.
- Figures can be up to a minute stale. The dashboard's server-rendered result is cached for a minute, and nothing polls in the browser. Module pages reload when you open them or make a change. Refresh the browser if you need an up-to-the-second count.
- Risk severity is derived, not stored. The band comes from the risk's score (falling back to impact × likelihood), so the register cannot be grouped by severity in the database. Filtering by band does work — Aegis translates the band into the score range behind it — but if you need to slice by band alongside other columns, export the register and do it in a spreadsheet.
- The compliance score is a coverage measure. It counts the controls that have at least one evidence item which is not deleted and not past its valid-until date, then divides by the controls in your enabled frameworks. It does not judge how strong that evidence is and it does not weight controls by importance. Use Audit readiness for a closer look at evidence health.
-
Global search does not cover everything. It spans policies,
procedures, risks, vendors, evidence, incidents and the connector catalogue.
It does not free-text-search audit-log payloads, compliance documents,
questionnaire responses, DORA ICT asset records or GDPR processing
activities — for those, use the module's own list page.
⌘K/CtrlKalways opens this search. When the keyboard-shortcuts feature is switched on for your workspace, the top bar's search box stops showing the chord as a hint, but the chord still works. - Translations do not refresh themselves. A machine translation of a policy is requested by hand and saved by hand. When the source text changes, the old translation stays visible until someone saves a new one, so build a translation check into your approval routine.
- Each workspace is fully separate. Aegis runs one isolated deployment per organisation — its own database, web server, worker and secrets, with nothing shared between customers. Upgrades are applied to each workspace's own deployment.
A few ISO 42001 AI-governance screens are still early scaffolding and will grow over time. SOC 2 support is planned but not yet shipped — if you see it described anywhere as available, that is ahead of the build. When the application and this guide disagree, trust the application and tell us so we can correct the guide. What is planned next is set out in What is coming next.
Where this connects
Unfamiliar terms are explained in Appendix B — Glossary. For who can do what, see What each role can do; for every action listed by role, see Appendix A — Action catalogue. If you are still finding your way around the interface, The screen layout and The left menu cover the top bar and navigation the help buttons live in.