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.com |
|
| GitHub | github.com |
google.com |
|
| Gry Google Play | playgames.google.com |
linkedin.com |
|
| Microsoft | microsoft.com |
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.