nano SIEM
Reference

Namespaces

Supported in:Self-hosted

How namespaces keep identity resolution apart across cloud accounts and networks with overlapping private IP ranges.

Set a namespace to keep identity resolution separate across networks that reuse private IP ranges. The same address, such as 10.0.1.5, can identify different machines in different cloud accounts, VPCs, or data centers.

Format

A namespace is either default or <provider>:<suffix>:

  • provider is one of aws, gcp, azure or onprem.
  • suffix is non-empty and uses letters, digits, ., _, - and :.
ExampleMeaning
defaultNo isolation needed
aws:123456789012One AWS account
aws:123456789012:vpc-abcOne VPC in an AWS account
gcp:my-project:prodA GCP project environment
azure:<directory-id>An Azure tenant
onprem:dc-eastAn on-premises data center

nano rejects any other form.

When to set one

Set a namespace on log sources whose events carry private addresses from more than one network:

SourceTypical namespace
AWS VPC Flow Logsaws:<account>:<vpc>; private ranges often overlap between VPCs
AWS CloudTrailaws:<account>
GCP audit logsgcp:<project>
Azure Activityazure:<tenant>
On-prem firewalls and EDRonprem:<site>

Identity providers such as Okta or Microsoft Entra ID don't need one; leave them on default.

Where it's set

A namespace is a property of a log source. Set it when you create or edit the log source in Log Sources.

The namespace is stored with the log source, not on its events: no OCSF field on an event carries it. To tell accounts apart in a search, use the account the parser maps from the event itself: cloud.account.uid for AWS sources, and resources.namespace (the project or subscription ID) for Google Cloud Audit Logs and Azure Activity Log.

Filtering by account

To scope a search to one cloud account, filter on the OCSF account fields:

metadata.log_source=aws_cloudtrail cloud.account.uid="123456789012" | stats count by api.operation, actor.user.name
metadata.log_source=aws_cloudtrail | stats count by cloud.account.uid | sort -count
metadata.log_source=gcp_audit | stats count by resources.namespace | sort -count

What's next

On this page