Веб-SDK проверки приложений Firebase.
Проверка приложений Firebase не работает в среде Node.js с использованием ReCaptchaV3Provider
или ReCaptchaEnterpriseProvider
, но его можно использовать в Node.js, если вы используете CustomProvider
и пишете собственный метод аттестации.
Функции
Функция | Описание |
---|---|
функция (приложение, ...) | |
инициализироватьAppCheck(приложение, параметры) | Активируйте проверку приложений для данного приложения. Можно вызвать только один раз для каждого приложения. |
функция (appCheckInstance, ...) | |
getLimitedUseToken (appCheckInstance) | Запрашивает токен проверки приложений Firebase. Этот метод следует использовать только в том случае, если вам необходимо авторизовать запросы к серверу, отличному от Firebase. Возвращает токены ограниченного использования, предназначенные для использования с вашими серверными конечными точками, не относящимися к Firebase, которые защищены защитой от воспроизведения . Этот метод не влияет на поведение генерации токенов метода #getAppCheckToken(). |
getToken (appCheckInstance, ForceRefresh) | Получите текущий токен проверки приложений. Если forceRefresh имеет значение false, эта функция сначала проверяет наличие допустимого токена в памяти, а затем локальное постоянство (IndexedDB). Если он не найден или если forceRefresh имеет значение true, он отправляет запрос к конечной точке проверки приложений для получения нового токена. Этот запрос присоединяется к самому последнему текущему запросу, если таковой имеется. |
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 | Параметры инициализации проверки приложений |
Возврат:
функция (appCheckInstance, ...)
getLimitedUseToken (appCheckInstance)
Запрашивает токен проверки приложений Firebase. Этот метод следует использовать только в том случае, если вам необходимо авторизовать запросы к серверу, отличному от Firebase.
Возвращает токены ограниченного использования, предназначенные для использования с вашими серверными конечными точками, не относящимися к Firebase, которые защищены защитой от воспроизведения . Этот метод не влияет на поведение генерации токенов метода #getAppCheckToken().
Подпись:
export declare function getLimitedUseToken(appCheckInstance: AppCheck): Promise<AppCheckTokenResult>;
Параметры
Параметр | Тип | Описание |
---|---|---|
приложениеCheckInstance | AppCheck | Экземпляр службы проверки приложений. |
Возврат:
Обещание < AppCheckTokenResult >
Токен ограниченного использования.
getToken (appCheckInstance, ForceRefresh)
Получите текущий токен проверки приложений. Если forceRefresh
имеет значение false, эта функция сначала проверяет наличие допустимого токена в памяти, а затем локальное постоянство (IndexedDB). Если он не найден или если forceRefresh
имеет значение true, он отправляет запрос к конечной точке проверки приложений для получения нового токена. Этот запрос присоединяется к самому последнему текущему запросу, если таковой имеется.
Подпись:
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 ). |
onCompletion | () => недействительно | В настоящее время не используется, так как поток токенов бесконечен. |
Возврат:
Функция, которая отписывает этого слушателя.
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;