Skip to main content
Version: 2.13


Authorization is the process of verifying that an authenticated entity (such as a user) has access to a resource and can perform a desired action. Ververica Platform implements a simple yet powerful authorization model based on preset roles.

We first describe our preset roles and then show how to bind a role to an entity such as a user or group.


Roles grant permissions to access resources. They specify which resources can be accessed and how they can be accessed. The following roles are available:

  • Viewer: read-only access to all resources within a Namespace, except for Secret Values and some special endpoints in the Apache Flink® UI.
  • Editor: read and write access to all resources within a Namespace except Deployment Targets and API Tokens.
  • Owner: full access within a Namespace.
  • Admin: read and write access to all Namespace resources (but no implicit access to individual Namespaces or their subresources).
ArtifactsList, GetMetadataAllAllNone
DeploymentTargetList, GetList, GetAllNone
{flink} UIGet*AllAllNone
NamespaceNoneNoneGet, UpdateAll
All OthersList, GetAllAllNone

* Except for TaskManager thread dumps, datasets and job cancellation requests.

Role Bindings

In order to assign a role to an authenticated entity such as a user or a group, a role has to be explicitly bound to it.

The Namespace resource allows to assign individual users and groups to roles viewer, editor, and owner. All assigned roles are scoped to the respective Namespace and don't imply any permissions in other Namespaces.

Members can be individual users, groups, or system-level groups:

  • matches the user
  • group:vvp-editors matches users in the group vvp-editors.
  • system:authenticated matches all authenticated users.

Example: Assign roles in a Namespace

"namespace": {
"name": "namespaces/foo",
"roleBindings": [
"role": "viewer",
"members": [ "system:authenticated" ]
"role": "editor",
"members": [ "group:vvp-editors" ]
"role": "owner",
"members": [ "" ]

In the example above any authenticated user is assigned the viewer role. All members of the vvp-editors group are assigned the editor role. The user authenticated as is assigned the owner role.


The admin role is configured on a global level in the main configuration file of Ververica Platform.

Administrators get full read/write access to Namespace resources. However, the admin role does not imply access to resources within a Namespace unless additional permissions are explicitly granted as shown above.

enabled: true
# A list of users and groups that are granted the admin role.
# - `` matches the user ``
# - `group:vvp-admins` matches users group `vvp-admins`
# - `system:authenticated` matches all authenticated users

API Tokens

API Tokens are a namespaced resource that allows non-interactive/machine to machine access to Ververica Platform. They have a designated role as part of their specification.