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

Аутентификация с использованием Google с JavaScript

Вы можете разрешить пользователям аутентифицироваться в Firebase, используя свои учетные записи Google. Вы можете либо использовать SDK Firebase для выполнения входа через Google, либо выполнить вход вручную с помощью библиотеки Sign In With Google и передать полученный токен ID в Firebase.

Прежде чем начать

Добавьте Firebase в свой JavaScript-проект .
Включите Google в качестве способа входа в систему в консоли Firebase :
1. В консоли Firebase откройте раздел «Аутентификация» .
2. На вкладке «Способ входа» включите вход через Google и нажмите «Сохранить» .
Совет: Если вы предпочитаете использовать Firebase CLI , выполните команду firebase init auth для настройки поставщиков аутентификации, а затем команду firebase deploy --only auth для развертывания изменений в вашем проекте.

Обрабатывайте процесс авторизации с помощью Firebase SDK.

Если вы разрабатываете веб-приложение, самый простой способ аутентификации пользователей в Firebase с использованием их учетных записей Google — это обработка процесса входа в систему с помощью Firebase JavaScript SDK. (Если вы хотите аутентифицировать пользователя в Node.js или другой среде, отличной от браузера, вам необходимо обрабатывать процесс входа в систему вручную.)

Для обработки процесса авторизации с помощью Firebase JavaScript SDK выполните следующие действия:

Создайте экземпляр объекта поставщика Google:

Web

import { GoogleAuthProvider } from "firebase/auth";

const provider = new GoogleAuthProvider();auth_google_provider_create.js

Web

var provider = new firebase.auth.GoogleAuthProvider();google-signin.js

Необязательно : укажите дополнительные области действия OAuth 2.0, которые вы хотите запросить у поставщика аутентификации. Чтобы добавить область действия, вызовите addScope . Например:
Web
```
provider.addScope('https://www.googleapis.com/auth/contacts.readonly');auth_google_provider_scopes.js
```
Web
```
provider.addScope('https://www.googleapis.com/auth/contacts.readonly');google-signin.js
```
См. документацию поставщика аутентификации .
Необязательно : Чтобы локализовать поток OAuth поставщика услуг на предпочитаемый пользователем язык без явной передачи соответствующих пользовательских параметров OAuth, обновите код языка в экземпляре Auth перед запуском потока OAuth. Например:
Web
```
import { getAuth } from "firebase/auth";

const auth = getAuth();
auth.languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// auth.useDeviceLanguage();auth_set_language_code.js
```
Web
```
firebase.auth().languageCode = 'it';
// To apply the default browser preference instead of explicitly setting it.
// firebase.auth().useDeviceLanguage();index.js
```
Необязательно : укажите дополнительные параметры пользовательского поставщика OAuth, которые вы хотите отправить вместе с запросом OAuth. Чтобы добавить пользовательский параметр, вызовите метод setCustomParameters для инициализированного поставщика, передав ему объект, содержащий ключ, указанный в документации поставщика OAuth, и соответствующее значение. Например:
Web
```
provider.setCustomParameters({
  'login_hint': 'user@example.com'
});auth_google_provider_params.js
```
Web
```
provider.setCustomParameters({
  'login_hint': 'user@example.com'
});google-signin.js
```
Зарезервированные обязательные параметры OAuth не допускаются и будут игнорироваться. Дополнительные сведения см. в справочнике поставщика аутентификации .

Аутентификация в Firebase осуществляется с помощью объекта поставщика Google. Вы можете предложить пользователям войти в систему с помощью своих учетных записей Google, открыв всплывающее окно или перенаправив их на страницу входа. На мобильных устройствах предпочтительнее использовать метод перенаправления.

Для входа в систему через всплывающее окно вызовите функцию signInWithPopup :

Web

import { getAuth, signInWithPopup, GoogleAuthProvider } from "firebase/auth";

const auth = getAuth();
signInWithPopup(auth, provider)
  .then((result) => {
    // This gives you a Google Access Token. You can use it to access the Google API.
    const credential = GoogleAuthProvider.credentialFromResult(result);
    const token = credential.accessToken;
    // The signed-in user info.
    const user = result.user;
    // IdP data available using getAdditionalUserInfo(result)
    // ...
  }).catch((error) => {
    // Handle Errors here.
    const errorCode = error.code;
    const errorMessage = error.message;
    // The email of the user's account used.
    const email = error.customData.email;
    // The AuthCredential type that was used.
    const credential = GoogleAuthProvider.credentialFromError(error);
    // ...
  });auth_google_signin_popup.js

Web

firebase.auth()
  .signInWithPopup(provider)
  .then((result) => {
    /** @type {firebase.auth.OAuthCredential} */
    var credential = result.credential;

    // This gives you a Google Access Token. You can use it to access the Google API.
    var token = credential.accessToken;
    // The signed-in user info.
    var user = result.user;
    // IdP data available in result.additionalUserInfo.profile.
      // ...
  }).catch((error) => {
    // Handle Errors here.
    var errorCode = error.code;
    var errorMessage = error.message;
    // The email of the user's account used.
    var email = error.email;
    // The firebase.auth.AuthCredential type that was used.
    var credential = error.credential;
    // ...
  });google-signin.js

Также обратите внимание, что вы можете получить токен OAuth от поставщика услуг Google, который можно использовать для получения дополнительных данных с помощью API Google.

Здесь же вы можете перехватывать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по аутентификации .

Для входа в систему путем перенаправления на страницу входа вызовите метод signInWithRedirect : следуйте рекомендациям по использованию `signInWithRedirect`.

Web

import { getAuth, signInWithRedirect } from "firebase/auth";

const auth = getAuth();
signInWithRedirect(auth, provider);auth_signin_redirect.js

Web

firebase.auth().signInWithRedirect(provider);index.js

Кроме того, вы можете получить токен OAuth от поставщика услуг Google, вызвав getRedirectResult при загрузке страницы:

Web

import { getAuth, getRedirectResult, GoogleAuthProvider } from "firebase/auth";

const auth = getAuth();
getRedirectResult(auth)
  .then((result) => {
    // This gives you a Google Access Token. You can use it to access Google APIs.
    const credential = GoogleAuthProvider.credentialFromResult(result);
    const token = credential.accessToken;

    // The signed-in user info.
    const user = result.user;
    // IdP data available using getAdditionalUserInfo(result)
    // ...
  }).catch((error) => {
    // Handle Errors here.
    const errorCode = error.code;
    const errorMessage = error.message;
    // The email of the user's account used.
    const email = error.customData.email;
    // The AuthCredential type that was used.
    const credential = GoogleAuthProvider.credentialFromError(error);
    // ...
  });auth_google_signin_redirect_result.js

Web

firebase.auth()
  .getRedirectResult()
  .then((result) => {
    if (result.credential) {
      /** @type {firebase.auth.OAuthCredential} */
      var credential = result.credential;

      // This gives you a Google Access Token. You can use it to access the Google API.
      var token = credential.accessToken;
      // ...
    }
    // The signed-in user info.
    var user = result.user;
    // IdP data available in result.additionalUserInfo.profile.
      // ...
  }).catch((error) => {
    // Handle Errors here.
    var errorCode = error.code;
    var errorMessage = error.message;
    // The email of the user's account used.
    var email = error.email;
    // The firebase.auth.AuthCredential type that was used.
    var credential = error.credential;
    // ...
  });google-signin.js

Обработка ошибок, связанных с существованием учетной записи с разными учетными данными.

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

Если в консоли Firebase включена настройка « Одна учетная запись на один адрес электронной почты» , то при попытке входа пользователя в систему через провайдера (например, Google) с использованием адреса электронной почты, уже существующего у другого пользователя Firebase (например, Facebook), будет выдана ошибка auth/account-exists-with-different-credential вместе с объектом AuthCredential (токен Google ID). Для завершения входа в систему через нужного провайдера пользователю необходимо сначала войти в существующую учетную запись (Facebook), а затем связать ее с предыдущим объектом AuthCredential (токен Google ID).

При использовании signInWithPopup вы можете обрабатывать ошибки auth/account-exists-with-different-credential с помощью кода, подобного приведенному ниже примеру:

import {
  getAuth,
  linkWithCredential,
  signInWithPopup,
  GoogleAuthProvider,
} from "firebase/auth";

try {
  // Step 1: User tries to sign in using Google.
  let result = await signInWithPopup(getAuth(), new GoogleAuthProvider());
} catch (error) {
  // Step 2: User's email already exists.
  if (error.code === "auth/account-exists-with-different-credential") {
    // The pending Google credential.
    let pendingCred = error.credential;

    // Step 3: Save the pending credential in temporary storage,

    // Step 4: Let the user know that they already have an account
    // but with a different provider, and let them choose another
    // sign-in method.
  }
}

// ...

try {
  // Step 5: Sign the user in using their chosen method.
  let result = await signInWithPopup(getAuth(), userSelectedProvider);

  // Step 6: Link to the Google credential.
  // TODO: implement `retrievePendingCred` for your app.
  let pendingCred = retrievePendingCred();

  if (pendingCred !== null) {
    // As you have access to the pending credential, you can directly call the
    // link method.
    let user = await linkWithCredential(result.user, pendingCred);
  }

  // Step 7: Continue to app.
} catch (error) {
  // ...
}

Режим перенаправления

В режиме перенаправления эта ошибка обрабатывается аналогичным образом, с той разницей, что ожидающие учетные данные должны кэшироваться между перенаправлениями страниц (например, с использованием хранилища сессий).

Также можно пройти аутентификацию в Firebase, используя учетную запись Google, обработав процесс входа с помощью библиотеки Sign In With Google:

Интегрируйте вход через Google в ваше приложение, следуя руководству по интеграции . Обязательно настройте вход через Google с использованием идентификатора клиента Google, сгенерированного для вашего проекта Firebase. Идентификатор клиента Google для вашего проекта можно найти на странице «Учетные данные» в консоли разработчика вашего проекта.

В функции обратного вызова, обрабатывающей результат авторизации, замените токен идентификации из ответа Google-аутентификации на учетные данные Firebase и используйте их для аутентификации в Firebase:

function handleCredentialResponse(response) {
  // Build Firebase credential with the Google ID token.
  const idToken = response.credential;
  const credential = GoogleAuthProvider.credential(idToken);

  // Sign in with credential from the Google user.
  signInWithCredential(auth, credential).catch((error) => {
    // Handle Errors here.
    const errorCode = error.code;
    const errorMessage = error.message;
    // The email of the user's account used.
    const email = error.email;
    // The credential that was used.
    const credential = GoogleAuthProvider.credentialFromError(error);
    // ...
  });
}

Расширенные возможности: аутентификация с помощью Firebase в Node.js

Для аутентификации в Firebase в приложении Node.js:

Войдите в систему пользователя с помощью его учетной записи Google и получите токен идентификатора Google пользователя. Это можно сделать несколькими способами. Например:
- Если ваше приложение имеет браузерный интерфейс, используйте вход через Google, как описано в разделе « Обработка процесса входа вручную» . Получите токен Google ID из ответа аутентификации:
```
var id_token = googleUser.getAuthResponse().id_token
```
  Затем отправьте этот токен в ваше приложение Node.js.
- Если ваше приложение работает на устройстве с ограниченными возможностями ввода, например, на телевизоре, вы можете использовать функцию входа через Google для телевизоров и других устройств .

Получив токен Google ID пользователя, используйте его для создания объекта Credential, а затем войдите в систему, используя эти учетные данные:

Web

import { getAuth, signInWithCredential, GoogleAuthProvider } from "firebase/auth";

// Build Firebase credential with the Google ID token.
const credential = GoogleAuthProvider.credential(id_token);

// Sign in with credential from the Google user.
const auth = getAuth();
signInWithCredential(auth, credential).catch((error) => {
  // Handle Errors here.
  const errorCode = error.code;
  const errorMessage = error.message;
  // The email of the user's account used.
  const email = error.customData.email;
  // The AuthCredential type that was used.
  const credential = GoogleAuthProvider.credentialFromError(error);
  // ...
});auth_google_build_signin.js

Web

// Build Firebase credential with the Google ID token.
var credential = firebase.auth.GoogleAuthProvider.credential(id_token);

// Sign in with credential from the Google user.
firebase.auth().signInWithCredential(credential).catch((error) => {
  // Handle Errors here.
  var errorCode = error.code;
  var errorMessage = error.message;
  // The email of the user's account used.
  var email = error.email;
  // The firebase.auth.AuthCredential type that was used.
  var credential = error.credential;
  // ...
});google-signin.js

Аутентификация с помощью Firebase в расширении Chrome

Если вы разрабатываете расширение для Chrome, ознакомьтесь с руководством по работе с документами, отображаемыми вне экрана .

При создании проекта Firebase автоматически создаст для него уникальный поддомен: https://my-app-12345.firebaseapp.com .

Этот домен также будет использоваться в качестве механизма перенаправления для входа через OAuth. Необходимо разрешить использование этого домена для всех поддерживаемых OAuth-провайдеров. Однако это означает, что пользователи могут видеть этот домен при входе в Google, прежде чем вернуться в приложение: [Перейти по ссылке: https://my-app-12345.firebaseapp.com ]

Чтобы избежать отображения вашего поддомена, вы можете настроить собственный домен с помощью Firebase Hosting :

Выполните шаги с 1 по 3 в разделе «Настройка домена для Hosting . После подтверждения права собственности на домен, Hosting выдаст SSL-сертификат для вашего пользовательского домена.
Добавьте свой пользовательский домен в список авторизованных доменов в консоли Firebase : auth.custom.domain.com .
В консоли разработчика Google или на странице настройки OAuth добавьте в белый список URL-адрес страницы перенаправления, которая будет доступна на вашем пользовательском домене: https://auth.custom.domain.com/__/auth/handler .

При инициализации библиотеки JavaScript укажите свой пользовательский домен в поле authDomain :

var config = {
  apiKey: '...',
  // Changed from 'PROJECT_ID.firebaseapp.com'.
  authDomain: 'auth.custom.domain.com',
  databaseURL: 'https://PROJECT_ID.firebaseio.com',
  projectId: 'PROJECT_ID',
  storageBucket: 'PROJECT_ID.firebasestorage.app',
  messagingSenderId: 'SENDER_ID'
};
firebase.initializeApp(config);

Следующие шаги

После первого входа пользователя в систему создается новая учетная запись, которая связывается с учетными данными — то есть именем пользователя и паролем, номером телефона или информацией о поставщике аутентификации, — которые пользователь использовал для входа. Эта новая учетная запись хранится как часть вашего проекта Firebase и может использоваться для идентификации пользователя во всех приложениях вашего проекта, независимо от способа входа пользователя.

В ваших приложениях рекомендуемый способ узнать статус авторизации пользователя — установить наблюдателя для объекта Auth . Затем вы можете получить основную информацию профиля пользователя из объекта User . См. раздел «Управление пользователями» .
В правилах безопасности Firebase Realtime Database и Cloud Storage вы можете получить уникальный идентификатор пользователя, вошедшего в систему, из переменной auth и использовать его для управления доступом пользователя к данным.

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

Для выхода из системы пользователя вызовите signOut :

Web

import { getAuth, signOut } from "firebase/auth";

const auth = getAuth();
signOut(auth).then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});auth_sign_out.js

Web

firebase.auth().signOut().then(() => {
  // Sign-out successful.
}).catch((error) => {
  // An error happened.
});index.js

Аутентификация с использованием Google с JavaScript Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.