Role Based Access Control

1 Overview
2 Configuration
- 2.1 Enable RBAC
  - 2.1.1 Policy Configuration
- 2.2 Change default policy
- 2.3 Apply changes
3 Concepts
- 3.1 Roles & Capabilities
- 3.2 Role Based Data Access
  - 3.2.1 Group
    - 3.2.1.1 User
  - 3.2.2 RBAC Policy
    - 3.2.2.1 Example policy: Viewer role for a custom scope.
    - 3.2.2.2 Example policy: Admin for all.
  - 3.2.3 Scope
    - 3.2.3.1 Type: scope_allow_all
    - 3.2.3.2 Type: scope_allow_none
    - 3.2.3.3 Type: scope_viewer_all
    - 3.2.3.4 Type: custom
  - 3.2.4 RBAC Configuration
4 Adding an RBAC User
- 4.1 With SSO
- 4.2 With basic authentication

Overview

Kfuse supports RBAC by enforcing access/permission (authorization) on ALL resources based on the logged in user’s role. Kfuse enforces this access on both workflows/operations (like creating alerts o saving metrics from logs) and the data (all telemetry collected from various sources). Authentication of the logged in user is derived from the SSO (OKTA, Google Auth, etc.) already configured to be used with Kfuse.

Configuration

Configure kfuse for implementing RBAC in your deployment. Copy the following code in your <custom_values.yaml> file and make edits as necessary. Please look through the comments for example and. To learn more review the concepts.

Enable RBAC

To enable RBAC, add following in the <custom_values.yaml> Default RBAC policy when RBAC is enabled allows full access. Be sure to change default policy.

global:
  ...
  RBACEnabled: true

Policy Configuration

Use following template, make changes in the <custom_values.yaml>

# user-mgmt-service:
#   config:
    # # Learn more:
    # # - "reserved" built group names (should not to be used):
    # #   "kf_admin", "kf_reader_all"
    # # - in built scope types:
    # #   scope_allow_all, scope_viewer_all, scope_allow_none
    # # - role types:
    # #   admin, editor, viewer
    # # Kloudfuse has following inbuilt RBAC policies
    # # rbac_allow_all - allows all operations for everyone
    # # rbac_allow_none - No accesss
    # # rbac_view_all - allow all READ operations for everyone
    # #
    # default_rbac_policy: rbac_allow_all
    # groups:
    # - name: group_admin
    #   users:
    #   - id_key: X-Auth-Request-Email
    #     value: admin1@company.com
    # - name: group_viewer_target_namespace
    #   users:
    #   - id_key: X-Auth-Request-Email
    #     value: op1@company.com
    # - name: group_editor_otel_namespace
    #   users:
    #   - id_key: X-Auth-Request-User
    #     value: maintainer2userid
    # rbac_policies:
    # - name: rbac_viewer_target_namespace
    #   role: viewer
    #   scope:
    #     filters:
    #     - key: kube_namespace
    #       op: =
    #       value: target
    #     type: custom
    # - name: rbac_editor_otel_namespace
    #   role: editor
    #   scope:
    #     filters:
    #     - key: kube_namespace
    #       op: =
    #       value: otel-demo-app
    #     type: custom
    # rbac_configs:
    # - group: group_admin
    #   policy: scope_allow_all
    # - group: group_viewer_target_namespace
    #   policy: rbac_viewer_target_namespace
    # - group: group_editor_otel_namespace
    #   policy: rbac_editor_otel_namespace

Change default policy

When RBAC is enabled, default policy allows full access. Add following to your <custom_values.yaml> to use your custom policy or remove the default policy of full access to no access.

  user-mgmt-service:
    config:
      # # - in built scope types:
      # #   scope_allow_all, scope_viewer_all, scope_allow_none
      # #
      default_rbac_policy: ""

Apply changes

After updating the values.yaml file with the desired configuration, upgrade the kfuse release.

Concepts

Roles & Capabilities

kloudfuse platform has following roles and their capabilities.

Capabilities \ Role	(UM) User management add admin user (add UserConfig)	R/W (Kfuse) ASM (Alerts) Recording Rule Save APM/Log Metrics parser pipeline config	R/W (grafana)** Alerts Dashboards Folders AlertMgr	Read Logs Explorer Metrics Explorer APM Explorer List Alerts
Admin	Yes	Yes	Yes	Yes
Editor	No	Yes	Yes	Yes
Viewer	No	No	No	Yes

** Only for user with admin role

Role Based Data Access

As part of RBAC implementation, a user can also achieve role based data access (view). To achieve this,

kloudfuse can be configured with Groups having assigned RBAC Policy (role and the associated view/scope) and together they define the RBAC Configuration of the system. To configure the system correctly please go through the following definitions.

Group

A group is set of users (a team) who share same RBAC configuration. In other words, share the same role and scope.

User

A user is defined by a user id value. For example an email address. Kloudfuse RBAC uses the information obtained from the configured IAM during the login process. See following example of some user valid configurations.

kfuse uses id keys by default. Other id keys can be added as well.

RBAC Policy

An RBAC policy is defined by a role (one of the "admin"/"editor"/"viewer") and a scope assigned to that role.

Example policy: Viewer role for a custom scope.

Example policy: Admin for all.

In addition kfuse has following inbuilt rbac policies which can be used in rbac config for any group.

Scope

A scope defines what data a given user has access to. Kloudfuse platform has following inbuilt (reserved) access types.

Type: scope_allow_all

This scope allows access to all data. Typically used for users with "Admin" capabilities.

Type: scope_allow_none

Fully restricted. User will not be allowed any access.

Type: scope_viewer_all

Only read access to all data. Typically used for support operators who only needs to visualize and wouldn’t be making configuration changes.

Type: custom

Custom scopes can be used to provided limited access to data. For a scope to match all filters should match. Each filter is defined by a key, an operator (=, ~=, =~, !~) and value to match. For example, following custom scope is defining a filter which matches data such that kube_namespace="target":

RBAC Configuration

An RBAC configuration ties a given group to a given RBAC policy. Many such configurations can be configured in kfuse.

Adding an RBAC User

To configure a user with RBAC, follow these steps by appropriately editing your custom-values.yaml file in user-mgmt-service section.

With SSO

Create user or add user to existing group.
Create a RBAC policy or use an existing one
Create RBAC config with the group and policy

With basic authentication

Create user or add user to existing group
Create a RBAC policy or use an existing one
Create RBAC config with the group and policy