Kiểm soát quyền truy cập mạng vào tính năng Trợ giúp lập trình của Gemini bằng các quy định hạn chế về miền của người dùng
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài liệu này hướng dẫn quản trị viên mạng định cấu hình mạng của họ để hạn chế quyền truy cập vào tính năng Gemini Code Assist dựa trên miền của người dùng. Tính năng này cho phép các tổ chức kiểm soát những người dùng trong mạng của họ có thể sử dụng tính năng Trợ giúp mã Gemini, tăng cường bảo mật và ngăn chặn truy cập trái phép.
Tổng quan
Bạn có thể định cấu hình tính năng Hỗ trợ mã Gemini để thực thi các quy định hạn chế về miền của người dùng bằng cách sử dụng phương pháp proxy Người ở giữa (PITM). Việc này liên quan đến việc chèn một tiêu đề HTTP tuỳ chỉnh, X-GeminiCodeAssist-Allowed-Domains, vào các yêu cầu được gửi đến Gemini Code Assist. Tiêu đề chỉ định danh sách các miền được phép và phần phụ trợ của Gemini Code Assist chỉ xử lý các yêu cầu của người dùng có miền được xác thực khớp với một trong các miền được phép.
Định cấu hình proxy trong IDE
Để định cấu hình proxy trong IDE, hãy làm theo các bước sau:
VS Code
Chuyển đến File (Tệp) >Settings (Cài đặt) (đối với Windows) hoặc Code (Mã) >Settings (Cài đặt) >Settings (Cài đặt) (đối với macOS).
Trong thẻ Người dùng, hãy chuyển đến Ứng dụng>Proxy.
Trong hộp bên dưới mục Proxy (Máy chủ proxy), hãy nhập địa chỉ của máy chủ proxy. Ví dụ: http://localhost:3128.
Không bắt buộc: Để định cấu hình tính năng Hỗ trợ mã Gemini nhằm bỏ qua lỗi chứng chỉ, trong phần Proxy Strict SSL (Proxy SSL nghiêm ngặt), hãy chọn hoặc bỏ chọn hộp đánh dấu. Chế độ cài đặt này áp dụng cho tất cả hồ sơ.
IntelliJ
Chuyển đến File (Tệp) >Settings (Cài đặt) (đối với Windows) hoặc IntelliJ IDEA>Settings (Cài đặt) (đối với macOS).
Chuyển đến Appearance & Behavior (Giao diện và hành vi) >System Settings (Cài đặt hệ thống)
>HTTP Proxy (Proxy HTTP).
Chọn Cấu hình proxy thủ công, rồi chọn HTTP.
Trong trường Tên máy chủ, hãy nhập tên máy chủ của máy chủ proxy.
Trong trường Số cổng, hãy nhập số cổng của máy chủ proxy.
Không bắt buộc: Để định cấu hình tính năng Trợ giúp mã Gemini nhằm bỏ qua lỗi chứng chỉ, trong thanh bên, hãy nhấp vào Tools (Công cụ) >Server Certificates (Chứng chỉ máy chủ), sau đó chọn hoặc bỏ chọn Accept non-trusted certificates automatically (Tự động chấp nhận chứng chỉ không đáng tin cậy).
Định cấu hình proxy PITM
Để định cấu hình proxy PITM, hãy làm theo các bước sau:
Đảm bảo mạng của bạn sử dụng một proxy PITM có thể chặn và chỉnh sửa lưu lượng truy cập HTTPS.
Định cấu hình proxy để chặn tất cả các yêu cầu gửi đến điểm cuối Gemini Code Assist (https://cloudcode-pa.googleapis.com). Đừng sử dụng ký tự đại diện (*) khi bạn chỉ định điểm cuối Gemini Code Assist.
Định cấu hình proxy để chèn tiêu đề X-GeminiCodeAssist-Allowed-Domains vào từng yêu cầu. Tiêu đề phải chứa danh sách các miền được phép được phân tách bằng dấu phẩy (ví dụ: example.com, yourcompany.net). Đảm bảo rằng tên miền được phân tách bằng dấu phẩy và không chứa ký hiệu @.
Nếu tiêu đề không được phân giải thành ít nhất một miền hợp lệ, thì các quy định hạn chế sẽ không áp dụng. Ví dụ: tiêu đề trống sẽ không áp dụng bất kỳ hạn chế nào.
domain sẽ không áp dụng bất kỳ quy định hạn chế nào vì đây không phải là tên miền hợp lệ.
Khi người dùng cố gắng truy cập vào tính năng Trợ giúp mã Gemini từ một miền không có trong danh sách tiêu đề, họ sẽ thấy thông báo cho biết rằng quản trị viên của họ đã hạn chế họ sử dụng tính năng Trợ giúp mã Gemini trên miền của họ.
Chặn SSL/TLS
Nếu proxy của bạn cần giải mã lưu lượng truy cập HTTPS để chèn tiêu đề, hãy đảm bảo rằng proxy đó được định cấu hình để chặn SSL/TLS. Việc này thường bao gồm:
Tạo chứng chỉ cho proxy.
Cài đặt chứng chỉ của proxy trên thiết bị của người dùng để thiết lập niềm tin và tránh lỗi chứng chỉ.
Xác thực tiêu đề
Tính năng Trợ giúp mã Gemini tự động xác thực tiêu đề X-GeminiCodeAssist-Allowed-Domains và thực thi các quy định hạn chế.
Nếu tiêu đề không phân giải đến ít nhất một miền hợp lệ, thì quá trình xác thực sẽ không được thực hiện.
Nếu miền của người dùng không có trong danh sách được phép, thì yêu cầu sẽ bị từ chối.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Khó hiểu","hardToUnderstand","thumb-down"],["Thông tin hoặc mã mẫu không chính xác","incorrectInformationOrSampleCode","thumb-down"],["Thiếu thông tin/mẫu tôi cần","missingTheInformationSamplesINeed","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2025-06-11 UTC."],[[["\u003cp\u003eNetwork administrators can restrict access to Gemini Code Assist by user domain, enhancing security and controlling who can use the tool.\u003c/p\u003e\n"],["\u003cp\u003eA Person-in-the-Middle (PITM) proxy is used to inject an \u003ccode\u003eX-GeminiCodeAssist-Allowed-Domains\u003c/code\u003e header into requests, specifying allowed domains.\u003c/p\u003e\n"],["\u003cp\u003eConfiguring the proxy within IDEs like VS Code and IntelliJ involves setting the proxy server address and optionally managing certificate error settings.\u003c/p\u003e\n"],["\u003cp\u003eThe PITM proxy must intercept HTTPS traffic to Gemini Code Assist endpoints, injecting the header with a comma-separated list of valid domains, such as \u003ccode\u003eexample.com\u003c/code\u003e, \u003ccode\u003eyourcompany.net\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGemini Code Assist automatically validates the header to ensure that users are coming from an allowed domain, rejecting the request if not.\u003c/p\u003e\n"]]],[],null,["# Control Network Access to Gemini Code Assist with User Domain Restrictions\n\nThis document provides instructions for network administrators to configure\ntheir networks to restrict access to Gemini Code Assist based on\nuser domains. This feature allows organizations to control which users within\ntheir network can utilize Gemini Code Assist, enhancing security\nand preventing unauthorized access.\n\nOverview\n--------\n\nYou can configure Gemini Code Assist to enforce user domain\nrestrictions using a Person-in-the-Middle (PITM) proxy approach. This involves\ninjecting a custom HTTP header,\n`X-GeminiCodeAssist-Allowed-Domains`, into requests made to\nGemini Code Assist. The header specifies a list of allowed\ndomains, and the Gemini Code Assist backend only processes\nrequests from users whose authenticated domain matches one of the allowed\ndomains.\n\nConfigure a proxy in your IDE\n-----------------------------\n\nTo configure a proxy in your IDE, follow these steps: \n\n### VS Code\n\n1. Navigate to **File** \\\u003e **Settings** (for Windows), or **Code**\n \\\u003e **Settings** \\\u003e **Settings** (for macOS).\n\n2. In the **User** tab, navigate to **Application** \\\u003e **Proxy**.\n\n3. In the box under **Proxy** , enter the address of your proxy server. For\n example `http://localhost:3128`.\n\n4. Optional: To configure Gemini Code Assist to ignore\n certificate errors, under **Proxy Strict SSL**, select or deselect the\n checkbox. This setting applies to all profiles.\n\n### IntelliJ\n\n1. Navigate to **File** \\\u003e **Settings** (for Windows) or **IntelliJ\n IDEA** \\\u003e **Settings** (for macOS).\n\n2. Navigate to **Appearance \\& Behavior** \\\u003e **System Settings**\n \\\u003e **HTTP Proxy**.\n\n3. Select **Manual proxy configuration** , and then select **HTTP**.\n\n4. In the **Host name** field, enter the hostname of your proxy server.\n\n5. In the **Port number** field, enter the port number of your proxy server.\n\n6. Optional: To configure Gemini Code Assist to ignore\n certificate errors, in the sidebar, click **Tools** \\\u003e **Server\n Certificates** and then select or deselect **Accept non-trusted certificates\n automatically**.\n\nConfigure PITM proxy\n--------------------\n\nTo configure your PITM proxy, follow these steps:\n\n1. Make sure your network utilizes a PITM proxy capable of intercepting and\n modifying HTTPS traffic.\n\n2. Configure the proxy to intercept all outgoing requests to the\n Gemini Code Assist endpoint\n (`https://cloudcode-pa.googleapis.com`). Don't use wildcards (`*`) when you\n specify the Gemini Code Assist endpoint.\n\n3. Configure the proxy to inject the `X-GeminiCodeAssist-Allowed-Domains`\n header into each request. The header should contain a comma-separated list\n of allowed domains (e.g., `example.com`, `yourcompany.net`).\n Make sure that domain names are separated by commas and\n don't include the `@` symbol.\n\n If headers aren't resolved into at least one valid domain, restrictions\n won't apply. For example, an empty header won't apply any restrictions.\n `domain` won't apply any restrictions as it isn't a valid domain name.\n\nWhen a user tries to access Gemini Code Assist from a domain not\nincluded in the header list, they see a message telling them that they're\nrestricted from using Gemini Code Assist on their domain by their\nadministrator.\n\nSSL/TLS interception\n--------------------\n\nIf your proxy needs to decrypt HTTPS traffic to inject the header, make sure\nit's configured for SSL/TLS interception. This typically involves:\n\n- Generating a certificate for the proxy.\n\n- Installing the proxy's certificate on user devices to establish trust and\n avoid certificate errors.\n\nHeader validation\n-----------------\n\n- Gemini Code Assist automatically validates the\n `X-GeminiCodeAssist-Allowed-Domains` header and enforces the restrictions.\n\n- If the header doesn't resolve to at least one valid domain, the validation\n won't be performed.\n\n- If the domain associated with the user's authentication isn't in the allowed\n list, the request is rejected. For example if the user logs in with a gmail\n account and only example.com is on the allowed list, the request is rejected.\n\nWhat's next\n-----------\n\nTo learn more about blocking access to consumer accounts, see\n[Block access to consumer accounts](https://support.google.com/a/answer/1668854)."]]
