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

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

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

Подготовка

Чтобы пользователи могли входить в систему с помощью аккаунтов Microsoft (Azure Active Directory и личных аккаунтов Microsoft), сначала включите Microsoft в качестве поставщика услуг входа для своего проекта Firebase:

Добавьте Firebase в свой проект JavaScript.
В консоли Firebase выберите Безопасность > Аутентификация.
На вкладке Способ входа включите поставщика для входа через Microsoft.
Добавьте идентификатор клиента и секретный код клиента из консоли разработчика поставщика в конфигурацию поставщика:
1. Чтобы зарегистрировать клиент OAuth Microsoft, следуйте инструкциям в руководстве по регистрации приложения с конечной точкой Azure Active Directory версии 2.0. Обратите внимание, что эта конечная точка поддерживает вход с использованием личных аккаунтов Microsoft, а также аккаунтов Azure Active Directory. Подробнее о Azure Active Directory версии 2.0…
2. При регистрации приложений у этих поставщиков обязательно укажите домен *.firebaseapp.com для своего проекта в качестве домена переадресации для приложения.
Нажмите Сохранить.

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

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

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

Создайте экземпляр OAuthProvider, используя идентификатор поставщика microsoft.com.

Web

import { OAuthProvider } from "firebase/auth";

const provider = new OAuthProvider('microsoft.com');auth_msft_create_provider.js

Web

var provider = new firebase.auth.OAuthProvider('microsoft.com');microsoft-oauth.js

Необязательно. Укажите дополнительные специальные параметры OAuth, которые вы хотите отправить с запросом OAuth.

Web

provider.setCustomParameters({
  // Force re-consent.
  prompt: 'consent',
  // Target specific email with login hint.
  login_hint: 'user@firstadd.onmicrosoft.com'
});auth_msft_provider_params.js

Web

provider.setCustomParameters({
  // Force re-consent.
  prompt: 'consent',
  // Target specific email with login hint.
  login_hint: 'user@firstadd.onmicrosoft.com'
});microsoft-oauth.js

Параметры, поддерживаемые Microsoft, описаны в документации по Microsoft OAuth. Обратите внимание, что с помощью setCustomParameters() нельзя передавать параметры, обязательные для Firebase. Это параметры client_id, response_type, redirect_uri, state, scope и response_mode.

Чтобы разрешить вход в приложение только пользователям определенного клиента Azure AD, можно использовать понятное доменное имя клиента Azure AD или его глобальный уникальный идентификатор. Для этого укажите поле tenant в объекте специальных параметров.

Web

provider.setCustomParameters({
  // Optional "tenant" parameter in case you are using an Azure AD tenant.
  // eg. '8eaef023-2b34-4da1-9baa-8bc8c9d6a490' or 'contoso.onmicrosoft.com'
  // or "common" for tenant-independent tokens.
  // The default value is "common".
  tenant: 'TENANT_ID'
});auth_msft_provider_params_tenant.js

Web

provider.setCustomParameters({
  // Optional "tenant" parameter in case you are using an Azure AD tenant.
  // eg. '8eaef023-2b34-4da1-9baa-8bc8c9d6a490' or 'contoso.onmicrosoft.com'
  // or "common" for tenant-independent tokens.
  // The default value is "common".
  tenant: 'TENANT_ID'
});microsoft-oauth.js

Необязательно. Укажите дополнительные области действия OAuth 2.0, помимо базового профиля, которые вы хотите запросить у поставщика услуг аутентификации.
```
provider.addScope('mail.read');
provider.addScope('calendars.read');
```
Подробнее о разрешениях и согласии Microsoft…
Выполните аутентификацию в Firebase, используя объект поставщика OAuth. Вы можете предложить пользователям войти в аккаунт Microsoft, открыв всплывающее окно или перенаправив их на страницу входа. На мобильных устройствах рекомендуется использовать метод переадресации.
- Чтобы войти в систему с помощью всплывающего окна, вызовите функцию signInWithPopup:
Web
```
import { getAuth, signInWithPopup, OAuthProvider } from "firebase/auth";

const auth = getAuth();
signInWithPopup(auth, provider)
  .then((result) => {
    // User is signed in.
    // IdP data available in result.additionalUserInfo.profile.

    // Get the OAuth access token and ID Token
    const credential = OAuthProvider.credentialFromResult(result);
    const accessToken = credential.accessToken;
    const idToken = credential.idToken;
  })
  .catch((error) => {
    // Handle error.
  });auth_msft_signin_popup.js
```
Web
```
firebase.auth().signInWithPopup(provider)
  .then((result) => {
    // IdP data available in result.additionalUserInfo.profile.
    // ...

    /** @type {firebase.auth.OAuthCredential} */
    var credential = result.credential;

    // OAuth access and id tokens can also be retrieved:
    var accessToken = credential.accessToken;
    var idToken = credential.idToken;
  })
  .catch((error) => {
    // Handle error.
  });microsoft-oauth.js
```
- Чтобы войти в аккаунт, перейдя на страницу входа, вызовите signInWithRedirect:
При использовании signInWithRedirect, linkWithRedirect или reauthenticateWithRedirect следуйте рекомендациям.
Web
```
import { getAuth, signInWithRedirect } from "firebase/auth";

const auth = getAuth();
signInWithRedirect(auth, provider);auth_msft_signin_redirect.js
```
Web
```
firebase.auth().signInWithRedirect(provider);microsoft-oauth.js
```
После того как пользователь выполнит вход и вернется на страницу, вы можете получить результат входа, вызвав функцию getRedirectResult.
Web
```
import { getAuth, getRedirectResult, OAuthProvider } from "firebase/auth";

const auth = getAuth();
getRedirectResult(auth)
  .then((result) => {
    // User is signed in.
    // IdP data available in result.additionalUserInfo.profile.

    // Get the OAuth access token and ID Token
    const credential = OAuthProvider.credentialFromResult(result);
    const accessToken = credential.accessToken;
    const idToken = credential.idToken;
  })
  .catch((error) => {
    // Handle error.
  });auth_msft_signin_redirect_result.js
```
Web
```
firebase.auth().getRedirectResult()
  .then((result) => {
    // IdP data available in result.additionalUserInfo.profile.
    // ...

    /** @type {firebase.auth.OAuthCredential} */
    var credential = result.credential;

    // OAuth access and id tokens can also be retrieved:
    var accessToken = credential.accessToken;
    var idToken = credential.idToken;
  })
  .catch((error) => {
    // Handle error.
  });microsoft-oauth.js
```
После успешного завершения токен доступа OAuth, связанный с поставщиком, можно получить из возвращенного объекта firebase.auth.UserCredential.

С помощью токена доступа OAuth можно вызвать Microsoft Graph API.

Например, чтобы получить основную информацию профиля, можно вызвать следующий REST API:
```
curl -i -H "Authorization: Bearer ACCESS_TOKEN" https://graph.microsoft.com/v1.0/me
```
В отличие от других поставщиков, поддерживаемых Firebase Auth, Microsoft не предоставляет URL фотографии. Вместо этого двоичные данные для фотографии профиля необходимо запросить через Microsoft Graph API.

Помимо токена доступа OAuth, из объекта firebase.auth.UserCredential можно также получить токен идентификации OAuth пользователя. Заявление sub в токене идентификатора относится к приложению и не совпадает с идентификатором федеративного пользователя, который используется Firebase Auth и доступен через user.providerData[0].uid. Вместо него следует использовать поле oid. При входе с использованием клиента Azure AD утверждение oid будет точным. Однако в случае, когда клиент не является арендатором, поле oid дополняется. Для федеративного идентификатора 4b2eabcdefghijkl значение oid будет иметь формат 00000000-0000-0000-4b2e-abcdefghijkl.

В приведенных выше примерах основное внимание уделяется процессам входа в систему, но вы также можете связать поставщика Microsoft с существующим пользователем, используя linkWithPopup/linkWithRedirect. Например, вы можете связать нескольких поставщиков с одним и тем же пользователем, чтобы он мог входить в систему с помощью любого из них.

Web

import { getAuth, linkWithPopup, OAuthProvider } from "firebase/auth";

const provider = new OAuthProvider('microsoft.com');
const auth = getAuth();

linkWithPopup(auth.currentUser, provider)
    .then((result) => {
      // Microsoft credential is linked to the current user.
      // IdP data available in result.additionalUserInfo.profile.

      // Get the OAuth access token and ID Token
      const credential = OAuthProvider.credentialFromResult(result);
      const accessToken = credential.accessToken;
      const idToken = credential.idToken;
    })
    .catch((error) => {
      // Handle error.
    });auth_msft_link_popup.js

Web

var provider = new firebase.auth.OAuthProvider('microsoft.com');
firebase.auth().currentUser.linkWithPopup(provider)
    .then((result) => {
      // Microsoft credential is linked to the current user.
      // IdP data available in result.additionalUserInfo.profile.
      // OAuth access token can also be retrieved:
      // result.credential.accessToken
      // OAuth ID token can also be retrieved:
      // result.credential.idToken
    })
    .catch((error) => {
      // Handle error.
    });microsoft-oauth.js

Аналогичный шаблон можно использовать с reauthenticateWithPopup/reauthenticateWithRedirect, чтобы получать новые учетные данные для операций, связанных с безопасностью и требующих недавнего входа в систему.

Web

import { getAuth, reauthenticateWithPopup, OAuthProvider } from "firebase/auth";

const provider = new OAuthProvider('microsoft.com');
const auth = getAuth();
reauthenticateWithPopup(auth.currentUser, provider)
    .then((result) => {
      // User is re-authenticated with fresh tokens minted and
      // should be able to perform sensitive operations like account
      // deletion and email or password update.
      // IdP data available in result.additionalUserInfo.profile.

      // Get the OAuth access token and ID Token
      const credential = OAuthProvider.credentialFromResult(result);
      const accessToken = credential.accessToken;
      const idToken = credential.idToken;
    })
    .catch((error) => {
      // Handle error.
    });auth_msft_reauth_popup.js

Web

var provider = new firebase.auth.OAuthProvider('microsoft.com');
firebase.auth().currentUser.reauthenticateWithPopup(provider)
    .then((result) => {
      // User is re-authenticated with fresh tokens minted and
      // should be able to perform sensitive operations like account
      // deletion and email or password update.
      // IdP data available in result.additionalUserInfo.profile.
      // OAuth access token can also be retrieved:
      // result.credential.accessToken
      // OAuth ID token can also be retrieved:
      // result.credential.idToken
    })
    .catch((error) => {
      // Handle error.
    });microsoft-oauth.js

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

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

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

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

try {
  // Step 1: User tries to sign in using Microsoft.
  let result = await signInWithPopup(getAuth(), new OAuthProvider());
} catch (error) {
  // Step 2: User's email already exists.
  if (error.code === "auth/account-exists-with-different-credential") {
    // The pending Microsoft 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 Microsoft 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) {
  // ...
}

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

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

В отличие от других поставщиков OAuth, поддерживаемых Firebase, таких как Google, Facebook и Twitter, где вход можно выполнить непосредственно с помощью учетных данных на основе токена доступа OAuth, Firebase Auth не поддерживает ту же возможность для поставщиков, таких как Microsoft, из-за невозможности сервера Firebase Auth проверить аудиторию токенов доступа OAuth Microsoft. Это критическое требование безопасности, несоблюдение которого может привести к тому, что приложения и сайты станут уязвимы для атак с повторным воспроизведением, когда полученный для одного проекта (злоумышленника) токен доступа Microsoft OAuth можно использовать для входа в другой проект (жертвы). Вместо этого Firebase Auth предлагает возможность обрабатывать весь поток OAuth и обмен кодом авторизации с использованием идентификатора клиента OAuth и секретного кода, настроенных в консоли Firebase. Поскольку код авторизации можно использовать только с определенным идентификатором клиента и секретом, код авторизации, полученный для одного проекта, нельзя использовать в другом.

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

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

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

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

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

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

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

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