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:
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:
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:
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;