app-check package

Веб-SDK проверки приложений Firebase.

Проверка приложений Firebase не работает в среде Node.js с использованием ReCaptchaV3Provider или ReCaptchaEnterpriseProvider , но его можно использовать в Node.js, если вы используете CustomProvider и пишете собственный метод аттестации.

Функции

Функция Описание
функция (приложение, ...)
инициализироватьAppCheck(приложение, параметры) Активируйте проверку приложений для данного приложения. Можно вызвать только один раз для каждого приложения.
функция (appCheckInstance, ...)
getLimitedUseToken (appCheckInstance) Запрашивает токен проверки приложений Firebase. Этот метод следует использовать только в том случае, если вам необходимо авторизовать запросы к серверу, отличному от Firebase. Возвращает токены ограниченного использования, предназначенные для использования с вашими серверными конечными точками, не относящимися к Firebase, которые защищены защитой от воспроизведения . Этот метод не влияет на поведение генерации токенов метода #getAppCheckToken().
getToken (appCheckInstance, ForceRefresh) Получите текущий токен проверки приложений. Прикрепляется к самому последнему текущему запросу, если таковой имеется. Возвращает значение NULL, если токен отсутствует и запросы токенов не выполняются.
onTokenChanged (appCheckInstance, наблюдатель) Регистрирует прослушиватель изменений состояния токена. Одновременно может быть зарегистрировано несколько прослушивателей для одного или нескольких экземпляров проверки приложений. Прослушиватели выполняют обратный вызов в потоке пользовательского интерфейса всякий раз, когда изменяется текущий токен, связанный с этим экземпляром проверки приложения.
onTokenChanged (appCheckInstance, onNext, onError, onCompletion) Регистрирует прослушиватель изменений состояния токена. Одновременно может быть зарегистрировано несколько прослушивателей для одного или нескольких экземпляров проверки приложений. Прослушиватели выполняют обратный вызов в потоке пользовательского интерфейса всякий раз, когда изменяется текущий токен, связанный с этим экземпляром проверки приложения.
setTokenAutoRefreshEnabled (appCheckInstance, isTokenAutoRefreshEnabled) Укажите, будет ли проверка приложений автоматически обновлять токены по мере необходимости.

Классы

Сорт Описание
CustomProvider Пользовательский класс поставщика.
ReCaptchaEnterpriseProvider Поставщик проверки приложений, который может получить токен reCAPTCHA Enterprise и обменять его на токен проверки приложений.
ReCaptchaV3Provider Поставщик проверки приложений, который может получить токен reCAPTCHA V3 и обменять его на токен проверки приложений.

Интерфейсы

Интерфейс Описание
AppCheck Интерфейс службы Firebase App Check.
AppCheckOptions Параметры инициализации проверки приложений.
AppCheckToken Токен, возвращенный поставщиком проверки приложений.
AppCheckTokenResult Результат, возвращаемый getToken() .
CustomProviderOptions Параметры при создании CustomProvider .

Введите псевдонимы

Введите псевдоним Описание
AppCheckTokenListener Прослушиватель, который вызывается всякий раз, когда изменяется токен проверки приложения.

функция (приложение, ...)

инициализироватьAppCheck(приложение, параметры)

Активируйте проверку приложений для данного приложения. Можно вызвать только один раз для каждого приложения.

Подпись:

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

Параметры

Параметр Тип Описание
приложение FirebaseApp | неопределенный FirebaseApp для активации проверки приложений
параметры AppCheckOptions Параметры инициализации проверки приложений

Возврат:

AppCheck

функция (appCheckInstance, ...)

getLimitedUseToken (appCheckInstance)

Запрашивает токен проверки приложений Firebase. Этот метод следует использовать только в том случае, если вам необходимо авторизовать запросы к серверу, отличному от Firebase.

Возвращает токены ограниченного использования, предназначенные для использования с вашими серверными конечными точками, не относящимися к Firebase, которые защищены защитой от воспроизведения . Этот метод не влияет на поведение генерации токенов метода #getAppCheckToken().

Подпись:

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

Параметры

Параметр Тип Описание
приложениеCheckInstance AppCheck Экземпляр службы проверки приложений.

Возврат:

Обещание < AppCheckTokenResult >

Токен ограниченного использования.

getToken (appCheckInstance, ForceRefresh)

Получите текущий токен проверки приложений. Прикрепляется к самому последнему текущему запросу, если таковой имеется. Возвращает значение NULL, если токен отсутствует и запросы токенов не выполняются.

Подпись:

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

Параметры

Параметр Тип Описание
приложениеCheckInstance AppCheck Экземпляр службы проверки приложений.
принудительное обновление логическое значение Если это правда, всегда будет пытаться получить новый токен. Если установлено значение false, будет использоваться кэшированный токен, если он найден в хранилище.

Возврат:

Обещание < AppCheckTokenResult >

onTokenChanged (appCheckInstance, наблюдатель)

Регистрирует прослушиватель изменений состояния токена. Одновременно может быть зарегистрировано несколько прослушивателей для одного или нескольких экземпляров проверки приложений. Прослушиватели выполняют обратный вызов в потоке пользовательского интерфейса всякий раз, когда изменяется текущий токен, связанный с этим экземпляром проверки приложения.

Подпись:

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

Параметры

Параметр Тип Описание
приложениеCheckInstance AppCheck Экземпляр службы проверки приложений.
наблюдатель Частичный наблюдатель < AppCheckTokenResult > Объект со свойствами next , error и complete . next вызывается с AppCheckTokenResult при каждом изменении токена. error не является обязательным и вызывается, если прослушиватель выдает ошибку ( next функция). complete не используется, поскольку поток токенов бесконечен.

Возврат:

Отписаться

Функция, которая отписывает этого слушателя.

onTokenChanged (appCheckInstance, onNext, onError, onCompletion)

Регистрирует прослушиватель изменений состояния токена. Одновременно может быть зарегистрировано несколько прослушивателей для одного или нескольких экземпляров проверки приложений. Прослушиватели выполняют обратный вызов в потоке пользовательского интерфейса всякий раз, когда изменяется текущий токен, связанный с этим экземпляром проверки приложения.

Подпись:

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

Параметры

Параметр Тип Описание
приложениеCheckInstance AppCheck Экземпляр службы проверки приложений.
onNext (токенРезультат: AppCheckTokenResult ) => пустота Когда токен изменяется, эта функция вызывается с AppCheckTokenResult. .
onError (ошибка: Ошибка) => недействительно Необязательный. Вызывается, если прослушиватель выдает ошибку (функция onNext ).
по окончании () => недействительно В настоящее время не используется, так как поток токенов бесконечен.

Возврат:

Отписаться

Функция, которая отписывает этого слушателя.

setTokenAutoRefreshEnabled (appCheckInstance, isTokenAutoRefreshEnabled)

Укажите, будет ли проверка приложений автоматически обновлять токены по мере необходимости.

Подпись:

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

Параметры

Параметр Тип Описание
приложениеCheckInstance AppCheck Экземпляр службы проверки приложений.
isTokenAutoRefreshEnabled логическое значение Если это правда, SDK автоматически обновляет токены проверки приложений по мере необходимости. Это переопределяет любое значение, установленное во время initializeAppCheck() .

Возврат:

пустота

AppCheckTokenListener

Прослушиватель, который вызывается всякий раз, когда изменяется токен проверки приложения.

Подпись:

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