Das Firebase App Check Web SDK.
Firebase App Check funktioniert nicht in einer Node.js-Umgebung mit ReCaptchaV3Provider
oder ReCaptchaEnterpriseProvider
, kann aber in Node.js verwendet werden, wenn Sie CustomProvider
verwenden und Ihre eigene Nachweismethode schreiben.
Funktionen
Funktion | Beschreibung |
---|---|
Funktion(App, ...) | |
initializeAppCheck(app, Optionen) | Aktivieren Sie die App-Prüfung für die angegebene App. Kann pro App nur einmal aufgerufen werden. |
Funktion(appCheckInstance, ...) | |
getLimitedUseToken(appCheckInstance) | Fordert ein Firebase App Check-Token an. Diese Methode sollte nur verwendet werden, wenn Sie Anfragen an ein Nicht-Firebase-Backend autorisieren müssen. Gibt Token mit eingeschränkter Verwendung zurück, die für die Verwendung mit Ihren Nicht-Firebase-Backend-Endpunkten vorgesehen sind, die durch Replay Protection geschützt sind. Diese Methode hat keinen Einfluss auf das Token-Generierungsverhalten der #getAppCheckToken()-Methode. |
getToken(appCheckInstance, forceRefresh) | Holen Sie sich das aktuelle App Check-Token. Wird an die letzte Fluganfrage angehängt, sofern vorhanden. Gibt null zurück, wenn kein Token vorhanden ist und keine Token-Anfragen im Umlauf sind. |
onTokenChanged(appCheckInstance, Beobachter) | Registriert einen Listener für Änderungen im Token-Status. Es kann mehr als ein Listener gleichzeitig für eine oder mehrere App Check-Instanzen registriert sein. Die Listener rufen den UI-Thread immer dann zurück, wenn sich das aktuelle Token ändert, das dieser App Check-Instanz zugeordnet ist. |
onTokenChanged(appCheckInstance, onNext, onError, onCompletion) | Registriert einen Listener für Änderungen im Token-Status. Es kann mehr als ein Listener gleichzeitig für eine oder mehrere App Check-Instanzen registriert sein. Die Listener rufen den UI-Thread immer dann zurück, wenn sich das aktuelle Token ändert, das dieser App Check-Instanz zugeordnet ist. |
setTokenAutoRefreshEnabled(appCheckInstance, isTokenAutoRefreshEnabled) | Legen Sie fest, ob App Check Token nach Bedarf automatisch aktualisieren soll. |
Klassen
Klasse | Beschreibung |
---|---|
CustomProvider | Benutzerdefinierte Anbieterklasse. |
ReCaptchaEnterpriseProvider | App Check-Anbieter, der einen reCAPTCHA Enterprise-Token erhalten und gegen einen App Check-Token eintauschen kann. |
ReCaptchaV3Provider | App Check-Anbieter, der einen reCAPTCHA V3-Token erhalten und gegen einen App Check-Token eintauschen kann. |
Schnittstellen
Schnittstelle | Beschreibung |
---|---|
AppCheck | Die Firebase App Check-Dienstschnittstelle. |
AppCheckOptions | Optionen für die App-Check-Initialisierung. |
AppCheckToken | Das von einem App Check-Anbieter zurückgegebene Token. |
AppCheckTokenResult | Von getToken() zurückgegebenes Ergebnis. |
CustomProviderOptions | Optionen beim Erstellen eines CustomProviders . |
Geben Sie Aliase ein
Geben Sie Alias ein | Beschreibung |
---|---|
AppCheckTokenListener | Ein Listener, der immer dann aufgerufen wird, wenn sich das App Check-Token ändert. |
Funktion(App, ...)
initializeAppCheck(app, Optionen)
Aktivieren Sie die App-Prüfung für die angegebene App. Kann pro App nur einmal aufgerufen werden.
Unterschrift:
export declare function initializeAppCheck(app: FirebaseApp | undefined, options: AppCheckOptions): AppCheck;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
App | FirebaseApp | nicht definiert | die FirebaseApp , um die App-Prüfung zu aktivieren |
Optionen | AppCheckOptions | Optionen für die App-Check-Initialisierung |
Kehrt zurück:
Funktion(appCheckInstance, ...)
getLimitedUseToken(appCheckInstance)
Fordert ein Firebase App Check-Token an. Diese Methode sollte nur verwendet werden, wenn Sie Anfragen an ein Nicht-Firebase-Backend autorisieren müssen.
Gibt Token mit eingeschränkter Verwendung zurück, die für die Verwendung mit Ihren Nicht-Firebase-Backend-Endpunkten vorgesehen sind, die durch Replay Protection geschützt sind. Diese Methode hat keinen Einfluss auf das Token-Generierungsverhalten der #getAppCheckToken()-Methode.
Unterschrift:
export declare function getLimitedUseToken(appCheckInstance: AppCheck): Promise<AppCheckTokenResult>;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
appCheckInstance | AppCheck | Die App Check-Dienstinstanz. |
Kehrt zurück:
Versprechen< AppCheckTokenResult >
Der Token mit eingeschränkter Nutzung.
getToken(appCheckInstance, forceRefresh)
Holen Sie sich das aktuelle App Check-Token. Wird an die letzte Fluganfrage angehängt, sofern vorhanden. Gibt null zurück, wenn kein Token vorhanden ist und keine Token-Anfragen im Umlauf sind.
Unterschrift:
export declare function getToken(appCheckInstance: AppCheck, forceRefresh?: boolean): Promise<AppCheckTokenResult>;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
appCheckInstance | AppCheck | Die App Check-Dienstinstanz. |
forceRefresh | Boolescher Wert | Wenn „true“, wird immer versucht, ein neues Token abzurufen. Bei „false“ wird ein zwischengespeichertes Token verwendet, wenn es im Speicher gefunden wird. |
Kehrt zurück:
Versprechen< AppCheckTokenResult >
onTokenChanged(appCheckInstance, Beobachter)
Registriert einen Listener für Änderungen im Token-Status. Es kann mehr als ein Listener gleichzeitig für eine oder mehrere App Check-Instanzen registriert sein. Die Listener rufen den UI-Thread immer dann zurück, wenn sich das aktuelle Token ändert, das dieser App Check-Instanz zugeordnet ist.
Unterschrift:
export declare function onTokenChanged(appCheckInstance: AppCheck, observer: PartialObserver<AppCheckTokenResult>): Unsubscribe;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
appCheckInstance | AppCheck | Die App Check-Dienstinstanz. |
Beobachter | PartialObserver < AppCheckTokenResult > | Ein Objekt mit den Eigenschaften next , error “ und „ complete “. next wird mit einem AppCheckTokenResult aufgerufen, wann immer sich das Token ändert. error ist optional und wird aufgerufen, wenn vom Listener (der next Funktion) ein Fehler ausgelöst wird. complete wird nicht verwendet, da der Token-Stream endlos ist. |
Kehrt zurück:
Eine Funktion, die diesen Listener abmeldet.
onTokenChanged(appCheckInstance, onNext, onError, onCompletion)
Registriert einen Listener für Änderungen im Token-Status. Es kann mehr als ein Listener gleichzeitig für eine oder mehrere App Check-Instanzen registriert sein. Die Listener rufen den UI-Thread immer dann zurück, wenn sich das aktuelle Token ändert, das dieser App Check-Instanz zugeordnet ist.
Unterschrift:
export declare function onTokenChanged(appCheckInstance: AppCheck, onNext: (tokenResult: AppCheckTokenResult) => void, onError?: (error: Error) => void, onCompletion?: () => void): Unsubscribe;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
appCheckInstance | AppCheck | Die App Check-Dienstinstanz. |
onNext | (tokenResult: AppCheckTokenResult ) => ungültig | Wenn sich das Token ändert, wird diese Funktion mit einem AppCheckTokenResult aufgerufen . |
onError | (Fehler: Fehler) => ungültig | Optional. Wird aufgerufen, wenn vom Listener ein Fehler ausgegeben wird (die onNext -Funktion). |
bei Fertigstellung | () => ungültig | Derzeit nicht genutzt, da der Token-Stream endlos ist. |
Kehrt zurück:
Eine Funktion, die diesen Listener abmeldet.
setTokenAutoRefreshEnabled(appCheckInstance, isTokenAutoRefreshEnabled)
Legen Sie fest, ob App Check Token nach Bedarf automatisch aktualisieren soll.
Unterschrift:
export declare function setTokenAutoRefreshEnabled(appCheckInstance: AppCheck, isTokenAutoRefreshEnabled: boolean): void;
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
appCheckInstance | AppCheck | Die App Check-Dienstinstanz. |
isTokenAutoRefreshEnabled | Boolescher Wert | Wenn „true“, aktualisiert das SDK die App-Check-Token automatisch nach Bedarf. Dies überschreibt alle während initializeAppCheck() festgelegten Werte. |
Kehrt zurück:
Leere
AppCheckTokenListener
Ein Listener, der immer dann aufgerufen wird, wenn sich das App Check-Token ändert.
Unterschrift:
export declare type AppCheckTokenListener = (token: AppCheckTokenResult) => void;