יצירת מזהי לקוח

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

Android

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

שימו לב: סיסמת ברירת המחדל של מאגר המפתחות לניפוי באגים היא android, והכינוי של המפתח הוא androiddebugkey. מיקום ברירת המחדל ב-Linux וב-macOS הוא ~/.android/debug.keystore.

  1. אם עדיין אין לכם מפתח, צריך ליצור מפתח ניפוי באגים או מפתח הפצה לאפליקציה ל-Android. אם משתמשים ב-Android Studio, המערכת יוצרת באופן אוטומטי מפתח ניפוי באגים במאגר המפתחות לניפוי באגים בפעם הראשונה שיוצרים פרויקט Android.
  2. בחלון מסוף של Linux או macOS, אפשר לקבל את טביעת האצבע של המפתח באמצעות keytool שכלול ב-Java SDK באופן הבא: 
    keytool -exportcert -alias androiddebugkey -keystore path-to-debug-or-production-keystore -list -v
     הפלט יציג טביעת אצבע שדומה לזו: DA:39:A3:EE:5E:6B:4B:0D:32:55:BF:EF:95:60:18:90:AF:D8:07:09
  3. מעתיקים ושומרים את טביעת האצבע של המפתח שמוצגת אחרי שמריצים את הפקודה keytool שלמעלה. צריך לספק את טביעת האצבע כדי ליצור את מספר הלקוח ל-Android ב Google Cloud מסוף.
  4. נכנסים לדף Credentials במסוף Google Cloud .

    לדף Credentials

  5. ברשימת הפרויקטים, בוחרים את הפרויקט שמכיל את ה-API.
  6. אם זו הפעם הראשונה שאתם יוצרים מזהה לקוח בפרויקט הזה, פועלים לפי שלבי המשנה כדי לעבור לדף הסכמה ל-OAuth. אחרת, מדלגים לשלב הבא.
    1. לוחצים על מסך הסכמה ל-OAuth.
    2. מזינים שם בשדה שם האפליקציה.
    3. ממלאים את שאר השדות לפי הצורך.
    4. לוחצים על Save.
  7. ברשימה הנפתחת Create credentials, בוחרים באפשרות OAuth client ID.
  8. בוחרים באפשרות Android כסוג האפליקציה.
  9. בשדה Name (שם), מזינים שם למזהה הלקוח.
  10. בקטע Signing-certificate fingerprint, מזינים את טביעת האצבע שקיבלתם קודם.
  11. בשדה שם החבילה, מזינים את שם החבילה של האפליקציה ל-Android, כפי שמופיע בקובץ AndroidManifest.xml.
  12. לוחצים על יצירה.

    משתמשים במזהה הלקוח שנוצר בקצה העורפי של ה-API ובאפליקציית הלקוח.

לקוח אינטרנט

  1. נכנסים לדף Credentials במסוף Google Cloud .

    לדף Credentials

  2. ברשימת הפרויקטים, בוחרים את הפרויקט שמכיל את ה-API.
  3. אם זו הפעם הראשונה שאתם יוצרים מזהה לקוח בפרויקט הזה, פועלים לפי שלבי המשנה כדי לעבור לדף הסכמה ל-OAuth. אחרת, מדלגים לשלב הבא.
    1. לוחצים על מסך הסכמה ל-OAuth.
    2. מזינים שם בשדה שם האפליקציה.
    3. ממלאים את שאר השדות לפי הצורך.
    4. לוחצים על Save.
  4. ברשימה הנפתחת Create credentials, בוחרים באפשרות OAuth client ID.
  5. בוחרים באפשרות Web application (אפליקציית אינטרנט) כסוג האפליקציה.
  6. בשדה Name (שם), מזינים שם למזהה הלקוח.
  7. בשדה מקורות מורשים של JavaScript, מזינים אחת מהאפשרויות הבאות:
    • http://localhost:8080 אם אתם בודקים את ה-backend באופן מקומי.

    • https://YOUR_PROJECT_ID.appspot.com, מחליפים את YOUR_PROJECT_ID במזהה הפרויקט של App Engine אם פורסים את ה-API של השרת העורפי ב-App Engine בסביבת הייצור.

  8. לוחצים על יצירה.

    משתמשים במזהה הלקוח שנוצר בקצה העורפי של ה-API ובאפליקציית הלקוח.

המאמרים הבאים

מידע על תמיכה באימות באפליקציית Android או JavaScript זמין במאמרים הבאים: