Эта страница переведена с помощью Cloud Translation API.

Включить принудительную проверку приложений для облачных функций

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

Прежде чем вы начнете

Включить App Проверьте в вашей компании Apple , Android и веб - клиентов.

Добавить поддержку проверки приложений в функцию

Обновление вашего проекта firebase-functions зависимость до версии 3.14.0 или более поздней версии:
```
npm install firebase-functions@">=3.14.0"
```
И обновление вашего проекта firebase-admin зависимости до версии 9.8.0 или более поздней версии:
```
npm install firebase-admin@">=9.8.0"
```

Добавьте проверку context.app вашей функции. Ваша функция должна потерпеть неудачу , если context.app не определен.

exports.yourCallableFunction = functions.https.onCall((data, context) => {
  // context.app will be undefined if the request doesn't include an
  // App Check token. (If the request includes an invalid App Check
  // token, the request will be rejected with HTTP error 401.)
  if (context.app == undefined) {
    throw new functions.https.HttpsError(
        'failed-precondition',
        'The function must be called from an App Check verified app.')
  }

  // Your function logic follows.
});

(Необязательно) Если вы хотите недействительных App Проверьте маркера с вашей собственной логикой (например, если вы хотите временно войти, а не отвергать, недопустимые запросы перед включением полного исполнения), установите allowInvalidAppCheckToken к true :

exports.yourCallableFunction = functions.
  .runWith({
    allowInvalidAppCheckToken: true  // Opt-out: Requests with invalid App
                                     // Check tokens continue to your code.
  })
  .https.onCall((data, context) => {
    // Now, requests with an invalid App Check token are not rejected.
    //
    // context.app will be undefined if the request:
    //   1) Does not include an App Check token
    //   2) Includes an invalid App Check token
    if (context.app == undefined) {
      // You can inspect the raw request header to check whether an App
      // Check token was provided in the request. If you're not ready to
      // fully enable App Check yet, you could log these conditions instead
      // of throwing errors.
      const rawToken = context.rawRequest.header['X-Firebase-AppCheck'];
      if (rawToken == undefined) {
        throw new functions.https.HttpsError(
            'failed-precondition',
            'The function must be called from an App Check verified app.'
        );
      } else {
        throw new functions.https.HttpsError(
            'unauthenticated',
            'Provided App Check token failed to validate.'
        );
      }
    }

    // Your function logic follows.
  });

Чтобы включить полную App проверки защиты, установите allowInvalidAppCheckToken в false .

Перераспределите свои функции:
```
firebase deploy --only functions
```

После развертывания этих изменений вашим вызываемым облачным функциям потребуются действительные токены проверки приложений. Клиентские SDK Cloud Functions автоматически прикрепляют токен проверки приложений при вызове вызываемой функции.