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

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

Подготовка

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

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

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

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

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

    Web

    import { TwitterAuthProvider } from "firebase/auth";
    
    const provider = new TwitterAuthProvider();

    Web

    var provider = new firebase.auth.TwitterAuthProvider();
  2. Необязательно. Чтобы локализовать процесс 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();

    Web

    firebase.auth().languageCode = 'it';
    // To apply the default browser preference instead of explicitly setting it.
    // firebase.auth().useDeviceLanguage();
  3. Необязательно. Укажите дополнительные параметры поставщика OAuth, которые нужно отправлять с запросом OAuth. Чтобы добавить специальный параметр, вызовите setCustomParameters для инициализированного поставщика с объектом, содержащим ключ, указанный в документации поставщика OAuth, и соответствующее значение. Пример:

    Web

    provider.setCustomParameters({
      'lang': 'es'
    });

    Web

    provider.setCustomParameters({
      'lang': 'es'
    });
    Зарезервированные обязательные параметры OAuth не допускаются и будут игнорироваться. Подробную информацию можно найти в справочнике по поставщикам аутентификации.
  4. Выполните аутентификацию в 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);
          // ...
        });

      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;
          // ...
        });
      Обратите внимание, что вы можете получить токен OAuth поставщика Twitter, который можно использовать для получения дополнительных данных с помощью API Twitter.

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

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

      Web

      import { getAuth, signInWithRedirect } from "firebase/auth";
      
      const auth = getAuth();
      signInWithRedirect(auth, provider);

      Web

      firebase.auth().signInWithRedirect(provider);
      Затем вы также можете получить токен 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);
          // ...
        });

      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;
          // ...
        });
      Здесь же можно отслеживать и обрабатывать ошибки. Список кодов ошибок можно найти в справочной документации по Auth.

Как вручную управлять процессом входа

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

  1. Интегрируйте аутентификацию Twitter в приложение, следуя документации для разработчиков. В конце процесса входа в Twitter вы получите токен доступа OAuth и криптоключ OAuth.
  2. Если вам нужно войти в приложение Node.js, отправьте в него токен доступа OAuth и криптоключ OAuth.
  3. После того как пользователь войдет в систему с помощью Twitter, обменяйте токен доступа OAuth и секретный ключ OAuth на учетные данные Firebase:
    var credential = firebase.auth.TwitterAuthProvider.credential(token, secret);
  4. Выполните аутентификацию в 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);
        // ...
      });

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

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

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

Дальнейшие действия

После первого входа пользователя создается новый аккаунт, который связывается с учетными данными, то есть именем пользователя и паролем, номером телефона или информацией от поставщика аутентификации, с помощью которых пользователь вошел в систему. Этот новый аккаунт сохраняется в проекте 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.
});

Web

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