Trang này được dịch bởi Cloud Translation API.

Miền tuỳ chỉnh Agentspace, hỗ trợ WIF

1. Giới thiệu

Tài liệu này cung cấp một cấu trúc tham chiếu để định cấu hình miền tuỳ chỉnh nhằm truy cập vào AgentSpace bằng WIF. Thay vì URL do Google quản lý được chỉ định trong quá trình tạo ứng dụng Agentspace, người dùng có thể sử dụng miền tuỳ chỉnh. Lớp học lập trình này minh hoạ cách truy cập vào các ứng dụng lịch và ổ đĩa của Agentspace bằng miền nip.io. nip.io là một dịch vụ nguồn mở miễn phí cung cấp DNS ký tự đại diện cho mọi địa chỉ IP. Về cơ bản, tính năng này cho phép bạn tạo một tên máy chủ phân giải thành một địa chỉ IP cụ thể mà không cần thiết lập máy chủ DNS của riêng bạn hoặc sửa đổi tệp /etc/hosts.

Bạn nên sử dụng miền của riêng mình, tuy nhiên, vì mục đích minh hoạ, hướng dẫn này sẽ sử dụng nip.io.

Trong tình huống triển khai được mô tả bên dưới (Hình 1), AgentSpace đã xuất bản một kho dữ liệu chứa Ứng dụng lịch được truy cập thông qua một URL công khai do Google quản lý.

Hình 1

Sự tăng trưởng liên tục của kho dữ liệu và các ứng dụng tiếp theo dẫn đến việc quản lý thêm các URL công khai do Google quản lý như được mô tả trong tình huống triển khai bên dưới (Hình 2), dẫn đến việc ánh xạ 1:1 giữa các ứng dụng Agentspace và URL.

Hình 2.

Miền tuỳ chỉnh cho phép liên kết nhiều ứng dụng AgentSpace với một miền duy nhất do khách hàng chỉ định. Tính năng này cho phép liên kết một đường dẫn URL cụ thể với từng ứng dụng Agentspace, mang lại tính linh hoạt cao hơn như minh hoạ trong tình huống triển khai bên dưới (Hình 3). Ví dụ: một miền do khách hàng quản lý agentspace.cosmopup.com được phân đoạn thành các quy tắc đường dẫn, mỗi quy tắc được liên kết với một ứng dụng Agentspace cụ thể, ví dụ:

agentspace.cosmopup.com/drive-app ánh xạ đến ứng dụng Agentspace cho Workspace Drive
agentspace.cosmopup.com/sharepoint-app liên kết đến ứng dụng Agentspace cho Sharepoint

Các quy tắc về máy chủ lưu trữ và đường dẫn của Bộ cân bằng tải ứng dụng bên ngoài (được định cấu hình thông qua MAP URL) kiểm soát logic ánh xạ miền tuỳ chỉnh đến URL do Google quản lý. Nó thực hiện chức năng sau bằng cách sử dụng không gian tác nhân ví dụ: agentspace.cosmopup.com/drive-app

Đường dẫn máy chủ miền tuỳ chỉnh agentspace.cosmopup.com/drive-app được loadbalancer nhận
Bản đồ URL được định cấu hình cho tính năng So khớp nâng cao theo quy tắc máy chủ lưu trữ và đường dẫn
Máy chủ lưu trữ agentspace.cosmopup.com đủ điều kiện để so khớp đường dẫn và chuyển hướng
Đường dẫn máy chủ miền tuỳ chỉnh agentspace.cosmopup.com/drive-app phải tuân theo UrlRedirect
pathRedirect là đường dẫn Agentspace: /us/home/cid/5970a1b4-080a-4b44-8acd-fa89460cf0cd
hostRedirect là máy chủ Agentspace: vertexaisearch.cloud.google.com
Đường dẫn máy chủ miền tuỳ chỉnh agentspace.cosmopup.com/sharepoint-app phải tuân theo UrlRedirect
pathRedirect là đường dẫn Agentspace: /signin/locations/global/workforcePools/your-pool-name/providers/your-provider-name?continueUrl=https://vertexaisearch.cloud.google/home/cid/f190000-0000-4d0a-0000-d08df6e3bef6
hostRedirect là máy chủ lưu trữ Agentspace: auth.cloud.google
Thao tác chuyển hướng được thực hiện trước khi định tuyến đến dịch vụ phụ trợ

Hình 3

Kiến thức bạn sẽ học được

Tạo một Trình cân bằng tải ứng dụng bên ngoài trên toàn cầu
Tạo một quy tắc định tuyến để chuyển hướng miền tuỳ chỉnh đến một ứng dụng Agentspace
Cách tích hợp nip.io và Cloud DNS để tạo miền tuỳ chỉnh
Cách xác thực quyền truy cập vào miền tuỳ chỉnh Agentspace

Bạn cần có

Dự án trên Google Cloud có quyền của chủ sở hữu
(Các) URL ứng dụng Agentspace hiện có
Miền tuỳ chỉnh của chủ sở hữu (không bắt buộc)
Chứng chỉ – Tự ký hoặc do Google quản lý

2. Sản phẩm bạn sẽ tạo ra

Bạn sẽ thiết lập một Bộ cân bằng tải ứng dụng bên ngoài toàn cầu với các chức năng quản lý lưu lượng truy cập nâng cao để cho phép so khớp đường dẫn miền tuỳ chỉnh cho các ứng dụng Agentspace bằng cách sử dụng tính năng chuyển hướng máy chủ lưu trữ và đường dẫn. Sau khi triển khai, bạn sẽ thực hiện các thao tác sau để xác thực quyền truy cập vào ứng dụng Agentspace:

Truy cập vào ứng dụng Agentspace bằng cách mở trình duyệt web rồi chuyển đến miền tuỳ chỉnh và đường dẫn đã chỉ định.

3. Yêu cầu về mạng

Dưới đây là thông tin chi tiết về các yêu cầu về mạng:

Thành phần	Mô tả
VPC (agentspace-vpc)	VPC ở chế độ tuỳ chỉnh
NEG Internet	Một tài nguyên được dùng để xác định một phần phụ trợ bên ngoài cho bộ cân bằng tải được định cấu hình dưới dạng FQDN biểu thị FQDN do Google quản lý của Agentspace (vertexaisearch.cloud.google.com). FQDN trên Internet thực hiện tra cứu DNS trong VPC để phân giải.
Dịch vụ phụ trợ	Dịch vụ phụ trợ đóng vai trò là cầu nối giữa trình cân bằng tải và các tài nguyên phụ trợ. Trong hướng dẫn này, dịch vụ phụ trợ được liên kết với NEG Internet.
Các chứng chỉ	Để định cấu hình chứng chỉ cho Bộ cân bằng tải ứng dụng trong Google Cloud, bạn sẽ sử dụng dịch vụ Trình quản lý chứng chỉ và chứng chỉ SSL do Google quản lý hoặc chứng chỉ SSL tự quản lý
Cloud DNS	Vùng công khai Cloud DNS được dùng để phân giải IP bên ngoài của bộ cân bằng tải ứng dụng bên ngoài thành nip.io (agentspace.externalip.nip.io). Ngoài ra, hãy sử dụng miền tuỳ chỉnh và bản ghi A bao gồm địa chỉ IP của bộ cân bằng tải.

4. Cấu trúc liên kết của lớp học lập trình

5. Thiết lập và yêu cầu

Thiết lập môi trường theo tốc độ của riêng bạn

Đăng nhập vào Google Cloud Console rồi tạo một dự án mới hoặc sử dụng lại một dự án hiện có. Nếu chưa có tài khoản Gmail hoặc Google Workspace, bạn phải tạo một tài khoản.

Tên dự án là tên hiển thị cho những người tham gia dự án này. Đây là một chuỗi ký tự mà các API của Google không sử dụng. Bạn luôn có thể cập nhật thông tin này.
Mã dự án là giá trị duy nhất trên tất cả các dự án trên Google Cloud và không thể thay đổi (bạn không thể thay đổi mã này sau khi đã đặt). Cloud Console sẽ tự động tạo một chuỗi duy nhất; thường thì bạn không cần quan tâm đến chuỗi này. Trong hầu hết các lớp học lập trình, bạn sẽ cần tham chiếu đến Mã dự án (thường được xác định là PROJECT_ID). Nếu không thích mã nhận dạng được tạo, bạn có thể tạo một mã nhận dạng ngẫu nhiên khác. Hoặc bạn có thể thử tên người dùng của riêng mình để xem tên đó có được chấp nhận hay không. Bạn không thể thay đổi tên này sau bước này và tên này sẽ tồn tại trong suốt thời gian của dự án.
Để bạn nắm được thông tin, có một giá trị thứ ba là Số dự án mà một số API sử dụng. Tìm hiểu thêm về cả 3 giá trị này trong tài liệu.

Tiếp theo, bạn cần bật tính năng thanh toán trong Cloud Console để sử dụng các tài nguyên/API trên Cloud. Việc thực hiện lớp học lập trình này sẽ không tốn nhiều chi phí, nếu có. Để tắt các tài nguyên nhằm tránh bị tính phí ngoài phạm vi hướng dẫn này, bạn có thể xoá các tài nguyên đã tạo hoặc xoá dự án. Người dùng mới của Google Cloud đủ điều kiện tham gia chương trình Dùng thử miễn phí 300 USD.

Khởi động Cloud Shell

Mặc dù có thể vận hành Google Cloud từ xa trên máy tính xách tay, nhưng trong lớp học lập trình này, bạn sẽ sử dụng Google Cloud Shell, một môi trường dòng lệnh chạy trên Cloud.

Trên Bảng điều khiển Google Cloud, hãy nhấp vào biểu tượng Cloud Shell trên thanh công cụ ở trên cùng bên phải:

Quá trình này chỉ mất vài phút để cung cấp và kết nối với môi trường. Khi quá trình này kết thúc, bạn sẽ thấy như sau:

Máy ảo này được trang bị tất cả các công cụ phát triển mà bạn cần. Nền tảng này cung cấp một thư mục chính có dung lượng 5 GB và chạy trên Google Cloud, giúp tăng cường đáng kể hiệu suất mạng và hoạt động xác thực. Bạn có thể thực hiện mọi thao tác trong lớp học lập trình này trong trình duyệt. Bạn không cần cài đặt bất cứ thứ gì.

6. Trước khi bắt đầu

Bật API

Trong Cloud Shell, hãy đảm bảo rằng bạn đã thiết lập mã dự án:

gcloud config list project
gcloud config set project [YOUR-PROJECT-ID]
project=[YOUR-PROJECT-ID]
region=[YOUR-REGION]
echo $project
echo $region

Bật tất cả các dịch vụ cần thiết:

gcloud services enable compute.googleapis.com
gcloud services enable dns.googleapis.com

7. Thiết lập các thành phần của Trình cân bằng tải

Đặt trước địa chỉ IP bên ngoài của trình cân bằng tải

Trong Cloud Shell, hãy đặt trước một địa chỉ IP bên ngoài cho trình cân bằng tải:

gcloud compute addresses create external-ip \
    --network-tier=PREMIUM \
    --ip-version=IPV4 \
    --global

Trong Cloud Shell, hãy xem địa chỉ IP dành riêng:

gcloud compute addresses describe external-ip \
  --global | grep -i address:

Kết quả điểm dữ liệu:

user@cloudshell$ gcloud compute addresses describe external-ip \
  --global | grep -i address:
address: 34.54.158.206

Thiết lập NEG Internet

Tạo một NEG trên Internet và đặt –network-endpoint-type thành internet-fqdn-port (tên máy chủ và cổng mà bạn có thể truy cập vào phụ trợ bên ngoài). Để phân giải Agentspace, đỉnh FQDN vertexaisearch.cloud.google.com và CỔNG 443 sẽ được dùng.

gcloud compute network-endpoint-groups create agentspace-ineg \
    --network-endpoint-type="internet-fqdn-port" \
    --global

gcloud compute network-endpoint-groups update agentspace-ineg \
    --add-endpoint="fqdn=vertexaisearch.cloud.google.com,port=443" \
    --global

Tạo Bộ cân bằng tải

Trong Cloud Shell, hãy thực hiện các bước sau:

gcloud compute backend-services create agentspace-ineg-bes \
      --load-balancing-scheme=EXTERNAL_MANAGED \
      --protocol=HTTPS \
      --global

gcloud compute backend-services add-backend agentspace-ineg-bes \
      --network-endpoint-group=agentspace-ineg \
      --global-network-endpoint-group \
      --global

Tạo chứng chỉ

Tại thời điểm này, bạn đã tạo dịch vụ phụ trợ và neg trên internet. Trong phần sau, bạn sẽ cần tạo một tài nguyên chứng chỉ để sử dụng trong proxy đích HTTP. Bạn có thể tạo một tài nguyên chứng chỉ SSL bằng cách sử dụng chứng chỉ SSL do Google quản lý hoặc chứng chỉ SSL tự quản lý. Bạn nên sử dụng chứng chỉ do Google quản lý vì Google Cloud sẽ tự động lấy, quản lý và gia hạn các chứng chỉ này.

Để tìm hiểu thêm về các chứng chỉ được hỗ trợ cho Trình cân bằng tải ứng dụng bên ngoài trên toàn cầu được dùng trong hướng dẫn này, hãy tham khảo những thông tin sau:

Tổng quan về chứng chỉ SSL | Cân bằng tải | Google Cloud

Trong phần sau, bạn sẽ tạo một chứng chỉ tự ký (mặc dù bạn có thể sử dụng chứng chỉ do Google quản lý) yêu cầu ánh xạ tên chung với tên miền đủ điều kiện (agentspace.YOUR-EXTERNAL-IP.nip.io) tương ứng với địa chỉ IP bên ngoài của bộ cân bằng tải đã được tạo trước đó, ví dụ:

Tên thông thường: agentspace.34.54.158.206.nip.io

Trong Cloud Shell, hãy tạo khoá riêng tư

openssl genrsa -out private-key-file.pem 2048

Trong Cloud Shell, hãy tạo một tệp config.txt dùng để tạo tệp pem. Chỉ định tên miền đủ điều kiện trong mục DNS 1 agentspace.YOUR-EXTERNAL-IP.nip.io, ví dụ: agentspace.34.54.158.206.nip.io trong cấu hình bên dưới.

cat <<'EOF' >config.txt
[req]
default_bits              = 2048
req_extensions            = extension_requirements
distinguished_name        = dn_requirements

[extension_requirements]
basicConstraints          = CA:FALSE
keyUsage                  = nonRepudiation, digitalSignature, keyEncipherment
subjectAltName            = @sans_list

[dn_requirements]
countryName               = Country Name (2 letter code)
stateOrProvinceName       = State or Province Name (full name)
localityName              = Locality Name (eg, city)
organizationName          = Organization Name (eg, company)
organizationalUnitName    = Organizational Unit Name (eg, section)
commonName                = Common Name (e.g. server FQDN or YOUR name)
emailAddress              = Email Address

[sans_list]
DNS.1                     = agentspace.YOUR-EXTERNAL-IP.nip.io

EOF

Trong Cloud Shell, hãy xác thực rằng config.txt và private-key-file.pem đã được tạo.

user@cloudshell:$ ls
config.txt  private-key-file.pem

Trong Cloud Shell, hãy thực hiện các thao tác sau.

sudo openssl req -new -key private-key-file.pem \
    -out csr.pem \
    -config config.txt

Ví dụ:

user@cloudshell:$ sudo openssl req -new -key private-key-file.pem \
    -out csr.pem \
    -config config.txt
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) []:
State or Province Name (full name) []:
Locality Name (eg, city) []:
Organization Name (eg, company) []:
Organizational Unit Name (eg, section) []:
Common Name (e.g. server FQDN or YOUR name)[]:agentspace.34.54.158.206.nip.io
Email Address []:

Trong Cloud Shell, hãy xác thực việc tạo tệp pem bắt buộc để ký chứng chỉ.

user@cloudshell:$ ls
config.txt  csr.pem  private-key-file.pem

Trong Cloud Shell, hãy tạo chứng chỉ.

sudo openssl x509 -req \
    -signkey private-key-file.pem \
    -in csr.pem \
    -out cert.cert \
    -extfile config.txt \
    -extensions extension_requirements \
    -days 365

Ví dụ về kết quả đầu ra:

user@cloudshell:$ sudo openssl x509 -req \
    -signkey private-key-file.pem \
    -in csr.pem \
    -out cert.cert \
    -extfile config.txt \
    -extensions extension_requirements \
    -days 365
Certificate request self-signature ok
subject=CN = agentspace.34.54.158.206.nip.io

Trong Cloud Shell, hãy xác thực việc tạo tệp cert.cert

user@cloudshell:$ ls
cert.cert  config.txt  csr.pem  private-key-file.pem

Tạo một tài nguyên chứng chỉ để liên kết với trình cân bằng tải bên ngoài. Thay thế các tham số chứng chỉ và khoá riêng tư bằng tên tệp cụ thể của bạn.