Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Release290 #186

Merged
merged 9 commits into from
Apr 8, 2024
2 changes: 1 addition & 1 deletion docs/releases/release280.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ is true by default):

```properties
#Enable new Klaw user interface
klaw.coral.enabled=false
klaw.coral.enabled=false
```

:::note
Expand Down
95 changes: 95 additions & 0 deletions docs/releases/release290.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
---
sidebar_position: 99.87
aindriu-aiven marked this conversation as resolved.
Show resolved Hide resolved
---

# Release 2.9.0

Date: 8th of April, 2024

## Overview

Overview
Klaw version 2.9.0 is a patch release which fixes an issue introduced in 2.9.0 with some minor bug fixes and improvements.
aindriu-aiven marked this conversation as resolved.
Show resolved Hide resolved

## Download

### Binaries

[`klaw-2.9.0.jar` ⬇︎](https://github.com/Aiven-Open/klaw/releases/download/v2.9.0/klaw-2.9.0.jar)

[`cluster-api-2.9.0.jar` ⬇](https://github.com/Aiven-Open/klaw/releases/download/v2.9.0/cluster-api-2.9.0.jar)

### Sources

[`klaw-2.9.0.zip` ⬇](https://github.com/Aiven-Open/klaw/archive/refs/tags/v2.9.0.zip)

### Docker

- [Klaw Core](https://hub.docker.com/r/aivenoy/klaw-core)
- [Klaw Cluster API](https://hub.docker.com/r/aivenoy/klaw-cluster-api)

## What's new in Klaw 2.9.0

### Redesigned screens with React UI

In this release, we have redesigned the user interface using React to enhance the user experience and provide a more intuitive design.

Key updates in the new React UI include:

- Topic catalog - Filter by Topic type
![image](../../static/images/release280/Filter-by.png)
- Activity log
![image](../../static/images/release280/Activity-Log.png)
- Dashboard landing page
![image](../../static/images/release280/Dashboard.png)
- View clusters
![image](../../static/images/release280/view-clusters.png)
- View environments
![image](../../static/images/release280/view-envs.png)

To disable the preview for the new Klaw user interface, open the
`application.properties` file on the Klaw **core** module, and set the
value of the following property to `false` (Effective from version 2.4.0, it
is true by default):

```properties
#Enable new Klaw user interface
klaw.coral.enabled=false
```

:::note
We are taking an incremental, feedback-driven approach in rolling out
the new Klaw interfaces. By providing the feature flag to preview the user
interfaces, we would like you to share your valuable
[feedback](https://github.com/aiven/klaw/issues/new?assignees=&labels=&template=03_feature.md).
:::

### JSON Schema support in Coral and Angular UIs

Klaw now supports provisioning Json Schemas through both the Angular and React UI. Previously only Schemas of type Avro were supported.

### BETA Release of ACL Claim functionality

We are pleased to announce the Beta release of Claim ACL/Subscription functionality. This functionality still has some limitations that we will be improving in upcoming releases.
Please see the ACL Claim page for more information on these limitations.

### Improvements

- Admin Guards on all APIs for roles for enhanced security and enhanced user feedback
- Delete Service Users when ACLs are deleted
- Declined User requests can be reused

### Bug fixes

- Allow creating new users with an email address as a username
- Fix the default schema version on promote to be an informational message in angular UI
- Fix unused script and unsafe links
- Fix target=blank vulnerability

### DB upgrade

In this release, there is a new primary key added to the kwregisterusers table to allow previously denied usernames to be re-used in future requests.

:::note
For a complete list of improvements, changelog, and to download the
release, see [GitHub release tag v2.9.0](https://github.com/aiven/klaw/releases/tag/v2.9.0)
44 changes: 44 additions & 0 deletions docs/workflows/subscription/claim-subscription.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Claim a subscription

To claim an existing subscription in Klaw, from another team.
:::note
This functionality is in Beta as of Klaw release 2.9.0 and we are working to improve it in upcoming releases.
At the moment this functionality is only available through the older angular user interface.
:::

## Create a claim subscription request

Once a subscription is created in an environment, it is possible to
claim the subscription from the topic if you are another team.

1. In Klaw, select **Topics** on the navigation bar.
2. Choose the specific Apache Kafka® topic where the subscription you wish to
claim is located.
3. Select the blue **Claim** on the right-hand side of the subscriptions table at the bottom of the topic overview.

:::note
This request can be raised by any team that does not currently own the subscription.
On Approval it requires two approvals, one from the topic owner who needs to approve a team accessing their data
and secondly by the current subscription owner.
:::

4. Confirm that you are sure you wish to claim the subscription.
5. A claim subscription request is created.

## Notes on Claim Subscription

Claim functionality is currently only available to be initiated through the Angular(old) UI. Although approvals can be made through either UI.

This is the first time Klaw has introduced the need for more than one approver for a request.
The Topic owner needs to approve the request as the data owner, and the existing owner needs to approve the transfer of the subscription to the new team.

The Service User will not transfer over to the new team until all subscriptions owned by the original team for that service user are transferred to the new team.

The topic owner must be the first approval, this is not reflected well in the UI and this user experience is planned to be improved as we move forward.

## Limitations to the current implementation

Currently when looking at the subscription table if a team has multiple service users for a topic it will not be possible to see if you have correctly selected the desired service account until after the claim request is created.
Once created you can see htis information on the "My Teams Requests" page along with the two teams who are required to approve the claim.

We do not currently recommend using this functionality with IP based subscriptions support for these will be part of Klaw 2.10.0
Loading