EterShieldDocs
etershield.com
PTLog in
Guide/Get started

Entities

Entities represent the organisational units managed on the platform (companies, departments, subsidiaries, clients).

Creating an entity

  1. Go to Entities in the sidebar
  2. Click New Entity
  3. Fill in the fields:
  4. Name (required)
  5. Tax ID (NIF): tax identification number
  6. Sector: sector of activity
  7. Size: Micro / Small / Medium / Large
  8. Country (default: PT)
  9. Website, Description
  10. Contact: name and email of the person in charge
  11. Number of employees
  12. Annual revenue (EUR) (optional): a number equal to or greater than 0, in euros; leave it empty if you prefer not to give it (when editing, clearing the value removes it). It is the basis for the euro quantification of supplier risk (section 9)
  13. Parent entity (optional): see "Groups and subsidiaries" below

Groups and subsidiaries (entity hierarchy)

For business groups, you can organise entities in a tree: a parent entity (the holding company) and its subsidiaries.

  • In the entity form, the Parent entity field lists the other entities (by default, "None (top-level entity)"). An entity cannot be its own parent or the parent of one of its ancestors.
  • In the entity list, each subsidiary shows "Subsidiary of ..."; on the entity page, the subsidiary links to its parent and the parent lists its Subsidiaries, with a link to each one.
  • Only the Admin and Super Admin roles can set or change the parent entity.

Consolidated group view. When you select the parent entity in the entity selector, pages show the data of the parent and of all its subsidiaries, for example the Dashboard, Risks, Asset Inventory and Contracts. The Dashboard indicates this with the message "Consolidated group view: includes N companies below this entity". When you select a subsidiary, you see only that subsidiary's data.

A role assigned on a parent entity is inherited by the subsidiaries that have no assignment of their own.

Entity page

Each entity has a detailed page with tabs:

  • Overview: KPIs: assessments, risks, incidents, gaps, tasks, score
  • Risks: list of associated risks
  • Gaps: the entity's non-conformities
  • Tasks: pending tasks
  • Profile: entity characterisation wizard (see section 3.1)
  • Knowledge: the entity's knowledge base with CISO validation queue (see section 3.2)
  • Meetings: meetings associated with the entity

3.1 Profile Tab (Characterisation Wizard)

The profile wizard lets you characterise the entity in detail, providing context that the AI uses in all operations (Cook, Gap Analysis, answer suggestions).

Wizard steps:

Step Fields
1. Identification Name, Tax ID (NIF), Country, Address, Website
2. Business Sector, Size, Number of employees, Description, Main services
3. Systems Technology stack, Cloud environments, Critical systems, Integrations
4. Regulation Applicable frameworks, Personal data categories, NIS2 authority, Maturity level
5. Team CISO, DPO, IT Manager, contacts
6. Maturity Assessment of the current security maturity level

Completeness score: progress bar at the top of the wizard (0-100%) that reflects in real time the percentage of fields completed.

Suggest with AI (Regulation step):

  1. Fill in the entity's sector and description (steps 1-2)
  2. In the Regulation step, click Suggest with AI
  3. Claude analyses the profile and suggests:
  4. Applicable frameworks (ISO 27001, NIS2, DORA, GDPR, etc.)
  5. Categories of personal data processed
  6. Competent NIS2 authority (CNCS, ANACOM, BdP, etc.)
  7. Estimated maturity level
  8. Suggestions fill only the blank fields: they never overwrite information already entered
  9. Review and adjust before saving

3.2 Knowledge Tab (Knowledge Base)

The Knowledge tab is the entity's knowledge base. All approved information is used automatically by the AI in Cook, Gap Analysis and answer suggestion operations (RAG: Retrieval-Augmented Generation).

Submitting free-form information

  1. In the Knowledge tab, type text in the input field (e.g. "The client uses Azure AD and has an active contract with Microsoft until December 2026")
  2. Select the source: Manual, Meeting, Audit, Interview, Other
  3. Click Submit
  4. The AI automatically classifies the item into 7 categories:
  5. ASSET: IT and information assets
  6. RISK: identified risks and threats
  7. CONTROL: implemented controls and measures
  8. PROCESS: processes and procedures
  9. CONTACT: contacts and people in charge
  10. CONTEXT: organisational context
  11. REGULATORY: regulatory obligations

Submitting a document

  1. Click Upload Document
  2. Select a PDF, DOCX, DOC or TXT file (max. 20 MB)
  3. The system extracts the text and splits it into semantic chunks
  4. Each chunk enters the queue as an independent item for validation
  5. The AI analyses at most the first 20 chunks of each file, one at a time, and spends AI credits (1 per chunk). The remaining chunks stay in the queue without a summary, for manual review. If the quota runs out halfway, or if AI is switched off for the organisation, the analysis stops and the pending chunks stay in the queue in the same way
  6. Only Admin and Manager upload and delete documents, and only in entities they have access to. A chunk whose text tries to give instructions to the AI is left without a summary, in the queue, for manual review. There is a limit on uploads per period; if you exceed it, try again later.

CISO validation queue

After AI extraction, each item appears in the queue with:

  • Assigned category
  • Summary (aiSummary)
  • Extracted structured fields
  • Confidence level and transparency package

For each item, the CISO can:

Action Effect
Approve Item approved and indexed for RAG
Edit and Approve Edit the content and approve the corrected version
Reject Item discarded (does not enter RAG)
Cook Bulk approval of all PENDING items

Note: The original content (rawContent) is never changed. The CISO's edits are stored in approvedContent. Tenant content is immutable.

RAG: Automatic context in AI prompts

When the CISO approves an item, the system automatically generates an embedding (vector representation) and indexes it with pgvector. From that moment:

  • All Claude calls for this entity (Cook, Gap Analysis, answer suggestions) automatically retrieve the 6 most relevant items by semantic similarity
  • The context is injected into the prompt as "VALIDATED KNOWLEDGE ABOUT THE CLIENT"
  • The AI uses this context to produce answers tailored to the client's specific case

3.3 EterKnowledge Tab

The EterKnowledge tab links the entity page to its dedicated Space in EterKnowledge, the document-based GRC repository.

What is available:

  • Knowledge Graph: interactive graph of pages, backlinks and GRC tags in the entity's Space
  • Search: semantic search in the entity's knowledge space
  • Contextual chat: Vera with context restricted to the entity's Space

Prerequisite: The entity must have a Space created in EterKnowledge. If it does not exist, the tab shows creation instructions.

The graph nodes represent EterKnowledge pages. The edges represent backlinks between pages and links to GRC controls (framework tags).

Cook (Cook proposes, you accept)

The Cook button (on the entities page and in the last step of the setup wizard) asks the AI to propose a set of records for the entity. Cook does not save anything by itself: what the AI generates stays as a proposal to review, and only what a person accepts becomes a record.

  1. Select what you want to generate: Frameworks & Assessments, Gaps & Recommendations, Tasks, Policies, Vendors, Assets
  2. Click Start and follow the progress in real time
  3. At the end the review screen opens, with the note "AI only proposes. Nothing below has been saved: accept, edit or reject each item"

Reviewing the proposals. Items appear grouped by type (Assessments, Gaps, Risks, Tasks, Policies, Vendors, Assets, Objectives, Audit plans), with the count "n of N to decide". You can:

  • Accept all, Accept group or Reject all
  • Accept or Reject item by item
  • Edit the title and text before accepting (Accept with changes). For assessments and gaps the item is a whole framework and cannot be edited; for objectives and audit plans only the title can be edited

What happens when you accept. The final record is created and marked AI-generated, and the audit log records who accepted it. Accepting gaps creates the framework assessment if it does not exist yet. Rejecting creates nothing and keeps the decision. If an item was already decided by someone else, you lack permission or it failed, the notice "n items were not decided" appears: refresh and try again.

Rules:

  • Generating and deciding require permission to create assessments and access to the entity. When accepting, the permission for the record type is also required (risks, tasks, policies, vendors, gaps, audit plans). Without it, the proposal stays pending.
  • A new generation expires the previous pending proposals of the same types.
  • Only one generation can run at a time per entity: if you try a second one, you see "A Cook generation is already running for this entity".
  • Each generation spends the organisation's AI credits. With AI switched off or unavailable, the screen shows a clear message and there are no proposals.
  • Proposals are visible to any member with permission to create assessments and access to the entity, not only the person who generated them.

Deleting an entity

To delete an entity, click the bin icon: EterShield sends an email with a confirmation link (it expires in 15 minutes and works only once). The link opens a confirmation page: the deletion only happens when you press the button, with the session of the person who requested it. This action is irreversible: assessments, risks and tasks lose their link to the entity.

Clearing an entity's data

The Clear entity data action removes the data generated for that entity (assessments, gaps, risks, tasks, assets, policies and suppliers associated with it) but keeps the entity itself; the data of other entities is not touched. For security, an email with a confirmation link is sent; it expires in 15 minutes and works only once. The link opens a confirmation page: the clearing only happens when you press the button, with the session of the person who requested it.

EterShield, an Eter Growth platform