Users and Groups

The Humio Operator can manage LogScale user accounts and groups declaratively. Use HumioUser resources to manage individual user accounts, and HumioGroup resources to manage groups and their external identity provider mappings.

HumioUser

A HumioUser resource creates and manages a user account in LogScale. The userName field sets the username, which is typically an email address. Set isRoot to true to grant root privileges. Updating root status requires an API token with elevated privileges.

The following shows an example HumioUser resource.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioUser
metadata:
  name: example-humiouser
  namespace: logging
spec:
  managedClusterName: example-humiocluster
  userName: example-user@example.com
  isRoot: false
  allowDataDeletion: true

Set allowDataDeletion to true to allow the operator to delete the user account in LogScale when the HumioUser resource is deleted. If this is unset or false, deleting the resource removes it from Kubernetes but leaves the user account in LogScale.

HumioGroup

A HumioGroup resource creates and manages a group in LogScale. The name field sets the display name of the group. Use the optional externalMappingName field to map the group to a group name from an external identity provider. When a user authenticates with a matching group claim, LogScale adds them to this group automatically.

The following shows an example HumioGroup resource.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioGroup
metadata:
  name: example-humiogroup
  namespace: logging
spec:
  managedClusterName: example-humiocluster
  name: example-group
  externalMappingName: sso-group-name
  allowDataDeletion: true