Google sử dụng công nghệ AI để dịch nội dung sang ngôn ngữ bạn ưu tiên. Bản dịch bằng AI có thể có lỗi.

Bắt đầu sử dụng tính năng Kiểm tra ứng dụng kết hợp với reCAPTCHA Enterprise trên các nền tảng của Apple

Chọn nền tảng:

iOS+ Android Web Flutter

Trang này hướng dẫn bạn cách thiết lập App Check trong một ứng dụng trên nền tảng của Apple bằng cách sử dụng trình cung cấp reCAPTCHA Enterprise. App Check giúp đảm bảo rằng chỉ ứng dụng của bạn mới có thể truy cập vào tài nguyên phụ trợ của dự án. Để tìm hiểu thêm, hãy xem bài viết tổng quan về App Check.

App Check yêu cầu sử dụng khoá reCAPTCHA dựa trên điểm số, giúp người dùng không nhìn thấy khoá này. Điều này có nghĩa là nhà cung cấp reCAPTCHA Enterprise sẽ không yêu cầu người dùng giải câu đố bất cứ lúc nào.

Nếu trường hợp sử dụng của bạn yêu cầu các tính năng reCAPTCHA Enterprise không được App Check triển khai hoặc nếu bạn muốn sử dụng App Check với nhà cung cấp tuỳ chỉnh của riêng mình, hãy xem phần Triển khai nhà cung cấp App Check tuỳ chỉnh.

1. Thiết lập dự án Firebase

Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Apple.
Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Chống lừa đảo rồi làm như sau cho nhà cung cấp reCAPTCHA Enterprise:
1. Đảm bảo rằng bạn đang ở đúng dự án (xem bộ chọn dự án ở đầu màn hình).
2. Nếu được nhắc, hãy bật API reCAPTCHA Enterprise.
3. Tạo khoá loại iOS và chỉ định mã nhận dạng gói của ứng dụng (ví dụ: com.example.my_app).
  - Hãy nhớ nhập cùng một mã nhận dạng gói mà bạn đã cung cấp khi tạo Ứng dụng Apple Firebase trong dự án Firebase. Giá trị mã nhận dạng gói có phân biệt chữ hoa chữ thường.
  - Đối với App Check, mỗi mã nhận dạng gói chỉ có thể tương ứng với một khoá reCAPTCHA.
  Để biết hướng dẫn chi tiết, hãy xem bài viết Tạo khoá reCAPTCHA dựa trên điểm số.
4. Hãy ghi lại khoá này. Bạn cần thêm mã này vào quy trình đăng ký trong bảng điều khiển Firebase.
Trong bảng điều khiển Firebase, hãy chuyển đến phần Security (Bảo mật) > App Check (Kiểm tra ứng dụng).
Trong thẻ Apps (Ứng dụng), hãy đăng ký các ứng dụng nền tảng Apple để sử dụng App Check với nhà cung cấp reCAPTCHA Enterprise. Bạn cần cung cấp khoá mà bạn nhận được trong bảng điều khiển Google Cloud.

Quan trọng: Hãy nhớ đăng ký tất cả ứng dụng của dự án với một nhà cung cấp dịch vụ chứng thực (chẳng hạn như reCAPTCHA Enterprise). Sau khi bạn bật chế độ thực thi cho một dịch vụ, chỉ những ứng dụng đã đăng ký mới có thể truy cập vào dịch vụ đó.
Không bắt buộc: Đặt thời gian tồn tại (TTL) của mã thông báo.

Trong phần cài đặt đăng ký ứng dụng, hãy đặt thời gian tồn tại (TTL) tuỳ chỉnh cho mã thông báo App Check do nhà cung cấp phát hành. Bạn có thể đặt TTL thành bất kỳ giá trị nào trong khoảng từ 30 phút đến 7 ngày. Khi thay đổi giá trị này, hãy lưu ý những điểm đánh đổi sau:
- Bảo mật: TTL ngắn hơn mang lại khả năng bảo mật mạnh mẽ hơn vì nó làm giảm khoảng thời gian mà kẻ tấn công có thể lợi dụng mã thông báo bị rò rỉ hoặc bị chặn.
- Hiệu suất: TTL ngắn hơn đồng nghĩa với việc ứng dụng của bạn sẽ thực hiện chứng thực thường xuyên hơn. Vì quy trình chứng thực ứng dụng làm tăng độ trễ cho các yêu cầu mạng mỗi khi được thực hiện, nên TTL ngắn có thể ảnh hưởng đến hiệu suất của ứng dụng.
- Hạn mức và chi phí: TTL ngắn hơn và việc chứng thực lại thường xuyên sẽ làm giảm hạn mức của bạn nhanh hơn và đối với các dịch vụ có tính phí, có thể tốn nhiều chi phí hơn. Xem Hạn mức và giới hạn.
TTL mặc định là 1 giờ, phù hợp với hầu hết các ứng dụng. Xin lưu ý rằng thư viện App Check sẽ làm mới mã thông báo sau khoảng một nửa thời gian TTL.
Không bắt buộc: Định cấu hình chế độ cài đặt nâng cao.
Nhấp vào Lưu.

(Không bắt buộc) Định cấu hình chế độ cài đặt nâng cao

Khi người dùng mở ứng dụng của bạn, reCAPTCHA Enterprise sẽ đánh giá mức độ rủi ro của hoạt động tương tác của người dùng theo khoá và trả về điểm số từ 0 đến 1, với mức tăng là 0, 1.

Điểm số 0 cho biết hoạt động tương tác có rủi ro cao và có thể là gian lận.
Điểm số 1 cho biết hoạt động tương tác có rủi ro thấp và rất có thể là hợp lệ.

App Check cho phép bạn định cấu hình ngưỡng rủi ro của ứng dụng để có thể điều chỉnh mức độ chấp nhận rủi ro này.

Đối với hầu hết các trường hợp sử dụng, bạn nên dùng giá trị ngưỡng mặc định là 0,5. Nếu trường hợp sử dụng của bạn cần điều chỉnh, bạn có thể định cấu hình giá trị này cho từng ứng dụng trong bảng điều khiển Firebase (chuyển đến phần Security (Bảo mật) > App Check (Kiểm tra ứng dụng)). Hãy nhớ mở rộng và xem xét một số điểm quan trọng cần lưu ý về việc định cấu hình ngưỡng rủi ro của ứng dụng bên dưới.

Xem những điểm quan trọng cần cân nhắc về ngưỡng rủi ro của ứng dụng

App Check sử dụng ngưỡng rủi ro của ứng dụng mà bạn đã định cấu hình làm điểm số reCAPTCHA Enterprise tối thiểu cần thiết để một lượt tương tác của người dùng được coi là hợp lệ. Tất cả điểm reCAPTCHA Enterprise thấp hơn ngưỡng bạn đã định cấu hình sẽ bị từ chối. Khi điều chỉnh ngưỡng rủi ro của ứng dụng, hãy lưu ý những điều sau:

Nếu dự án Firebase của bạn đang sử dụng gói giá Spark không tốn phí, thì trong số 11 mức điểm reCAPTCHA Enterprise có thể có, bạn chỉ có thể sử dụng 4 mức điểm sau: 0,1, 0,3, 0,7 và 0,9.

Trong thời gian này, App Check sẽ chỉ cho phép các giá trị ngưỡng rủi ro của ứng dụng là 0,1, 0,3, 0,5, 0,7 và 0,9. Bạn vẫn nên đặt giá trị ngưỡng rủi ro của ứng dụng là 0,5 cho hầu hết các trường hợp sử dụng.
- Để bật tất cả 11 cấp độ điểm reCAPTCHA Enterprise, hãy liên kết một tài khoản Cloud Billing với dự án của bạn (tức là bạn nâng cấp dự án Firebase lên gói giá linh hoạt (trả tiền theo mức dùng)). Sau khi nâng cấp dự án, App Check sẽ cho phép bạn định cấu hình mọi giá trị ngưỡng rủi ro của ứng dụng trong khoảng từ 0 đến 1, với mức tăng là 0,1.
  
  Lưu ý: Sau khi tài khoản Cloud Billing được liên kết với dự án của bạn, hệ thống sẽ tự động kích hoạt quy trình xem xét bảo mật cho dự án của bạn. Để biết thêm thông tin, hãy xem tài liệu về reCAPTCHA Enterprise.
Để theo dõi việc phân phối điểm reCAPTCHA Enterprise cao và thấp cho ứng dụng của bạn, hãy chuyển đến trang reCAPTCHA Enterprise trong bảng điều khiển Google Cloud, rồi chọn khoá mà ứng dụng của bạn sử dụng.
Đặt ngưỡng rủi ro của ứng dụng phù hợp với khả năng chấp nhận rủi ro của bạn:
- Nếu bạn có mức độ chấp nhận rủi ro của ứng dụng ở mức cao, hãy di chuyển thanh trượt sang phải để giảm ngưỡng rủi ro của ứng dụng.
  - Bạn không nên đặt giá trị là 0.0 vì chế độ cài đặt này sẽ tắt tính năng chống hành vi sai trái.
- Nếu bạn có mức độ chấp nhận rủi ro của ứng dụng thấp, hãy di chuyển thanh trượt sang trái để tăng ngưỡng rủi ro của ứng dụng.
  - Bạn không nên đặt giá trị là 1, vì chế độ cài đặt này cũng có thể từ chối quyền truy cập của những người dùng hợp lệ không đáp ứng ngưỡng tin cậy cao này.
  Cảnh báo: Để tránh làm gián đoạn người dùng hợp pháp, hãy tăng dần ngưỡng rủi ro của ứng dụng khi App Check được thực thi. Luôn theo dõi App Check chỉ số yêu cầu để xác minh rằng lưu lượng truy cập không bị gián đoạn.

Để biết thêm thông tin, hãy xem tài liệu về reCAPTCHA Enterprise.

2. Thêm SDK App Check vào ứng dụng của bạn

Sử dụng Trình quản lý gói Swift (SPM) để cài đặt và quản lý các phần phụ thuộc của Firebase. Nếu bạn đang sử dụng Firebase, hãy đảm bảo gói Firebase của bạn là phiên bản 12.17.0 trở lên.

Trong Xcode, hãy mở dự án ứng dụng của bạn.
Thêm thư viện Firebase:
1. Chuyển đến File > Add Packages (Tệp > Thêm gói).
2. Khi được nhắc, hãy thêm kho lưu trữ SDK Firebase cho nền tảng của Apple:
```
https://github.com/firebase/firebase-ios-sdk
```
3. Chọn phiên bản SDK mới nhất (phiên bản 12.17.0 trở lên).
4. Chọn thư viện FirebaseAppCheck.
5. Nhấp vào Thêm gói. Xcode sẽ phân giải và tải các phần phụ thuộc xuống.
6. Khi được nhắc, hãy thêm thư viện vào mục tiêu ứng dụng.
Thêm thư viện reCAPTCHA Enterprise:
1. Quay lại phần File > Add Packages (Tệp > Thêm gói)
2. Khi được nhắc, hãy thêm kho lưu trữ SDK reCAPTCHA Enterprise:
```
https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
```
3. Chọn thư viện RecaptchaEnterprise.
4. Nhấp vào Thêm gói. Khi được nhắc, hãy thêm thư viện vào mục tiêu ứng dụng của bạn.

3. Khởi chạy App Check

Trong ứng dụng, bạn cần khởi chạy App Check trước khi sử dụng bất kỳ dịch vụ nào khác của Firebase.

Tạo một thực thể của RecaptchaProviderFactory, truyền khoá reCAPTCHA của bạn, sau đó định cấu hình App Check để sử dụng thực thể đó:

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

4. Theo dõi các chỉ số và bật chế độ thực thi

Sau khi thiết lập App Check trong ứng dụng, hãy bắt đầu phân phối ứng dụng đã cập nhật cho người dùng.

Ứng dụng khách đã cập nhật sẽ bắt đầu gửi mã thông báo App Check cùng với mọi yêu cầu mà ứng dụng đó gửi đến Firebase. Tuy nhiên, App Check sẽ không chặn các yêu cầu có mã thông báo không hợp lệ cho đến khi App Check được thực thi.

Theo dõi các chỉ số

Trước khi bật chế độ thực thi, hãy đảm bảo rằng việc này sẽ không làm gián đoạn người dùng hợp pháp hiện tại của bạn. Tuy nhiên, nếu nhận thấy tài nguyên ứng dụng của bạn đang được sử dụng theo cách đáng ngờ, thì bạn nên bật chế độ thực thi sớm hơn.

Để đưa ra quyết định này, bạn có thể xem các chỉ số của App Check cho những dịch vụ mà bạn sử dụng:

Theo dõi App Check chỉ số yêu cầu cho Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity cho iOS, Maps JavaScript API và Places API (Mới).
Theo dõi các chỉ số yêu cầu App Check cho Cloud Functions.

Bật chế độ thực thi App Check

Khi hiểu rõ cách App Check ảnh hưởng đến người dùng và sẵn sàng tiếp tục, bạn có thể bật chế độ thực thi App Check:

Bật tính năng thực thi App Check cho Firebase AI Logic, SQL Connect, Realtime Database, Cloud Firestore, Cloud Storage, Authentication, Google Identity cho iOS, Maps JavaScript API và Places API (Mới).
Bật chế độ thực thi App Check cho Cloud Functions.

Sử dụng App Check trong môi trường gỡ lỗi

App Check phân loại một số môi trường là không hợp lệ, chẳng hạn như các yêu cầu từ trình mô phỏng trong quá trình phát triển hoặc từ môi trường tích hợp liên tục (CI).

Để chạy ứng dụng trong các loại môi trường này sau khi App Check được thực thi, bạn cần tạo một bản gỡ lỗi cho ứng dụng sử dụng App Check nhà cung cấp dịch vụ gỡ lỗi thay vì nhà cung cấp dịch vụ chứng thực chính thức.

Để biết thêm thông tin, hãy xem phần Sử dụng App Check với nhà cung cấp dịch vụ gỡ lỗi trên các nền tảng của Apple.

Giá

App Check sẽ thay mặt bạn tạo một bản đánh giá để xác thực mã thông báo phản hồi của người dùng mỗi khi ứng dụng của bạn làm mới mã thông báo App Check. Dự án Firebase của bạn sẽ bị tính phí cho mỗi bản đánh giá được tạo vượt quá hạn mức không mất phí. Để biết thông tin chi tiết, hãy xem giá của reCAPTCHA.

Theo mặc định, ứng dụng của bạn sẽ làm mới mã thông báo này hai lần mỗi 1 giờ. Để kiểm soát tần suất ứng dụng làm mới mã thông báo App Check (và do đó, tần suất tạo bản đánh giá mới), bạn có thể định cấu hình TTL của mã thông báo.