Artica Wiki

Artica SIEM — Granting tenant privileges to a group

Grant a SIEM tenant to a group of users — the same screen for OpenLDAP, Active Directory and local administrator groups.

Declaring a tenant does not give anyone access to it. Access is granted to a group, and a user inherits the tenants of every group they belong to.
This page covers that step, for the three directories Artica can hold groups in: OpenLDAP, Active Directory and the appliance's own local administrators.

The concept

A SIEM tenant is a reading perimeter. 
The right to read one is not a checkbox on a user — it is a link between a group and a tenant, and that link is what an operator's session resolves at sign-in.

Three properties make the whole mechanism work, and they are worth stating before the click-by-click:

One screen, three directories

Artica can hold its groups in three places, and the tenant assignment works identically in all three. Only the way you reach the screen differs:

Directory Where the groups live How to get there
OpenLDAP (the appliance's own directory) posixGroup entries Members > Groups > your group > Privileges
Active Directory the AD groups your appliance is connected to Members > Active Directory > your group > Privileges
Local administrators the appliance's own account database Your system > Local administrators > your group > Privileges

What changes underneath is only the key the assignment is stored against — the group's distinguished name for Active Directory, its gidNumber for OpenLDAP, and its internal identifier for a local group. You never type that key; the screen carries it for you. 
It matters for one reason only: it is the same key the session resolution reads back, which is why an assignment made in one directory is never visible from another.

What it gives you

Typical use cases

Step 1 — have the tenants declared

The assignment screen offers the tenants declared in Statistics/SIEM > Tenants. 
Only enabled tenants are offered: granting a right over a tenant that nothing feeds any more would be a right over nothing.

The tenants declared on the appliance

If a tenant you expect is missing from the next screen, check its status here first. Declaring tenants is covered in Multi-tenancy: isolate and delegate per client organisation.

Step 2 — open the group's privileges

Open the group and go to its Privileges tab. 
The SIEM tenants are the last section of that screen, after the group, proxy and administration rights.

Privileges of an OpenLDAP group, with the SIEM tenants section

They sit there rather than in a tab of their own for a simple reason: 
this is the screen an administrator opens to answer "what is this group allowed to see". 
A tenant is part of that answer.

The same section on a local administrators group

Step 3 — tick the tenants

Tick every tenant the group may consult. Two behaviours differ from the rest of the screen and are worth knowing:

Two tenants granted to the group

When does it take effect? 
The perimeter is cached with the account's privileges, so a change is effective at the user's next sign-in at the latest. 
If you need it applied straight away, have the user sign out and back in.

What the operator gets

A member of that group signs in and receives a console reduced to what they are entitled to. 
No tenant administration, no system menus — the Tenants entry itself is not offered, because declaring tenants is an appliance-administration task and the page would only refuse them.

The console of a tenant operator

Their own account page lists the perimeter, so they can always see what they are reading:

The account page listing the granted tenants

And the SIEM pages answer with their data only — the filter is applied by the appliance, on the query itself:

A SIEM page restricted to the operator's perimeter

Troubleshooting

Symptom Cause What to do
The SIEM tenants section is missing from the Privileges screen The SIEM module is disabled on this appliance. Enable it; the section appears only when it is on.
A tenant is missing from the list It is disabled, or not declared. Check Statistics/SIEM > Tenants.
The user is told no perimeter has been granted None of their groups holds a tenant. Tick at least one tenant on one of their groups.
A newly granted tenant is not visible yet The perimeter is cached with the account's privileges. Have the user sign out and back in.
The user cannot sign in at all Holding a tenant is what opens the session for an account with no other right — an appliance predating that behaviour refuses them. Update the web console.
The tenant appears ticked but the user sees nothing The tenant is declared and granted, but no collector feeds it. Check the Client servers column in Statistics/SIEM > Tenants.
  1. Declare the tenant and connect its collectors.
  2. Create or pick the group that should read it, in whichever directory you use.
  3. Tick the tenant in the group's Privileges screen.
  4. Put the people into that group.
  5. Have one of them sign in and confirm they see the expected perimeter — and only it.