במאי 2016 פרסמנו את הגרסה החדשה ביותר של ערכת הכלים של Google Identity כ- Firebase Authentication ובאפריל 2019 פרסמנו את פלטפורמת הזהות של Google Cloud . מוצרים אלה כוללים SDK לקוח משודרג, ספריות ממשק משתמש פתוח, ניהול הפעלות ושירות שליחת דוא"ל משולב לזרימת סיסמאות שנשכחו.

ב- 30 ביוני 2020 , ה- SDK שתועדו בדף זה ועמוד הגדרת ה- API יפסיקו לפעול. (נקודות הקצה https://identitytoolkit.googleapis.com/... ו- https://securetoken.googleapis.com/... , המשמשות את פלטפורמת הזהות ואימות Firebase, ימשיכו לתפקד.)

להעברת פרויקט קיים מערכת הכלים לזהות, עיין במדריך ההעברה של פלטפורמת הזהות או במדריך העברת האימות של Firebase .

מעבר מ-Google Identity Toolkit ל-Google Cloud Identity Platform

הגרסה החדשה של Google Identity Toolkit הושקה כ-Identity Platform ו-Firebase Authentication. מעכשיו, הפיצ'ר 'תכונות זהות' יוקפא. כל פיתוח חדש של התכונות יתבצע ב-Id Platform Platform ובאימות Firebase. אנחנו ממליצים למפתחים של ערכת כלים למעבר לפלטפורמות האלה ברגע שבו הן מעשיות באפליקציות שלהם.

תכונות חדשות

כבר קיים שיפור משמעותי בתכונות ב-Id Platform ב-Google Identity Toolkit:

  • מסוף Admin החדש

    ל-Identity Platform יש מסוף מפתחים חדש שמאפשר לך להציג, לשנות ולמחוק משתמשים, וכך לנפות באגים בתהליכי הכניסה וההרשמה. המסוף מאפשר גם להגדיר שיטות אימות ולהתאים אישית את תבניות האימייל.

  • שיטות אימות חדשות

    פלטפורמת Identity תומכת בסטנדרטים של פדרציה ארגונית, כמו SAML ו-OIDC, ומאפשרת לכם להרחיב אפליקציות ושירותים של SaaS. פלטפורמת Identity מציעה גם תמיכה בספקים כמו GitHub, Microsoft, Yahoo ועוד. תוכלו להשתמש בכניסה אנונימית כדי ליצור מזהה משתמש ייחודי, בלי שהמשתמש יצטרך לעבור תהליך כניסה או תהליך הרשמה. כך תוכלו לבצע קריאות ל-API מאומתות בדיוק כמו עם משתמש רגיל. כשהמשתמש מחליט להירשם לחשבון, כל הפעילות נשמרת עם אותו מזהה משתמש. זה חשוב בתרחישים כמו עגלות קניות בצד השרת או אפליקציות אחרות שבהן אתם רוצים לעודד את המשתמשים לפני שליחתם דרך תהליך הרשמה.

  • התאמה לעומס (scale) בצורה מאובטחת עם הסכמי רמת שירות ותמיכת Cloud

    פלטפורמת Identity מבוססת על תשתית Google אמינה, ומספקת הסכמי רמת שירות ותמיכה ב-Google Cloud. פירוש הדבר הוא שאתם יכולים להרחיב את השירות בביטחון, להסתמך על Google כדי לספק את הגמישות, הזמינות והיכולת להתאמה לפי הצורך.

  • גישה לכל Firebase

    Firebase הוא פלטפורמה לניידים שעוזרת לך לפתח במהירות אפליקציות באיכות גבוהה, להגדיל את בסיס המשתמשים ולהרוויח יותר כסף. Firebase כולל תכונות משתלבות שאפשר לשלב ולהתאים אותן לצרכים שלכם, כולל תשתית שכוללת ניתוח נתונים לנייד, העברת הודעות בענן, מסד נתונים בזמן אמת, אחסון קבצים, אירוח סטטי, תצורה מרחוק, דיווח על קריסות ו-Android .

  • ממשקי משתמש מעודכנים

    שיפרנו לחלוטין את תהליכי העבודה של המשתמש בממשק המשתמש של Google. התהליך הזה כולל שחזור סיסמה, קישור חשבונות, תהליך לבחירת חשבון חדש/קיים, בדרך כלל לוקח הרבה זמן לקוד ולנפות באגים. היא משלבת את Smart Lock לסיסמאות ב-Android, מה ששיפר באופן משמעותי את הכניסה ואת תהליך ההרשמה לאפליקציות המשתתפות. היא תומכת גם בשינויים קלים בעיצוב כדי שיתאימו לאפליקציה, ולצורך התאמה אישית מקסימלית, גרסאות ה-Android ו-iOS מבוססות על קוד פתוח.

  • הגדרת שרת פשוטה יותר

    ב-ערכת הכלים לאימות (IDV), ראינו שמפתחים רבים בחרו שלא להטמיע את תהליך שחזור האימייל. פעולה זו איפשרה למשתמשים שלהם לשחזר את החשבונות שלהם במקרה ששכחו את הסיסמה. פלטפורמת Identity יכולה לשלוח למשתמשים אימות של כתובת האימייל, איפוס הסיסמה ושינוי סיסמה. כמו כן, ניתן להתאים אישית בקלות את הטקסט של המשתמשים. בנוסף, אין צורך יותר לארח את הווידג'טים של ממשק המשתמש לאירוח הפניות מחדש ולהשלמה של פעולות שינוי סיסמה.

  • ערכות SDK חדשות

    כל ממשקי ה-API של שרתי Toolkit של Identity זמינים עכשיו בנפרד בכל אחת מספריות הלקוחות שלנו (Android , iOS או אינטרנט). המפתחים יוכלו להיכנס ולהירשם למשתמשים חדשים וקיימים, לגשת למאפייני משתמשים, לקשר, לעדכן ולמחוק חשבונות, לאפס סיסמאות ועוד – בלי לקשר לממשק משתמש קבוע. אם תעדיפו, תוכלו ליצור בעצמכם זרימת כניסה וחוויה משלכם באמצעות ה-API הזה.

  • ניהול סשנים באפליקציות לנייד

    עם Identity Toolkit, אפליקציות יצרו מצב סשן משלהן על סמך אירוע האימות הראשוני מ-Id Toolkit. ב-Identity Platform נעשה שימוש בשירות לקצה העורפי שנלקח ממנו אסימון רענון, שנכרת מאירוע האימות ומחליף אותו באסימונים לגישה במשך שעה ל-Android, ל-iOS ול-JavaScript. כשהמשתמשים משנים את הסיסמה שלהם, אסימוני רענון לא יוכלו יותר ליצור אסימוני גישה חדשים. פעולה זו תשבית את הגישה עד שהמשתמש יבצע אימות מחדש במכשיר הזה.

הבדלי תכונות

חלק מהתכונות של ערכת הכלים של Identity לא זמינות כרגע בפלטפורמת Identity, ואילו תכונות אחרות עוצבו מחדש ועובדות בצורה שונה. אתם יכולים לבחור לא להעביר את האפליקציה באופן מיידי אם התכונות האלה חשובות לאפליקציה שלכם. במקרים רבים, יכול להיות שהתכונות האלה לא חשובות עבור האפליקציה שלכם, או שיש כשלים קלים ביישום.

הבדלים בצד השרת

שירות הליבה של ערכת הזהויות עם ממשקי ה-API ל-REST, לוגיקת אימות החשבון ומסד הנתונים הראשי של המשתמשים עברו רק עדכונים קלים. עם זאת, חלק מהתכונות ואופן השילוב של Identity Identity בשירות השתנו.

  • ספקי זהות

    PayPal ו-AOL אינם נתמכים. משתמשים עם חשבונות של ספקי הזהויות האלה עדיין יכולים להיכנס לאפליקציה שלכם באמצעות תהליך שחזור הסיסמה ולהגדיר סיסמה לחשבון שלהם.

  • ספריות שרתים

    כרגע יש ערכות SDK למנהלי מערכת שזמינות ל-Java, Node.js, Python, Go ו-C#.

  • אימיילים של ניהול החשבון

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

  • אישור שינוי של כתובת אימייל

    כשמשתמשים ב-Identity Toolkit, כשמשתמש מחליט לשנות את כתובת האימייל שלו, הוא שולח אימייל לכתובת החדשה שיש בה קישור להמשך התהליך.

    Firebase מאשר את שינוי כתובת האימייל על ידי שליחת אימייל לביטול לכתובת האימייל הישנה עם קישור לביטול השינוי.

  • השקה של IDP

    הייתה אפשרות להוסיף בהדרגה את Identity Identity למערכת הכניסה שלך, כדי לערוך ניסויים בהשפעה של הבקשות שלך לתמיכה. התכונה הזו הוסרה באמצעות האימות ב-Firebase.

הבדלים בצד הלקוח

בפלטפורמת Identity, התכונות שסופקו על ידי Google Identity Toolkit מחולקות לשני רכיבים:

  • ערכות SDK של לקוחות ושרתים

    בפלטפורמת Identity, הפונקציונליות שסופקה על ידי Identity Toolkit's REST API נאספה לערכות SDK של לקוחות שזמינות ל-Android, ל-iOS ול-JavaScript. תוכלו להשתמש ב-SDK כדי להיכנס ולרשום משתמשים, לגשת לפרטי פרופיל המשתמש, לקשר, לעדכן ולמחוק חשבונות, ולאפס סיסמאות באמצעות SDK של הלקוח במקום לתקשר עם שירות הקצה באמצעות קריאות REST.

  • ווידג'ט ממשק משתמש

    כל תהליכי המשתמש שמנהלים את הכניסה, ההרשמה, שחזור הסיסמה וקישור החשבונות נבנו מחדש באמצעות ערכות ה-SDK של הלקוח, והן ארוזות כווידג'ט התחברות. הם זמינים כערכות SDK בקוד פתוח עבור iOS, Android ו-Web, ומאפשרים התאמה אישית מלאה של הזרימה בדרכים שלא ניתן לבצע באמצעות Identity Identity Toolkit.

הבדלים נוספים כוללים:

  • ביקורים ומיגרציה

    מכיוון שהסשנים מנוהלים בצורה שונה ב-Identity וב-Identity Platform, המשתמשים והסשנים הקיימים יפסיקו לעבור את השדרוג ל-SDK, והמשתמשים יצטרכו להיכנס שוב לחשבון.

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

כדי לעבור מ- Identity Toolkit ל-Id Platform, צריך:

  1. פותחים את Cloud Console ובוחרים את הפרויקט שלכם ב-Identity Toolkit.

  2. מה-Marketplace, מעיינים אל Identity Platform ובוחרים באפשרות 'Enable Identity Platform'

  3. פותחים את הדף חשבונות שירות. כאן תוכלו לראות את חשבון השירות שהגדרתם בעבר ל-Id Toolkit.

  4. לצד חשבון השירות, לחצו על > יצירת מפתח. לאחר מכן, בתיבת הדו-שיח יצירת מפתח פרטי, מגדירים את סוג המפתח כ-JSON ולוחצים על יצירה. המערכת תוריד עבורכם קובץ JSON שכולל את פרטי הכניסה לחשבון השירות. יהיה עליך להפעיל את ה-SDK בשלב הבא.

  5. חוזרים אל Cloud Console. בקטע 'ספקים', בשיטת הכניסה 'Email/Password' , פותחים את הדף תבניות אימייל. לאחר מכן תוכלו להתאים אישית את תבניות האפליקציה.

    כשמשתמשים ב-Identity Toolkit, כשמשתמשים מאפסים סיסמאות, משנים את כתובות האימייל שלהם או מאמתים את כתובות האימייל שלהם, צריך לקבל קוד OOB מהשרת של Identity Identity, ואז לשלוח את הקוד למשתמשים באימייל. Cloud Identity שולח הודעות אימייל בהתאם לתבניות שהגדרתם, בלי שתצטרכו לבצע פעולות נוספות.

  6. אופציונלי: אם אתם צריכים לגשת לשירותי Identity Platform בשרת שלכם, צריך להתקין את Firebase SDK.

    1. ניתן להתקין את ה-Admin SDK של Node.js באמצעות npm:

      $ npm init
      $ npm install --save firebase-admin
      
    2. בקוד, אפשר לגשת ל-Firebase באמצעות:

      var admin = require('firebase-admin');
      var app = admin.initializeApp({
        credential: admin.credential.cert('path/to/serviceAccountCredentials.json')
      });
      

לאחר מכן, משלימים את שלבי ההעברה לפלטפורמה של האפליקציה: Android, iOS, אינטרנט.

שרתים ו-JavaScript

השינויים הבולטים

יש כמה הבדלים נוספים בהטמעה של Cloud Identity Platform מ-Id Toolkit.

  • ניהול סשנים באינטרנט

    בעבר, כשמשתמש אומת באמצעות הווידג'ט של ערכת הזהויות, הוגדר קובץ cookie עבור המשתמש ששימש לסריקת הסשן באתר. קובץ ה-cookie הזה פעל במשך שבועיים ונעזר בו כדי לאפשר למשתמש להשתמש בווידג'ט של ניהול החשבון כדי לשנות את הסיסמה ואת כתובת האימייל. חלק מהאתרים השתמשו בקובץ ה-cookie הזה כדי לאמת את כל שאר בקשות הדפים באתר. אתרים אחרים השתמשו בקובץ ה-cookie כדי ליצור קובצי cookie משלהם באמצעות מערכת ניהול קובצי ה-cookie שלהם.

    עכשיו, ערכות ה-SDK ללקוחות של Identity Platform מנהלות אסימונים מזהים ופועלת עם הקצה העורפי של Identity Platforms כדי לשמור על עדכניות הסשן. התוקף של הקצה העורפי פג אם מתרחשים שינויים חשובים בחשבון (כמו שינויים בסיסמאות של משתמשים). אסימוני מזהה לא מוגדרים באופן אוטומטי כקובצי cookie בלקוח האינטרנט, ויש להם משך חיים של שעה אחת בלבד. אם אתם לא רוצים שסשן של שעה יסתיים, אתם לא יכולים להשתמש באסימונים לאימות קובצי ה-cookie כדי לאמת את כל הבקשות לדפים. במקום זאת תצטרכו להגדיר האזנה עבור התחברות לחשבון של המשתמש, לקבל את אסימון המזהה, לאמת את האסימון וליצור קובץ Cookie משלכם באמצעות מערכת ניהול קובצי ה-cookie של ה-framework.

    תצטרכו להגדיר את משך החיים של קובץ ה-cookie בהתאם לצורכי האבטחה של האפליקציה.

  • תהליך הכניסה לאינטרנט

    בעבר, משתמשים הופנו אל accountchooser.com כשהכניסה בוצעה כדי להבין באיזה מזהה המשתמש רוצה להשתמש. תהליך Cloud Identity בממשק המשתמש מתחיל עכשיו עם רשימה של שיטות כניסה, כולל אפשרות שליחת אימייל לכתובת accountchooser.com עבור אינטרנט ומשתמשת ב-hintRequest API ב-Android. בנוסף, אין יותר צורך בכתובות אימייל בממשק המשתמש. כך יהיה קל יותר לתמוך במשתמשים אנונימיים, במשתמשי אימות מותאמים אישית או בספקים של כתובות אימייל שלא נדרשות לצורך כך.

  • ווידג'ט לניהול החשבון

    הווידג'ט הזה מספק ממשק משתמש שבו המשתמשים יכולים לשנות כתובות אימייל, לשנות סיסמאות או לבטל את הקישור בין החשבונות שלהם לספקי זהות. היא נמצאת כרגע בפיתוח.

  • לחצן/ווידג'ט של כניסה

    כבר לא מוצגים ווידג'טים כמו לחצן הכניסה וכרטיס המשתמש. ניתן לבנות אותם בקלות באמצעות ממשק ה-API לאימות של Firebase.

  • NoSignOutUrl

    עליך להתקשר אל firebase.auth.signOut() ולטפל בשיחה החוזרת.

  • No oobActionUrl

    מעכשיו צריך לשלוח אימיילים באמצעות פלטפורמת Identity, והיא מוגדרת במסוף Firebase.

  • התאמה אישית של CSS

    הווידג'ט של ממשק המשתמש מבוסס על עיצוב של Material Design Lite, שמוסיף באופן דינמי אנימציות בעיצוב חדשני תלת-ממדי.

שלב 1: משנים את קוד השרת

  1. אם השרת שלכם מסתמך על אסימון ערכת הכלים של Identity (תקף לשבועיים) לניהול סשנים של משתמשים באינטרנט, תצטרכו להמיר את השרת לשימוש בקובץ cookie משלו לסשן.

    1. מטמיעים נקודת קצה לאימות אסימון המזהה ומגדירים את קובץ ה-Cookie של הסשן עבור המשתמש. אפליקציית הלקוח שולחת את האסימון של Firebase לנקודת הקצה הזו.
    2. אם הבקשה הנכנסת מכילה קובץ cookie משלכם, תוכלו לבדוק את הסטטוס של המשתמש המאומת. אחרת, יש להתייחס לבקשה ללא אימות.
    3. אם אתם לא רוצים שהמשתמשים שלכם יאבדו את הסשנים הקיימים שלהם, עליכם להמתין שבועיים עד שפג התוקף של כל האסימונים של Identity Toolkit, או לבצע אימות דו-שלבי של אפליקציית האינטרנט כפי שמתואר בהמשך בשלב 3.
  2. בהמשך, מכיוון שהאסימונים של המזהה שונים מהאסימונים של ערכת הכלים לאימות, עליכם לעדכן את לוגיקת אימות האסימון. מתקינים לשרת את Admin SDK, או אם משתמשים בשפה שלא נתמכת על ידי Admin SDK, מורידים ספריית אימות של אסימון JWT לסביבה שלכם ומאמתים את האסימון בצורה נכונה.

  3. כשתבצעו את העדכונים הראשונים, יכול להיות שעדיין יהיו לכם נתיבי קוד שמבוססים על אסימונים של Identity Toolkit. אם יש לכם אפליקציות ל-iOS או ל-Android, כדי שנתיבי הקוד החדשים יפעלו, המשתמשים יצטרכו לשדרג לגרסה החדשה של האפליקציה. אם אתם לא רוצים לאלץ את המשתמשים לעדכן את האפליקציה, אתם יכולים להוסיף לוגיקה נוספת של אימות שרת שבודקת את האסימון, ולקבוע אם צריך להשתמש ב-Firebase SDK או ב-SDK Toolkit SDK כדי לאמת את האסימון. אם יש לכם רק אפליקציית אינטרנט, כל בקשות האימות החדשות יועברו לפלטפורמת הזהויות, ולכן תצטרכו להשתמש רק בשיטות האימות של אסימון הזיהוי.

יש לעיין בחומר העזר בנושא Web API.

שלב 2: מעדכנים את קוד ה-HTML

  1. מוסיפים את קוד האתחול לאפליקציה:

    1. פותחים את הפרויקט ב-Cloud Console.
    2. בדף ספקים, לוחצים על פרטי הגדרת אפליקציה. יוצג קטע קוד שמפעיל את Identity Identity.
    3. מעתיקים ומדביקים את קטע הקוד של תהליך האתחול לדף האינטרנט.
  2. מוסיפים ווידג'ט אימות לאפליקציה:

    <script src="https://www.gstatic.com/firebasejs/ui/live/0.4/firebase-ui-auth.js"></script>
    <link type="text/css" rel="stylesheet" href="https://www.gstatic.com/firebasejs/ui/live/0.4/firebase-ui-auth.css" />
    <!-- *******************************************************************************************
       * TODO(DEVELOPER): Paste the initialization snippet from:
       * Firebase Console > Overview > Add Firebase to your web app. *
       ***************************************************************************************** -->
    <script type="text/javascript">
      // FirebaseUI config.
      var uiConfig = {
        'signInSuccessUrl': '<url-to-redirect-to-on-success>',
        'signInOptions': [
          // Leave the lines as is for the providers you want to offer your users.
          firebase.auth.GoogleAuthProvider.PROVIDER_ID,
          firebase.auth.FacebookAuthProvider.PROVIDER_ID,
          firebase.auth.TwitterAuthProvider.PROVIDER_ID,
          firebase.auth.GithubAuthProvider.PROVIDER_ID,
          firebase.auth.EmailAuthProvider.PROVIDER_ID
        ],
        // Terms of service url.
        'tosUrl': '<your-tos-url>',
      };
    
      // Initialize the FirebaseUI Widget using Firebase.
      var ui = new firebaseui.auth.AuthUI(firebase.auth());
      // The start method will wait until the DOM is loaded.
      ui.start('#firebaseui-auth-container', uiConfig);
    </script>
    
  3. יש להסיר את SDK SDK SDK מהאפליקציה.

  4. אם הסתמכת על אסימון של מזהה ערכת כלים לניהול סשן, עליך לבצע את השינויים הבאים בצד הלקוח:

    1. אחרי שנכנסים בהצלחה ל-Identity Platform, מקבלים אסימון מזהה ב-firebase.auth().currentUser.getToken().

    2. שולחים את אסימון המזהה לשרת הקצה העורפי, מאמתים אותו ומנפיקים קובץ cookie משלכם של הסשן.

      אין להסתמך רק על קובץ ה-cookie של ההפעלה בעת ביצוע פעולות רגישות או שליחת בקשות עריכה מאומתות לשרת. תצטרכו לספק הגנה נוספת מפני זיוף של בקשות בין אתרים (CSRF).

      אם המסגרת שלכם לא מספקת הגנה על CSRF, אחת הדרכים למנוע מתקפה היא לקבל אסימון מזהה עבור המשתמש המחובר באמצעות getToken(), ולכלול את האסימון בכל בקשה (קובץ ה-cookie של הסשן יישלח גם הוא כברירת מחדל). לאחר מכן, יהיה עליכם לאמת את האסימון באמצעות ה-Admin SDK, בנוסף לבדיקת קובצי ה-cookie בסשן, אשר הושלמה במסגרת הקצה העורפי. בעקבות זאת, יהיה קשה יותר למתקפות של CSRF, כי אסימון המזהה מאוחסן רק באחסון באינטרנט ואף פעם לא בקובץ cookie.

    3. האסימונים של ערכת הכלים לאימות הזהות תקפים למשך שבועיים. יכול להיות שתרצו להמשיך להנפיק אסימונים במשך שבועיים, או שתרצו להאריך אותם או לקצר אותם בהתאם לדרישות האבטחה של האפליקציה. כשמשתמש יוצא מהחשבון, נקו את קובץ ה-cookie המשויך לסשן.

שלב 3: עדכון כתובות URL להפניה אוטומטית ל-IDP

  1. ב-Cloud Console, פותחים את הקטע ספקים.

  2. עבור כל ספק כניסה מאוחד שבו אתם תומכים, יש לבצע את הפעולות הבאות:

    1. לוחצים על השם של ספק הכניסה.
    2. מעתיקים את ה-URI של ההפניה האוטומטית ל-OAuth.
    3. במסוף המפתחים של ספק הכניסה, מעדכנים את ה-URI של ההפניה האוטומטית מסוג OAuth.

Android

שלב 1: הוספת פלטפורמת Identity לאפליקציה באמצעות Firebase

  1. פותחים את Cloud Console ובוחרים את הפרויקט של Toolkit הזה.

  2. בדף 'ספקים' לוחצים על פרטי הגדרת האפליקציה, בוחרים בכרטיסייה Android ולאחר מכן לוחצים על תחילת העבודה ב-Firebase. בתיבת הדו-שיח 'הוספת Firebase', ציינו את שם החבילה של האפליקציה שלכם ואת טביעת האצבע של אישור החתימה, ולחצו על הוספת אפליקציה. לאחר מכן, ההורדה של קובץ התצורה google-services.json מתבצעת למחשב.

  3. מעתיקים את קובץ התצורה לספריית הבסיס של מודול האפליקציה ל-Android. קובץ התצורה מכיל את פרטי הפרויקט ולקוח Google OAuth.

  4. בקובץ build.gradle ברמת הפרויקט (<var>your-project</var>/build.gradle), לציין את שם החבילה של האפליקציה שלך בקטע defaultConfig:

    defaultConfig {
       …..
      applicationId "com.your-app"
    }
    
  5. בנוסף, בקובץ build.gradle ברמת הפרויקט, יש להוסיף תלות שכוללת את הפלאגין של google-services:

    buildscript {
     dependencies {
       // Add this line
       classpath 'com.google.gms:google-services:3.0.0'
     }
    }
    
  6. בקובץ build.gradleשל האפליקציה שלך ברמת האפליקציה (<var>my-project</var>/<var>app-module</var>/build.gradle), יש להוסיף את השורה הבאה אחרי הפלאגין ל-Android Gradle כדי להפעיל את הפלאגין google-services:

    apply plugin: 'com.android.application'
    // Add this line
    apply plugin: 'com.google.gms.google-services'
    

    הפלאגין של google-services משתמש בקובץ google-services.json להגדרת האפליקציה שלכם לשימוש ב-Firebase

  7. בקובץ build.gradle ברמת האפליקציה, מוסיפים גם את תלות האימות של Firebase:

    compile 'com.google.firebase:firebase-auth:21.0.7'
    compile 'com.google.android.gms:play-services-auth:20.2.0'
    

שלב 2: מסירים את SDK Toolkit SDK

  1. מסירים את ההגדרה של Toolkit Identity מהקובץ AndroidManifest.xml. המידע הזה כלול בקובץ google-service.json ונטען באמצעות הפלאגין google-services.
  2. יש להסיר את SDK SDK SDK מהאפליקציה.

שלב 3: הוספת FirebaseUI לאפליקציה

  1. מוסיפים לאפליקציה את ההרשאה FirebaseUI.

  2. באפליקציה, מחליפים את השיחות ל-SDK Toolkit SDK ב-FirebaseUI.

iOS

שלב 1: הוספת Firebase לאפליקציה

  1. כדי להוסיף לאפליקציה את ה-SDK של הלקוח, מריצים את הפקודות הבאות:

    $ cd your-project directory
    $ pod init
    $ pod 'Firebase'
    
  2. פותחים את Cloud Console ובוחרים את הפרויקט של Toolkit הזה.

  3. בדף 'ספקים', לוחצים על פרטי הגדרת האפליקציה, בוחרים בכרטיסייה iOS ולאחר מכן לוחצים על תחילת העבודה ב-Firebase. בתיבת הדו-שיח 'הוספת Firebase', מספקים את שם החבילה של האפליקציה ואת טביעת האצבע של אישור החתימה ולוחצים על הוספת אפליקציה. לאחר מכן, מתבצעת הורדה למחשב של קובץ התצורה של google-services.json. בתיבת הדו-שיח 'הוספת Firebase', מספקים את מזהה החבילה ומזהה האפליקציה ב-App Store, ולאחר מכן לוחצים על Add App (הוספת אפליקציה). לאחר מכן, מתבצעת הורדה של קובץ התצורה של GoogleService-Info.plist למחשב. אם לפרויקט שלכם יש כמה מזהי חבילות, צריך לחבר כל מזהה חבילה במסוף Firebase כדי שיהיה לו קובץ GoogleService-Info.plist משלו.

  4. מעתיקים את קובץ התצורה לרמה הבסיסית (root) של פרויקט Xcode ומוסיפים אותו לכל יעדי הטרגוט.

שלב 2: מסירים את SDK Toolkit SDK

  1. מסירים את GoogleIdentityToolkit מקובץ ה-Podfile של האפליקציה.
  2. מריצים את הפקודה pod install.

שלב 3: הוספת FirebaseUI לאפליקציה

  1. מוסיפים לאפליקציה את ההרשאה FirebaseUI.

  2. באפליקציה, מחליפים את השיחות ל-SDK Toolkit SDK ב-FirebaseUI.