runZero users and groups

User search keywords

When viewing users, you can use the keywords in this section to search and filter.

Email

Use the syntax email:<address> to search for someone by email address.

email:john@example.com

Name

Use the syntax name:<text> to search for someone by name.

name:john
name:"John Smith"

Superuser

To search for people based on whether they have superuser access, use the term superuser:<boolean>.

superuser:true
superuser:f

Access

Use the syntax access:<term> to search for users with a specific access level. Possible access levels are admin, user, annotator, viewer, billing and none.

access:admin

Status

To search for users by invitation status, use the term status:<text>. Possible status values are activated, pending and expired.

status:pending

SSO

To search for people based on whether they can only log in via SSO, use the term sso:<boolean>.

sso:true

MFA

To search for people based on whether they have enrolled an MFA token, use the term mfa:<boolean>.

mfa:f

Group ID

The group_id field is the unique identifier for a given group, written as a UUID. To search for users that are part of a group based on the group’s ID, use the syntax group_id:<uuid>.

group_id:cdb084f9-4811-445c-8ea1-3ea9cf88d536

Group name

To search for users that are part of a group based on the group’s name, use the syntax group_name:<text>.

group_name:administrators
group_name:"Temp annotators"

User groups

To search for users based on whether they are part of a group or not, use the term has_group:<boolean>. Use boolean value t or true to show all users who are members of a group.

has_group:t

Conversely, use boolean value f or false to show users who are not members of a group.

has_group:f

Group count

Use the syntax group_count:<number>to search the group membership count. This search term supports numerical comparison operators (>, >=, <, <=, =).

group_count:>1
group_count:=0

Group search keywords

When viewing your groups, you can use the keywords in this section to search and filter.

ID

The ID field is the unique identifier for a given group, written as a UUID. Use the syntax id:<uuid> to filter by ID field.

id:cdb084f9-4811-445c-8ea1-3ea9cf88d536

Name

Use the syntax name:<text> to search by group name.

name:administrators
name:"Temp annotators"

Access

Use the syntax access:<term> to search for groups with a specific access level. Possible access levels are admin, user, annotator, viewer, billing and none.

access:admin

Timestamps (created at, updated at)

Filter groups by their timestamp fields, created_at and updated_at, using the syntax created_at:<term> and updated_at:<term>. The terms support the standard runZero [time comparison syntax][time].

created_at:<30days
updated_at:<1week

Expiration

Filter groups by their expiration timestamp, expires_at, using the syntax expires_at:<term>. The term supports the standard runZero [time comparison syntax][time].

expires_at:<30days
expires_at:>8/1/2019

The expired property describes whether or not a group has expired. Search this property using the expired:<boolean> syntax.

The term is a boolean value:

  • true, t, 1, and yes represent true
  • false, f, 0, and no represent false
expired:true
expired:0

Use the syntax has_expiration:<term> to find any assets with an expiration date.

The term is a boolean value:

  • true, t, 1, and yes represent true
  • false, f, 0, and no represent false
has_expiration:true
has_expiration:0

Email

The created_by_email property holds the email address for the user that created the group. It can be searched using the syntax created_by_email:<term>.

created_by_email:user@runzero.com

Group mapping search keywords

When viewing your SSO group mappings, you can use the keywords in this section to search and filter.

ID

The ID field is the unique identifier for a given group mapping, written as a UUID. Use the syntax id:<uuid> to filter by ID field.

id:cdb084f9-4811-445c-8ea1-3ea9cf88d536

SSO attribute

The sso_attribute is the name of the attribute field to check for matching values. Use the syntax sso_attribute:<text> to search by sso_attribute.

sso_attribute:department

SSO value

The sso_value is the value or comma-separated list of values to match. Use the syntax sso_value:<text> to search by sso_value.

sso_value:security
sso_value:"admins, administrators"

Group ID

The group_id field is the unique identifier for a given group, written as a UUID. To search for group mappings related to a group based on the group’s ID, use the syntax group_id:<uuid>.

group_id:cdb084f9-4811-445c-8ea1-3ea9cf88d536

Group name

To search for group mappings related to a group based on the group’s name, use the syntax group_name:<text>.

group_name:administrators
group_name:"Temp annotators"

Timestamps (created at, updated at)

Filter group mappings by their timestamp fields, created_at and updated_at, using the syntax created_at:<term> and updated_at:<term>. The terms support the standard runZero [time comparison syntax][time].

created_at:<30days
updated_at:<1week

Email

The created_by_email property holds the email address for the user that created the group. It can be searched using the syntax created_by_email:<term>.

created_by_email:user@runzero.com