Permission Roles

The Humio Operator can manage three types of permission role resources. Each role defines a set of permissions and can be assigned to one or more LogScale groups.

  • HumioOrganizationPermissionRole โ€” grants organization-level permissions such as creating repositories and managing users.

  • HumioSystemPermissionRole โ€” grants system-level permissions such as reading health checks and viewing organizations.

  • HumioViewPermissionRole โ€” grants permissions scoped to specific repositories or views, such as read access or event forwarding access.

HumioOrganizationPermissionRole

A HumioOrganizationPermissionRole resource creates a role with organization-level permissions in LogScale. The permissions field lists the permissions the role grants. The optional roleAssignmentGroupNames field assigns the role to one or more LogScale groups. For the full list of valid organization permissions, see the OrganizationPermission enum in the LogScale GraphQL reference.

The following shows an example HumioOrganizationPermissionRole resource.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioOrganizationPermissionRole
metadata:
  name: example-org-role
  namespace: logging
spec:
  managedClusterName: example-humiocluster
  name: example-organization-role
  permissions:
    - CreateRepository
    - ManageUsers
  roleAssignmentGroupNames:
    - example-group
  allowDataDeletion: true

HumioSystemPermissionRole

A HumioSystemPermissionRole resource creates a role with system-level permissions in LogScale. The permissions field lists the permissions the role grants. The optional roleAssignmentGroupNames field assigns the role to one or more LogScale groups. For the full list of valid system permissions, see the SystemPermission enum in the LogScale GraphQL reference.

The following shows an example HumioSystemPermissionRole resource.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioSystemPermissionRole
metadata:
  name: example-system-role
  namespace: logging
spec:
  managedClusterName: example-humiocluster
  name: example-system-role
  permissions:
    - ReadHealthCheck
    - ViewOrganizations
  roleAssignmentGroupNames:
    - example-group
  allowDataDeletion: true

HumioViewPermissionRole

A HumioViewPermissionRole resource creates a role scoped to one or more repositories or views in LogScale. The permissions field lists the permissions the role grants. The optional roleAssignments field assigns the role to specific groups for specific repositories or views. Each entry requires a repoOrViewName and a groupName. For the full list of valid view permissions, see the Permission enum in the LogScale GraphQL reference.

The following shows an example HumioViewPermissionRole resource.

yaml
apiVersion: core.humio.com/v1alpha1
kind: HumioViewPermissionRole
metadata:
  name: example-view-role
  namespace: logging
spec:
  managedClusterName: example-humiocluster
  name: example-view-role
  permissions:
    - ReadAccess
    - EventForwardingAccess
  roleAssignments:
    - repoOrViewName: example-repository
      groupName: example-group
  allowDataDeletion: true