Thiết lập định tuyến máy chủ proxy

Tài liệu này dành cho những nhà phát triển muốn định tuyến tất cả lưu lượng truy cập gắn thẻ phía máy chủ thông qua một máy chủ proxy.

Trước khi bắt đầu

Trước khi có thể thiết lập tính năng định tuyến máy chủ proxy, hãy đảm bảo rằng bạn có:

  • Một vùng chứa phía máy chủ được triển khai trên Cloud Run hoặc thông qua thiết lập thủ công.

  • Một máy chủ proxy được triển khai để hỗ trợ các yêu cầu HTTP CONNECT.

  • Khả năng đưa lưu lượng truy cập đi cụ thể từ máy chủ proxy vào danh sách cho phép, chẳng hạn như sử dụng VPC, Tường lửa hoặc Danh sách kiểm soát quyền truy cập (ACL) của Proxy.

Định cấu hình định tuyến máy chủ proxy

Cloud Run

Cách chuyển tiếp lưu lượng truy cập đến một proxy cho các hoạt động triển khai Cloud Run:

  1. Mở Cloud Run
  2. Chọn phiên bản Cloud Run gắn thẻ phía máy chủ.
  3. Nhấp vào CHỈNH SỬA VÀ TRIỂN KHAI BẢN SỬA ĐỔI MỚI. Màn hình triển khai bản sửa đổi sẽ mở ra.
  4. Trong mục Vùng chứa, hãy chọn vùng chứa phía máy chủ của bạn. Một màn hình mới có chế độ cài đặt vùng chứa sẽ mở ra.

  5. Để mở rộng cấu hình dịch vụ, hãy chọn thẻ Variables & Secrets (Biến và khoá bí mật). Nhấp vào nút Add Variable (Thêm biến) rồi thêm biến môi trường sau:

    1. Tên: HTTP_PROXY
    2. Giá trị: URI của máy chủ proxy (ví dụ: https://proxy.example.com:3333 hoặc http://32.12.83.10)

  6. Nhấp vào Xong.

  7. Xác nhận nội dung chỉnh sửa rồi nhấp vào Triển khai.

Triển khai thủ công

Cách chuyển tiếp lưu lượng truy cập đến một proxy cho các hoạt động triển khai thủ công:

  1. Xác định một biến môi trường có thể truy cập vào hình ảnh Docker:

    1. Tên: HTTP_PROXY
    2. Giá trị: URI của máy chủ proxy (ví dụ: https://proxy.example.com hoặc http://32.12.83.10:1234)

  2. Chạy hình ảnh Docker bằng biến môi trường mới.

    docker run -p 8080:8080 \
-e CONTAINER_CONFIG=CONTAINER_CONFIG \
-e HTTP_PROXY=PROXY_URL \
gcr.io/cloud-tagging-10302018/gtm-cloud-image:stable

Kết quả: Việc triển khai tính năng gắn thẻ phía máy chủ sẽ gửi tất cả lưu lượng truy cập đi đến điểm cuối của proxy mà bạn đã chỉ định trong biến môi trường.

Xác minh chế độ thiết lập máy chủ proxy

Để xác minh chế độ thiết lập yêu cầu proxy, hãy kiểm tra cả Trình quản lý thẻ của Google và cấu hình máy chủ proxy của bạn.

Cách xác minh rằng vùng chứa phía máy chủ của bạn đang uỷ quyền các yêu cầu:

  1. Mở Trình quản lý thẻ của Google

  2. Mở vùng chứa phía máy chủ.

  3. Mở chế độ Xem trước. Trong thẻ Yêu cầu:

    1. Đảm bảo rằng ứng dụng của bạn xác nhận yêu cầu đến.
    2. Đảm bảo rằng thẻ và biến của bạn gửi thành công các yêu cầu HTTP đi.
    3. Để kiểm tra xem một yêu cầu có được gửi qua máy chủ proxy hay không, hãy nhấp vào một yêu cầu HTTP để xem Thông tin chi tiết về yêu cầu HTTP.

Cách xác minh chế độ thiết lập proxy:

  1. Kiểm tra nhật ký mạng và nhật ký máy chủ proxy. Bạn nên thấy ít nhất các yêu cầu thành công đến các điểm cuối sau:
  2. Kiểm tra xem có yêu cầu nào đến các điểm cuối khác hay không.
  3. Tuỳ thuộc vào các tính năng gắn thẻ phía máy chủ mà bạn sử dụng, bạn cũng có thể thấy các yêu cầu được gửi đến những điểm cuối khác, chẳng hạn như www.google-analytics.com, bigquery.googleapis.com hoặc các điểm cuối của bên thứ ba. Thêm mọi điểm cuối khác cần thiết cho chế độ thiết lập tính năng gắn thẻ của bạn vào danh sách cho phép.

Không bắt buộc: Thêm lưu lượng truy cập đi từ máy chủ proxy vào danh sách cho phép

Nếu chặn lưu lượng truy cập đi ra từ mạng hoặc từ máy chủ proxy, bạn phải đưa các miền của Trình quản lý thẻ của Google vào danh sách cho phép để phiên bản máy chủ gắn thẻ hoạt động. Cách bạn đưa lưu lượng truy cập đi vào danh sách cho phép phụ thuộc vào môi trường mạng và phần mềm proxy của bạn. Trước khi bắt đầu đưa các điểm cuối vào danh sách cho phép, hãy đảm bảo rằng bạn hiểu rõ cấu trúc liên kết mạng của mình.

Các miền sau đây được dùng để tìm nạp, xem trước và gỡ lỗi vùng chứa Trình quản lý thẻ của Google:

  • https://www.googletagmanager.com
  • https://tagmanager.google.com
  • ${Preview server URL}

Nếu bạn lưu trữ máy chủ Xem trước trên một mạng khác với máy chủ proxy hoặc có các quy tắc mạng hạn chế, hãy đưa lưu lượng truy cập đi ra từ proxy vào danh sách cho phép đến máy chủ Xem trước. URL của máy chủ Xem trước được xác định khi bạn triển khai vùng chứa phía máy chủ.

Không bắt buộc: Sử dụng phương thức Xác thực cơ bản với máy chủ proxy

Nếu tổ chức của bạn yêu cầu xác thực, bạn có thể sử dụng phương thức xác thực CƠ BẢN với tất cả các loại máy chủ.

Để sử dụng phương thức xác thực CƠ BẢN, hãy thêm thông tin đăng nhập (tên người dùng/mật khẩu) vào URL của máy chủ proxy theo định dạng sau:

HTTP_PROXY=http(s)://USER_NAME:PASSWORD@PROXY_URL

Mỗi yêu cầu đến proxy sẽ đặt tên người dùng và mật khẩu trong tiêu đề Proxy-Authorization dưới dạng các giá trị Base64.

Nếu bạn sử dụng Cloud Run, hãy lưu trữ thông tin xác thực điểm cuối của proxy trong Secret Manager. Secret Manager cho phép Cloud Run truy cập vào khoá bí mật tại thời điểm khởi động và phân giải giá trị. Tìm hiểu cách thiết lập bí mật trong Cloud Run.

Không bắt buộc: Tắt proxy cho các máy chủ lưu trữ cụ thể

Biến môi trường NO_PROXY cho phép bạn xác định danh sách tên máy chủ được phân tách bằng dấu phẩy mà không thể gửi qua máy chủ proxy.

Ví dụ: cho trước: NO_PROXY=example.com,169.254.169.254,diagnostics.example2.com:3131

Vùng chứa sGTM không uỷ quyền cho bất kỳ yêu cầu nào sau đây:

  • http://example.com, https://sub.example.com, https://other.example.com:123
  • http://169.254.169.254, https://169.254.169.254, http://169.254.169.254:123
  • http://diagonstics.example2.com:3131, https://diagonstics.example2.com:3131