Tags
Tags are free-form text labels attached to one or more systems in your account which allow administrators to group systems together which share similar characteristics (i.e. business unit, security level or function) in order to build connectivity between them.
Tags can be manually added to enrolled systems, or an Enrolment Key can be configured to apply an initial set of Tags to new systems as they enrol to your account.
Usage
Tags form the building blocks of policies and policies define connectivity between enrolled systems. Instead of directly attaching systems to a Policy, Administrators use Tags to freely group enrolled systems together which can be referenced once across many policies. The decoupling which Tags provide allows policies to be defined once and remain static, while the business shifts and evolves underneath.
For example, if an Administrator creates a developers Tag and a kubernetes-pods Tag, and then defines a Kubernetes access
Policy which allows developers direct access to kubernetes-pods; then systems in the developers Tag can change over time, so can members of the kubernetes-pods Tag as new instances are spun up and old instances are shutdown. The policy however (the business intent underpinning connectivity between those groups) remains in-place, constant and unchanged.
Managed vs. unmanaged systems: When one or more Tags are attached to a system, that system automatically switches into Managed mode. This means all connectivity for that system must be defined by Policy and that the Enclave software on that system will no longer accept commands from the local user(s). Conversely, if no Tags are attached to a system then the opposite is true; the system enters Unmanaged mode and users are able to configure and control the Enclave software locally.
Naming conventions
It is considered best practice to define a naming pattern which reflects the structure and security model of your organisation, and group systems along those lines when defining Tags.
A valid Tag name is composed of lower-case characters (a-z
and 0-9
without spaces) and may be up to 64 characters long. Valid separator characters include -
and .
Tags names should be made up of designators which represent your organisational structure. Consider designations for your organisation which group systems:
-
By user geography: uk, london or nyc-office
-
By business unit: developers, sales or marketing
-
By security level: staging, production or uat
-
By function: webservers, database-servers or intranet
-
By infrastructure: aws-eu-west-2 or dc-lax-11
-
By project: us-gov or f22-raptor
You may also decide to combine multiple designations into a single Tag. We suggest using the period character .
to include multiple designations as part of a single Tag name, with the most specific designator placed last.
- f22-raptor.rapid-prototype-team
- nyc-office.developers
- aws-eu-west-2.production.webservers
- dc-lax-11.intranet
- uk.laptops
- uk.laptops.developers
- all-staff
- contractors
Once defined, account Administrators can add member systems to Tags and compose Policies to create connectivity.
Policy Name | Sender Tags | Receiver Tags |
---|---|---|
Access to Jira | all-staff contractors |
dc-lax-11.jira |
Access to preprod db | uk.laptops.developers nyc-office.developers |
aws-eu-west-2.staging.db-servers aws-eu-west-2.uat.db-servers |
R22 prototype team | f22-raptor.rapid-prototype-team | f22-raptor.rapid-prototype-team |
Note: When the same Tag is applied to both the
Sender
andReceiver
sides of the same policy Enclave will create connectivity between that Tag's member systems. In this case, forming a fully connected mesh and community of interest between members of the f22-raptor.rapid-prototype-team Tag. You should consider the capabilities of your underlying network infrastructure when deploying a fully connected mesh. Learn more.