בדף הזה מוסבר איך ליצור ולנהל הגדרות אמון לשימוש בתרחישים שונים של אימות TLS בו-זמני (mTLS).
למידע נוסף על mTLS, אפשר לעיין במקורות המידע הבאים:
כדי להבין את המושגים של הגדרות אמינות, ישויות עוגן אמינות ואישורים זמניים, קראו את המאמר הגדרות אמינות.
למידע נוסף על mTLS, קראו את הסקירה הכללית על Mutual TLS במסמכי התיעוד של Cloud Load Balancing.
כדי להשתמש בהגדרת האמון כדי להגדיר mTLS בשרת ה-Proxy לטירגוט, קראו את הדפים הבאים במסמכי התיעוד של Cloud Load Balancing:
יצירת הגדרת אמון
כשיוצרים הגדרת אמינות, צריך לציין את ישויות העוגן האמינות שמשמשות לאימות האישור.
כדי ליצור הגדרת אמון, מבצעים את השלבים הבאים:
המסוף
במסוף Google Cloud , נכנסים לכרטיסייה Trust configs בדף Certificate Manager.
לוחצים על הוספת הגדרת אמינות. מופיע הדף Create Trust Config.
בשדה Name, מזינים שם להגדרה.
השם חייב להיות ייחודי לפרויקט. הוא צריך להתחיל באות קטנה, ואחריה עד 62 אותיות קטנות, מספרים או מקפים, ולא להסתיים במקף.
אופציונלי: בשדה Description, מזינים תיאור להגדרה. התיאור הזה עוזר לזהות הגדרה ספציפית בהמשך.
אופציונלי: בשדה Labels, מציינים תוויות שרוצים לשייך להגדרת האמון. כדי להוסיף תווית, לוחצים על Add label ומציינים מפתח וערך בשביל התווית.
בשדה Location, בוחרים באפשרות Global או Regional.
אם בחרתם באפשרות Regional, בוחרים את האזור (Region).
בקטע מאגר אישורים, מוסיפים ישויות עוגן אמינות ורשויות ביניים לאישורים.
אפשר לציין כמה ישויות עוגן אמינות ואישורי ביניים באמצעות כמה מופעים של המטען הייעודי (payload) המלא של PEM לאישור, אישור אחד לכל מופע.
בקטע ישות עוגן אמינה, לוחצים על הוספת ישות עוגן אמינה ומעלים את קובץ האישור בקידוד PEM, או מעתיקים את תוכן האישור. כשמסיימים, לוחצים על הוספה.
אופציונלי: בקטע רשויות ביניים לאישורי CA, לוחצים על הוספת רשות ביניים לאישורי CA ומעלים את קובץ אישור הביניים בקידוד PEM, או מעתיקים את התוכן של אישור הביניים. כשמסיימים, לוחצים על Add.
השלב הזה מאפשר להוסיף עוד רמת אמון בין אישור הבסיס לבין אישור השרת.
אופציונלי: בקטע אישורים ברשימת ההיתרים, לוחצים על הוספת אישור ומעלים את קובץ האישור בקידוד PEM, או מעתיקים את תוכן האישור. הפעולה הזו מוסיפה את האישור לרשימת היתרים. כשמסיימים, לוחצים על הוספה.
כדי לציין כמה ישויות עוגן אמינות או אישורי ביניים במפרט המשאבים של הגדרת האמון, משתמשים בכמה מופעים של השדה
pemCertificate. כל מופע של השדה מכיל אישור אחד.הגדרת האמון תמיד מתייחסת לאישור ברשימת ההיתרים כאישור תקף. כדי לכלול כמה אישורים ברשימת היתרים, צריך להשתמש בכמה מופעים של השדה
pemCertificate, אישור אחד לכל מופע. כשמשתמשים באישורים שנוספו לרשימת היתרים, לא צריך מאגר אישורים.הגדרת האמון תמיד מחשיבה אישור ברשימת ההיתרים כתקף אם הוא עומד בתנאים ספציפיים: אפשר לנתח אותו, יש לו הוכחה לבעלות על מפתח פרטי והוא עומד במגבלות בשדה SAN של האישור. גם אישורים שפג תוקפם נחשבים לתקפים אם הם נוספו לרשימת היתרים. מידע נוסף על הפורמט בקידוד PEM זמין ב-RFC 7468.
לוחצים על יצירה.
מוודאים שהגדרת האמון החדשה מופיעה ברשימת ההגדרות.
gcloud
יוצרים קובץ YAML של הגדרת האמון שמציין את הפרמטרים של הגדרת האמון.
הקובץ הוא בפורמט הבא:
name: "TRUST_CONFIG_ID" trustStores: - trustAnchors: - pemCertificate: "CERTIFICATE_PEM_PAYLOAD" intermediateCas: - pemCertificate: "INTER_CERT_PEM_PAYLOAD" allowlistedCertificates: - pemCertificate: "ALLOWLISTED_CERT1" - pemCertificate: "ALLOWLISTED_CERT2"מחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. CERTIFICATE_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור שבו משתמשים במשאב הגדרת האמון.INTER_CERT_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור הביניים שבו משתמשים במשאב של הגדרת האמון.-
ALLOWLISTED_CERT1ו-ALLOWLISTED_CERT2: האישורים שנוספו לרשימת היתרים כדי להשתמש בהם במשאב הגדרת האמון הזה.
כדי לציין כמה ישויות עוגן אמינות או אישורי ביניים במפרט המשאבים של הגדרת האמון, משתמשים בכמה מופעים של השדה
pemCertificate. כל מופע של השדה מכיל אישור אחד.הגדרת האמון תמיד מתייחסת לאישור ברשימת ההיתרים כאישור תקף. כדי לכלול כמה אישורים ברשימת היתרים, צריך להשתמש בכמה מופעים של השדה
pemCertificate, אישור אחד לכל מופע. כשמשתמשים באישורים שנוספו לרשימת היתרים, לא צריך מאגר אישורים.הגדרת האמון תמיד מחשיבה אישור ברשימת ההיתרים כתקף אם הוא עומד בתנאים ספציפיים: אפשר לנתח אותו, יש לו הוכחה לבעלות על מפתח פרטי והוא עומד במגבלות בשדה SAN של האישור. גם אישורים שפג תוקפם נחשבים לתקפים אם הם נוספו לרשימת היתרים. מידע נוסף על הפורמט בקידוד PEM זמין ב-RFC 7468.
-
כדי לייבא את קובץ ה-YAML של הגדרת האמון, משתמשים בפקודה
gcloud certificate-manager trust-configs import:gcloud certificate-manager trust-configs import TRUST_CONFIG_ID \ --project=PROJECT_ID \ --source=TRUST_CONFIG_FILE \ --location=LOCATION
מחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
TRUST_CONFIG_FILE: הנתיב המלא והשם של קובץ ה-YAML של הגדרת האמון שיצרתם בשלב 1. -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal.
-
API
שולחים בקשת POST ל-method trustConfigs.create:
POST /v1/projects/PROJECT_ID/locations/LOCATION/trustConfigs?trust_config_id=TRUST_CONFIG_ID
{
"description": "DESCRIPTION",
"trust_stores": [{
"trust_anchors": [{
"pem_certificate": "CERTIFICATE_PEM_PAYLOAD"
}],
"intermediate_cas": [{
"pem_certificate": "INTER_CERT_PEM_PAYLOAD"
}],
}],
"allowlistedCertificates": [{
"pem_certificate": "ALLOWLISTED_CERT"
}],
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal. -
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
DESCRIPTION: תיאור משמעותי של המשאב הזה להגדרת האמון. הערך הזה הוא אופציונלי. CERTIFICATE_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור שבו משתמשים במשאב הגדרת האמון.INTER_CERT_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור הביניים שבו משתמשים במשאב של הגדרת האמון. הערך הזה הוא אופציונלי.-
ALLOWLISTED_CERT: האישור שנוסף לרשימת ההיתרים לשימוש במשאב של הגדרת האמון הזו. הערך הזה הוא אופציונלי.
עדכון של הגדרת אמינות
כדי לעדכן הגדרת אמינות, יוצרים קובץ YAML אחר של הגדרת אמינות שמציין את הפרמטרים החדשים של הגדרת האמינות, ומייבאים את הקובץ הזה אל Certificate Manager.
המסוף
במסוף Google Cloud , נכנסים לכרטיסייה Trust configs בדף Certificate Manager.
מאתרים ובוחרים את הגדרת האמינות שרוצים לעדכן.
בעמודה More Options, לוחצים על More actions בהגדרות שרוצים לעדכן ובוחרים באפשרות Edit.
מבצעים את השינויים הנדרשים.
לוחצים על Save.
מוודאים שהשינויים בהגדרות עודכנו.
gcloud
מייצאים את קובץ ה-YAML של הגדרת האמון.
gcloud certificate-manager trust-configs export TRUST_CONFIG_ID \ --project=PROJECT_ID \ --destination=TRUST_CONFIG_FILE \ --location=LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
TRUST_CONFIG_FILE: הנתיב המלא והשם של קובץ ה-YAML של הגדרת האמון. -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal.
-
עורכים את קובץ ה-YAML של הגדרת האמון.
הקובץ הוא בפורמט הבא:
name: "TRUST_CONFIG_ID" trustStores: - trustAnchors: - pemCertificate: "CERTIFICATE_PEM_PAYLOAD" intermediateCas: - pemCertificate: "INTER_CERT_PEM_PAYLOAD" allowlistedCertificates: - pemCertificate: "ALLOWLISTED_CERT1" - pemCertificate: "ALLOWLISTED_CERT2"מחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. CERTIFICATE_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור שבו משתמשים במשאב הגדרת האמון.INTER_CERT_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור הביניים שבו משתמשים במשאב של הגדרת האמון. הערך הזה אופציונלי.-
ALLOWLISTED_CERT1ו-ALLOWLISTED_CERT2: האישורים שנוספים לרשימת ההיתרים כדי להשתמש בהם במשאב של הגדרת האמון הזו. הערך הזה אופציונלי.
-
מייבאים את קובץ התצורה החדש של האמון אל Certificate Manager, בהתאם לשם המשאב הקיים של הגדרת האמון.
gcloud certificate-manager trust-configs import TRUST_CONFIG_ID \ --project=PROJECT_ID \ --source=TRUST_CONFIG_FILE \ --location=LOCATIONמחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
TRUST_CONFIG_FILE: הנתיב המלא והשם של קובץ ה-YAML של הגדרת האמון. -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal.
-
API
שולחים בקשת PATCH ל-method trustConfigs.update:
PATCH /v1/projects/PROJECT_ID/locations/LOCATION/trustConfigs/TRUST_CONFIG_ID?update_mask=*
{
"description": "DESCRIPTION",
"trust_stores": [{
"trust_anchors": [{
"pem_certificate": "CERTIFICATE_PEM_PAYLOAD"
}],
"intermediate_cas": [{
"pem_certificate": "INTER_CERT_PEM_PAYLOAD"
}],
}],
"allowlistedCertificates": [{
"pem_certificate": "ALLOWLISTED_CERT"
}],
}
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal. -
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
DESCRIPTION: תיאור משמעותי של המשאב הזה להגדרת האמון. התיאור הזה הוא אופציונלי. CERTIFICATE_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור שבו משתמשים במשאב הגדרת האמון.INTER_CERT_PEM_PAYLOAD: המטען הייעודי (payload) המלא של PEM לאישור הביניים שבו משתמשים במשאב של הגדרת האמון. הערך הזה הוא אופציונלי.-
ALLOWLISTED_CERT: האישור שנוסף לרשימת ההיתרים לשימוש במשאב של הגדרת האמון הזו. הערך הזה הוא אופציונלי.
הצגת רשימה של הגדרות האמינות
אתם יכולים לראות את כל הגדרות האמון שנקבעו בפרויקט.
המסוף
במסוף Google Cloud , נכנסים לכרטיסייה Trust configs בדף Certificate Manager.
בכרטיסייה Trust configs אפשר לראות רשימה של כל המשאבים שהוגדרו כהגדרות אמינות בפרויקט שנבחר.
gcloud
משתמשים בפקודה gcloud certificate-manager trust-configs list:
gcloud certificate-manager trust-configs list \
--filter="FILTER" \
--page-size="PAGE_SIZE" \
--limit="LIMIT" \
--sort-by="SORT_BY" \
--location=LOCATION
מחליפים את מה שכתוב בשדות הבאים:
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, שלפיהם התוצאות שמוחזרות ממוינות. ברירת המחדל היא סדר עולה. כדי למיין בסדר יורד, צריך להוסיף טילדה (~) בתחילת השדה.
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. כדי להציג רשימה של הגדרות האמון מכל האזורים, משתמשים בערך-. ערך ברירת המחדל הוא-. הדגל הזה הוא אופציונלי.
API
שולחים בקשת GET ל-method trustConfigs.list:
GET /v1/projects/PROJECT_ID/locations/LOCATION/trustConfigs?filter=FILTER&pageSize=PAGE_SIZE&sortBy=SORT_BY
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. כדי לראות את כל הגדרות האמון בכל המיקומים, צריך לציין מקף בודד (-).
FILTER: ביטוי שמגביל את התוצאות שמוחזרות לערכים ספציפיים.לדוגמה, כדי לסנן את התוצאות לפי התוויות וזמן היצירה, אפשר לציין:
--filter='labels.key:value AND create_time > "2021-09-01T00:00:00Z"'דוגמאות נוספות לסינון שאפשר להשתמש בהן עם Certificate Manager מפורטות במאמר מיון וסינון של תוצאות רשימה במסמכי התיעוד של Cloud Key Management Service.
PAGE_SIZE: מספר התוצאות שרוצים להחזיר בכל דף
SORT_BY: רשימה מופרדת בפסיקים של שדותname, שלפיהם התוצאות שמוחזרות ממוינות. ברירת המחדל היא סדר עולה. כדי למיין בסדר יורד, צריך להוסיף טילדה (~) בתחילת השדה.
צפייה בהגדרות האמינות
אתם יכולים לראות את הפרטים של הגדרת אמינות ספציפית.
המסוף
במסוף Google Cloud , נכנסים לכרטיסייה Trust configs בדף Certificate Manager.
לוחצים על המשאב של הגדרת האמינות שרוצים לראות. בדף Trust Config details מוצג מידע מפורט על משאב הגדרת האמון שנבחר.
gcloud
משתמשים בפקודה gcloud certificate-manager trust-configs describe:
gcloud certificate-manager trust-configs describe TRUST_CONFIG_ID \
--location=LOCATION
מחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal.
API
שולחים בקשת GET ל-method trustConfigs.get:
GET /v1/projects/PROJECT_ID/locations/LOCATION/trustConfigs/TRUST_CONFIG_ID
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal. -
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון.
מחיקה של הגדרת אמינות
לפני שמוחקים הגדרת אמינות, צריך לנתק אותה מהמשאב Client Authentication (ServerTlsPolicy).
המסוף
במסוף Google Cloud , נכנסים לכרטיסייה Trust configs בדף Certificate Manager.
מסמנים את התיבה של הגדרת האמון שרוצים למחוק.
לוחצים על Delete.
בתיבת הדו-שיח שמופיעה, לוחצים על מחיקה כדי לאשר.
gcloud
משתמשים בפקודה gcloud certificate-manager trust-configs delete:
gcloud certificate-manager trust-configs delete TRUST_CONFIG_ID \
--location=LOCATION
מחליפים את מה שכתוב בשדות הבאים:
-
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון. -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal.
API
שולחים בקשת DELETE ל-method trustConfigs.delete:
DELETE /v1/projects/PROJECT_ID/locations/LOCATION/trustConfigs/TRUST_CONFIG_ID
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud . -
LOCATION: האזור שבו מאוחסן המשאב של הגדרת האמון. מיקום ברירת המחדל הואglobal. -
TRUST_CONFIG_ID: המזהה של משאב הגדרת האמון.