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

Аутентификация с помощью Twitter в JavaScript

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

Подготовка

Добавьте Firebase в свой проект JavaScript.
В консоли Firebase выберите Безопасность > Аутентификация.
На вкладке Способ входа включите поставщика для входа через Twitter.
Добавьте ключ API и секрет API из консоли разработчика поставщика в конфигурацию поставщика:
1. Зарегистрируйте приложение как приложение для разработчиков в Twitter и получите ключ API и секрет API OAuth.
2. Убедитесь, что URI переадресации OAuth Firebase (например, my-app-12345.firebaseapp.com/__/auth/handler) указан в качестве URL обратного вызова авторизации на странице настроек приложения в конфигурации приложения Twitter.
Нажмите Сохранить.

Как обрабатывать процесс входа с помощью Firebase SDK

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

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

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

Web

import { TwitterAuthProvider } from "firebase/auth";

const provider = new TwitterAuthProvider();auth_twitter_provider_create.js

Web

var provider = new firebase.auth.TwitterAuthProvider();twitter.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({
  'lang': 'es'
});auth_twitter_provider_params.js
```
Web
```
provider.setCustomParameters({
  'lang': 'es'
});twitter.js
```
Зарезервированные обязательные параметры OAuth не допускаются и будут игнорироваться. Подробнее о поставщике аутентификации…

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

Чтобы войти в систему с помощью всплывающего окна, вызовите функцию signInWithPopup:

Web

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

const auth = getAuth();
signInWithPopup(auth, provider)
  .then((result) => {
    // This gives you a the Twitter OAuth 1.0 Access Token and Secret.
    // You can use these server side with your app's credentials to access the Twitter API.
    const credential = TwitterAuthProvider.credentialFromResult(result);
    const token = credential.accessToken;
    const secret = credential.secret;

    // 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 = TwitterAuthProvider.credentialFromError(error);
    // ...
  });auth_twitter_signin_popup.js

Web

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

    // This gives you a the Twitter OAuth 1.0 Access Token and Secret.
    // You can use these server side with your app's credentials to access the Twitter API.
    var token = credential.accessToken;
    var secret = credential.secret;

    // 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;
    // ...
  });twitter.js

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

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

Чтобы войти в аккаунт, перейдя на страницу входа, вызовите метод 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 поставщика Twitter, вызвав функцию getRedirectResult при загрузке страницы:

Web

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

const auth = getAuth();
getRedirectResult(auth)
  .then((result) => {
    // This gives you a the Twitter OAuth 1.0 Access Token and Secret.
    // You can use these server side with your app's credentials to access the Twitter API.
    const credential = TwitterAuthProvider.credentialFromResult(result);
    const token = credential.accessToken;
    const secret = credential.secret;
    // ...

    // 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 = TwitterAuthProvider.credentialFromError(error);
    // ...
  });auth_twitter_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 the Twitter OAuth 1.0 Access Token and Secret.
      // You can use these server side with your app's credentials to access the Twitter API.
      var token = credential.accessToken;
      var secret = credential.secret;
      // ...
    }

    // 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;
    // ...
  });twitter.js

Как устранять ошибки account-exists-with-different-credential

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

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

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

try {
  // Step 1: User tries to sign in using Twitter.
  let result = await signInWithPopup(getAuth(), new TwitterAuthProvider());
} catch (error) {
  // Step 2: User's email already exists.
  if (error.code === "auth/account-exists-with-different-credential") {
    // The pending Twitter 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 Twitter 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 с помощью аккаунта Twitter, обработав процесс входа, вызвав конечные точки Twitter OAuth:

Добавьте в приложение аутентификацию через Twitter, следуя документации для разработчиков. В конце процесса входа в Twitter вы получите токен доступа OAuth и секретный код OAuth.
Если вам нужно войти в приложение Node.js, отправьте в него токен доступа OAuth и секрет OAuth.
После того как пользователь успешно войдет в аккаунт Twitter, обменяйте токен доступа OAuth и секрет OAuth на учетные данные Firebase:
```
var credential = firebase.auth.TwitterAuthProvider.credential(token, secret);
```

Выполните аутентификацию в Firebase с помощью учетных данных Firebase:

Web

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

// Sign in with the credential from the Facebook user.
const auth = getAuth();
signInWithCredential(auth, credential)
  .then((result) => {
    // Signed in 
    const credential = FacebookAuthProvider.credentialFromResult(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 = FacebookAuthProvider.credentialFromError(error);
    // ...
  });auth_facebook_signin_credential.js

Web

// Sign in with the credential from the Facebook user.
firebase.auth().signInWithCredential(credential)
  .then((result) => {
    // Signed in       
    var credential = result.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;
    // ...
  });facebook.js

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

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

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

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

Чтобы не показывать субдомен, настройте пользовательский домен с помощью Firebase Hosting:

Выполните шаги 1–3 из статьи Как настроить домен для Hosting. После подтверждения права собственности на домен Hosting предоставит SSL-сертификат для вашего специального домена.
Добавьте свой домен в список авторизованных доменов в консоли Firebase: auth.custom.domain.com.
В консоли разработчика Twitter или на странице настройки 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

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