Как программно настроить поставщиков идентификационной информации OAuth для Firebase Authentication

Вы можете использовать Google Cloud Identity Platform REST API, чтобы программно управлять конфигурацией поставщика идентификационной информации OAuth в проекте Firebase. С помощью этого API вы можете настроить поставщиков идентификационной информации, которых хотите поддерживать, а также обновить, включить и отключить текущие конфигурации OAuth вашего проекта.

Получение авторизации

Прежде чем вызывать REST API, вам нужен токен доступа OAuth 2.0, который предоставляет права на редактирование для проекта Firebase. Например, чтобы получить токен доступа с помощью сервисного аккаунта в Node.js:

const googleAuth = require('google-auth-library');
const SCOPES = ['https://www.googleapis.com/auth/cloud-platform'];

async function getAccessToken() {
    const serviceAccount = require('/path/to/service_account_key.json');
    const jwtClient = new googleAuth.JWT(
        serviceAccount.client_email,
        null,
        serviceAccount.private_key,
        SCOPES,
        null
    );
    return jwtClient.authorize().then((tokens) => tokens.access_token);
}

Как добавить новую конфигурацию поставщика идентификационной информации OAuth

Чтобы добавить новую конфигурацию поставщика идентификационной информации OAuth, отправьте ее в конечную точку projects.defaultSupportedIdpConfigs.

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

Поставщик Идентификатор поставщика идентификационной информации
Apple apple.com
Apple Game Center gc.apple.com
Facebook facebook.com
GitHub github.com
Google google.com
Google Play Игры playgames.google.com
LinkedIn linkedin.com
Microsoft microsoft.com
Twitter twitter.com
Yahoo yahoo.com

Пример с использованием Node.js:

const fetch = require('node-fetch');
const GCIP_API_BASE = 'https://identitytoolkit.googleapis.com/v2';

async function addIdpConfig(projectId, accessToken, idpId, clientId, clientSecret) {
    const uri = `${GCIP_API_BASE}/projects/${projectId}/defaultSupportedIdpConfigs?idpId=${idpId}`;
    const options = {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${accessToken}`
        },
        body: JSON.stringify({
            name: `projects/${projectId}/defaultSupportedIdpConfigs/${idpId}`,
            enabled: true,
            clientId: clientId,
            clientSecret: clientSecret,
        }),
    };
    return fetch(uri, options).then((response) => {
        if (response.ok) {
            return response.json();
        } else if (response.status == 409) {
            throw new Error('IdP configuration already exists. Update it instead.');
        } else {
            throw new Error('Server error.');
        }
    });
}

(async () => {
    const projectId = 'your-firebase-project-id';
    const accessToken = await getAccessToken();
    const idpId = 'facebook.com';
    const clientId = 'your-facebook-client-id';
    const clientSecret = 'your-facebook-client-secret';
    try {
        await addIdpConfig(projectId, accessToken, idpId, clientId, clientSecret);
    } catch (err) {
        console.error(err.message);
    }
})().catch(console.error);

Если вызов выполнен успешно, возвращается новая конфигурация. Пример:

{
  name: 'projects/your-numerical-project-id/defaultSupportedIdpConfigs/facebook.com',
  enabled: true,
  clientId: 'your-facebook-client-id',
  clientSecret: 'your-facebook-client-secret'
}

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

Как обновить конфигурацию поставщика идентификационной информации OAuth

Чтобы включить или отключить поставщика идентификационной информации OAuth или обновить конфигурацию клиента проекта, сначала получите текущую конфигурацию поставщика, отправив GET-запрос к конечной точке projects.defaultSupportedIdpConfigs. Затем внесите нужные изменения в конфигурацию и отправьте ее в конечную точку projects.defaultSupportedIdpConfigs с помощью метода PATCH.

Пример с использованием Node.js:

async function getIdpCfg(projectId, accessToken, idpId) {
    const uri = `${GCIP_API_BASE}/projects/${projectId}/defaultSupportedIdpConfigs/${idpId}`;
    const options = {
        method: 'GET',
        headers: {
            'Authorization': `Bearer ${accessToken}`
        },
    };
    return fetch(uri, options).then((response) => {
        if (response.ok) {
            return response.json();
        } else if (response.status == 404) {
            throw new Error('IdP configuration not found. First add the IdP'
                            + ' configuration to your project.');
        } else {
            throw new Error('Server error.');
        }
    });
}

async function updateIdpConfig(accessToken, idpCfg) {
    const uri = `${GCIP_API_BASE}/${idpCfg.name}`;
    const options = {
        method: 'PATCH',
        headers: {
            'Authorization': `Bearer ${accessToken}`
        },
        body: JSON.stringify(idpCfg),
    };
    return fetch(uri, options).then((response) => {
        if (response.ok) {
            return response.json();
        } else if (response.status == 404) {
            throw new Error('IdP configuration not found. First add the IdP'
                            + ' configuration to your project.');
        } else {
            throw new Error('Server error.');
        }
    });
}

(async () => {
    const projectId = 'your-firebase-project-id';
    const accessToken = await getAccessToken();
    const idpId = 'facebook.com';
    try {
        // Get the IdP's current configuration.
        const idpCfg = await getIdpCfg(projectId, accessToken, idpId);

        // Update the configuration. (For example, disable the IdP.)
        idpCfg.enabled = false;
        await updateIdpConfig(accessToken, idpCfg);
    } catch (err) {
        console.error(err.message);
    }
})().catch(console.error);

Если вы попытаетесь обновить конфигурацию поставщика идентификационной информации, которого вы никогда не настраивали для своего проекта, вызовы вернут ошибку HTTP 404. Вместо этого настройте нового поставщика идентификационной информации, как описано в предыдущем разделе.