אם שדרגתם ל-Firebase Authentication with Identity Platform, אתם יכולים לאמת את המשתמשים שלכם ב-Firebase באמצעות ספק זהויות SAML לבחירתכם. כך אפשר להשתמש בפתרון ה-SSO מבוסס ה-SAML כדי להכניס משתמשים לאפליקציית Firebase.
Firebase Authentication תומכת רק בתהליך SAML שיוזם ספק השירות.
לפני שמתחילים
כדי להכניס משתמשים באמצעות ספק זהויות SAML, קודם צריך לאסוף מידע מהספק:
- מזהה הישות ב-SAML של הספק: URI שמזהה את ספק הזהויות.
- כתובת ה-URL של ה-SSO ב-SAML של הספק: כתובת ה-URL של דף הכניסה של ספק הזהויות.
- אישור של מפתח ציבורי של הספק: האישור שמשמש לאימות טוקנים שנחתמו על ידי ספק הזהויות.
- מזהה הישות של האפליקציה: מזהה URI שמזהה את האפליקציה, "ספק השירות".
אחרי שקיבלתם את המידע שלמעלה, אתם יכולים להפעיל את SAML כספק כניסה לפרויקט ב-Firebase:
אם עדיין לא עשיתם את זה, ודאו שהפרויקט שלכם משודרג ל-Firebase Authentication with Identity Platform. אימות SAML זמין רק בפרויקטים משודרגים.
במסוף Firebase, נכנסים לאבטחה > אימות.
בכרטיסייה שיטת התחברות, לוחצים על Add new provider ואז על SAML.
נותנים שם לספק. שימו לב למזהה הספק שנוצר, למשל
saml.example-provider. המזהה הזה נדרש כשמוסיפים קוד כניסה לאפליקציה.מציינים את מזהה הישות ב-SAML, את כתובת ה-URL של ה-SSO ואת האישור של המפתח הציבורי של ספק הזהויות. צריך גם לציין את מזהה הישות ב-SAML של האפליקציה (ספק השירות). הערכים האלה חייבים להיות זהים בדיוק לערכים שהספק הקצה לכם.
שומרים את השינויים.
אם עדיין לא עשיתם זאת, צריך לאשר את הדומיין של האפליקציה:
במסוף Firebase, נכנסים לכרטיסייה Security > Authentication > Settings.
בקטע Authorized domains, לוחצים על Add domain ומוסיפים את הדומיין.
טיפול בתהליך הכניסה באמצעות Firebase SDK
כדי לטפל בתהליך הכניסה באמצעות Firebase JavaScript SDK, מבצעים את הפעולות הבאות:
יוצרים מכונה של
SAMLAuthProviderבאמצעות מזהה הספק שקיבלתם במסוף Firebase.Web
import { SAMLAuthProvider } from "firebase/auth"; const provider = new SAMLAuthProvider('saml.example-provider');Web
var provider = new firebase.auth.SAMLAuthProvider('saml.example-provider'); ``
מאמתים באמצעות Firebase באמצעות האובייקט של ספק ה-SAML.
אתם יכולים להפנות את המשתמש לדף הכניסה של הספק או לפתוח את דף הכניסה בחלון קופץ בדפדפן.
תהליך ההפניה לכתובת אחרת
מפנים לדף הכניסה של הספק באמצעות קריאה ל-
signInWithRedirect():Web
import { getAuth, signInWithRedirect } from "firebase/auth"; const auth = getAuth(); signInWithRedirect(auth, provider);Web
firebase.auth().signInWithRedirect(provider);אחרי שהמשתמש משלים את הכניסה וחוזר לאפליקציה, אפשר לקבל את תוצאת הכניסה באמצעות קריאה ל-
getRedirectResult().Web
import { getAuth, getRedirectResult, SAMLAuthProvider } from "firebase/auth"; const auth = getAuth(); getRedirectResult(auth) .then((result) => { // User is signed in. // Provider data available using getAdditionalUserInfo() }) .catch((error) => { // Handle error. });Web
firebase.auth().getRedirectResult() .then((result) => { // User is signed in. // Provider data available in result.additionalUserInfo.profile, // or from the user's ID token obtained from result.user.getIdToken() // as an object in the firebase.sign_in_attributes custom claim. }) .catch((error) => { // Handle error. });תהליך בחלון קופץ
Web
import { getAuth, signInWithPopup, OAuthProvider } from "firebase/auth"; const auth = getAuth(); signInWithPopup(auth, provider) .then((result) => { // User is signed in. // Provider data available in result.additionalUserInfo.profile, // or from the user's ID token obtained from result.user.getIdToken() // as an object in the firebase.sign_in_attributes custom claim. }) .catch((error) => { // Handle error. });Web
firebase.auth().signInWithPopup(provider) .then((result) => { // User is signed in. // Provider data available in result.additionalUserInfo.profile, // or from the user's ID token obtained from result.user.getIdToken() // as an object in the firebase.sign_in_attributes custom claim. }) .catch((error) => { // Handle error. });הטוקן של המזהה והאובייקט UserInfo מכילים את כתובת האימייל של המשתמש רק אם היא צוינה במאפיין
NameIDשל טענת הנכוֹנוּת (assertion) של SAML מספק הזהויות:<Subject> <NameID Format="urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress">test@email.com</NameID> </Subject>הדוגמאות שלמעלה מתמקדות בתהליכי כניסה, אבל אפשר להשתמש באותו דפוס כדי לקשר ספק SAML למשתמש קיים באמצעות
linkWithRedirect()ו-linkWithPopup(), ולאמת מחדש משתמש באמצעותreauthenticateWithRedirect()ו-reauthenticateWithPopup(). אפשר להשתמש בזה כדי לאחזר פרטי כניסה חדשים לפעולות רגישות שדורשות כניסה מהזמן האחרון.