app-check package

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:

AppCheck

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:

Abbestellen

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:

Abbestellen

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;