runZero users and groups

View as Markdown

User search keywords

When viewing users, use these keywords to search and filter them.

Email

Use email:<address> to find someone by email address.

email:john@example.com

Name

Use name:<text> to find someone by name.

name:john

name:"John Smith"

Superuser

Use superuser:<boolean> to find people by whether they have superuser access.

superuser:true

superuser:f

Access

Use access:<term> to find users with a specific access level. The access levels are admin, user, annotator, viewer, billing and none.

access:admin

Status

Use status:<text> to find users by invitation status. The status values are activated, pending and expired.

status:pending

SSO

Use sso:<boolean> to find people by whether they can only sign in via SSO.

sso:true

MFA

Use mfa:<boolean> to find people by whether they have enrolled an MFA token.

mfa:f

Group ID

The group_id field is the unique identifier for a group, written as a UUID. Use group_id:<uuid> to find the members of a group by its ID.

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

Group name

Use group_name:<text> to find the members of a group by its name.

group_name:administrators

group_name:"Temp annotators"

User groups

Use has_group:<boolean> to find users by whether they belong to a group. The value t or true shows all users who are members of a group.

has_group:t

The value f or false shows users who are not members of a group.

has_group:f

Group count

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

group_count:>1

group_count:=0

Group search keywords

When viewing your groups, use these keywords to search and filter them.

ID

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

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

Name

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

name:administrators

name:"Temp annotators"

Access

Use access:<term> to find groups with a specific access level. The 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, with created_at:<term> and updated_at:<term>. The terms support the standard runZero time comparison syntax.

created_at:<30days

updated_at:<1week

Expiration

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

expires_at:<30days

expires_at:>8/1/2019

The expired property records whether a group has expired. Search it with expired:<boolean>.

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 has_expiration:<term> to find groups that have 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 of the user who created the group. Search it with created_by_email:<term>.

created_by_email:user@runzero.com

Group mapping search keywords

When viewing your SSO group mappings, use these keywords to search and filter them.

ID

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

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

SSO attribute

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

sso_attribute:department

SSO value

The sso_value field is the value, or comma-separated list of values, to match. Use 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 group, written as a UUID. Use group_id:<uuid> to find the mappings for a group by its ID.

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

Group name

Use group_name:<text> to find the mappings for a group by its name.

group_name:administrators

group_name:"Temp annotators"

Timestamps (created at, updated at)

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

created_at:<30days

updated_at:<1week

Email

The created_by_email property holds the email address of the user who created the group. Search it with created_by_email:<term>.

created_by_email:user@runzero.com
Updated