Lợi ích khi kết nối
Việc kết nối tài khoản Cloudflare của quý vị cho phép chúng tôi xuất bản các trang tĩnh lên Cloudflare Pages trên tài khoản của quý vị, đồng thời phân phối DNS và bộ nhớ đệm (cache) cho các trang web của quý vị từ tài khoản đó. Mọi thứ đều nằm trong bảng điều khiển Cloudflare riêng và thuộc gói dịch vụ Cloudflare của chính quý vị.
Trước khi quý vị bắt đầu
Một tài khoản Cloudflare, với các tên miền quý vị muốn sử dụng đã được thêm vào dưới dạng các zone. Gói miễn phí là đủ để kết nối; những gì quý vị có thể thực hiện trên mỗi zone phụ thuộc vào quyền hạn mà gói của quý vị cho phép.
1. Tạo khóa tại Cloudflare
Trong bảng điều khiển Cloudflare, hãy mở My Profile → API Tokens và chọn Create Token, sau đó chọn Create Custom Token. Đặt tên cho mã này, thêm các quyền bên dưới và trong mục Zone Resources, hãy chọn các zone quý vị muốn chúng tôi truy cập — tất cả các zone hoặc chỉ những zone quý vị chỉ định. Xem lại thông tin và nhấn Create Token. Cloudflare chỉ hiển thị mã token một lần; hãy sao chép mã ngay lúc đó.
Thêm các quyền sau:
- Zone → Zone → Read
- Zone → DNS → Edit
- Zone → Cache Purge → Purge
- Zone → Zone Settings → Edit
- Account → Cloudflare Pages → Edit — chỉ khi quý vị muốn chúng tôi xuất bản các trang web lên Pages. Mã token không có quyền này vẫn có thể kết nối và hoạt động bình thường cho DNS và bộ nhớ đệm.
Phương án thay thế cũ hơn. Thay vì mã token, quý vị có thể kết nối bằng Global API Key và địa chỉ email quý vị dùng để đăng nhập (My Profile → API Tokens → API Keys → Global API Key → View). Cloudflare khuyến cáo không nên dùng cách này: Global API Key mang toàn bộ quyền hạn mà tài khoản đăng nhập của quý vị có trên mọi zone và không thể thu hẹp phạm vi quyền. Hãy sử dụng mã token nếu có thể.
2. Kết nối tại đây
Mở mục Integrations trong bảng điều khiển của quý vị và chọn Connect an account. Chọn Cloudflare account (Pages, CDN & DNS) làm nhóm và Cloudflare làm tài khoản, điền API token — hoặc đối với phương án thay thế cũ hơn, điền API key cùng Account email, rồi nhấn Connect account.
Chúng tôi sẽ kiểm tra nội dung quý vị dán vào trước khi lưu bất kỳ thông tin nào. Khóa không hoạt động sẽ không bao giờ được lưu trữ, và thông báo phản hồi sẽ cho biết khóa đó gặp lỗi gì. Khóa hoạt động được sẽ được mã hóa và lưu giữ trong kho bí mật (secrets vault) của chúng tôi — không bao giờ lưu trong cơ sở dữ liệu — và sẽ không bao giờ hiển thị lại, kể cả với quý vị.
Điều gì xảy ra tiếp theo
- Cloudflare Pages sẽ xuất hiện dưới dạng một đích triển khai khi quý vị tạo hoặc chuyển một trang web tĩnh, và chúng tôi sẽ xuất bản bản dựng lên một dự án Pages trên tài khoản của quý vị.
- Các zone của quý vị có thể cung cấp DNS của tên miền và bộ nhớ đệm của trang web từ tài khoản này.
- Chúng tôi kiểm tra xem mã token có thể đọc các zone, chỉnh sửa DNS, xóa bộ nhớ đệm và thay đổi cài đặt zone của quý vị hay không. Danh sách kiểm tra bên cạnh kết nối sẽ hiển thị những quyền nào chúng tôi đã có thể xác nhận.
Nếu quý vị muốn giữ CDN và DNS trên các tài khoản Cloudflare khác nhau, hãy kết nối riêng chúng dưới dạng Cloudflare CDN và Cloudflare DNS — mỗi loại đều có hướng dẫn riêng.
Nếu không thể kết nối
Một quyền hiển thị là chưa được xác nhận. Cloudflare không phải lúc nào cũng cho phép mã token tự liệt kê các quyền của chính nó, vì vậy một số quyền sẽ được xác nhận vào lần đầu tiên chúng tôi sử dụng chúng. Nếu một thao tác sau đó thất bại do lỗi phân quyền, hãy chỉnh sửa mã token trong My Profile → API Tokens và thêm quyền còn thiếu — giá trị của mã token không thay đổi, vì vậy không cần phải kết nối lại.
Thiếu một zone. Mục Zone Resources của mã token không bao gồm zone đó. Hãy chỉnh sửa mã token để thêm zone đó vào, hoặc chọn tất cả các zone.
Có thông báo khóa bị từ chối. Hầu như luôn là một trong ba nguyên nhân: có khoảng trắng hoặc ký tự xuống dòng bị sao chép cùng, khóa đã hết hạn, hoặc khóa đã bị thu hồi hay tạo lại sau khi quý vị sao chép. Hãy tạo một khóa mới và dán lại.
Kết nối được, nhưng sau đó phát sinh lỗi. Khóa đã xác thực thành công nhưng thiếu một quyền mà thao tác yêu cầu. Hãy tạo một khóa mới với các quyền được liệt kê ở trên, sau đó ngắt kết nối cũ và kết nối với khóa mới.
Ngắt kết nối
Mở Integrations, tìm tài khoản và nhấn Disconnect. Thao tác này sẽ xóa khóa đã lưu trữ ngay lập tức. Bất kỳ tác vụ nào đang sử dụng khóa này sẽ dừng lại ở thao tác tiếp theo, và các màn hình phụ thuộc vào nó sẽ thông báo rõ ràng thay vì âm thầm gặp lỗi.
Việc ngắt kết nối không hoàn tác những gì đã được thực hiện — các bản ghi, bản triển khai hoặc cài đặt chúng tôi đã thay đổi trên tài khoản của quý vị vẫn sẽ được giữ nguyên. Nếu quý vị cho rằng chính khóa đó có thể đã bị lộ, hãy thu hồi nó tại nhà cung cấp; việc ngắt kết nối chỉ xóa bản sao của chúng tôi chứ không xóa bản sao của họ.