פתרון בעיות ב-OS Login

במאמר הזה מוסבר איך לפתור בעיות ב-OS Login באמצעות שרת המטא-נתונים. למידע נוסף על הגדרת OS Login או להוראות מפורטות, ראו הגדרת OS Login.

אתם יכולים לשלוח שאילתות לשרת המטא-נתונים מתוך מכונה של Compute Engine. למידע נוסף, קראו את המאמר אחסון ואחזור של מטא-נתונים של מכונות.

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

  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא התהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים האלה:

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

    המסוף

    כשמשתמשים במסוף Google Cloud כדי לגשת לשירותים ולממשקי ה-API של Google Cloud , לא צריך להגדיר אימות.

    gcloud

    1. התקינו את ה-CLI של Google Cloud. אחר כך, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

      gcloud init

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

  • הגדרת אזור ותחום כברירת מחדל.
  • REST

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

      התקינו את ה-CLI של Google Cloud.

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

    מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

הודעות שגיאה נפוצות

בהמשך מפורטות דוגמאות לשגיאות נפוצות שעשויות להתרחש כשמשתמשים ב-OS Login.

לא נמצא שם לקבוצה

במכונות מסוימות שמשתמשות ב-OS Login, יכול להיות שתופיע הודעת השגיאה הבאה אחרי שהחיבור נוצר:

/usr/bin/id: cannot find name for group ID 123456789

מתעלמים מהודעת השגיאה הזו. השגיאה הזו לא משפיעה על המכונות שלכם.

לא הצלחנו לקבל את הקבוצות

יכול להיות שיופיעו יומנים דומים לאלה כשיוצרים מכונות:

Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Refreshing group entry cache
Dec 10 22:31:05 instance-1 google_oslogin_nss_cache[381]: oslogin_cache_refresh[381]: Failure getting groups, quitting

היומנים האלה מציינים שבארגון שלכם לא מוגדרות קבוצות Linux של OS Login. התעלמו מההודעות האלה.

התנאי המוקדם נכשל

יכול להיות שתופיע שגיאה דומה לזו כשמתחברים למכונה באמצעות SSH:

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: The specified username or UID is not unique within given system ID.

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

כדי לפתור את הבעיה תוכלו לנסות אחד מהפתרונות הבאים:

חריגה ממגבלת הגודל של פרופיל OS Login

יכול להיות שתראו את אחת מהשגיאות הבאות כשאתם מתחברים למכונה של Linux באמצעות SSH או משתמשים ב-SCP כדי להעביר קבצים:

ERROR: (gcloud.compute.ssh) FAILED_PRECONDITION: Login profile size exceeds 32 KiB. Delete profile values to make additional space.
ERROR: (gcloud.compute.scp) INVALID_ARGUMENT: Login profile size exceeds 32 KiB. Delete profile values to make additional space.

ב-OS Login, פרטי המשתמשים, כולל מפתחות ציבוריים של SSH, מאוחסנים בחשבון POSIX עם מגבלת גודל של 32KiB לכל משתמש. אם פרופיל OS Login חורג מהמגבלה הזו, או אם יש לכם יותר מ-64 מפתחות SSH בפרופיל, לא תוכלו להוסיף לו עוד מפתחות SSH, ולא תוכלו להתחבר למכונות וירטואליות באמצעות SSH.

כדי לפתור את השגיאות האלה, צריך לבצע את הפעולות הבאות:

  1. בודקים את הגודל של פרופיל OS Login. כדי לבדוק את גודל הפרופיל, מייצאים אותו לקובץ JSON זמני ובודקים את גודל הקובץ באמצעות הפקודה הבאה:

    gcloud compute os-login describe-profile --format="json" | wc
    

    אם הגודל קרוב ל-32KiB או חורג ממנו, צריך להסיר מפתחות SSH שלא בשימוש.

  2. כדי לזהות מפתחות SSH שלא בשימוש, בודקים את הפרופיל ב-OS Login:

    gcloud compute os-login describe-profile
    

    הפלט אמור להיראות כך:

    name: '00000000000000'
    posixAccounts:
    ...
    sshPublicKeys:
     ...:
       fingerprint: ...
       key: |
         ssh-rsa AAAAB3NzaC1yc2...
       name: ...
     ...
    
  3. מסירים את המפתחות שלא בשימוש באמצעות הפקודה gcloud compute os-login ssh-keys remove:

    gcloud compute os-login ssh-keys remove --key=KEY
    

    מחליפים את KEY בטביעת האצבע של המפתח או במחרוזת המלאה של המפתח הציבורי SSH.

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

  • כדי להשתמש מחדש בזוג מפתחות קיים, מציינים את הדגל --ssh-key-file בפקודה gcloud compute ssh:

    gcloud compute ssh VM_NAME --ssh-key-file=PATH_TO_PRIVATE_KEY
    
  • אם אתם מתחברים לעיתים קרובות למכונות וירטואליות באמצעות SSH עם ה-CLI של gcloud, צרו זוג מפתחות SSH שמוגדר כברירת מחדל בשם google_compute_engine בספרייה .ssh/. שורת הפקודה של ה-CLI של gcloud משתמשת בזוג המפתחות הזה אם הוא קיים, ולא יוצרת זוג מפתחות חדש בכל חיבור. כדי ליצור זוג מפתחות כברירת מחדל, מריצים את הפקודה:

    ssh-keygen -t rsa -f ~/.ssh/google_compute_engine -C USERNAME -b 2048
    

    ואז מוסיפים את המפתח הציבורי לפרופיל ב-OS Login:

    gcloud compute os-login ssh-keys add --key-file=~/.ssh/google_compute_engine.pub
    

Cloud Build

אם אתם משתמשים ב-Cloud Build ופרופיל OS Login של חשבון השירות שלכם חורג מהמגבלה של 32KiB, יכול להיות שחיבור ה-SSH ייכשל ותופיע הודעת השגיאה הבאה: Login profile size exceeds 32 KiB.... כדי לפתור את הבעיה, אתם יכולים להגדיר את Cloud Build כך שישתמש בחשבונות שירות שצוינו על ידי המשתמש במקום בחשבון השירות שמוגדר כברירת מחדל ב-Cloud Build.

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

קוד תגובת HTTP‏: 429

יכול להיות שתופיע השגיאה הבאה כשמנסים להתחבר למכונה באמצעות SSH:

Failed to validate organization user USERNAME has login permission, got HTTP response code: 429

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

כדי למנוע את הבעיה הזו בעתיד, נסו את הפתרונות הבאים:

ערכי ברירת המחדל של המטא-נתונים של OS Login

ב-Compute Engine מוגדרת קבוצה של רשומות מטא-נתונים שמוגדרות כברירת מחדל, שמשמשות למידע על OS Login. מטא-נתונים שמוגדרים כברירת מחדל תמיד מוגדרים על ידי השרת. מפתחות המטא-נתונים שמוגדרים כברירת מחדל הם תלויי אותיות רישיות.

בטבלה הבאה מתוארים הרשומות שאפשר לשלוח להן שאילתות.

ביחס ל-http://metadata.google.internal/computeMetadata/v1/
רשומת מטא-נתונים תיאור
project/attributes/enable-oslogin בדיקה אם OS Login מופעל בפרויקט Google Cloud הנוכחי.
instance/attributes/enable-oslogin בדיקה אם OS Login מופעל במכונה הנוכחית.
oslogin/users/ אחזור פרטי פרופיל של משתמשי OS Login. אפשר להעביר פרמטרים של שאילתה כמו username, uid, pagesize ו-pagetoken.
oslogin/authorize/

אחזור הגדרות ההרשאות ברמת ההתחברות או הניהול של משתמש OS Login.

כדי לבדוק הרשאה, צריך לציין את פרמטר השאילתה policy. הערך של פרמטר המדיניות צריך להיות login (כדי לבדוק את הרשאת ההתחברות) או adminLogin (כדי לבדוק את הגישה ל-sudo).

איך בודקים שהשירות OS Login מופעל

משתמשים במסוף Google Cloud או ב-Google Cloud CLI כדי לשלוח שאילתות למטא-נתונים, כדי לבדוק אם OS Login מופעל. השירות OS Login מופעל כשמפתח המטא-נתונים enable-oslogin מוגדר לערך TRUE במטא-נתונים של הפרויקט או של המכונה. אם מגדירים גם מטא-נתונים של מכונה וגם מטא-נתונים של פרויקט, הערך שמוגדר במטא-נתונים של המכונה מקבל קדימות.

הצגת משתמשי OS Login

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

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=PAGE_SIZE" -H "Metadata-Flavor: Google"

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

לדוגמה, כדי להגדיר את pagesize ל-1, מריצים את הפקודה הבאה:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1" -H "Metadata-Flavor: Google"

כדי לקבל את המשתמש הבא, מגדירים את pagesize ל-1 ואת pagetoken לאסימון הדף מהפלט של הפקודה הקודמת.

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?pagesize=1&pagetoken=PAGE_TOKEN" -H "Metadata-Flavor: Google"

ברוב ההפצות, אפשר גם להריץ את הפקודה getent passwd של Unix כדי לאחזר את רשומות הסיסמאות של משתמשי הארגון.

הצגת משתמש ספציפי ב-OS Login

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

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=USERNAME" -H "Metadata-Flavor: Google"

מחליפים את USERNAME בשם המשתמש שרוצים לשלוח אליו שאילתה.

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

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"

הפלט אמור להיראות כך:

{
    "loginProfiles": [{
        "name": "12345678912345",
        "posixAccounts": [{
            "primary": true,
            "username": "user_example_com",
            "uid": "123451",
            "gid": "123451",
            "homeDirectory": "/home/user_example_com",
            "operatingSystemType": "LINUX"
        }],
        "sshPublicKeys": {
            "204c4b4fb...": {
                "key": "ssh-rsa AAAAB3Nz...",
                "fingerprint": "204c4b4fb..."
            }
        }
    }]
}

ברוב ההפצות, אפשר גם להריץ פקודות Unix כמו getent passwd username או getent passwd uid כדי לאחזר את פרטי הפרופיל.

כדי לאחזר את מפתחות ה-SSH של משתמש, אפשר גם להריץ את הפקודה /usr/bin/google_authorized_keys USERNAME. אם לא מוחזרים מפתחות, יכול להיות שלמשתמש אין את ההרשאות הנדרשות כדי להיכנס למכונה.

מתבצעת בדיקה של הרשאות ההתחברות

כדי לראות את ההרשאות ברמת ההתחברות והניהול, צריך לספק את הפרמטרים של השאילתה policy=login&email=LOGIN_NAME.

  1. שולחים שאילתה לפרופיל המשתמש כדי לקבל את הערך של השדה name:

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/users?username=user_example_com" -H "Metadata-Flavor: Google"
  2. בפלט, מאתרים את name.

  3. מריצים את הפקודה הבאה של login באמצעות הערך של name:

    curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=LOGIN_NAME" -H "Metadata-Flavor: Google"
    

לדוגמה, אפשר לשלוח שאילתה לגבי הרשאות ההתחברות של המשתמש user_example_com שהוצג בקטע הקודם:

curl "http://metadata.google.internal/computeMetadata/v1/oslogin/authorize?policy=login&email=12345678912345" -H "Metadata-Flavor: Google"

פלט הפקודה מציין שהמשתמש מורשה להיכנס למכונה:

{"success":true}

בדיקה אם למכונה יש חשבון שירות

אתם יכולים לשלוח שאילתה לשרת המטא-נתונים כדי למצוא את חשבון השירות שמשויך למכונה. נכנסים למכונה ומריצים את הפקודה הבאה:

curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" -H "Metadata-Flavor: Google"

הפלט אמור להיראות כך:

12345-sa@developer.gserviceaccount.com/
default/

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

בעיות ב-SSH כשמופעל אימות דו-שלבי (2FA)

בקטעים הבאים מוסבר איך מגדירים במכונה OS Login עם אימות דו-שלבי (2FA), ואיך פותרים שגיאות בחיבור SSH כשמופעל אימות דו-שלבי.

אימות דו-שלבי

2FA מוסיף שכבת אבטחה ל-OS Login. אם חשבון של משתמש בארגון נפרץ, הגישה למכונות באמצעות SSH עדיין מוגנת עד לאימות של גורם שני.

כשמגדירים את מפתח המטא-נתונים enable-oslogin-2fa לערך TRUE, ה-guest agent מוסיף את הגדרת ה-PAM הבאה לאימות דו-שלבי בחלק העליון של הקובץ /etc/pam.d/sshd:

auth       [success=done perm_denied=die default=ignore] pam_oslogin_login.so

ה-guest agent גם מעדכן את קובץ התצורה של OpenSSH ברמת המערכת, /etc/ssh/sshd_config. ה-guest agent לא מוחק מהקובץ צמדים של מילות מפתח וארגומנטים שהוגדרו בעבר, אבל מכיוון ש-OpenSSH משתמש בערך הראשון של כל פרמטר, ה-guest agent מוסיף את השורות הבאות לחלק העליון של הקובץ /etc/ssh/sshd_config:

AuthenticationMethods publickey,keyboard-interactive
ChallengeResponseAuthentication yes

פתרון בעיות בחיבור לאימות דו-שלבי (2FA)

כשמתחברים למכונה באמצעות SSH עם 2FA מופעל, יכול להיות שתוצג ב-Cloud Shell הודעת שגיאה כללית מסוג Permission denied (keyboard-interactive) או not authorized בלי לציין את הסיבה לכשל:

Permission denied (keyboard-interactive)
ERROR: (gcloud.compute.start-iap-tunnel) Error while connecting [4033: 'not authorized'].
kex_exchange_identification: Connection closed by remote host
Connection closed by UNKNOWN port 65535

ERROR: (gcloud.compute.ssh) [/usr/bin/ssh] exited with return code [255].

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

  1. כדי לבודד אם הבעיה נגרמת בגלל 2FA, מבטלים את ההגדרה של מפתח המטא-נתונים enable-oslogin-2fa או מגדירים אותו לערך FALSE, ואז מנסים להתחבר למכונה. אם עדיין אין גישה למכונה, כנראה שהבעיה היא לא באימות הדו-שלבי.

  2. אם אתם מצליחים לגשת למכונה אחרי שהשבתתם את 2FA, חפשו הודעות שגיאה שקשורות ל-2FA בקובצי היומן בספרייה /var/log/ כדי להבין למה 2FA נכשל.

  3. בזמן שהמכונה מחוברת, מפעילים מחדש את enable-oslogin-2fa ובודקים שסוכן האורח עדכן את הקבצים /etc/pam.d/sshd ו-/etc/ssh/sshd_config – לדוגמה, על ידי בדיקת חותמות הזמן של השינויים באמצעות הפקודה ls -l. מוודאים שהקבצים מכילים את הרשומות הנדרשות של pam_oslogin_login.so,‏ AuthenticationMethods publickey,keyboard-interactive ו-ChallengeResponseAuthentication yes, כפי שמתואר בקטע אימות דו-שלבי.

  4. כדי לבדוק אם החיבור נכשל כי האימות הדו-שלבי (2SV) לא מופעל בחשבון Google או בדומיין, מסננים את יומני הביקורת של OS Login או את קובצי היומן בספרייה /var/log/ לפי הודעת השגיאה הבאה:

    "message": "The caller does not have permission"
    
          "@type": "type.googleapis.com/google.cloud.oslogin.v1.StartSessionRequest",
          "supportedChallengeTypes": [
            "INTERNAL_TWO_FACTOR",
            "SECURITY_KEY_OTP",
            "AUTHZEN",
            "TOTP",
            "IDV_PREREGISTERED_PHONE"
          ],
    

    הודעת השגיאה הזו נרשמת ביומן כשלא מפעילים אימות דו-שלבי בחשבון Google או בדומיין. יכול להיות שגם לקוח ה-SSH יחזיר את השגיאה No supported authentication methods available (server sent: keyboard-interactive).

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

    אתם יכולים גם לפנות לאדמין ב-Google Workspace כדי לבדוק אם האימות הדו-שלבי מופעל בדומיין שלכם.

  5. אם המאפיין response.challenges של יומני הביקורת של OS Login ב-ContinueSession מציג סטטוס שונה מ-'READY', יכול להיות שיש בעיה באתגר האימות שבו אתם משתמשים. הדוגמה הבאה מראה בעיות שקשורות לקוד האימות בהודעה קולית או בהודעת SMS שלא נשלח לטלפון כדי להשלים את תהליך הכניסה:

    "response": {
        "challenges": [
          {
            "challengeId": 2,
            "challengeType": "IDV_PREREGISTERED_PHONE",
            "status": "RETRYABLE_ERROR"
          }
    

    כדי לצמצם את הבעיה, אתם יכולים להשתמש בשיטת אימות אחרת, כמו מאמת החשבונות של Google. אם אתם מצליחים להתחבר באמצעות שיטת אימות אחרת, אבל לא מקבלים קודי אימות בהודעות SMS בטלפון הרשום, ומופיע RETRYABLE_ERROR עבור IDV_PREREGISTERED_PHONE ביומנים, פנו לצוות התמיכה למשתמשי Google Workspace.

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