אימות באמצעות SAML באפליקציות אינטרנט

אם שדרגתם ל-Firebase Authentication with Identity Platform, אתם יכולים לאמת את המשתמשים שלכם ב-Firebase באמצעות ספק זהויות SAML לבחירתכם. כך אפשר להשתמש בפתרון ה-SSO מבוסס ה-SAML כדי להכניס משתמשים לאפליקציית Firebase.

‫Firebase Authentication תומכת רק בתהליך SAML שיוזם ספק השירות.

לפני שמתחילים

כדי להכניס משתמשים באמצעות ספק זהויות SAML, קודם צריך לאסוף מידע מהספק:

  • מזהה הישות ב-SAML של הספק: URI שמזהה את ספק הזהויות.
  • כתובת ה-URL של ה-SSO ב-SAML של הספק: כתובת ה-URL של דף הכניסה של ספק הזהויות.
  • אישור של מפתח ציבורי של הספק: האישור שמשמש לאימות טוקנים שנחתמו על ידי ספק הזהויות.
  • מזהה הישות של האפליקציה: מזהה URI שמזהה את האפליקציה, "ספק השירות".

אחרי שקיבלתם את המידע שלמעלה, אתם יכולים להפעיל את SAML כספק כניסה לפרויקט ב-Firebase:

  1. מוסיפים את Firebase לפרויקט ב-JavaScript.

  2. אם עדיין לא עשיתם את זה, ודאו שהפרויקט שלכם משודרג ל-Firebase Authentication with Identity Platform. אימות SAML זמין רק בפרויקטים משודרגים.

  3. במסוף Firebase, נכנסים לאבטחה > אימות.

  4. בכרטיסייה שיטת התחברות, לוחצים על Add new provider ואז על SAML.

  5. נותנים שם לספק. שימו לב למזהה הספק שנוצר, למשל saml.example-provider. המזהה הזה נדרש כשמוסיפים קוד כניסה לאפליקציה.

  6. מציינים את מזהה הישות ב-SAML, את כתובת ה-URL של ה-SSO ואת האישור של המפתח הציבורי של ספק הזהויות. צריך גם לציין את מזהה הישות ב-SAML של האפליקציה (ספק השירות). הערכים האלה חייבים להיות זהים בדיוק לערכים שהספק הקצה לכם.

  7. שומרים את השינויים.

  8. אם עדיין לא עשיתם זאת, צריך לאשר את הדומיין של האפליקציה:

    1. במסוף Firebase, נכנסים לכרטיסייה Security ‏> Authentication ‏> Settings.

    2. בקטע Authorized domains, לוחצים על Add domain ומוסיפים את הדומיין.

טיפול בתהליך הכניסה באמצעות Firebase SDK

כדי לטפל בתהליך הכניסה באמצעות Firebase JavaScript SDK, מבצעים את הפעולות הבאות:

  1. יוצרים מכונה של 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');
    ``
    
  1. מאמתים באמצעות 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>
    
  2. הדוגמאות שלמעלה מתמקדות בתהליכי כניסה, אבל אפשר להשתמש באותו דפוס כדי לקשר ספק SAML למשתמש קיים באמצעות linkWithRedirect() ו-linkWithPopup(), ולאמת מחדש משתמש באמצעות reauthenticateWithRedirect() ו-reauthenticateWithPopup(). אפשר להשתמש בזה כדי לאחזר פרטי כניסה חדשים לפעולות רגישות שדורשות כניסה מהזמן האחרון.