app-check package

La aplicación Firebase comprueba el SDK web.

Firebase App Check no funciona en un entorno Node.js usando ReCaptchaV3Provider o ReCaptchaEnterpriseProvider , pero se puede usar en Node.js si usa CustomProvider y escribe su propio método de certificación.

Funciones

Función Descripción
función (aplicación, ...)
inicializarAppCheck(aplicación, opciones) Active App Check para la aplicación dada. Solo se puede llamar una vez por aplicación.
función (appCheckInstance, ...)
getLimitedUseToken(appCheckInstance) Solicita un token de verificación de aplicación de Firebase. Este método debe usarse solo si necesita autorizar solicitudes a un backend que no sea de Firebase. Devuelve tokens de uso limitado destinados a usarse con sus puntos finales de backend que no son de Firebase y que están protegidos con Replay Protection . Este método no afecta el comportamiento de generación de tokens del método #getAppCheckToken().
getToken(appCheckInstance, forceRefresh) Obtenga el token de verificación de aplicaciones actual. Se adjunta a la solicitud en vuelo más reciente, si hay alguna presente. Devuelve nulo si no hay ningún token presente y no hay solicitudes de token en curso.
onTokenChanged(appCheckInstance, observador) Registra un oyente para los cambios en el estado del token. Puede haber más de un oyente registrado al mismo tiempo para una o más instancias de App Check. Los oyentes vuelven a llamar al subproceso de la interfaz de usuario cada vez que cambia el token actual asociado con esta instancia de App Check.
onTokenChanged (appCheckInstance, onNext, onError, onCompletion) Registra un oyente para los cambios en el estado del token. Puede haber más de un oyente registrado al mismo tiempo para una o más instancias de App Check. Los oyentes vuelven a llamar al subproceso de la interfaz de usuario cada vez que cambia el token actual asociado con esta instancia de App Check.
setTokenAutoRefreshEnabled(appCheckInstance, isTokenAutoRefreshEnabled) Establezca si App Check actualizará automáticamente los tokens según sea necesario.

Clases

Clase Descripción
Proveedor personalizado Clase de proveedor personalizada.
ReCaptchaEnterpriseProveedor Proveedor de App Check que puede obtener un token reCAPTCHA Enterprise y cambiarlo por un token de App Check.
Proveedor ReCaptchaV3 Proveedor de App Check que puede obtener un token reCAPTCHA V3 y cambiarlo por un token de App Check.

Interfaces

Interfaz Descripción
AppCheck La interfaz del servicio Firebase App Check.
Opciones de verificación de aplicaciones Opciones para la inicialización de App Check.
AppCheckToken El token devuelto por un proveedor de App Check.
AppCheckTokenResultado Resultado devuelto por getToken() .
Opciones de proveedor personalizadas Opciones al crear un CustomProvider .

Tipo de alias

Tipo Alias Descripción
AppCheckTokenListener Un oyente al que se llama cada vez que cambia el token de verificación de la aplicación.

función (aplicación, ...)

inicializarAppCheck(aplicación, opciones)

Active App Check para la aplicación dada. Solo se puede llamar una vez por aplicación.

Firma:

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

Parámetros

Parámetro Tipo Descripción
aplicación Aplicación Firebase | indefinido FirebaseApp para activar App Check para
opciones Opciones de verificación de aplicaciones Opciones de inicialización de App Check

Devoluciones:

AppCheck

función (appCheckInstance, ...)

getLimitedUseToken(appCheckInstance)

Solicita un token de verificación de aplicación de Firebase. Este método debe usarse solo si necesita autorizar solicitudes a un backend que no sea de Firebase.

Devuelve tokens de uso limitado destinados a usarse con sus puntos finales de backend que no son de Firebase y que están protegidos con Replay Protection . Este método no afecta el comportamiento de generación de tokens del método #getAppCheckToken().

Firma:

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

Parámetros

Parámetro Tipo Descripción
aplicaciónCheckInstance AppCheck La instancia del servicio App Check.

Devoluciones:

Promesa < AppCheckTokenResult >

El token de uso limitado.

getToken(appCheckInstance, forceRefresh)

Obtenga el token de verificación de aplicaciones actual. Se adjunta a la solicitud en vuelo más reciente, si hay alguna presente. Devuelve nulo si no hay ningún token presente y no hay solicitudes de token en curso.

Firma:

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

Parámetros

Parámetro Tipo Descripción
aplicaciónCheckInstance AppCheck La instancia del servicio App Check.
forceRefresh booleano Si es cierto, siempre intentará recuperar un token nuevo. Si es falso, utilizará un token almacenado en caché si se encuentra almacenado.

Devoluciones:

Promesa < AppCheckTokenResult >

onTokenChanged(appCheckInstance, observador)

Registra un oyente para los cambios en el estado del token. Puede haber más de un oyente registrado al mismo tiempo para una o más instancias de App Check. Los oyentes vuelven a llamar al subproceso de la interfaz de usuario cada vez que cambia el token actual asociado con esta instancia de App Check.

Firma:

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

Parámetros

Parámetro Tipo Descripción
aplicaciónCheckInstance AppCheck La instancia del servicio App Check.
observador Observador parcial < AppCheckTokenResultado > Un objeto con propiedades next , error y complete . next se llama con un AppCheckTokenResult cada vez que cambia el token. error es opcional y se llama si el oyente arroja un error (la next función). complete no se utiliza, ya que el flujo de tokens es interminable.

Devoluciones:

Darse de baja

Una función que da de baja a este oyente.

onTokenChanged (appCheckInstance, onNext, onError, onCompletion)

Registra un oyente para los cambios en el estado del token. Puede haber más de un oyente registrado al mismo tiempo para una o más instancias de App Check. Los oyentes vuelven a llamar al subproceso de la interfaz de usuario cada vez que cambia el token actual asociado con esta instancia de App Check.

Firma:

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

Parámetros

Parámetro Tipo Descripción
aplicaciónCheckInstance AppCheck La instancia del servicio App Check.
En el siguiente (tokenResult: AppCheckTokenResult ) => vacío Cuando el token cambia, esta función se llama con un AppCheckTokenResult .
enError (error: Error) => nulo Opcional. Se llama si el oyente arroja un error (la función onNext ).
en la terminación () => nulo Actualmente no se utiliza, ya que el flujo de tokens es interminable.

Devoluciones:

Darse de baja

Una función que da de baja a este oyente.

setTokenAutoRefreshEnabled(appCheckInstance, isTokenAutoRefreshEnabled)

Establezca si App Check actualizará automáticamente los tokens según sea necesario.

Firma:

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

Parámetros

Parámetro Tipo Descripción
aplicaciónCheckInstance AppCheck La instancia del servicio App Check.
isTokenAutoRefreshEnabled booleano Si es verdadero, el SDK actualiza automáticamente los tokens de verificación de aplicaciones según sea necesario. Esto anula cualquier valor establecido durante initializeAppCheck() .

Devoluciones:

vacío

AppCheckTokenListener

Un oyente al que se llama cada vez que cambia el token de verificación de la aplicación.

Firma:

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