פתרון בעיות ב-Certificate Manager

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

כדי לקבל עזרה בפתרון בעיות שקשורות לאישורי TLS (SSL), קראו את המאמר פתרון בעיות שקשורות לאישורי SSL.

פתרון בעיות באישורים שמנוהלים על ידי Google

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

סטטוס האישור המנוהל

בודקים את מצב האישור המנוהל (managed.state):

gcloud certificate-manager certificates describe CERTIFICATE_NAME \
    --location=LOCATION \
    --format="get(managed.state)"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CERTIFICATE_NAME: שם האישור.
  • ‫LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הוא global.

אלה הערכים של מצב האישור:

מדינה הסבר
PROVISIONING

‫Certificate Manager מקצה או מחדש את האישור.

הקצאת אישור בניהול Google יכולה להימשך עד 60 דקות אחרי שהשינויים בהגדרות ה-DNS ומאזן העומסים יופצו באינטרנט. אם האישור נשאר בסטטוס PROVISIONING, בודקים את השדות managed.provisioningIssue או managed.authorizationAttemptInfo כדי לקבל מידע נוסף.

ACTIVE האישור הוקצה. הוא מוכן לטפל בתנועה אחרי שמשייכים אותו לרשומת מיפוי לאישורים ומצרפים אותו לשרת proxy לחלוקת העומס או למאזן עומסים.
FAILED

מספר ניסיונות להקצאה או לחידוש של אישורים נכשלו, ו-Certificate Manager הפסיק להקצות את האישור. במצב הזה, Certificate Manager לא מנסה שוב להקצות את האישור.

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

כדי לקבל פרטים על הכישלון, אפשר לבדוק את השדות managed.provisioningIssue או managed.authorizationAttemptInfo.

מצב הניסיון לאימות הדומיין

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

gcloud certificate-manager certificates describe CERTIFICATE_NAME \
    --location=LOCATION \
    --format="get(managed.authorizationAttemptInfo)"

מחליפים את מה שכתוב בשדות הבאים:

  • ‫CERTIFICATE_NAME: שם האישור.
  • ‫LOCATION: מיקום היעד Google Cloud . מיקום ברירת המחדל הוא global.

לכל דומיין שמשויך לאישור יש אחד מהסטטוסים הבאים (managed.authorizationAttemptInfo.state):

מדינה הסבר
AUTHORIZING Certificate Manager מקצה את האישור לדומיין הזה ומאשר את הדומיין.
AUTHORIZED הדומיין מאושר. אם האישור כולל כמה דומיינים, הוא מוקצה והופך ל-ACTIVE רק אחרי שכל הדומיינים שלו מגיעים למצב AUTHORIZED.
FAILED הניסיון לאשר את הדומיין נכשל. הכשל הזה מונע ממנהל האישורים להנפיק את האישור המנוהל. כדי לאבחן את הבעיה, צריך לבדוק את השדות failureReason,‏ details ו-troubleshooting בדומיין שנכשל.

הסיבות לכשל באימות הדומיין

אם מצב ניסיון ההרשאה של דומיין הוא FAILED, השדה managed.authorizationAttemptInfo.failureReason מציין את הסיבה לכישלון. בטבלה הבאה מתוארים הערכים האפשריים:

הסיבה לכישלון הסבר
CONFIG

יש בעיה בהגדרות של ה-DNS או של מאזן העומסים בדומיין הזה.

מידע נוסף זמין בטבלה המפורטת לפתרון שגיאות.

CAA

הקצאת האישור נכשלה בגלל בעיה ברשומת CAA, כמו הגבלת CAA מפורשת או כישלון בבדיקת רשומות ה-CAA של הדומיין.

כדי לפתור את הבעיה, צריך לוודא שהגדרת תחום ה-DNS מאפשרת לרשות האישורים להנפיק אישורים לדומיין. בהרשאות DNS לכל פרויקט (כולל כל האישורים האזוריים), מנהל האישורים משתמש רק ב-Google Trust Services‏ (pki.goog), לכן חשוב לוודא שרשומת ה-CAA מאפשרת את pki.goog. בהרשאות DNS אחרות ובהרשאות של מאזן עומסים, Certificate Manager יכול להשתמש גם ב-Google Trust Services (‏pki.goog) וגם ב-Let's Encrypt (‏letsencrypt.org). מידע נוסף זמין במאמר ציון רשויות האישורים שיכולות להנפיק את האישור שלכם שמנוהל על ידי Google.

RATE_LIMITED

הבקשה הוגבלה על ידי רשות האישורים או המערכת הפנימית, כמו המגבלות השבועיות של Let's Encrypt על אישורים לכל דומיין רשום.

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

שגיאות שקשורות לאישורים של Certificate Manager

בקטע הזה מוסבר איך לפתור שגיאות שקשורות לשדה authorizationAttemptInfo של אישורים שמנוהלים על ידי Google ב-Certificate Manager. השגיאות מוצגות בקטע managed.authorizationAttemptInfo.troubleshooting רק כשהשדות הבאים מכילים את הערכים האלה:

  • managed.authorizationAttemptInfo.state = FAILED
  • managed.authorizationAttemptInfo.failureReason = CONFIG

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

שגיאה תיאור
CNAME_MISMATCH השגיאה הזו מתרחשת רק בהרשאות DNS, כשהערך של רשומת ה-CNAME הצפויה לא תואם לערך של רשומת ה-CNAME שנפתרה.

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

RESOLVED_TO_NOT_SERVING השגיאה הזו מתרחשת כשהדומיין מכיל רשומות DNS מסוג A ו-AAAA שמפנות לכתובות IP מסוימות, שבהן האישור לא מצורף לאף מאזן עומסים.

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

כדי לפתור את הבעיה, עדכן את רשומות ה-DNS מסוג A ורשומות AAAA של הדומיין כך שיפנו לכתובת ה-IP של מאזן העומסים. כתובות ה-IP שמתקבלות מרשומות ה-DNS מסוג A ו-AAAA של הדומיין מאוחסנות בפרמטר ips.resolved, וכתובות ה-IP של מאזן העומסים שאליו מצורף האישור הזה מאוחסנות בפרמטר ips.serving.

רשומות ה-DNS מסוג A ו-AAAA של הדומיין צריכות להפנות רק לכתובת ה-IP של מאזן העומסים. לדוגמה, אם רשומת A ב-DNS מפנה לכתובת ה-IP של מאזן העומסים, אבל רשומת AAAA ב-DNS מפנה לכתובת IP אחרת, תופיע השגיאה RESOLVED_TO_NOT_SERVING.

צריך גם לוודא שרשומות ה-DNS של הדומיין, A ו-AAAA, מתורגמות בצורה נכונה ועקבית בכל העולם. מידע נוסף זמין בקטע כשלים באימות דומיין מנקודות מבט מרובות.

NO_RESOLVED_IPS השגיאה הזו מתרחשת כשהדומיין לא מכיל רשומות DNS מסוג A ו-AAAA.

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

כדי לפתור את הבעיה, צריך להוסיף רשומות DNS מסוג A ו-AAAA לדומיין הזה, ולוודא שהרשומות מפנות לכתובת ה-IP של שרת ה-proxy ל-HTTPS או של שירות שמירת מטמון הקצה של Media CDN.

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

RESOLVED_TO_SERVING_ON_ALT_PORTS השגיאה הזו מתרחשת כשהדומיין שמכיל את רשומות ה-DNS מסוג A ו-AAAA מפנה לכתובות ה-IP של מאזן העומסים שאליו מצורף האישור הזה, אבל יציאה 443 לא פתוחה בכתובות ה-IP האלה.

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

כדי לפתור את הבעיה, צריך לוודא שמאזן העומסים עם האישור המצורף מאזין ליציאה 443. הפרמטר ips.serving_on_alt_ports מאחסן את רשימת כתובות ה-IP של מאזני העומסים שבהם היציאה 443 לא פתוחה.

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

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

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

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

שגיאה בניתוק של מפת אישורים משרת proxy לטירגוט

כשמנתקים מפת אישורים משרת proxy לחלוקת העומס, מופיעה השגיאה הבאה:

"There must be at least one certificate configured for a target proxy."

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

שגיאה בשיוך של רשומת מיפוי לאישורים עם אישור

כשמשייכים רשומת מיפוי לאישורים לאישור, מופיעה השגיאה הבאה:

"certificate can't be used more than 100 times"

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

  • באישורים שמנוהלים על ידי Google, צריך ליצור אישור אחר. משייכים את רשומות המיפוי החדשות לאישורים לאישור החדש, ומצרפים את האישור החדש למאזן העומסים.
  • באישורים בניהול עצמי, מעלים את האישור מחדש עם שם חדש. משייכים את רשומות המיפוי החדשות לאישורים לאישור החדש, ומצרפים את האישור החדש למאזן העומסים.

בעיות שקשורות לאישורים שהונפקו על ידי מכונה של שירות CA

בקטע הזה מפורטות השגיאות הנפוצות ביותר שאתם עשויים להיתקל בהן כשאתם משתמשים ב-Certificate Manager כדי לפרוס אישורים בניהול Google שהונפקו על ידי המכונה של שירות ה-CA, והסיבות האפשריות לשגיאות האלה.

אם מופיעה השגיאה Failed to create Certificate Issuance Config resources, בדקו את הדברים הבאים:

  • משך החיים. הערכים החוקיים של משך חיי האישור הם בין 21 ל-30 ימים.
  • אחוז חלון הסבב. הערכים התקינים של אחוז חלון הרוטציה הם בין 1% ל-99%. צריך להגדיר את אחוז חלון הרוטציה ביחס למשך החיים של האישור, כך שהחידוש של האישור יתבצע לפחות 7 ימים אחרי שהאישור הונפק ולפחות 7 ימים לפני שהוא יפוג.
  • אלגוריתם המפתח. הערכים התקינים של אלגוריתם המפתח הם: RSA_2048 ו-ECDSA_P256.
  • מאגר הרשויות לאישורים (CA). מאגר ה-CA לא קיים או שהוא מוגדר באופן שגוי. מאגר ה-CA צריך להכיל לפחות רשות אחת להנפקת אישורים (CA) שמופעלת, ולמבצע הקריאה החוזרת צריכה להיות הרשאת privateca.capools.use בפרויקטGoogle Cloud היעד. באישורים אזוריים, צריך ליצור את משאב ההגדרות להנפקת אישורים באותו מיקום שבו נמצא מאגר ה-CA.

אם קיבלתם את השגיאה Failed to create a managed certificate, בדקו את הדברים הבאים:

  • משאב הגדרת הנפקת האישורים שציינתם כשנוצר האישור קיים.
  • לגורם המבקש יש את ההרשאה certificatemanager.certissuanceconfigs.use במשאב של הגדרת הנפקת האישורים שציינתם כשנוצר האישור.
  • האישור נמצא באותו מיקום שבו נמצא משאב ההגדרות להנפקת האישור.

אם קיבלתם את השגיאה Failed to renew certificate או Failed to provision certificate, בדקו את הדברים הבאים:

  • לחשבון השירות של Certificate Manager יש את ההרשאה roles/privateca.certificateRequester במאגר ה-CA שצוין במשאב של הגדרת הנפקת האישורים שמשמש לאישור הזה.

    כדי לבדוק את ההרשאות במאגר היעד של רשויות ה-CA, משתמשים בפקודה הבאה:

    gcloud privateca pools get-iam-policy CA_POOL
    --location REGION
    

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫CA_POOL: הנתיב המלא של המשאב והשם של מאגר היעד של רשויות האישורים (CA)
    • ‫REGION: האזור של יעד ה- Google Cloud
  • מדיניות הנפקת אישורים בתוקף. מידע נוסף זמין במאמר בעיות שקשורות להגבלות של מדיניות ההנפקה.

בעיות שקשורות להגבלות של מדיניות ההנפקה

אם Certificate Manager לא תומך בשינויים שבוצעו באישור על ידי מדיניות הנפקת האישורים, הקצאת האישור נכשלת והמצב של האישור המנוהל משתנה ל-Failed. כדי לפתור את הבעיה, צריך לוודא את הדברים הבאים:

בבעיות הקודמות, מכיוון ששירות CA כבר הנפיק את האישור, תחויבו בהתאם לתמחור של שירות CA.

אם מופיעה השגיאה Rejected for issuing certificates from the configured CA Pool, סימן שהמדיניות להנפקת אישורים חסמה את האישור המבוקש. כדי לפתור את השגיאה, צריך לבדוק את הדברים הבאים:

במקרים הקודמים, מכיוון ששירות CA לא הנפיק את האישור, לא תחויבו על ידי שירות CA.

בעיות שקשורות להתאמת שם המארח של IAP

אם מופיעה השגיאה The host name provided does not match the SSL certificate on the server כשמשתמשים ב-Certificate Manager עם שרת proxy לאימות זהויות (IAP), צריך לוודא שמשתמשים באישור שתקף לשם המארח הזה. אפשר גם להציג רשימה של רשומות המיפוי לאישורים שהגדרתם במפת האישורים. לכל שם מארח או שם מארח עם תו כללי לחיפוש שאתם מתכוונים להשתמש בו עם IAP, צריך להיות רשומה ייעודית. אם חסרה רשומת מיפוי לאישורים של שם המארח, יוצרים רשומת מיפוי לאישורים.

בקשות שחוזרות לרשומת מיפוי לאישורים הראשית במהלך בחירת האישור תמיד נדחות על ידי IAP.

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

Google Cloud מחדש מדי פעם את האישורים שמנוהלים על ידי Google, על ידי בקשה שלהם מרשויות אישורים (CA). רשויות האישורים ש-Google Cloud עובדת איתן כדי לחדש את האישורים משתמשות בשיטה לאימות דומיינים מנקודות מבט מרובות, שנקראת Multi-Perspective Issuance Corroboration ‏(MPIC). כחלק מהתהליך הזה, רשויות האישורים מאמתות את השליטה בדומיין על ידי בדיקת הגדרות ה-DNS של הדומיין. במקרה של הרשאה של מאזן עומסים, הן מנסות ליצור קשר עם השרת שמאחורי כתובת ה-IP של הדומיין. האימותים האלה מתבצעים מכמה נקודות תצפית באינטרנט. אם תהליך האימות נכשל, אי אפשר לחדש את האישורים שמנוהלים על ידי Google. כתוצאה מכך, מאזן העומסים מציג ללקוחות אישור שפג תוקפו, ומשתמשי הדפדפן נתקלים בשגיאות שקשורות לאישור ולקוחות ה-API נתקלים בכשלים בחיבור.

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

  • רשומות ה-DNS מסוג A (IPv4) ורשומות ה-DNS מסוג AAAA (IPv6) של הדומיינים ושל כל תת-דומיין מפנות רק לכתובת ה-IP (או הכתובות) שמשויכות לכלל ההעברה (או הכללים) של מאזן העומסים. אם ברשומה יש כתובות אחרות, יכול להיות שהאימות ייכשל.
  • רשות האישורים, שמבצעת אימות של רשומות DNS, שולחת שאילתות לגבי רשומות DNS מכמה מיקומים. מוודאים שספק ה-DNS מגיב באופן עקבי לכל הבקשות הגלובליות לאימות הדומיין.
  • שימוש ב-GeoDNS (החזרת כתובות IP שונות על סמך מיקום הבקשה) או בכללי מדיניות DNS שמבוססים על מיקום עלול להוביל לתגובות לא עקביות ולגרום לכשל באימות. אם ספק ה-DNS משתמש ב-GeoDNS, צריך להשבית אותו או לוודא שכל האזורים מחזירים את אותה כתובת IP של מאזן העומסים.
  • אם אתם משתמשים בשיטה הרשאה של מאזן עומסים כדי להקצות אישורים בניהול Google, אתם צריכים לציין במפורש את כתובות ה-IP של מאזן העומסים בהגדרות ה-DNS. שכבות ביניים, כמו CDN, יכולות לגרום להתנהגות בלתי צפויה. כתובת ה-IP צריכה להיות נגישה ישירות, בלי הפניות אוטומטיות, חומות אש או רשתות CDN בנתיב הבקשה. מידע נוסף מופיע בקטע מאזני עומסים מאחורי CDN במאמר הזה.
  • מומלץ להשתמש בכלי לבדיקת הפצת DNS גלובלית לבחירתכם כדי לוודא שכל רשומות ה-DNS הרלוונטיות נפתרות בצורה נכונה ועקבית בכל העולם.

אימות השינויים בהגדרות האישיות

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

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

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

מאזני עומסים מאחורי CDN

במאזני עומסים שבהם מופעל CDN, יכול להיות שספקי CDN מסוימים של צד שלישי בנתיב הבקשה ימנעו את הצלחת בקשות האימות. זה יכול לקרות אם ספק ה-CDN מעביר באופן פעיל תנועת HTTP(S)‎ דרך שרת proxy.

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

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