diff --git a/English/.gitbook/assets/Agentbase-image/Security-Runtime.png b/English/.gitbook/assets/Agentbase-image/Security-Runtime.png new file mode 100644 index 00000000..ce58989f Binary files /dev/null and b/English/.gitbook/assets/Agentbase-image/Security-Runtime.png differ diff --git a/English/ai-stack/agent-base/agent-runtime/create-runtime.md b/English/ai-stack/agent-base/agent-runtime/create-runtime.md index d81c08fb..c6952230 100644 --- a/English/ai-stack/agent-base/agent-runtime/create-runtime.md +++ b/English/ai-stack/agent-base/agent-runtime/create-runtime.md @@ -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. diff --git a/English/ai-stack/agent-base/agent-runtime/runtime-reference.md b/English/ai-stack/agent-base/agent-runtime/runtime-reference.md index 92f53cd6..3cccba2a 100644 --- a/English/ai-stack/agent-base/agent-runtime/runtime-reference.md +++ b/English/ai-stack/agent-base/agent-runtime/runtime-reference.md @@ -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: @@ -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` diff --git a/English/ai-stack/release-notes.md b/English/ai-stack/release-notes.md index 4cadd72b..81a8674f 100644 --- a/English/ai-stack/release-notes.md +++ b/English/ai-stack/release-notes.md @@ -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** diff --git a/English/overview/product-updates-all/2026.md b/English/overview/product-updates-all/2026.md index fa7c58d3..c60aeeab 100644 --- a/English/overview/product-updates-all/2026.md +++ b/English/overview/product-updates-all/2026.md @@ -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)** diff --git a/Vietnamese/.gitbook/assets/Agentbase-image/Security-Runtime.png b/Vietnamese/.gitbook/assets/Agentbase-image/Security-Runtime.png new file mode 100644 index 00000000..ce58989f Binary files /dev/null and b/Vietnamese/.gitbook/assets/Agentbase-image/Security-Runtime.png differ diff --git a/Vietnamese/ai-stack/agent-base/agent-runtime/khoi-tao-runtime.md b/Vietnamese/ai-stack/agent-base/agent-runtime/khoi-tao-runtime.md index d2f64da3..4bcf8091 100644 --- a/Vietnamese/ai-stack/agent-base/agent-runtime/khoi-tao-runtime.md +++ b/Vietnamese/ai-stack/agent-base/agent-runtime/khoi-tao-runtime.md @@ -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. diff --git a/Vietnamese/ai-stack/agent-base/agent-runtime/tham-chieu-runtime.md b/Vietnamese/ai-stack/agent-base/agent-runtime/tham-chieu-runtime.md index fdabaf67..12b6dcb1 100644 --- a/Vietnamese/ai-stack/agent-base/agent-runtime/tham-chieu-runtime.md +++ b/Vietnamese/ai-stack/agent-base/agent-runtime/tham-chieu-runtime.md @@ -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: @@ -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` diff --git a/Vietnamese/ai-stack/release-notes.md b/Vietnamese/ai-stack/release-notes.md index 0c4a6fb7..53ff7392 100644 --- a/Vietnamese/ai-stack/release-notes.md +++ b/Vietnamese/ai-stack/release-notes.md @@ -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** diff --git a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md index 61c45923..6e217800 100644 --- a/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md +++ b/Vietnamese/gioi-thieu-chung/thong-bao-va-cap-nhat/2026.md @@ -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)**