app-check package

SDK web kiểm tra ứng dụng Firebase.

Kiểm tra ứng dụng Firebase không hoạt động trong môi trường Node.js bằng ReCaptchaV3Provider hoặc ReCaptchaEnterpriseProvider , nhưng có thể được sử dụng trong Node.js nếu bạn sử dụng CustomProvider và viết phương thức chứng thực của riêng mình.

Chức năng

Chức năng Sự miêu tả
chức năng (ứng dụng, ...)
khởi tạoAppCheck(ứng dụng, tùy chọn) Kích hoạt Kiểm tra ứng dụng cho ứng dụng đã cho. Chỉ có thể được gọi một lần cho mỗi ứng dụng.
hàm(appCheckInstance, ...)
getLimitedUseToken(appCheckInstance) Yêu cầu mã thông báo Kiểm tra ứng dụng Firebase. Phương pháp này chỉ nên được sử dụng nếu bạn cần ủy quyền các yêu cầu tới chương trình phụ trợ không phải của Firebase. Trả về các mã thông báo có mức sử dụng giới hạn được thiết kế để sử dụng với các điểm cuối phụ trợ không phải của Firebase được bảo vệ bằng Bảo vệ phát lại . Phương thức này không ảnh hưởng đến hành vi tạo mã thông báo của phương thức #getAppCheckToken().
getToken(appCheckInstance, ForceRefresh) Nhận mã thông báo Kiểm tra ứng dụng hiện tại. Đính kèm với yêu cầu trên chuyến bay gần đây nhất nếu có. Trả về null nếu không có mã thông báo nào và không có yêu cầu mã thông báo nào đang được thực hiện.
onTokenChanged(appCheckInstance, người quan sát) Đăng ký người nghe để thay đổi trạng thái mã thông báo. Có thể có nhiều trình nghe được đăng ký cùng lúc cho một hoặc nhiều phiên bản Kiểm tra ứng dụng. Trình nghe gọi lại trên chuỗi giao diện người dùng bất cứ khi nào mã thông báo hiện tại được liên kết với phiên bản Kiểm tra ứng dụng này thay đổi.
onTokenChanged(appCheckInstance, onNext, onError, onCompletion) Đăng ký người nghe để thay đổi trạng thái mã thông báo. Có thể có nhiều trình nghe được đăng ký cùng lúc cho một hoặc nhiều phiên bản Kiểm tra ứng dụng. Trình nghe gọi lại trên chuỗi giao diện người dùng bất cứ khi nào mã thông báo hiện tại được liên kết với phiên bản Kiểm tra ứng dụng này thay đổi.
setTokenAutoRefreshEnabled(appCheckInstance, isTokenAutoRefreshEnabled) Đặt xem Kiểm tra ứng dụng có tự động làm mới mã thông báo khi cần hay không.

Các lớp học

Lớp học Sự miêu tả
Nhà cung cấp tùy chỉnh Lớp nhà cung cấp tùy chỉnh.
ReCaptchaEnterpriseNhà cung cấp Nhà cung cấp Kiểm tra ứng dụng có thể nhận mã thông báo reCAPTCHA Enterprise và đổi nó lấy mã thông báo Kiểm tra ứng dụng.
Nhà cung cấp ReCaptchaV3 Nhà cung cấp Kiểm tra ứng dụng có thể nhận mã thông báo reCAPTCHA V3 và đổi nó lấy mã thông báo Kiểm tra ứng dụng.

Giao diện

Giao diện Sự miêu tả
Kiểm tra ứng dụng Giao diện dịch vụ Kiểm tra ứng dụng Firebase.
Tùy chọn kiểm tra ứng dụng Tùy chọn khởi tạo Kiểm tra ứng dụng.
AppCheckToken Mã thông báo được trả về từ nhà cung cấp Kiểm tra ứng dụng.
AppCheckTokenKết quả Kết quả được trả về bởi getToken() .
Tùy chọn nhà cung cấp tùy chỉnh Các tùy chọn khi tạo CustomProvider .

Nhập bí danh

Nhập bí danh Sự miêu tả
AppCheckTokenListener Trình nghe được gọi bất cứ khi nào mã thông báo Kiểm tra ứng dụng thay đổi.

chức năng (ứng dụng, ...)

khởi tạoAppCheck(ứng dụng, tùy chọn)

Kích hoạt Kiểm tra ứng dụng cho ứng dụng đã cho. Chỉ có thể được gọi một lần cho mỗi ứng dụng.

Chữ ký:

export declare function initializeAppCheck(app: FirebaseApp | undefined, options: AppCheckOptions): AppCheck;

Thông số

Tham số Kiểu Sự miêu tả
ứng dụng Ứng dụng Firebase | không xác định FirebaseApp để kích hoạt Kiểm tra ứng dụng
tùy chọn Tùy chọn kiểm tra ứng dụng Tùy chọn khởi tạo Kiểm tra ứng dụng

Trả về:

Kiểm tra ứng dụng

hàm(appCheckInstance, ...)

getLimitedUseToken(appCheckInstance)

Yêu cầu mã thông báo Kiểm tra ứng dụng Firebase. Phương pháp này chỉ nên được sử dụng nếu bạn cần ủy quyền các yêu cầu tới chương trình phụ trợ không phải của Firebase.

Trả về các mã thông báo có mức sử dụng giới hạn được thiết kế để sử dụng với các điểm cuối phụ trợ không phải của Firebase được bảo vệ bằng Bảo vệ phát lại . Phương thức này không ảnh hưởng đến hành vi tạo mã thông báo của phương thức #getAppCheckToken().

Chữ ký:

export declare function getLimitedUseToken(appCheckInstance: AppCheck): Promise<AppCheckTokenResult>;

Thông số

Tham số Kiểu Sự miêu tả
ứng dụngCheckInstance Kiểm tra ứng dụng Phiên bản dịch vụ Kiểm tra ứng dụng.

Trả về:

Lời hứa< AppCheckTokenResult >

Mã thông báo sử dụng hạn chế.

getToken(appCheckInstance, ForceRefresh)

Nhận mã thông báo Kiểm tra ứng dụng hiện tại. Đính kèm với yêu cầu trên chuyến bay gần đây nhất nếu có. Trả về null nếu không có mã thông báo nào và không có yêu cầu mã thông báo nào đang được thực hiện.

Chữ ký:

export declare function getToken(appCheckInstance: AppCheck, forceRefresh?: boolean): Promise<AppCheckTokenResult>;

Thông số

Tham số Kiểu Sự miêu tả
ứng dụngCheckInstance Kiểm tra ứng dụng Phiên bản dịch vụ Kiểm tra ứng dụng.
lực lượngLàm mới boolean Nếu đúng, sẽ luôn cố gắng tìm nạp mã thông báo mới. Nếu sai, sẽ sử dụng mã thông báo được lưu trong bộ nhớ đệm nếu tìm thấy trong bộ lưu trữ.

Trả về:

Lời hứa< AppCheckTokenResult >

onTokenChanged(appCheckInstance, người quan sát)

Đăng ký người nghe để thay đổi trạng thái mã thông báo. Có thể có nhiều trình nghe được đăng ký cùng lúc cho một hoặc nhiều phiên bản Kiểm tra ứng dụng. Trình nghe gọi lại trên chuỗi giao diện người dùng bất cứ khi nào mã thông báo hiện tại được liên kết với phiên bản Kiểm tra ứng dụng này thay đổi.

Chữ ký:

export declare function onTokenChanged(appCheckInstance: AppCheck, observer: PartialObserver<AppCheckTokenResult>): Unsubscribe;

Thông số

Tham số Kiểu Sự miêu tả
ứng dụngCheckInstance Kiểm tra ứng dụng Phiên bản dịch vụ Kiểm tra ứng dụng.
người quan sát Người quan sát một phần < AppCheckTokenResult > Một đối tượng có các thuộc tính next , errorcomplete . next được gọi bằng AppCheckTokenResult bất cứ khi nào mã thông báo thay đổi. error là tùy chọn và được gọi nếu người nghe đưa ra lỗi (hàm next ). complete không được sử dụng vì luồng mã thông báo không kết thúc.

Trả về:

Hủy đăng ký

Một chức năng hủy đăng ký người nghe này.

onTokenChanged(appCheckInstance, onNext, onError, onCompletion)

Đăng ký người nghe để thay đổi trạng thái mã thông báo. Có thể có nhiều trình nghe được đăng ký cùng lúc cho một hoặc nhiều phiên bản Kiểm tra ứng dụng. Trình nghe gọi lại trên chuỗi giao diện người dùng bất cứ khi nào mã thông báo hiện tại được liên kết với phiên bản Kiểm tra ứng dụng này thay đổi.

Chữ ký:

export declare function onTokenChanged(appCheckInstance: AppCheck, onNext: (tokenResult: AppCheckTokenResult) => void, onError?: (error: Error) => void, onCompletion?: () => void): Unsubscribe;

Thông số

Tham số Kiểu Sự miêu tả
ứng dụngCheckInstance Kiểm tra ứng dụng Phiên bản dịch vụ Kiểm tra ứng dụng.
tiếp theo (mã thông báoKết quả: AppCheckTokenResult ) => vô hiệu Khi mã thông báo thay đổi, hàm này được gọi bằng AppCheckTokenResult .
onError (lỗi: Lỗi) => void Không bắt buộc. Được gọi nếu có lỗi do trình nghe đưa ra (hàm onNext ).
hoàn thành () => vô hiệu Hiện không được sử dụng vì luồng mã thông báo không có hồi kết.

Trả về:

Hủy đăng ký

Một chức năng hủy đăng ký người nghe này.

setTokenAutoRefreshEnabled(appCheckInstance, isTokenAutoRefreshEnabled)

Đặt xem Kiểm tra ứng dụng có tự động làm mới mã thông báo khi cần hay không.

Chữ ký:

export declare function setTokenAutoRefreshEnabled(appCheckInstance: AppCheck, isTokenAutoRefreshEnabled: boolean): void;

Thông số

Tham số Kiểu Sự miêu tả
ứng dụngCheckInstance Kiểm tra ứng dụng Phiên bản dịch vụ Kiểm tra ứng dụng.
isTokenAutoRefreshEnabled boolean Nếu đúng, SDK sẽ tự động làm mới mã thông báo Kiểm tra ứng dụng nếu cần. Điều này ghi đè mọi giá trị được đặt trong quá trình initializeAppCheck() .

Trả về:

trống rỗng

AppCheckTokenListener

Trình nghe được gọi bất cứ khi nào mã thông báo Kiểm tra ứng dụng thay đổi.

Chữ ký:

export declare type AppCheckTokenListener = (token: AppCheckTokenResult) => void;