(highway/how-to/tao-granular-key-v2)=
# Tạo Granular key

```{admonition} Pre-condition
*   Access vào Spinner Group.
*   Có ít nhất một dịch vụ Kafka.
```

**Các bước thực hiện:**
----------

### **Bước 1: Truy cập Kafka**

Tại màn hình Kafka Highway List, người dùng truy cập vào Kafka cần kiểm tra thông tin.

```{thumbnail} ../../../_static/img/highway/how-to/tao-granular-key-v2-1.png
:width: 65%
:alt: Image
:align: center
```

### **Bước 2: Tạo Granular key**

Sau khi truy cập Kafka, người dùng vào tab SERVICE API KEYS sau đó nhấn NEW API KEY, chọn Granular key.

```{thumbnail} ../../../_static/img/highway/how-to/tao-granular-key-v2-2.png
:width: 65%
:alt: Image
:align: center
```

Hệ thống hiển thị các bước để tạo granular key.

1\. Service account

*   Service Account Type: Có 2 lựa chọn tạo mới hoặc chọn các giá trị từ trước (các service account của workspace này sẽ được hiển thị tại đây)
*   Service Account Name (Bắt buộc): Tên của key
*   Description (Tùy chọn): Mô tả về key

Sau khi điền xong, nhấn Next để chuyển sang bước tiếp theo.

```{thumbnail} ../../../_static/img/highway/how-to/tao-granular-key-v2-3.png
:width: 65%
:alt: Image
:align: center
```

2\. Add ACLs

Bước này bao gồm 4 tabs nhỏ:

*   Cluster
*   Consumer Group
*   Topic: Bắt buộc set quyền để có thể sử dụng
*   Transaction ID

Ở mỗi tab nhỏ, người sử dụng có thể chọn thêm một hoặc nhiều cấu hình quyền cho các hoạt động cần thiết. 

```{thumbnail} ../../../_static/img/highway/how-to/tao-granular-key-v2-4.png
:width: 65%
:alt: Image
:align: center
```

Sau đó, người dùng nhấn Next để chuyển sang bước get api key.

3\. Get API Key

Hệ thống sẽ tự động get api key, người dùng nhấn DOWNLOAD để download file key và xem thông tin key.

```{thumbnail} ../../../_static/img/highway/how-to/tao-granular-key-v2-5.png
:width: 65%
:alt: Image
:align: center
```

```{div} sd-fs-5 sd-text-primary
Result:
```

Sau khi tạo thành công Granular Key, key đó sẽ được hiển thị trên hệ thống trong mục Service API Keys đồng thời trả về cho người dùng json file chứa các thông tin của key.

```{thumbnail} ../../../_static/img/highway/how-to/tao-granular-key-v2-6.png
:width: 65%
:alt: Image
:align: center
```