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

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

למידע נוסף, קראו את המאמר מפות אישורים.

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף Certificate Manager ולוחצים על הכרטיסייה מפות אישורים.

    כניסה ל-Certificate Manager

  2. לוחצים על Create certificate map.

  3. בשדה Name, מזינים שם למפת האישורים, למשל cert-map-8.

  4. בשדה Description, מזינים תיאור למפת האישורים, למשל My new certificate map.

  5. כדי ליצור רשומת מיפוי לאישורים ולהוסיף אותה למפת האישורים, לוחצים על Add map entry ופועלים לפי השלבים שמפורטים בקטע הבא.

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

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

gcloud

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

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

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

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

API

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

POST /v1/projects/PROJECT_ID/locations/global/certificateMaps?certificate_map_id=CERTIFICATE_MAP_NAME

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

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

Terraform

כדי ליצור מפת אישורים, משתמשים במשאב google_certificate_manager_certificate_map:

resource "google_certificate_manager_certificate_map" "default" {
  name        = "${local.name}-certmap1-${random_id.tf_prefix.hex}"
  description = "${local.domain} certificate map"
  labels = {
    "terraform" : true
  }
}

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

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

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

אם מצרפים אישור TLS ‏ (SSL) לשרת ה-proxy לחלוקת העומס וגם מצרפים אישורים דרך מפת אישורים, שרת ה-proxy משתמש באישורים שמצוינים במפת האישורים ומתעלם מהאישור שצורף ישירות.

המסוף

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

  1. במסוף Google Cloud , עוברים לדף איזון עומסים.

    כניסה לדף Load balancing

  2. לוחצים על השם של מאזן העומסים שרוצים לעדכן ואז על Edit.

  3. לוחצים על Frontend configuration ובוחרים את כתובת ה-IP של ממשק הקצה ואת הגדרת היציאה שרוצים לערוך.

  4. אם מופיעה האפשרות Choose certificate repository, בוחרים באפשרות Use certificate map.

  5. ברשימה Select a certificate map, בוחרים את מפת האישורים.

  6. לוחצים על Done ואז על Update.

gcloud

כדי לצרף את מפת האישורים לשרת ה-proxy ל-HTTPS, משתמשים בפקודה gcloud compute target-https-proxies update:

gcloud compute target-https-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

כדי לצרף את מפת האישורים לשרת ה-proxy של יעד ה-SSL, משתמשים בפקודה gcloud compute target-ssl-proxies update:

gcloud compute target-ssl-proxies update PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME"

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

  • ‫PROXY_NAME: השם של שרת ה-proxy לחלוקת העומס
  • ‫CERTIFICATE_MAP_NAME: השם של מפת האישורים שמכילה את רשומות המיפוי שמפנות לאישורי היעד

API

כדי לצרף את מפת האישורים לשרת ה-proxy ל-HTTPS, שולחים בקשת POST ל-method‏ targetHttpsProxies:

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

כדי לצרף את מפת האישורים לשרת ה-proxy של SSL ביעד, שולחים בקשת POST ל-method‏ targetSslProxies:

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "//certificatemanager.googleapis.com/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME",
}

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫PROXY_NAME: השם של שרת ה-proxy לחלוקת העומס
  • ‫CERTIFICATE_MAP_NAME: השם של מפת האישורים שמכילה את רשומות המיפוי שמפנות לאישורי היעד

ניתוק מפת אישורים משרת proxy

לפני שמנתקים מפת אישורים משרת proxy, חשוב לשים לב לנקודות הבאות:

  • אם אישורי TLS‏ (SSL) מצורפים ישירות לשרת ה-proxy, ניתוק מפת האישורים גורם לשרת ה-proxy לחזור להשתמש בהם.

  • אם אין אישורי TLS‏ (SSL) שמצורפים ישירות לשרת ה-proxy, אי אפשר לנתק את מפת האישורים. לפני שמנתקים את מפת האישורים, צריך לצרף לפחות אישור TLS אחד ישירות לשרת ה-proxy.

gcloud

כדי לנתק את מפת האישורים המצורפת משרת ה-Proxy ל-HTTPS, משתמשים בפקודה gcloud compute target-https-proxies update:

gcloud compute target-https-proxies update PROXY_NAME \
    --clear-certificate-map

כדי לנתק מפת אישורים שמצורפת לשרת ה-proxy ל-SSL, משתמשים בפקודה gcloud compute target-ssl-proxies update:

gcloud compute target-ssl-proxies update PROXY_NAME \
    --clear-certificate-map

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

  • ‫PROXY_NAME: השם של שרת ה-proxy לחלוקת העומס

API

כדי לנתק מפת אישורים מצורפת משרת ה-proxy ל-HTTPS, שולחים בקשת POST ל-method‏ targetHttpsProxies:

POST /projects/PROJECT_ID/global/targetHttpsProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

כדי לנתק מפת אישורים שמצורפת לשרת ה-proxy ל-SSL, שולחים בקשת POST ל-method‏ targetSslProxies:

POST /projects/PROJECT_ID/global/targetSslProxies/PROXY_NAME/setCertificateMap
{
  certificateMap: "",
}

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud
  • ‫PROXY_NAME: השם של שרת ה-proxy לחלוקת העומס

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף Certificate Manager ולוחצים על הכרטיסייה מפות אישורים.

    כניסה ל-Certificate Manager

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

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

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

  5. כדי להוסיף רשומת מיפוי חדשה למפת האישורים, לוחצים על Add map entry ופועלים לפי השלבים שמפורטים בקטע יצירת רשומת מיפוי לאישורים.

    כדי לערוך רשומת מיפוי, בעמודה Actions בשורה של רשומת המיפוי, לוחצים על הסמל , בוחרים באפשרות Edit ופועלים לפי השלבים שמפורטים בקטע עדכון של רשומת מיפוי לאישורים.

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

  6. אתם יכולים להוסיף, למחוק או לעדכן את התוויות שמשויכות למפת האישורים.

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

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

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

gcloud

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

gcloud certificate-manager maps update CERTIFICATE_MAP_NAME \
    --description="DESCRIPTION"
    --update-labels="LABELS"

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

  • ‫CERTIFICATE_MAP_NAME: שם מפת האישורים
  • ‫DESCRIPTION: התיאור החדש של מפת האישורים הזו
  • ‫LABELS: רשימה מופרדת בפסיקים של תוויות שחלות על מפת האישורים הזו

API

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

PATCH /v1/projects/PROJECT_ID/locations/global/certificateMaps/CERTIFICATE_MAP_NAME?updateMask=labels,description
{
  "description": "DESCRIPTION",
  "labels": {
    "LABEL_KEY": "LABEL_VALUE",
  }
}

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

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

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

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

המסוף

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

    כניסה ל-Certificate Manager

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

gcloud

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

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

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

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

    לדוגמה, כדי לסנן את התוצאות לפי התוויות וזמן היצירה, אפשר לציין: --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

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

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

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud

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

    לדוגמה, כדי לסנן את התוצאות לפי התוויות וזמן היצירה, אפשר לציין: --filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'

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

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

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

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף Certificate Manager ולוחצים על הכרטיסייה מפות אישורים.

    כניסה ל-Certificate Manager

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

gcloud

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

gcloud certificate-manager maps describe CERTIFICATE_MAP_NAME

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

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

API

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

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

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

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

מחיקת מפת אישורים

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף Certificate Manager ולוחצים על הכרטיסייה מפות אישורים.

    כניסה ל-Certificate Manager

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

  3. לוחצים על Delete ואז על Delete.

gcloud

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

gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME

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

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

API

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

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

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

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

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