Аутентификация в Firebase с использованием номера телефона в Unity

Вы можете использовать Firebase Authentication для входа пользователя, отправив SMS-сообщение на его телефон. Пользователь авторизуется, используя одноразовый код, содержащийся в SMS-сообщении.

В этом документе описывается, как реализовать процесс входа по номеру телефона с использованием Firebase SDK.

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

  1. Прежде чем использовать Firebase Authentication , вам необходимо добавить Firebase Unity SDK (в частности, FirebaseAuth.unitypackage ) в ваш проект Unity.

    Подробные инструкции по начальным этапам настройки можно найти в статье Добавление Firebase в ваш проект Unity .

  2. Если вы еще не подключили свое приложение к проекту Firebase, сделайте это из консоли Firebase .
  3. Ознакомьтесь с требованиями платформы для входа по номеру телефона:
    • Вход по номеру телефона возможен только для мобильных платформ.
    • На устройствах iOS для входа по номеру телефона требуется физическое устройство, и он не будет работать на симуляторе.

Проблемы безопасности

Аутентификация только по номеру телефона, хоть и удобна, менее безопасна, чем другие доступные методы, поскольку владение номером телефона может легко передаваться от одного пользователя другому. Кроме того, на устройствах с несколькими профилями любой пользователь, принимающий SMS, может войти в учётную запись, используя номер телефона устройства.

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

Включите вход по номеру телефона для вашего проекта Firebase

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

  1. В консоли Firebase откройте раздел «Аутентификация» .
  2. На странице «Способ входа» включите способ входа по номеру телефона .
  3. Необязательно : на странице настроек задайте политику регионов, в которых вы хотите разрешить или запретить отправку SMS-сообщений. Настройка политики региона для SMS поможет защитить ваши приложения от злоупотреблений SMS.

Начните получать уведомления APNs (только для iOS)

Для использования аутентификации по номеру телефона на iOS ваше приложение должно иметь возможность получать уведомления APN от Firebase. При первом входе пользователя с использованием его номера телефона на устройство Firebase Authentication отправляет на него скрытое push-уведомление, чтобы убедиться, что запрос на вход по номеру телефона исходит от вашего приложения. (По этой причине вход по номеру телефона не может быть использован в симуляторе.)

Чтобы включить уведомления APNs для использования с Firebase Authentication :

  1. В Xcode включите push-уведомления для вашего проекта.

  2. Загрузите свой сертификат APNs в Firebase. Если у вас ещё нет сертификата APNs, создайте его в Центре разработчиков Apple .

    1. Внутри вашего проекта в консоли Firebase выберите значок шестеренки, выберите Настройки проекта , а затем выберите вкладку Облачные сообщения .

    2. Нажмите кнопку «Загрузить сертификат» для вашего сертификата разработки, сертификата производства или обоих. Требуется как минимум один сертификат.

    3. Для каждого сертификата выберите файл .p12 и укажите пароль, если он есть. Убедитесь, что идентификатор пакета этого сертификата совпадает с идентификатором пакета вашего приложения. Нажмите «Сохранить» .

Отправить проверочный код на телефон пользователя

Чтобы инициировать вход по номеру телефона, предоставьте пользователю интерфейс, предлагающий ему указать свой номер телефона, а затем вызовите PhoneAuthProvider.VerifyPhoneNumber , чтобы запросить у Firebase отправку кода аутентификации на телефон пользователя по SMS:

  1. Получите номер телефона пользователя.

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

  2. Вызовите PhoneAuthProvider.VerifyPhoneNumber , передав ему PhoneAuthOptions, содержащий номер телефона пользователя. 
    PhoneAuthProvider provider = PhoneAuthProvider.GetInstance(firebaseAuth);
provider.VerifyPhoneNumber(
  new Firebase.Auth.PhoneAuthOptions {
    PhoneNumber = phoneNumber,
    TimeoutInMilliseconds = phoneAuthTimeoutMs,
    ForceResendingToken = null
  },
  verificationCompleted: (credential) =&gt {
    // Auto-sms-retrieval or instant validation has succeeded (Android only).
    // There is no need to input the verification code.
    // `credential` can be used instead of calling GetCredential().
  },
  verificationFailed: (error) =&gt {
    // The verification code was not sent.
    // `error` contains a human readable explanation of the problem.
  },
  codeSent: (id, token) =&gt {
    // Verification code was successfully sent via SMS.
    // `id` contains the verification id that will need to passed in with
    // the code from the user when calling GetCredential().
    // `token` can be used if the user requests the code be sent again, to
    // tie the two requests together.
  },
  codeAutoRetrievalTimeout: (id) =&gt {
    // Called when the auto-sms-retrieval has timed out, based on the given
    // timeout parameter.
    // `id` contains the verification id of the request that timed out.
  });
     Когда вы вызываете PhoneAuthProvider.VerifyPhoneNumber , Firebase,
    • (на iOS) отправляет тихое push-уведомление в ваше приложение.
    • Firebase отправляет SMS с кодом аутентификации на указанный номер телефона и передаёт идентификатор верификации в функцию завершения. Для входа пользователя вам понадобятся как код верификации, так и идентификатор верификации.

  3. Сохраните идентификатор проверки и восстановите его при загрузке приложения. Это гарантирует, что ваш идентификатор проверки останется действительным, даже если приложение будет закрыто до того, как пользователь завершит процесс входа (например, при переходе в приложение для отправки SMS).

    Вы можете сохранить идентификатор проверки любым удобным для вас способом. Самый простой способ — сохранить его с помощью UnityEngine.PlayerPrefs .

Если вызывается обратный вызов, переданный codeSent , вы можете предложить пользователю ввести код подтверждения, когда он получит его в SMS-сообщении.

С другой стороны, если вызывается обратный вызов для verificationCompleted , то автоматическая проверка прошла успешно, и теперь у вас есть PhoneAuthCredential , который вы можете использовать, как описано ниже.

Авторизуйте пользователя с помощью проверочного кода.

После того как пользователь предоставит вашему приложению код подтверждения из SMS-сообщения, выполните вход пользователя, создав объект PhoneAuthCredential из кода подтверждения и идентификатора подтверждения и передав этот объект в FirebaseAuth.SignInAndRetrieveDataWithCredentialAsync .

  1. Получите проверочный код от пользователя.
  2. Создайте объект Credential из кода проверки и идентификатора проверки. 
    PhoneAuthCredential credential =
    phoneAuthProvider.GetCredential(verificationId, verificationCode);
  3. Авторизуйте пользователя с помощью объекта PhoneAuthCredential : 
    auth.SignInAndRetrieveDataWithCredentialAsync(credential).ContinueWith(task =&gt {
  if (task.IsFaulted) {
    Debug.LogError("SignInAndRetrieveDataWithCredentialAsync encountered an error: " +
                   task.Exception);
    return;
  }

  FirebaseUser newUser = task.Result.User;
  Debug.Log("User signed in successfully");
  // This should display the phone number.
  Debug.Log("Phone number: " + newUser.PhoneNumber);
  // The phone number providerID is 'phone'.
  Debug.Log("Phone provider ID: " + newUser.ProviderId);
});

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

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

  • В ваших приложениях вы можете получить основную информацию профиля пользователя из объекта Firebase.Auth.FirebaseUser :

    Firebase.Auth.FirebaseUser user = auth.CurrentUser;
if (user != null) {
  string name = user.DisplayName;
  string email = user.Email;
  System.Uri photo_url = user.PhotoUrl;
  // The user's Id, unique to the Firebase project.
  // Do NOT use this value to authenticate with your backend server, if you
  // have one; use User.TokenAsync() instead.
  string uid = user.UserId;
}

  • В правилах безопасности Firebase Realtime Database и Cloud Storage вы можете получить уникальный идентификатор вошедшего в систему пользователя из переменной auth и использовать его для управления данными, к которым пользователь может получить доступ.

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

Чтобы выйти из системы пользователя, вызовите SignOut() :

auth.SignOut();