Automatyczne konfigurowanie dostawców tożsamości OAuth na potrzeby uwierzytelniania Firebase

Możesz użyć interfejsu REST API Google Cloud Identity Platform, aby zautomatyzowanie zarządzać konfiguracją dostawcy tożsamości OAuth w projekcie w Firebase. Za pomocą tego interfejsu API możesz konfigurować dostawców tożsamości, których chcesz obsługiwać, oraz aktualizować, włączać i wyłączać bieżące konfiguracje OAuth projektu.

Pobranie autoryzacji

Zanim wywołasz interfejs API (typu) REST, musisz mieć token dostępu OAuth 2.0, który przyznaje uprawnienia do edycji projektu w Firebase. Aby na przykład uzyskać token dostępu za pomocą konta usługi w 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);
}

Dodawanie nowej konfiguracji dostawcy tożsamości OAuth

Aby dodać nową konfigurację dostawcy tożsamości OAuth, wyślij nową konfigurację do punktu końcowego projects.defaultSupportedIdpConfigs za pomocą metody POST.

Musisz podać identyfikator dostawcy tożsamości oraz identyfikator klienta i tajny klucz klienta, które zwykle można uzyskać na stronie dostawcy dla deweloperów. Oto dostawcy tożsamości obsługiwani przez Firebase i ich identyfikatory:

Dostawca Identyfikator dostawcy tożsamości
Apple apple.com
Apple Game Center gc.apple.com
Facebook facebook.com
GitHub github.com
Google google.com
Gry Google Play playgames.google.com
LinkedIn linkedin.com
Microsoft microsoft.com
Twitter twitter.com
Yahoo yahoo.com

Na przykład przy użyciu 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);

Jeśli wywołanie się powiedzie, zwróci nowo utworzoną konfigurację. Na przykład:

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

Jeśli spróbujesz skonfigurować dostawcę tożsamości, który został już skonfigurowany w projekcie, wywołanie zwróci błąd HTTP 409. W takiej sytuacji możesz zaktualizować konfigurację w sposób opisany poniżej.

Aktualizowanie konfiguracji dostawcy tożsamości OAuth

Aby włączyć lub wyłączyć dostawcę tożsamości OAuth albo zaktualizować konfigurację klienta projektu, najpierw pobierz bieżącą konfigurację dostawcy, wysyłając żądanie GET do punktu końcowego projects.defaultSupportedIdpConfigs. Następnie wprowadź odpowiednie zmiany w konfiguracji i wyślij nową konfigurację do punktu końcowego projects.defaultSupportedIdpConfigs za pomocą metody PATCH.

Na przykład przy użyciu 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);

Jeśli spróbujesz zaktualizować konfigurację dostawcy tożsamości, który nigdy nie został skonfigurowany w Twoim projekcie, wywołania zwrócą błąd HTTP 404. Zamiast tego skonfiguruj nowego dostawcę tożsamości, jak opisano w poprzedniej sekcji.