Firebase से पुष्टि करने के लिए, OAuth आइडेंटिटी प्रोवाइडर को प्रोग्राम के हिसाब से कॉन्फ़िगर करें

Google Cloud Identity Platform REST API का इस्तेमाल करके, प्रोग्राम के हिसाब से Firebase प्रोजेक्ट के OAuth आइडेंटिटी प्रोवाइडर (आईडीपी) कॉन्फ़िगरेशन को मैनेज किया जा सकता है. इस एपीआई की मदद से, उन आइडेंटिटी प्रोवाइडर को कॉन्फ़िगर किया जा सकता है जिन्हें आपको इस्तेमाल करना है. साथ ही, अपने प्रोजेक्ट के मौजूदा 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 आइडेंटिटी प्रोवाइडर (IdP) का नया कॉन्फ़िगरेशन जोड़ने के लिए, नए कॉन्फ़िगरेशन को projects.defaultSupportedIdpConfigs एंडपॉइंट पर POST करें.

आपको आइडेंटिटी प्रोवाइडर का आईडी, अपना क्लाइंट आईडी, और क्लाइंट सीक्रेट बताना होगा. आम तौर पर, यह जानकारी आपको प्रोवाइडर की डेवलपर साइट से मिलती है. यहां Firebase के साथ काम करने वाले आइडेंटिटी प्रोवाइडर और उनके आईडी दिए गए हैं:

सेवा देने वाली कंपनी आईडीपी (IdP) आईडी
Apple apple.com
Apple Game Center gc.apple.com
Facebook facebook.com
GitHub github.com
Google google.com
Google Play Games 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'
}

अगर आपके प्रोजेक्ट के लिए पहले से कॉन्फ़िगर किए गए आइडेंटिटी प्रोवाइडर को कॉन्फ़िगर करने की कोशिश की जाती है, तो कॉल एचटीटीपी गड़बड़ी 409 दिखाता है. ऐसी स्थिति में, कॉन्फ़िगरेशन को अपडेट किया जा सकता है. इसके लिए, यहां बताया गया तरीका अपनाएं.

OAuth आइडेंटिटी प्रोवाइडर के कॉन्फ़िगरेशन को अपडेट करना

OAuth आइडेंटिटी प्रोवाइडर को चालू या बंद करने के लिए या अपने प्रोजेक्ट के क्लाइंट कॉन्फ़िगरेशन को अपडेट करने के लिए, पहले प्रोवाइडर का मौजूदा कॉन्फ़िगरेशन पाएं. इसके लिए, projects.defaultSupportedIdpConfigs एंडपॉइंट पर GET अनुरोध करें. इसके बाद, कॉन्फ़िगरेशन में अपनी पसंद के मुताबिक बदलाव करें और नए कॉन्फ़िगरेशन को 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);

अगर आपने अपने प्रोजेक्ट के लिए, किसी आइडेंटिटी प्रोवाइडर का कॉन्फ़िगरेशन कभी सेट अप नहीं किया है और उसे अपडेट करने की कोशिश की जाती है, तो कॉल से एचटीटीपी गड़बड़ी 404 दिखेगी. इसके बजाय, पिछले सेक्शन में बताए गए तरीके से, एक नया आइडेंटिटी प्रोवाइडर कॉन्फ़िगर करें.