ניהול רשומות מיפוי לאישורים

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

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

יצירת רשומת מיפוי לאישורים

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

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

המסוף

  1. נכנסים לדף Certificate Manager במסוף Google Cloud ולוחצים על הכרטיסייה Certificate maps.

    מעבר אל Certificate Manager

  2. כדי ליצור מיפוי אישורים חדש, לוחצים על יצירת מיפוי אישורים.

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

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

  4. בשדה Map entry name (שם רשומה במפה), מזינים שם לרשומה במפת האישורים, כמו my-cert-map-entry-01.

  5. בשדה Description (תיאור), מזינים תיאור של הרשומה במפת האישורים, כמו My new cert map entry.

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

    הערה: אפשר לשייך רק רשומה אחת של מיפוי אישורים ראשי למיפוי אישורים.

  7. בשדה שם המארח, מזינים את שם המארח שרוצים לשייך לרשומה במפת האישורים, כמו www.example.com.

    הערה: בערך ראשי במפת אישורים, שם המארח מצוין כ-<PRIMARY> כברירת מחדל, ואי אפשר לשנות את שם המארח.

  8. כדי לשייך אישור לרשומה במפת האישורים, לוחצים על בחירת אישור. אפשר לבחור אישור קיים או ללחוץ על הוספת אישור כדי ליצור אישור.

    הערה: אפשר לשייך עד ארבעה אישורים לרשומה במפת האישורים.

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

  10. לוחצים על הוספה. רשומת המיפוי לאישורים עם האישורים המשויכים אליה נוספת למפת האישורים.

gcloud

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

כדי ליצור רשומה במפת האישורים, משתמשים בפקודה gcloud certificate-manager maps entries create:

gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAMES" \
    --hostname="HOSTNAME"

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

  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_NAMES: רשימה מופרדת בפסיקים של שמות האישורים שרוצים לשייך לרשומה במפת האישורים
  • ‫HOSTNAME: שם המארח שרוצים לשייך לרשומה במפת האישורים

API

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

כדי ליצור רשומה במפת אישורים, שולחים בקשת POST אל ה-method‏ certificateMaps.certificateMapEntries.create:

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?certificate_map_entry_id=CERTIFICATE_MAP_ENTRY_NAME
{
 hostname: "HOSTNAME"
 certificates: ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME1","projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME2"]
}

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫HOSTNAME: שם המארח שרוצים לשייך לרשומה במפת האישורים
  • ‫CERTIFICATE_NAME1: השם של האישור הראשון שרוצים לשייך לרשומת המיפוי לאישורים
  • ‫CERTIFICATE_NAME2: השם של האישור השני שרוצים לשייך לרשומת מיפוי האישורים

Terraform

כדי ליצור רשומה במפת האישורים, משתמשים במשאב google_certificate_manager_certificate_map_entry.

resource "google_certificate_manager_certificate_map_entry" "default" {
  name        = "${local.name}-first-entry-${random_id.tf_prefix.hex}"
  description = "example certificate map entry"
  map         = google_certificate_manager_certificate_map.default.name
  labels = {
    "terraform" : true
  }
  certificates = [google_certificate_manager_certificate.default.id]
  hostname     = local.domain
}

כדי ללמוד איך להחיל הגדרות ב-Terraform או להסיר אותן, ראו פקודות בסיסיות ב-Terraform.

יצירת רשומת מיפוי ראשית לאישורים

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

המסוף

  1. נכנסים לדף Certificate Manager במסוף Google Cloud ולוחצים על הכרטיסייה Certificate maps.

    מעבר אל Certificate Manager

  2. כדי ליצור מיפוי אישורים חדש, לוחצים על יצירת מיפוי אישורים.

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

  3. כשמוסיפים רשומה חדשה למיפוי אישורים, בדף יצירת מיפוי אישורים לוחצים על הוספת רשומה למיפוי.

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

  4. כדי להגדיר רשומה במפת האישורים כרשומה הראשית במפת האישורים, בחלון הוספת רשומה למפה, בוחרים באפשרות רשומה ראשית.

    הערה: אפשר לשייך רק רשומה אחת של מיפוי אישורים ראשי למיפוי אישורים.

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

gcloud

כדי ליצור רשומה ראשית במפת האישורים, משתמשים בפקודה gcloud certificate-manager maps entries create עם הדגל set-primary:

gcloud certificate-manager maps entries create CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAMES" \
    --set-primary

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

  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_NAMES: רשימה מופרדת בפסיקים של שמות האישורים שרוצים לשייך לרשומה במפת האישורים

API

כדי ליצור רשומה במפת אישורים, שולחים בקשת POST אל ה-method‏ certificateMaps.certificateMapEntries.create:

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?certificate_map_entry_id=CERTIFICATE_MAP_ENTRY_NAME
{
   matcher: "PRIMARY",
   certificates: ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME1","projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME2"]
}

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫CERTIFICATE_NAME1: השם של האישור הראשון שרוצים לשייך לרשומה הראשית במפת האישורים.
  • ‫CERTIFICATE_NAME2: השם של האישור השני שרוצים לשייך לרשומה במפת האישורים הראשית.

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

עדכון רשומת מיפוי לאישורים

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

  • הקצאה או ביטול הקצאה של אישורים
  • שינוי התיאור
  • שינוי התוויות

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

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

המסוף

  1. נכנסים לדף Certificate Manager במסוף Google Cloud ולוחצים על הכרטיסייה Certificate maps.

    מעבר אל Certificate Manager

  2. ברשימת מיפויי האישורים, לוחצים על מיפוי האישורים הנדרש. הדף Certificate Map Details נפתח.

  3. לוחצים על עריכה. ייפתח הדף עריכת מיפוי האישורים.

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

  5. בשדה שם רשומה במפה, משנים את השם של הרשומה במפת האישורים.

  6. בשדה Description, משנים את התיאור של הרשומה במפת האישורים.

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

    הערה: אפשר לשייך רק רשומה אחת של מיפוי אישורים ראשי למיפוי אישורים.

  8. בשדה שם המארח, משנים את שם המארח שרוצים לשייך לרשומה במפת האישורים.

    הערה: בערך ראשי במפת אישורים, שם המארח מצוין כ-<PRIMARY> כברירת מחדל, ואי אפשר לשנות את שם המארח.

  9. כדי לשייך אישור לרשומה במפת האישורים, לוחצים על בחירת אישור. אפשר לבחור אישור קיים או ללחוץ על הוספת אישור כדי ליצור אישור.

    הערה: אפשר לשייך עד ארבעה אישורים לרשומה במפת האישורים.

    כדי להעלות או להוריד את הסדר של אישור, לוחצים על הסמל או על הסמל של האישור הרצוי.

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

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

    כדי למחוק תווית, לוחצים על מחיקת פריט בתווית הרצויה.

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

gcloud

כדי לעדכן רשומה במפת האישורים, משתמשים בפקודה gcloud certificate-manager maps entries update:

gcloud certificate-manager maps entries update CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME" \
    --certificates="CERTIFICATE_NAME,CERTIFICATE_NAME" \
    --description="DESCRIPTION" \
    --update-labels="LABELS"

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

  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_NAME: השם של האישור שרוצים לשייך לרשומת מיפוי האישורים
  • ‫DESCRIPTION: תיאור של רשומת מיפוי לאישורים
  • LABELS: רשימת התוויות שמוחלות על הרשומה במפת האישורים

API

כדי לעדכן את הרשומה במפת האישורים, שולחים בקשת PATCH ל-method‏ certificateMaps.certificateMapEntries.patch:

PATCH  /v1/projects/example-project/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME?updateMask=labels,description,certificates
{
  "certificates": ["projects/PROJECT_ID/locations/global/certificates/CERTIFICATE_NAME"],
  "description": "DESCRIPTION",
  "labels": { "LABEL_KEY": "LABEL_VALUE" }
}

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

  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫CERTIFICATE_NAME: שם האישור
  • ‫DESCRIPTION: תיאור של רשומת מיפוי לאישורים
  • ‫LABEL_KEY: מפתח תווית שמוחל על רשומה במפת האישורים
  • ‫LABEL_VALUE: ערך של תווית שהוחל על רשומת המיפוי לאישורים

הצגת רשומות מיפוי לאישורים

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

המסוף

  1. נכנסים לדף Certificate Manager במסוף Google Cloud ולוחצים על הכרטיסייה Certificate maps.

    מעבר אל Certificate Manager

  2. ברשימת מיפויי האישורים, לוחצים על מיפוי האישורים הנדרש. נפתח הדף Certificate Map Details (פרטי מיפוי האישורים) עם מידע מפורט על מיפוי האישורים שנבחר ועל רשימת רשומות המיפוי שמשויכות אליו.

gcloud

כדי לראות את רשומות המיפוי לאישורים שמשויכות למפת אישורים, משתמשים בפקודה gcloud certificate-manager maps entries list

gcloud certificate-manager maps entries list --map=CERTIFICATE_MAP_NAME \
    --filter="FILTER" \
    --page-size="PAGE_SIZE" \
    --limit="LIMIT" \
    --sort-by="SORT_BY"

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

  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים

  • ‫FILTER: ביטוי שמגביל את התוצאות שמוחזרות לערכים ספציפיים.

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

    • מצב ההצגה: --filter='state=ACTIVE'
    • הכלי להתאמת מילות מפתח (מוגדר כראשי): --filter='-matcher=PRIMARY'
    • שם המארח: --filter='hostname=example.com'
    • אישורים שהוקצו: --filter='certificates:my-cert'
    • תוויות וזמן יצירה: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    דוגמאות נוספות לסינון שאפשר להשתמש בהן ב-Certificate Manager מופיעות במאמר מיון וסינון של תוצאות רשימה במסמכי התיעוד של Cloud Key Management Service.

  • ‫PAGE_SIZE: מספר התוצאות שרוצים להחזיר בכל דף

  • ‫LIMIT: המספר המקסימלי של התוצאות שרוצים להחזיר

  • ‫SORT_BY: רשימה מופרדת בפסיקים של name שדות שלפיהם התוצאות שמוחזרות ממוינות. סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי להגדיר סדר יורד, מוסיפים טילדה (~) לפני השדה.

API

כדי להציג רשומות מיפוי לאישורים שמשויכות למפת אישורים, שולחים בקשת GET אל ה-method‏ certificateMaps.certificateMapEntries.list:

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי אישורי היעד

  • ‫FILTER: ביטוי שמגביל את התוצאות שמוחזרות לערכים ספציפיים.

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

    • מצב ההצגה: --filter='state=ACTIVE'
    • הכלי להתאמת מילות מפתח (מוגדר כראשי): --filter='-matcher=PRIMARY'
    • שם המארח: --filter='hostname=example.com'
    • אישורים שהוקצו: --filter='certificates:my-cert'
    • תוויות וזמן יצירה: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

    דוגמאות נוספות לסינון שאפשר להשתמש בהן ב-Certificate Manager מופיעות במאמר מיון וסינון של תוצאות ברשימה במסמכי התיעוד של Cloud Key Management Service.

  • ‫PAGE_SIZE: מספר התוצאות שרוצים להחזיר בכל דף

  • ‫SORT_BY: רשימה מופרדת בפסיקים של name שדות שלפיהם התוצאות שמוחזרות ממוינות. סדר המיון שמוגדר כברירת מחדל הוא סדר עולה. כדי להגדיר סדר יורד, מוסיפים טילדה (~) לפני השדה.

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

אפשר לראות את הפרטים והמצב של רשומת מיפוי לאישורים שמשויכת למפת אישורים.

המסוף

  1. נכנסים לדף Certificate Manager במסוף Google Cloud ולוחצים על הכרטיסייה Certificate maps.

    מעבר אל Certificate Manager

  2. ברשימת מיפויי האישורים, לוחצים על מיפוי האישורים הנדרש. נפתח הדף Certificate Map Details (פרטי מיפוי האישורים) עם מידע מפורט על מיפוי האישורים שנבחר ועל רשימת רשומות המיפוי שמשויכות אליו.

  3. בקטע Map entries, לוחצים על השם של רשומה במפה שרוצים לראות. הדף Map entry details נפתח עם מידע מפורט על רשומת המיפוי שנבחרה.

gcloud

כדי לראות את הסטטוס של רשומה במפת אישורים שמשויכת למפת אישורים, משתמשים בפקודה gcloud certificate-manager maps entries describe:

gcloud certificate-manager maps entries describe CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME"

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

  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים

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

certificates:
createTime: '2021-09-06T10:01:56.229472109Z'
hostname: example.com
name: projects/my-project/locations/global/certificateMaps/myCertMap/certificateMapEntries/myCertMapEntry
state: ACTIVE
updateTime: '2021-09-06T10:01:58.277031787Z'

API

כדי לראות את הסטטוס של רשומת מיפוי לאישורים שמשויכת למפת אישורים, שולחים בקשת GET אל ה-method‏ certificateMaps.certificateMapEntries.get:

GET /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים

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

כשמוחקים רשומת מיפוי לאישורים, האישורים שמשויכים לרשומת המיפוי לאישורים מנותקים משרת היעד של ה-proxy.

מחיקה של רשומה במפת האישורים לא מוחקת את האישורים המשויכים מ-Google Cloud. חובה למחוק את האישורים האלה באופן ידני.

המסוף

  1. נכנסים לדף Certificate Manager במסוף Google Cloud ולוחצים על הכרטיסייה Certificate maps.

    מעבר אל Certificate Manager

  2. ברשימת מיפויי האישורים, לוחצים על מיפוי האישורים הנדרש. הדף Certificate Map Details נפתח.

  3. לוחצים על עריכה. ייפתח הדף עריכת מיפוי האישורים.

  4. בעמודה פעולות בשורה של רשומה במפה, לוחצים על הסמל , בוחרים באפשרות מחיקה ואז לוחצים על מחיקה.

gcloud

כדי למחוק רשומה במפת אישורים שמשויכת למפת אישורים, משתמשים בפקודה gcloud certificate-manager maps entries delete:

gcloud certificate-manager maps entries delete CERTIFICATE_MAP_ENTRY_NAME \
    --map="CERTIFICATE_MAP_NAME"

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

  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים

API

כדי למחוק רשומת מיפוי לאישורים שמשויכת למיפוי לאישורים, שולחים בקשת DELETE לשיטה certificateMaps.certificateMapEntries.delete:

DELETE /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME/certificateMapEntries/CERTIFICATE_MAP_ENTRY_NAME

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫CERTIFICATE_MAP_NAME: השם של מיפוי האישורים שאליו משויכת רשומת מיפוי האישורים
  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים

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