פריסת אישור גלובלי שמנוהל על ידי Google באמצעות Certificate Authority Service

במדריך הזה מוסבר איך להשתמש ב-Certificate Manager כדי לפרוס אישור גלובלי בניהול Google באמצעות Certificate Authority Service.

מאזני העומסים הגלובליים הבאים תומכים באישורים בניהול Google עם Certificate Authority Service:

  • מאזן עומסים גלובלי חיצוני של אפליקציות (ALB)
  • מאזן עומסים קלאסי של אפליקציות (ALB)
  • מאזן עומסי רשת גלובלי חיצוני בשרת proxy
  • מאזן עומסי רשת קלאסי בשרת proxy

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

מטרות

במדריך הזה מוסבר איך לבצע את הפעולות הבאות:

  • יצירת אישור בניהול Google באמצעות CA Service דרך Certificate Manager.
  • פורסים את האישור במאזן עומסים נתמך באמצעות שרת proxy ל-HTTPS.

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

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the Compute Engine, Certificate Manager, Certificate Authority APIs, if any are not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the APIs

  4. Install the Google Cloud CLI.

  5. Configure the gcloud CLI to use your federated identity.

    For more information, see Sign in to the gcloud CLI with your federated identity.

  6. To initialize the gcloud CLI, run the following command:

    gcloud init
  7. מפעילים את CA Service API.
  8. יוצרים מאגר רשויות להנפקת אישורים (CA). צריך ליצור ולהפעיל לפחות רשות אחת להנפקת אישורים (CA) במאגר הזה.

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

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

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

  • אפשר להגדיר אישורי TLS גלובליים בניהול Google כך שיונפקו ממאגר רשויות להנפקת אישורים (CA) בכל אזור.

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

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

  • בעלים של Certificate Manager ‏ (roles/certificatemanager.owner)

    נדרש כדי ליצור ולנהל משאבים של Certificate Manager.

  • אדמין של מאזן עומסים ב-Compute‏ (roles/compute.loadBalancerAdmin) או אדמין של רשת Compute‏ (roles/compute.networkAdmin)

    נדרשת כדי ליצור ולנהל שרת proxy לחלוקת העומס מסוג HTTPS.

  • אדמין של שירות CA‏ (roles/privateca.admin)

    נדרש כדי לבצע פעולות ב-CA Service.

למידע נוסף, קראו את המאמרים הבאים:

יצירת מאזן העומסים

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

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

הגדרת השילוב של שירות CA עם Certificate Manager

כדי לשלב את CA Service עם Certificate Manager, צריך לבצע את השלבים הבאים:

  1. בפרויקט היעד Google Cloud , יוצרים חשבון שירות של Certificate Manager:

    gcloud beta services identity create --service=certificatemanager.googleapis.com \
        --project=PROJECT_ID
    

    מחליפים את PROJECT_ID במזהה של פרויקט היעד ב-Google Cloud .

    הפקודה מחזירה את השם של זהות השירות שנוצרה. לדוגמה:

    service-520498234@gcp-sa-certificatemanager.
    
  2. מקצים לחשבון השירות של Certificate Manager את התפקיד "מבקש אישורים של שירות CA" (roles/privateca.certificateRequester) במאגר רשויות ה-CA המטורגט:

    gcloud privateca pools add-iam-policy-binding CA_POOL \
        --location LOCATION \
        --member "serviceAccount:SERVICE_ACCOUNT" \
        --role roles/privateca.certificateRequester
    

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

    • ‫CA_POOL: המזהה של מאגר רשויות להנפקת אישורים (CA) היעד.
    • ‫LOCATION: מיקום היעד Google Cloud .
    • ‫SERVICE_ACCOUNT: השם המלא של חשבון השירות שיצרתם בשלב 1.
  3. יוצרים משאב של הגדרת הנפקת אישורים למאגר ה-CA:

    המסוף

    1. במסוף Google Cloud , נכנסים לכרטיסייה Issuance configs בדף Certificate Manager.

      כניסה ל-Certificate Manager

    2. לוחצים על יצירה. ייפתח הדף Create a Certificate Issuance Config.

    3. בשדה Name, מזינים שם ייחודי להגדרת הנפקת האישור.

    4. אופציונלי: בשדה Description, מזינים תיאור להגדרת ההנפקה.

    5. בקטע Location, בוחרים באפשרות Global.

    6. אופציונלי: בשדה Lifetime, מציינים את משך החיים של האישור שהונפק בימים. הערך צריך להיות בין 21 ל-30 ימים (כולל).

    7. אופציונלי: בשדה Rotation window percentage, מציינים את אחוז משך החיים של האישור שבו מתחיל תהליך החידוש שלו. כדי למצוא את טווח הערכים החוקיים, עיינו בקטע אחוז חלון הרוטציה ומשך החיים.

    8. אופציונלי: ברשימה Key algorithm, בוחרים את אלגוריתם המפתח שבו רוצים להשתמש כדי ליצור את המפתח הפרטי.

    9. ברשימה CA pool, בוחרים את השם של מאגר ה-CA שרוצים להקצות למשאב של הגדרת הנפקת האישורים.

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

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

    gcloud

    gcloud certificate-manager issuance-configs create ISSUANCE_CONFIG_NAME \
        --ca-pool=CA_POOL
    

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

    • ‫ISSUANCE_CONFIG_NAME: השם של משאב הגדרת ההנפקה של האישור.
    • ‫CA_POOL: הנתיב המלא של המשאב והשם של מאגר ה-CA שרוצים להקצות למשאב של הגדרת הנפקת האישורים.

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

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

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

המסוף

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

    כניסה ל-Certificate Manager

  2. בכרטיסייה אישורים, לוחצים על הוספת אישור.

  3. בשדה Certificate name, מזינים שם ייחודי לאישור.

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

  5. בקטע Location, בוחרים באפשרות Global.

  6. בשדה היקף, בוחרים באפשרות ברירת מחדל.

  7. בשביל Certificate type, בוחרים Create Google-managed certificate.

  8. בשדה Certificate Authority type, בוחרים באפשרות Private.

  9. בשדה Domain Names, מציינים רשימה של שמות הדומיינים של האישור, מופרדים בפסיקים. כל שם דומיין חייב להיות שם דומיין שמוגדר במלואו, כמו myorg.example.com.

  10. בשדה Select a certificate issuance config, בוחרים את השם של משאב הגדרת הנפקת האישורים שמפנה למאגר רשויות ה-CA הרצוי.

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

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

    האישור החדש מופיע ברשימת האישורים.

gcloud

כדי ליצור אישור גלובלי בניהול Google באמצעות שירות רשות האישורים, משתמשים בפקודה certificate-manager certificates create עם הדגל issuance-config:

gcloud certificate-manager certificates create CERTIFICATE_NAME \
    --domains="DOMAIN_NAMES" \
    --issuance-config=ISSUANCE_CONFIG_NAME

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

  • ‫CERTIFICATE_NAME: שם האישור.
  • ‫DOMAIN_NAME: שם דומיין היעד. שם הדומיין חייב להיות שם דומיין שמוגדר במלואו, כמו myorg.example.com.
  • ‫ISSUANCE_CONFIG_NAME: השם של משאב ההגדרות להנפקת אישורים שמפנה למאגר היעד של רשויות האישורים.

API

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

POST /v1/projects/PROJECT_ID/locations/global/certificates?certificate_id=CERTIFICATE_NAME"
{
 "managed": {
  "domains": ["DOMAIN_NAME"],
  "issuanceConfig": "ISSUANCE_CONFIG_NAME",
 }
}

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
  • ‫CERTIFICATE_NAME: שם האישור.
  • ‫DOMAIN_NAME: שם דומיין היעד. שם הדומיין חייב להיות שם דומיין שמוגדר במלואו, כמו myorg.example.com.
  • ‫ISSUANCE_CONFIG_NAME: השם של משאב ההגדרות להנפקת אישורים שמפנה למאגר היעד של רשויות האישורים.

אימות סטטוס האישור

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

המסוף

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

    כניסה ל-Certificate Manager

  2. בכרטיסייה אישורים, בודקים את העמודה סטטוס של האישור.

gcloud

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

gcloud certificate-manager certificates describe CERTIFICATE_NAME

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

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

createTime: '2021-10-20T12:19:53.370778666Z'
expireTime: '2022-05-07T05:03:49Z'
managed:
  domains:
  - myorg.example.com
  issuanceConfig: projects/myproject/locations/global/issuanceConfigs/myissuanceConfig
  state: ACTIVE
name: projects/myproject/locations/global/certificates/mycertificate
pemCertificate: |
  -----BEGIN CERTIFICATE-----
  [...]
  -----END CERTIFICATE-----
sanDnsnames:
  - myorg.example.com
updateTime: '2021-10-20T12:19:55.083385630Z'

לשלבים נוספים לפתרון בעיות, ראו פתרון בעיות ב-Certificate Manager.

פריסת האישור למאזן עומסים

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

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

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

gcloud

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

gcloud certificate-manager maps create CERTIFICATE_MAP_NAME

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

Terraform

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

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

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

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

gcloud

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

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

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

  • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים.
  • ‫CERTIFICATE_MAP_NAME: השם של מפת האישורים שאליה משויכת רשומת המיפוי לאישורים.
  • ‫CERTIFICATE_NAME: שם האישור שרוצים לשייך לרשומת המיפוי לאישורים.
  • ‫HOSTNAME: שם המארח שרוצים לשייך לרשומת המיפוי לאישורים.

    אם רוצים ליצור אישור שכולל גם דומיין עם תו כללי לחיפוש וגם דומיין בסיסי (root), צריך לציין את שם המארח עם דומיין בסיסי ועם תו כללי לחיפוש, למשל example.com ו-*.example.com. בנוסף, צריך לציין שתי רשומות מיפוי לאישורים – אחת ל-example.com והשנייה ל-*.example.com.

Terraform

כדי ליצור רשומת מיפוי לאישורים עם דומיין בסיסי (root), משתמשים במשאב google_certificate_manager_certificate_map_entry.

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

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

resource "google_certificate_manager_certificate_map_entry" "second_entry" {
  name        = "${local.name}-second-entity-${random_id.tf_prefix.hex}"
  description = "example certificate map entry"
  map         = google_certificate_manager_certificate_map.certificate_map.name
  labels = {
    "terraform" : true
  }
  certificates = [google_certificate_manager_certificate.root_cert.id]
  hostname     = "*.${local.domain}"
}

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

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

כדי לאמת את רשומת המיפוי לאישורים, משתמשים בפקודה 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_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'

צירוף מפת האישורים לשרת 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 חדש לחלוקת העומס, משתמשים בפקודה gcloud compute target-https-proxies create:

gcloud compute target-https-proxies create PROXY_NAME \
    --certificate-map="CERTIFICATE_MAP_NAME" \
    --url-map="URL_MAP" \
    --global

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

  • ‫PROXY_NAME: שם שרת ה-proxy לחלוקת העומס.
  • ‫CERTIFICATE_MAP_NAME: השם של מפת האישורים שמפנה לרשומת המיפוי לאישורים ולאישור המשויך.
  • ‫URL_MAP: השם של מפת URL

כדי לצרף את מפת האישורים לשרת proxy קיים של יעד HTTPS, משתמשים בפקודה gcloud compute target-https-proxies update. אם אתם לא יודעים את השם של שרת ה-proxy הקיים לחלוקת העומס, היכנסו לדף Target proxies ושימו לב לשם של שרת ה-proxy לחלוקת העומס.

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

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

gcloud compute target-https-proxies list

Terraform

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

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

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

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

הסרת המשאבים

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

  1. מוחקים את מאזן העומסים והמשאבים שלו.

    ניקוי הגדרה של איזון עומסים

  2. מוחקים את מפת האישורים או מנתקים אותה מה-proxy.

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

    gcloud compute target-https-proxies delete PROXY_NAME
    

    אם רוצים להשאיר את שרת ה-proxy ל-HTTPS, צריך לנתק את מפת האישורים משרת ה-proxy.

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

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

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

    מחליפים את PROXY_NAME בשם של שרת ה-Proxy לטירגוט.

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

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

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

    • ‫CERTIFICATE_MAP_ENTRY_NAME: השם של רשומת המיפוי לאישורים.
    • ‫CERTIFICATE_MAP_NAME: שם מפת האישורים.
  4. מוחקים את מפת האישורים:

    gcloud certificate-manager maps delete CERTIFICATE_MAP_NAME
    

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

  5. מוחקים את האישור שמנוהל על ידי Google:

    המסוף

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

      כניסה ל-Certificate Manager

    2. בכרטיסייה Certificates, מסמנים את התיבה של האישור.

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

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

    gcloud

    gcloud certificate-manager certificates delete CERTIFICATE_NAME
    

    מחליפים את CERTIFICATE_NAME בשם של אישור היעד.

  6. מוחקים את משאב ההגדרות להנפקת אישורים:

    המסוף

    1. במסוף Google Cloud , נכנסים לכרטיסייה Issuance configs בדף Certificate Manager.

      כניסה ל-Certificate Manager

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

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

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

    gcloud

     gcloud certificate-manager issuance-configs delete ISSUANCE_CONFIG_NAME
     

    מחליפים את ISSUANCE_CONFIG_NAME בשם של משאב היעד להגדרת הנפקת האישורים.

  7. מוחקים את מאגר ה-CA.

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

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