Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 23 additions & 2 deletions English/ai-stack/agent-base/agent-runtime/create-runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,9 +70,30 @@ Click **DEPLOY** in the **Custom Agent** card to continue.

* **Private VPC**: enable to deploy inside your enterprise network

**Step 4:** Configure Endpoint — AgentBase automatically creates a **DEFAULT** Endpoint
**Step 4:** Configure Security Settings (optional) — control which clients can reach the Runtime and how incoming requests are authenticated

**Step 5:** Review → click **Create**
![Security Settings — IP Access Control and Inbound Identity](<../../../.gitbook/assets/Agentbase-image/Security-Runtime.png>)

| Setting | Description |
| ------- | ----------- |
| **IP Access Control** | Restrict which source IP CIDR ranges can reach this Runtime. Add one or more CIDRs to **Allowed source IP ranges**; leave empty to allow all sources. |
| **Inbound Identity** | Configure how incoming requests to this Runtime are authenticated — set the **Inbound Auth type** below. |

**Inbound Auth type:**

| Mode | Description |
| ---- | ----------- |
| **IAM Permissions** | Authenticates callers using the GreenNode AI Platform IAM token. |
| **JSON Web Tokens (JWT)** | Validates incoming JWT bearer tokens. Set the **JWT key source** to a **Discovery URL** (automatically fetches and refreshes public keys) or inline **JWKS**. |
| **No authorization** | No authentication required. |

{% hint style="warning" %}
Selecting **No authorization** makes the Runtime publicly accessible to anyone with the endpoint URL, with no access control. Use **IAM Permissions** or **JWT** for production workloads.
{% endhint %}

**Step 5:** Configure Endpoint — AgentBase automatically creates a **DEFAULT** Endpoint

**Step 6:** Review → click **Create**

The Runtime transitions from `CREATING` → `ACTIVE` once the container starts successfully.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,11 @@ The Runtime Service supports autoscaling based on CPU or RAM utilization. You de

When load drops, AgentBase scales replicas back down to `minReplicas`.

### Security Settings

* **IP Access Control** — restricts which source IP CIDR ranges can reach the Runtime endpoint; leave empty to allow all sources.
* **Inbound Identity** — configures how incoming requests are authenticated, via an **Inbound Auth type**: **IAM Permissions** (GreenNode AI Platform IAM token), **JSON Web Tokens (JWT)** (validated via a Discovery URL or inline JWKS), or **No authorization** (publicly accessible, no access control).

### Service Contract

Your agent container must satisfy these requirements to work correctly with the Runtime Service:
Expand Down Expand Up @@ -109,6 +114,10 @@ Runtime: my-order-agent
| **Memory Threshold** | `50` | Scale out when RAM exceeds this % (25–75) |
| **Registry Auth** | Enable if private | Username = robot account `backendName` (see [Supporting Services — Robot Accounts](../supporting-services.md#create-a-robot-account)) |
| **Environment Variables** | `KEY=value` | Non-sensitive config only |
| **IP Access Control** | `10.0.0.0/16` | Optional — allowed source IP CIDR ranges; leave empty to allow all sources |
| **Inbound Auth type** | `JSON Web Tokens (JWT)` | Optional — **IAM Permissions**, **JWT** (Discovery URL or inline JWKS), or **No authorization** |

![Security Settings — IP Access Control and Inbound Identity](<../../../.gitbook/assets/Agentbase-image/Security-Runtime.png>)

5. Click **Create**
6. Runtime appears with status `CREATING`, then transitions to `ACTIVE`
Expand Down
16 changes: 16 additions & 0 deletions English/ai-stack/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,22 @@ Need support during the transition? Contact us via email at [support@greennode.a

***

## July 2026

**GreenNode AgentBase — Security Runtime & MCP Connectors**

GreenNode AgentBase adds new security and integration capabilities for AI Agents:

**New Features:**

* **Security Runtime:** Control which clients can reach a Runtime and how incoming requests are authenticated — configure **IP Access Control** (allowed source IP CIDR ranges) and **Inbound Identity** (IAM Permissions, JWT, or No authorization) directly when creating a Runtime.
* Learn more at [Create Runtime](agent-base/agent-runtime/create-runtime.md).

* **MCP Connectors:** Connect an agent to external services — GitHub, Slack, Microsoft 365 (M365 VNG bundle)... — in minutes via a prebuilt catalog, without building an MCP server or hand-coding OAuth.
* Learn more at [MCP Connectors](agent-base/mcp-connectors/README.md).

***

## May 2026

**GreenNode AgentBase — Phase 2**
Expand Down
8 changes: 8 additions & 0 deletions English/overview/product-updates-all/2026.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,14 @@ The GreenNode CLI (the `grn` command) lets you manage the full lifecycle of VKS

* Learn more at [Manage VKS with the GreenNode CLI](../../vks/getting-started/manage-vks-with-the-greennode-cli.md).

**GreenNode AgentBase — Security Runtime & MCP Connectors**

GreenNode AgentBase adds new security and integration capabilities for AI Agents:

* **Security Runtime:** Configure **IP Access Control** (allowed source IP CIDR ranges) and **Inbound Identity** (IAM Permissions, JWT, or No authorization) directly when creating a Runtime.
* **MCP Connectors:** Connect an agent to external services — GitHub, Slack, Microsoft 365... — in minutes via a prebuilt catalog, without building an MCP server or hand-coding OAuth.
* Learn more at [AI Stack — Release Notes](../../ai-stack/release-notes.md).

**Jun 2026**

**vDB - Redis Cluster (Non-sharding) for MemoryStore (MDS)**
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
25 changes: 23 additions & 2 deletions Vietnamese/ai-stack/agent-base/agent-runtime/khoi-tao-runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -70,9 +70,30 @@ Nhấp **DEPLOY** trong card **Custom Agent** để tiếp tục.

- **Private VPC**: bật để triển khai trong mạng nội bộ doanh nghiệp

**Bước 4:** Cấu hình Endpoint — AgentBase tự động tạo một Endpoint **DEFAULT**
**Bước 4:** Cấu hình Security Settings (tùy chọn) — kiểm soát client nào được phép truy cập Runtime và cách xác thực request đến

**Bước 5:** Xem lại → nhấp **Create**
![Security Settings — IP Access Control và Inbound Identity](<../../../.gitbook/assets/Agentbase-image/Security-Runtime.png>)

| Cấu hình | Mô tả |
| --- | --- |
| **IP Access Control** | Giới hạn dải IP CIDR nguồn được phép truy cập Runtime này. Thêm một hoặc nhiều CIDR vào **Allowed source IP ranges**; để trống nếu muốn cho phép mọi nguồn. |
| **Inbound Identity** | Cấu hình cách xác thực request đến Runtime này — chọn **Inbound Auth type** bên dưới. |

**Inbound Auth type:**

| Chế độ | Mô tả |
| --- | --- |
| **IAM Permissions** | Xác thực caller bằng IAM token của GreenNode AI Platform. |
| **JSON Web Tokens (JWT)** | Validate JWT bearer token đính kèm trong request. Chọn **JWT key source** là **Discovery URL** (tự fetch và refresh public keys) hoặc JWKS inline. |
| **No authorization** | Không yêu cầu xác thực. |

{% hint style="warning" %}
Chọn **No authorization** khiến Runtime accessible công khai với bất kỳ ai có endpoint URL, không có access control. Dùng **IAM Permissions** hoặc **JWT** cho môi trường production.
{% endhint %}

**Bước 5:** Cấu hình Endpoint — AgentBase tự động tạo một Endpoint **DEFAULT**

**Bước 6:** Xem lại → nhấp **Create**

Runtime chuyển từ `CREATING` → `ACTIVE` khi container khởi động thành công.

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,11 @@ Runtime Service hỗ trợ autoscaling dựa trên mức sử dụng CPU hoặc

Khi tải giảm, AgentBase thu hẹp số bản sao về `minReplicas`.

### Security Settings

* **IP Access Control** — giới hạn dải IP CIDR nguồn được phép truy cập endpoint của Runtime; để trống nếu muốn cho phép mọi nguồn.
* **Inbound Identity** — cấu hình cách xác thực request đến, thông qua **Inbound Auth type**: **IAM Permissions** (IAM token của GreenNode AI Platform), **JSON Web Tokens (JWT)** (validate qua Discovery URL hoặc JWKS inline), hoặc **No authorization** (accessible công khai, không có access control).

### Hợp đồng dịch vụ (Service Contract)

Container agent của bạn phải đáp ứng các yêu cầu sau để hoạt động đúng với Runtime Service:
Expand Down Expand Up @@ -109,6 +114,10 @@ Runtime: my-order-agent
| **Memory Threshold** | `50` | Scale out khi RAM vượt quá % này (25–75) |
| **Registry Auth** | Bật nếu là private | Username = robot account `backendName` (xem [Supporting Services — Robot Accounts](../supporting-services.md#create-a-robot-account)) |
| **Environment Variables** | `KEY=value` | Chỉ cấu hình không nhạy cảm |
| **IP Access Control** | `10.0.0.0/16` | Tùy chọn — dải IP CIDR nguồn được phép truy cập; để trống nếu muốn cho phép mọi nguồn |
| **Inbound Auth type** | `JSON Web Tokens (JWT)` | Tùy chọn — **IAM Permissions**, **JWT** (Discovery URL hoặc JWKS inline), hoặc **No authorization** |

![Security Settings — IP Access Control và Inbound Identity](<../../../.gitbook/assets/Agentbase-image/Security-Runtime.png>)

5. Nhấn **Create**
6. Runtime xuất hiện với trạng thái `CREATING`, sau đó chuyển sang `ACTIVE`
Expand Down
16 changes: 16 additions & 0 deletions Vietnamese/ai-stack/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,6 +42,22 @@ Cần hỗ trợ trong quá trình chuyển đổi? Liên hệ qua email [suppor

***

## Tháng 7, 2026

**GreenNode AgentBase — Security Runtime & MCP Connectors**

GreenNode AgentBase bổ sung các tính năng bảo mật và tích hợp mới cho AI Agent:

**Tính năng mới:**

* **Security Runtime:** Kiểm soát client nào được phép truy cập Runtime và cách xác thực request đến — cấu hình **IP Access Control** (dải IP CIDR nguồn được phép) và **Inbound Identity** (IAM Permissions, JWT, hoặc No authorization) ngay khi tạo Runtime.
* Tìm hiểu thêm tại [Khởi tạo Runtime](agent-base/agent-runtime/khoi-tao-runtime.md).

* **MCP Connectors:** Kết nối agent với external service — GitHub, Slack, Microsoft 365 (bundle M365 VNG)... — chỉ trong vài phút thông qua catalog dựng sẵn, không cần build MCP server hay tự code OAuth.
* Tìm hiểu thêm tại [MCP Connectors](agent-base/mcp-connectors/README.md).

***

## Tháng 5, 2026

**GreenNode AgentBase — Phase 2**
Expand Down
8 changes: 8 additions & 0 deletions Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,14 @@ GreenNode CLI (lệnh `grn`) cho phép quản lý toàn bộ vòng đời **Clus

* Tìm hiểu thêm tại [Sử dụng GreenNode CLI để quản lý VKS](../../vks/getting-started/su-dung-greennode-cli-de-quan-ly-vks.md).

**GreenNode AgentBase — Security Runtime & MCP Connectors**

GreenNode AgentBase bổ sung các tính năng bảo mật và tích hợp mới cho AI Agent:

* **Security Runtime:** Cấu hình **IP Access Control** (dải IP CIDR nguồn được phép) và **Inbound Identity** (IAM Permissions, JWT, hoặc No authorization) ngay khi tạo Runtime.
* **MCP Connectors:** Kết nối agent với external service — GitHub, Slack, Microsoft 365... — chỉ trong vài phút thông qua catalog dựng sẵn, không cần build MCP server hay tự code OAuth.
* Tìm hiểu thêm tại [AI Stack — Lịch sử cập nhật](../../ai-stack/release-notes.md).

**Tháng 6, 2026**

**vDB - Redis Cluster (Non-sharding) cho MemoryStore (MDS)**
Expand Down
Loading