יצירת לקוח OAuth ופרטי כניסה למופע Looker (Google Cloud core)

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

מתי צריך ליצור פרטי כניסה ל-OAuth

ברוב המקרים, Looker (Google Cloud core) יוצר ומקצה באופן אוטומטי פרטי כניסה ל-OAuth שמנוהלים על ידי Looker כברירת מחדל. צריך ליצור לקוח OAuth ולשייך באופן ידני פרטי כניסה מותאמים אישית של OAuth רק בתרחישים ספציפיים, בהתאם לסוג החיבור לרשת ולהגדרת האימות של המכונה:

  • חיבורים פרטיים או היברידיים עם Google OAuth: חובה להגדיר את OAuth באופן ידני בכל פעם שמשתמשים ב-Google OAuth (כאימות ראשי או משני) עם חיבורים פרטיים או היברידיים.
  • חיבורים ציבוריים עם Google OAuth: אם יוצרים את המכונה במסוףGoogle Cloud , לא צריך להגדיר את OAuth באופן ידני כי Looker (Google Cloud core) מקצה באופן אוטומטי פרטי כניסה שמנוהלים על ידי Looker כברירת מחדל, אבל אפשר גם להגדיר פרטי כניסה בהתאמה אישית. אם יוצרים את המכונה באמצעות Google Cloud CLI, צריך לספק פרטי כניסה ל-OAuth.
  • רק באיחוד שירותי אימות הזהות של כוח העבודה: לא צריך להגדיר ידנית את OAuth בכל סוג של חיבור לרשת כשמשתמשים באיחוד שירותי אימות הזהות של כוח העבודה בלי Google OAuth משני.
  • דומיינים בהתאמה אישית: אם מגדירים דומיין בהתאמה אישית למכונה שמשתמשת בחיבורים מאובטחים ציבוריים וב-Google OAuth, צריך פרטי כניסה מותאמים אישית ל-OAuth, והם מוגדרים כחלק מתהליך היצירה של הדומיין בהתאמה אישית.

בטבלה הבאה מפורט מתי נדרשת הגדרה ידנית של פרטי כניסה ב-OAuth:

אימות ראשי אימות משני סוג החיבור לרשת הגדרה ידנית של OAuth
Google OAuth ללא חיבורים מאובטחים שגלויים לכולם לא נדרש אם משתמשים במסוף Google Cloud , כי Looker (Google Cloud core)‎ מקצה באופן אוטומטי פרטי כניסה שמנוהלים על ידי Looker. נדרש אם משתמשים ב-CLI של gcloud.
חיבורים פרטיים או חיבורים היברידיים חובה. פועלים לפי ההוראות שבדף הזה.
איחוד שירותי אימות הזהות של כוח עבודה ללא חיבורים שגלויים לכולם לא נדרשת.
איחוד שירותי אימות הזהות של כוח עבודה Google OAuth חיבורים מאובטחים שגלויים לכולם אופציונלי אם משתמשים במסוף Google Cloud . כברירת מחדל, ב-Looker (Google Cloud core) נעשה שימוש בפרטי כניסה שמנוהלים על ידי Looker, אבל אתם יכולים לספק פרטי כניסה בהתאמה אישית. נדרש אם משתמשים ב-CLI של gcloud.

התפקידים הנדרשים

כדי להשתמש במסוף Google Cloud ליצירה ולעריכה של פרטי כניסה ל-OAuth, אתם צריכים את ההרשאות הבאות. (כדי להסתיר את רשימת ההרשאות, מכווצים את הקטע Required permissions).

ההרשאות הנדרשות

  • clientauthconfig.*‎
    • clientauthconfig.brands.create
    • clientauthconfig.brands.delete
    • clientauthconfig.brands.get
    • clientauthconfig.brands.list
    • clientauthconfig.brands.update
    • clientauthconfig.clients.create
    • clientauthconfig.clients.createSecret
    • clientauthconfig.clients.delete
    • clientauthconfig.clients.get
    • clientauthconfig.clients.getWithSecret
    • clientauthconfig.clients.list
    • clientauthconfig.clients.listWithSecrets
    • clientauthconfig.clients.undelete
    • clientauthconfig.clients.update
  • oauthconfig.*
    • oauthconfig.clientpolicy.get
    • oauthconfig.testusers.get
    • oauthconfig.testusers.update
    • oauthconfig.verification.get
    • oauthconfig.verification.submit
    • oauthconfig.verification.update

יכול להיות שתוכלו לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש. למידע נוסף על הקצאת תפקידים, קראו את המאמר ניהול הגישה לפרויקטים, לתיקיות ולארגונים במסמכי התיעוד של ניהול זהויות והרשאות גישה (IAM).

לפני שיוצרים מכונה של Looker (Google Cloud core)‎

לפני שיוצרים מכונה של Looker (Google Cloud core), צריך לבצע את השלבים שמתוארים בקטעים הבאים:

יצירת מזהה הלקוח וסוד הלקוח ב-OAuth

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

אתם יכולים להגדיר את לקוח ה-OAuth בכל פרויקט ב- Google Cloud . הוא לא חייב להיות באותו פרויקט כמו המכונה של Looker (Google Cloud core). עם זאת, צריך להפעיל את Looker (Google Cloud core) API בפרויקט הזה.

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

  1. עוברים לפרויקט שבו רוצים ליצור את לקוח ה-OAuth.
  2. עוברים אל APIs & Services > Credentials.
  3. בדף Credentials, לוחצים על Create Credentials.
  4. בתפריט הנפתח, בוחרים באפשרות מזהה לקוח OAuth.
  5. בתפריט הנפתח Application type, בוחרים באפשרות אפליקציית אינטרנט.
  6. בשדה Name, מזינים שם ללקוח OAuth.
  7. בשלב הזה, אין צורך להוסיף מזהי URI בקטעים Authorized JavaScript origins או Authorized redirect URIs.
  8. לוחצים על יצירה.

אחרי שלוחצים על Create, מופיע החלון לקוח OAuth נוצר. בחלון הזה מוצגים מזהה הלקוח וסוד הלקוח שנוצרו בשביל לקוח ה-OAuth. אם אתם מגדירים פרטי כניסה מותאמים אישית ל-OAuth, הזינו את הערכים האלה כשאתם יוצרים את המכונה של Looker (ליבת Google Cloud) לחיבורים מאובטחים ציבוריים, ל-Private Service Connect או לגישה לשירותים פרטיים.

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

בשלב הבא, יכול להיות שתרצו להגדיר את מסך ההסכמה. מסך ההסכמה מוצג למשתמש במכונה של Looker (Google Cloud core) בכניסה הראשונה שלו, ובכל שלב שבו ההרשאה שלו פגה או מבוטלת על ידי המשתמש.

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

  • בקטע מיתוג, בקטע דומיינים מורשים, הדומיין חייב להתאים לדומיין של המכונה של Looker (Google Cloud core) שמשתמשת בפרטי הכניסה ל-OAuth. אם אתם מתכוונים ליצור דומיין מותאם אישית למכונה של Looker (Google Cloud core) ואתם יודעים איזה דומיין תקצו לה, אתם יכולים להזין אותו עכשיו. אחרת, אפשר להשאיר את השדה הזה ריק. הוא יאוכלס באופן אוטומטי כשתוסיפו את ה-URI המורשה להפניה אוטומטית אחרי שתיצרו את המכונה של Looker (Google Cloud core).

  • בקטע Audience, בוחרים באחת מהאפשרויות הבאות בקטע User Type:

במהלך יצירת המכונה של Looker (Google Cloud core)

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

בהתאם לסוג החיבור ולשיטת היצירה, מזינים את פרטי הכניסה באופן הבא:

אחרי שיוצרים מכונה של Looker (Google Cloud core)‎

כדי לסיים את ההגדרה, פועלים לפי ההוראות הבאות. כשמוסיפים כתובת URI מורשית להפניה אוטומטית, היא מתווספת למסך ההסכמה ל-OAuth כדומיין מורשה.

הוספת ה-URI המורשה להפניה אוטומטית ללקוח OAuth

אם עדיין לא עשיתם את זה, בצעו את השלבים הבאים כדי להזין את כתובת ה-URL של המכונה החדשה של Looker (Google Cloud core) בלקוח OAuth.

  1. אחרי שיוצרים מכונה של Looker (Google Cloud core), מחפשים ומעתיקים את כתובת ה-URL של המכונה. אפשר למצוא את כתובת ה-URL בדף Instances.

  2. במסוף Google Cloud , נכנסים לדף APIs & Services > Credentials.

  3. בקטע OAuth 2.0 Client IDs, לוחצים על השם של הלקוח שיצרתם.

  4. בקטע Authorized redirect URIs, לוחצים על Add URI.

  5. מדביקים את כתובת ה-URL של המכונה של Looker (Google Cloud core) בשדה URIs. מוסיפים /oauth2callback לסוף כתובת ה-URL. לדוגמה: https://uuid.looker.app/oauth2callback.

    אם אתם מתכוונים להגדיר הרשאת OAuth ל-BigQuery, אתם יכולים גם להוסיף כתובת URI שנייה להפניה אוטומטית שמפנה לכתובת ה-URL של המכונה של Looker (Google Cloud core), ואחריה /external_oauth/redirect בסוף כתובת ה-URL. לדוגמה: https://uuid.looker.app/external_oauth/redirect.

  6. לוחצים על Save.

יכול להיות שיעברו בין חמש דקות לכמה שעות עד שהעדכון ייכנס לתוקף.

ניהול משתמשים

אחרי שמגדירים את לקוח ה-OAuth ויוצרים את המכונה של Looker (Google Cloud core), אפשר להיכנס למכונה באמצעות OAuth. לאחר מכן, תוכלו לבחור את שיטת האימות של המכונה.

אם אתם משתמשים ב-OAuth כשיטת האימות העיקרית, בצעו את השלבים שמתוארים בדף התיעוד שימוש ב-Google OAuth לאימות משתמשים ב-Looker (Google Cloud core)‎ כדי להשלים את הגדרת OAuth לאימות משתמשים.

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

איך בודקים את סוג פרטי הכניסה של OAuth במכונה שלכם

פרטי הכניסה ל-OAuth לא מופיעים ישירות בדף ההגדרות של המכונה במסוף Google Cloud . לוחצים על Edit בדף הגדרות המכונה כדי לראות את הקטע OAuth application credentials.

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

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

עריכת לקוח OAuth של מכונה של Looker (Google Cloud core)

אם רוצים, אפשר להוסיף, לערוך או לשנות את פרטי הכניסה ל-OAuth במכונה של Looker (Google Cloud core) לפי השלבים הבאים:

  1. מגדירים את הלקוח או את פרטי הכניסה החדשים.
  2. במסוף Google Cloud , בדף Instances, לוחצים על שם המכונה כדי לפתוח את הדף DETAILS.
  3. בדף DETAILS, לוחצים על Edit.
  4. בדף Edit Looker (Google Cloud core) instance, עוברים לקטע OAuth application credentials ובוחרים באפשרות Manual, אם היא עדיין לא נבחרה.
  5. מזינים את הערכים החדשים בשדות מזהה לקוח ב-OAuth וסוד לקוח ב-OAuth.
  6. לוחצים על Save.

אם פרטי הכניסה של אפליקציית OAuth מוגדרים כמנוהלים על ידי Looker, אי אפשר להוסיף או לערוך את פרטי הכניסה. כדי לערוך או להוסיף פרטי כניסה, עוברים להגדרה ידנית.

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