ניהול המשאבים של CA Service באמצעות אילוצים בהתאמה אישית
בדף הזה מוסבר איך להשתמש באילוצים בהתאמה אישית של שירות מדיניות הארגון כדי להגביל פעולות ספציפיות במשאבי Google Cloud הבאים:
privateca.googleapis.com/CaPoolprivateca.googleapis.com/CertificateAuthorityprivateca.googleapis.com/CertificateTemplate
מידע נוסף על מדיניות הארגון בהתאמה אישית
מידע על כללי מדיניות ואילוצים של הארגון
Google Cloud שירות מדיניות הארגון מאפשר לכם שליטה מרוכזת ופרוגרמטית על המשאבים של הארגון. אדמינים של מדיניות הארגון יכולים להגדיר מדיניות לארגון, שהיא קבוצה של הגבלות שנקראות אילוצים. האילוצים חלים על משאביGoogle Cloud ועל הצאצאים של המשאבים האלה בהיררכיית המשאבים שלGoogle Cloud . אפשר לאכוף את מדיניות הארגון ברמת הארגון, התיקייה או הפרויקט.
מדיניות הארגון מספקת אילוצים מנוהלים מובְנים לשירותים שונים של Google Cloud . עם זאת, אם אתם רוצים שליטה מפורטת יותר בהתאמה אישית על השדות הספציפיים שמוגבלים במדיניות הארגון, אתם יכולים גם ליצור אילוצים בהתאמה אישית ולהשתמש בהם במדיניות הארגון.
ירושה של מדיניות
כברירת מחדל, מדיניות הארגון עוברת בירושה לצאצאים של המשאבים שעליהם אתם אוכפים את המדיניות. לדוגמה, אם אוכפים מדיניות בתיקייה, Google Cloud אוכף את המדיניות בכל הפרויקטים שבתיקייה. במאמר כללי הערכה של היררכיה מוסבר בהרחבה על ההתנהגות הזו ואיך לשנות אותה.
לפני שמתחילים
- נכנסים לחשבון Google Cloud . אנחנו ממליצים למשתמשים חדשים ב- Google Cloudליצור חשבון כדי שיוכלו להעריך את הביצועים של המוצרים שלנו בתרחישים מהעולם האמיתי. לקוחות חדשים מקבלים בחינם גם קרדיט בשווי 300$ להרצה, לבדיקה ולפריסה של עומסי העבודה.
-
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init -
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 theresourcemanager.projects.createpermission. Learn how to grant roles.
-
Verify that billing is enabled for your Google Cloud project.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init - מוודאים שאתם יודעים מהו מזהה הארגון שלכם.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול של מדיניות ארגונית בהתאמה אישית, צריך לבקש מהאדמין להקצות לכם את התפקיד אדמין של מדיניות ארגונית (roles/orgpolicy.policyAdmin) ב-IAM במשאב הארגון.
כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
משאבים נתמכים של Certificate Authority Service
בטבלה הבאה מפורטים המשאבים של Certificate Authority Service שאפשר להפנות אליהם באילוצים בהתאמה אישית.
| משאב | שדה |
|---|---|
| privateca.googleapis.com/CaPool |
resource.encryptionSpec.cloudKmsKey
|
resource.issuancePolicy.allowedIssuanceModes.allowConfigBasedIssuance
| |
resource.issuancePolicy.allowedIssuanceModes.allowCsrBasedIssuance
| |
resource.issuancePolicy.allowedKeyTypes.ellipticCurve.signatureAlgorithm
| |
resource.issuancePolicy.allowedKeyTypes.rsa.maxModulusSize
| |
resource.issuancePolicy.allowedKeyTypes.rsa.minModulusSize
| |
resource.issuancePolicy.allowRequesterSpecifiedNotBeforeTime
| |
resource.issuancePolicy.backdateDuration
| |
resource.issuancePolicy.baselineValues.additionalExtensions.critical
| |
resource.issuancePolicy.baselineValues.additionalExtensions.objectId.objectIdPath
| |
resource.issuancePolicy.baselineValues.additionalExtensions.value
| |
resource.issuancePolicy.baselineValues.aiaOcspServers
| |
resource.issuancePolicy.baselineValues.caOptions.isCa
| |
resource.issuancePolicy.baselineValues.caOptions.maxIssuerPathLength
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.certSign
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.contentCommitment
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.crlSign
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.dataEncipherment
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.decipherOnly
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.digitalSignature
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.encipherOnly
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.keyAgreement
| |
resource.issuancePolicy.baselineValues.keyUsage.baseKeyUsage.keyEncipherment
| |
resource.issuancePolicy.baselineValues.keyUsage.extendedKeyUsage.clientAuth
| |
resource.issuancePolicy.baselineValues.keyUsage.extendedKeyUsage.codeSigning
| |
resource.issuancePolicy.baselineValues.keyUsage.extendedKeyUsage.emailProtection
| |
resource.issuancePolicy.baselineValues.keyUsage.extendedKeyUsage.ocspSigning
| |
resource.issuancePolicy.baselineValues.keyUsage.extendedKeyUsage.serverAuth
| |
resource.issuancePolicy.baselineValues.keyUsage.extendedKeyUsage.timeStamping
| |
resource.issuancePolicy.baselineValues.keyUsage.unknownExtendedKeyUsages.objectIdPath
| |
resource.issuancePolicy.baselineValues.nameConstraints.critical
| |
resource.issuancePolicy.baselineValues.nameConstraints.excludedDnsNames
| |
resource.issuancePolicy.baselineValues.nameConstraints.excludedEmailAddresses
| |
resource.issuancePolicy.baselineValues.nameConstraints.excludedIpRanges
| |
resource.issuancePolicy.baselineValues.nameConstraints.excludedUris
| |
resource.issuancePolicy.baselineValues.nameConstraints.permittedDnsNames
| |
resource.issuancePolicy.baselineValues.nameConstraints.permittedEmailAddresses
| |
resource.issuancePolicy.baselineValues.nameConstraints.permittedIpRanges
| |
resource.issuancePolicy.baselineValues.nameConstraints.permittedUris
| |
resource.issuancePolicy.baselineValues.policyIds.objectIdPath
| |
resource.issuancePolicy.identityConstraints.allowSubjectAltNamesPassthrough
| |
resource.issuancePolicy.identityConstraints.allowSubjectPassthrough
| |
resource.issuancePolicy.identityConstraints.celExpression
| |
resource.issuancePolicy.maximumLifetime
| |
resource.issuancePolicy.passthroughExtensions.additionalExtensions.objectIdPath
| |
resource.issuancePolicy.passthroughExtensions.knownExtensions
| |
resource.name
| |
resource.publishingOptions.encodingFormat
| |
resource.publishingOptions.publishCaCert
| |
resource.publishingOptions.publishCrl
| |
resource.tier
| |
| privateca.googleapis.com/CertificateAuthority |
resource.config.publicKey.format
|
resource.config.publicKey.key
| |
resource.config.subjectConfig.subject.commonName
| |
resource.config.subjectConfig.subject.countryCode
| |
resource.config.subjectConfig.subject.locality
| |
resource.config.subjectConfig.subject.organization
| |
resource.config.subjectConfig.subject.organizationalUnit
| |
resource.config.subjectConfig.subject.postalCode
| |
resource.config.subjectConfig.subject.province
| |
resource.config.subjectConfig.subject.rdnSequence.attributes.objectId.objectIdPath
| |
resource.config.subjectConfig.subject.rdnSequence.attributes.type
| |
resource.config.subjectConfig.subject.rdnSequence.attributes.value
| |
resource.config.subjectConfig.subject.streetAddress
| |
resource.config.subjectConfig.subjectAltName.customSans.critical
| |
resource.config.subjectConfig.subjectAltName.customSans.objectId.objectIdPath
| |
resource.config.subjectConfig.subjectAltName.customSans.value
| |
resource.config.subjectConfig.subjectAltName.dnsNames
| |
resource.config.subjectConfig.subjectAltName.emailAddresses
| |
resource.config.subjectConfig.subjectAltName.ipAddresses
| |
resource.config.subjectConfig.subjectAltName.uris
| |
resource.config.subjectKeyId.keyId
| |
resource.config.x509Config.additionalExtensions.critical
| |
resource.config.x509Config.additionalExtensions.objectId.objectIdPath
| |
resource.config.x509Config.additionalExtensions.value
| |
resource.config.x509Config.aiaOcspServers
| |
resource.config.x509Config.caOptions.isCa
| |
resource.config.x509Config.caOptions.maxIssuerPathLength
| |
resource.config.x509Config.keyUsage.baseKeyUsage.certSign
| |
resource.config.x509Config.keyUsage.baseKeyUsage.contentCommitment
| |
resource.config.x509Config.keyUsage.baseKeyUsage.crlSign
| |
resource.config.x509Config.keyUsage.baseKeyUsage.dataEncipherment
| |
resource.config.x509Config.keyUsage.baseKeyUsage.decipherOnly
| |
resource.config.x509Config.keyUsage.baseKeyUsage.digitalSignature
| |
resource.config.x509Config.keyUsage.baseKeyUsage.encipherOnly
| |
resource.config.x509Config.keyUsage.baseKeyUsage.keyAgreement
| |
resource.config.x509Config.keyUsage.baseKeyUsage.keyEncipherment
| |
resource.config.x509Config.keyUsage.extendedKeyUsage.clientAuth
| |
resource.config.x509Config.keyUsage.extendedKeyUsage.codeSigning
| |
resource.config.x509Config.keyUsage.extendedKeyUsage.emailProtection
| |
resource.config.x509Config.keyUsage.extendedKeyUsage.ocspSigning
| |
resource.config.x509Config.keyUsage.extendedKeyUsage.serverAuth
| |
resource.config.x509Config.keyUsage.extendedKeyUsage.timeStamping
| |
resource.config.x509Config.keyUsage.unknownExtendedKeyUsages.objectIdPath
| |
resource.config.x509Config.nameConstraints.critical
| |
resource.config.x509Config.nameConstraints.excludedDnsNames
| |
resource.config.x509Config.nameConstraints.excludedEmailAddresses
| |
resource.config.x509Config.nameConstraints.excludedIpRanges
| |
resource.config.x509Config.nameConstraints.excludedUris
| |
resource.config.x509Config.nameConstraints.permittedDnsNames
| |
resource.config.x509Config.nameConstraints.permittedEmailAddresses
| |
resource.config.x509Config.nameConstraints.permittedIpRanges
| |
resource.config.x509Config.nameConstraints.permittedUris
| |
resource.config.x509Config.policyIds.objectIdPath
| |
resource.gcsBucket
| |
resource.keySpec.algorithm
| |
resource.keySpec.cloudKmsKeyVersion
| |
resource.lifetime
| |
resource.name
| |
resource.subordinateConfig.certificateAuthority
| |
resource.subordinateConfig.pemIssuerChain.pemCertificates
| |
resource.type
| |
resource.userDefinedAccessUrls.aiaIssuingCertificateUrls
| |
resource.userDefinedAccessUrls.crlAccessUrls
| |
| privateca.googleapis.com/CertificateTemplate |
resource.description
|
resource.identityConstraints.allowSubjectAltNamesPassthrough
| |
resource.identityConstraints.allowSubjectPassthrough
| |
resource.identityConstraints.celExpression
| |
resource.maximumLifetime
| |
resource.name
| |
resource.passthroughExtensions.additionalExtensions.objectIdPath
| |
resource.passthroughExtensions.knownExtensions
| |
resource.predefinedValues.additionalExtensions.critical
| |
resource.predefinedValues.additionalExtensions.objectId.objectIdPath
| |
resource.predefinedValues.additionalExtensions.value
| |
resource.predefinedValues.aiaOcspServers
| |
resource.predefinedValues.caOptions.isCa
| |
resource.predefinedValues.caOptions.maxIssuerPathLength
| |
resource.predefinedValues.keyUsage.baseKeyUsage.certSign
| |
resource.predefinedValues.keyUsage.baseKeyUsage.contentCommitment
| |
resource.predefinedValues.keyUsage.baseKeyUsage.crlSign
| |
resource.predefinedValues.keyUsage.baseKeyUsage.dataEncipherment
| |
resource.predefinedValues.keyUsage.baseKeyUsage.decipherOnly
| |
resource.predefinedValues.keyUsage.baseKeyUsage.digitalSignature
| |
resource.predefinedValues.keyUsage.baseKeyUsage.encipherOnly
| |
resource.predefinedValues.keyUsage.baseKeyUsage.keyAgreement
| |
resource.predefinedValues.keyUsage.baseKeyUsage.keyEncipherment
| |
resource.predefinedValues.keyUsage.extendedKeyUsage.clientAuth
| |
resource.predefinedValues.keyUsage.extendedKeyUsage.codeSigning
| |
resource.predefinedValues.keyUsage.extendedKeyUsage.emailProtection
| |
resource.predefinedValues.keyUsage.extendedKeyUsage.ocspSigning
| |
resource.predefinedValues.keyUsage.extendedKeyUsage.serverAuth
| |
resource.predefinedValues.keyUsage.extendedKeyUsage.timeStamping
| |
resource.predefinedValues.keyUsage.unknownExtendedKeyUsages.objectIdPath
| |
resource.predefinedValues.nameConstraints.critical
| |
resource.predefinedValues.nameConstraints.excludedDnsNames
| |
resource.predefinedValues.nameConstraints.excludedEmailAddresses
| |
resource.predefinedValues.nameConstraints.excludedIpRanges
| |
resource.predefinedValues.nameConstraints.excludedUris
| |
resource.predefinedValues.nameConstraints.permittedDnsNames
| |
resource.predefinedValues.nameConstraints.permittedEmailAddresses
| |
resource.predefinedValues.nameConstraints.permittedIpRanges
| |
resource.predefinedValues.nameConstraints.permittedUris
| |
resource.predefinedValues.policyIds.objectIdPath
|
הגדרת אילוץ בהתאמה אישית
אילוץ מותאם אישית מוגדר בקובץ YAML לפי המשאבים, השיטות, התנאים והפעולות שנתמכים בשירות שבו אתם אוכפים את מדיניות הארגון. התנאים של האילוצים המותאמים אישית מוגדרים באמצעות Common Expression Language (CEL). בקטע CEL במאמר יצירה וניהול של אילוצים בהתאמה אישית מוסבר איך ליצור תנאים באילוצים בהתאמה אישית באמצעות CEL.
המסוף
כדי ליצור אילוץ בהתאמה אישית:
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- לוחצים על Custom constraint.
- בתיבה Display name, מזינים שם לאילוץ שיהיה קריא לאנשים. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים (PII) או במידע רגיש בשמות לתצוגה, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים.
-
בתיבה Constraint ID, מזינים את המזהה שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה
custom.enforceCaPoolEncodingFormat. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.), לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. - בתיבה Description, מזינים תיאור של האילוץ שקריא לאנשים. התיאור הזה משמש כהודעת שגיאה כשיש הפרה של המדיניות. ציינו פרטים על הסיבה להפרת המדיניות ואיך לפתור את הבעיה. אל תכללו פרטים אישיים מזהים או מידע רגיש בתיאור, כי הם עלולים להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 2,000 תווים.
-
בתיבה Resource type, בוחרים את השם של משאב ה- Google Cloud REST שמכיל את האובייקט והשדה שרוצים להגביל, לדוגמה
container.googleapis.com/Cluster. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
בקטע Enforcement method, בוחרים אם לאכוף את המגבלה על שיטת REST
CREATEאו על שתי השיטותCREATEו-UPDATE. אם אוכפים את האילוץ באמצעות השיטהUPDATEבמשאב שמפר את האילוץ, מדיניות הארגון חוסמת את השינויים במשאב הזה, אלא אם השינוי פותר את ההפרה. - כדי להגדיר תנאי, לוחצים על עריכת התנאי.
-
בחלונית Add condition, יוצרים תנאי CEL שמתייחס למשאב שירות נתמך, לדוגמה
resource.autopilot.enabled == false. השדה הזה יכול להכיל עד 1,500 תווים. לפרטים על השימוש ב-CEL, ראו Common Expression Language. מידע נוסף על משאבי השירות שבהם אפשר להשתמש באילוצים מותאמים אישית מופיע במאמר שירותים שנתמכים באילוצים מותאמים אישית. - לוחצים על Save.
- בקטע Action, בוחרים אם לאשר או לדחות את השיטה שנבדקה אם התנאי מתקיים.
- לוחצים על Create constraint.
כדי לראות את השיטות הנתמכות בכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
פעולת הדחייה פירושה שהפעולה ליצירה או לעדכון של המשאב נחסמת אם התנאי מקבל את הערך True.
פעולת ההרשאה מאפשרת ליצור או לעדכן את המשאב רק אם התנאי מתקיים. כל מקרה אחר, מלבד אלה שרשומים במפורש בתנאי, נחסם.
אחרי שמזינים ערך בכל שדה, הגדרת ה-YAML המקבילה לאילוץ המותאם אישית הזה מופיעה בצד שמאל.
gcloud
- כדי ליצור אילוץ בהתאמה אישית, יוצרים קובץ YAML בפורמט הבא:
-
ORGANIZATION_ID: מזהה הארגון, למשל123456789. -
CONSTRAINT_NAME: השם שרוצים לתת לאילוץ החדש בהתאמה אישית. אילוץ בהתאמה אישית יכול להכיל רק אותיות (כולל אותיות רישיות וקטנות) או מספרים, לדוגמה,custom.enforceCaPoolEncodingFormat. השדה הזה יכול להכיל עד 70 תווים, לא כולל הקידומת (custom.) – לדוגמה,organizations/123456789/customConstraints/custom. אל תכללו פרטים אישיים מזהים או מידע רגיש במזהה האילוץ, כי הם עלולים להיחשף בהודעות שגיאה. -
RESOURCE_NAME: השם המלא של המשאב ב- Google Cloudשמכיל את האובייקט והשדה שרוצים להגביל. לדוגמה,privateca.googleapis.com/CaPool. רוב סוגי המשאבים תומכים בעד 20 אילוצים בהתאמה אישית. אם תנסו ליצור יותר אילוצים בהתאמה אישית, הפעולה תיכשל. -
methodTypes: השיטות של REST שעליהן נאכף האילוץ. יכול להיותCREATEאו גםCREATEוגםUPDATE. אם אוכפים את האילוץ באמצעות השיטהUPDATEבמשאב שמפר את האילוץ, מדיניות הארגון חוסמת את השינויים במשאב הזה, אלא אם השינוי פותר את ההפרה. -
CONDITION: תנאי CEL שנכתב כנגד ייצוג של משאב שירות נתמך. השדה הזה יכול להכיל עד 1,500 תווים. לדוגמה,"resource.publishingOptions.encodingFormat == 'DER'". -
ACTION: הפעולה שצריך לבצע אם התנאיconditionמתקיים. הערכים האפשריים הםALLOWו-DENY. -
DISPLAY_NAME: שם קריא לאנשים של האילוץ. השם הזה מופיע בהודעות שגיאה ואפשר להשתמש בו לזיהוי ולניפוי באגים. אל תשתמשו בפרטים אישיים מזהים או במידע רגיש בשמות המוצגים, כי השם הזה עלול להיחשף בהודעות שגיאה. השדה הזה יכול להכיל עד 200 תווים. -
DESCRIPTION: תיאור קריא של האילוץ שיוצג כהודעת שגיאה במקרה של הפרת המדיניות. השדה הזה יכול להכיל עד 2,000 תווים. -
אחרי שיוצרים את קובץ ה-YAML לאילוץ חדש בהתאמה אישית, צריך להגדיר אותו כדי שיהיה זמין למדיניות הארגון. כדי להגדיר אילוץ בהתאמה אישית, משתמשים בפקודה
gcloud org-policies set-custom-constraint: -
כדי לוודא שהאילוץ המותאם אישית קיים, משתמשים בפקודה
gcloud org-policies list-custom-constraints:
name: organizations/ORGANIZATION_ID/customConstraints/CONSTRAINT_NAME resourceTypes: RESOURCE_NAME methodTypes: - CREATE
- UPDATE condition: "CONDITION" actionType: ACTION displayName: DISPLAY_NAME description: DESCRIPTION
מחליפים את מה שכתוב בשדות הבאים:
כדי לראות את השיטות הנתמכות לכל שירות, חפשו את השירות במאמר שירותים שתומכים באילוצים בהתאמה אישית.
למידע נוסף על המשאבים הזמינים לכתיבת תנאים, ראו משאבים נתמכים.
הפעולה allow פירושה שאם התנאי מקבל את הערך true, מותר ליצור או לעדכן את המשאב. זה גם אומר שכל מקרה אחר, מלבד המקרה שמופיע במפורש בתנאי, נחסם.
פעולת הדחייה פירושה שאם התנאי מקבל את הערך True, הפעולה ליצירה או לעדכון של המשאב נחסמת.
gcloud org-policies set-custom-constraint CONSTRAINT_PATH
מחליפים את CONSTRAINT_PATH בנתיב המלא לקובץ האילוץ בהתאמה אישית. לדוגמה, /home/user/customconstraint.yaml.
בסיום הפעולה, האילוצים המותאמים אישית יהיו זמינים כמדיניות ארגונית ברשימת Google Cloud כללי המדיניות של הארגון.
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_ID
מחליפים את ORGANIZATION_ID במזהה של משאב הארגון.
אכיפה של מדיניות ארגונית בהתאמה אישית
כדי לאכוף אילוץ, אתם יכולים ליצור מדיניות ארגון שמפנה אליו, ואז להחיל את מדיניות הארגון על משאב Google Cloud .המסוף
- במסוף Google Cloud , נכנסים לדף מדיניות הארגון.
- בכלי לבחירת פרויקטים, בוחרים את הפרויקט שרוצים להגדיר לו את מדיניות הארגון.
- ברשימה שבדף מדיניות הארגון, בוחרים את האילוץ כדי להציג את הדף Policy details של אותו אילוץ.
- כדי להגדיר את מדיניות הארגון למשאב הזה, לוחצים על ניהול המדיניות.
- בדף עריכת המדיניות, בוחרים באפשרות במקום המדיניות של המשאב הראשי.
- לוחצים על Add a rule.
- בקטע Enforcement, בוחרים אם לאכוף את מדיניות הארגון הזו או לא.
- אופציונלי: כדי להוסיף תנאי למדיניות הארגון שמבוסס על תג, לוחצים על Add condition. שימו לב: אם מוסיפים כלל מותנה למדיניות הארגון, צריך להוסיף לפחות כלל אחד לא מותנה, אחרת אי אפשר לשמור את המדיניות. מידע נוסף זמין במאמר הגדרת ההיקף של מדיניות הארגון באמצעות תגים.
- לוחצים על בדיקת השינויים כדי לדמות את ההשפעה של מדיניות הארגון. למידע נוסף, קראו את המאמר בדיקת שינויים במדיניות הארגון באמצעות סימולטור המדיניות.
- כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, לוחצים על הגדרת המדיניות להרצת בדיקה. למידע נוסף, קראו את המאמר בדיקת כללי מדיניות של הארגון.
- אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמו שצריך, לוחצים על Set policy כדי להגדיר את המדיניות הפעילה.
gcloud
- כדי ליצור מדיניות ארגונית עם כללים בוליאניים, יוצרים קובץ YAML של מדיניות שמפנה לאילוץ:
-
PROJECT_ID: הפרויקט שבו רוצים לאכוף את האילוץ. -
CONSTRAINT_NAME: השם שהגדרתם לאילוץ המותאם אישית. לדוגמה,custom.enforceCaPoolEncodingFormat. -
כדי לאכוף את מדיניות הארגון במצב פרימטר לבדיקות, מריצים את הפקודה הבאה עם הדגל
dryRunSpec: -
אחרי שמוודאים שמדיניות הארגון במצב פרימטר לבדיקות פועלת כמצופה, מגדירים את המדיניות הפעילה באמצעות הפקודה
org-policies set-policyוהדגלspec:
name: projects/PROJECT_ID/policies/CONSTRAINT_NAME spec: rules: - enforce: true dryRunSpec: rules: - enforce: true
מחליפים את מה שכתוב בשדות הבאים:
gcloud org-policies set-policy POLICY_PATH --update-mask=dryRunSpec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
gcloud org-policies set-policy POLICY_PATH --update-mask=spec
מחליפים את POLICY_PATH בנתיב המלא לקובץ ה-YAML של מדיניות הארגון. המדיניות תיכנס לתוקף תוך 15 דקות לכל היותר.
בדיקת מדיניות הארגון בהתאמה אישית
בדוגמה הבאה נוצרת מדיניות עם אילוץ בהתאמה אישית, שדורשת שכל המשאבים של מאגר רשויות האישורים (CaPool) בפרויקט ספציפי ינפיקו אישורים עם משך חיים מקסימלי של עד 30 יום.
לפני שמתחילים, חשוב לדעת את הדברים הבאים:
- מזהה הארגון שלכם
- מזהה פרויקט
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות לניהול אילוצים בהתאמה אישית, להפעלת ממשקי API ולניהול משאבים של שירות CA, צריך לבקש מהאדמין את התפקידים הבאים ב-IAM:
- אדמין של מדיניות הארגון (
roles/orgpolicy.policyAdmin) בארגון - אדמין של שירות CA (
roles/privateca.admin) בפרויקט - אדמין של שימוש בשירות (
roles/serviceusage.serviceUsageAdmin) בפרויקט
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
הפעלת ה-API של שירות מדיניות הארגון
הפקודות של gcloud org-policies דורשות את ה-API של orgpolicy.googleapis.com. מפעילים את ה-API הזה בפרויקט:
gcloud services enable orgpolicy.googleapis.com --project=PROJECT_ID
מחליפים את PROJECT_ID במזהה הפרויקט.
יצירת האילוץ
שומרים את הקובץ הבא בשם
constraint-cas-capool-lifetime.yaml:name: organizations/ORGANIZATION_ID/customConstraints/custom.enforceCasMaxLifetime30d resourceTypes: - privateca.googleapis.com/CaPool methodTypes: - CREATE - UPDATE condition: "!has(resource.issuancePolicy.maximumLifetime) || duration(resource.issuancePolicy.maximumLifetime) > duration('2592000s')" actionType: DENY displayName: Enforce Max Certificate Lifetime (30 Days) description: Only allows CaPools where the issuancePolicy.maximumLifetime field is set to 30 days (2592000 seconds) or less.מחליפים את
ORGANIZATION_IDבמזהה הארגון.מחילים את האילוץ הבא:
gcloud org-policies set-custom-constraint ~/constraint-cas-capool-lifetime.yamlמוודאים שהאילוץ קיים:
gcloud org-policies list-custom-constraints --organization=ORGANIZATION_IDמחליפים את
ORGANIZATION_IDבמזהה הארגון.
יצירת המדיניות
שומרים את הקובץ הבא בשם
policy-cas-capool-lifetime.yaml:name: projects/PROJECT_ID/policies/custom.enforceCasMaxLifetime30d spec: rules: - enforce: trueמחליפים את
PROJECT_IDבמזהה הפרויקט.מחילים את המדיניות הבאה:
gcloud org-policies set-policy ~/policy-cas-capool-lifetime.yamlמוודאים שהמדיניות קיימת:
gcloud org-policies list --project=PROJECT_IDמחליפים את
PROJECT_IDבמזהה הפרויקט.
אחרי שמחילים את המדיניות, צריך להמתין כ-15 דקות עד ש- Google Cloud יתחיל לאכוף אותה. מידע נוסף זמין במאמר יצירה וניהול של מדיניות הארגון.
בדיקת המדיניות
כדי לבדוק את האילוץ המותאם אישית, תיצרו ותעדכנו מאגר של CA Service באמצעות ה-CLI של gcloud.
מגדירים משתנים למשאבי הבדיקה:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
LOCATION: האזור של מאגר ה-CA, לדוגמהus-west1 -
POOL_NAME: שם למאגר ה-CA לבדיקה, למשלmy-test-pool
יוצרים מאגר רשויות להנפקת אישורים (CA) עם משך חיים מקסימלי של יותר מ-30 ימים:
יוצרים קובץ YAML בשם
capool_violating.yamlעםmaximumLifetimeשל יותר מ-30 ימים (לדוגמה, 31 ימים, שהם 2,678,400 שניות). השדהmaximumLifetimeמוגדר בשניות.# capool_violating.yaml maximumLifetime: 2678400sכדי ליצור מאגר CA שמפר את המדיניות, מריצים את הפקודה הבאה:
# This creation should be blocked by the policy gcloud privateca pools create POOL_NAME-violating \ --location LOCATION \ --project PROJECT_ID \ --issuance-policy capool_violating.yamlהפקודה נכשלת עם השגיאה
FAILED_PRECONDITION, שמציינת הפרה של האילוץcustomConstraints/custom.enforceCasMaxLifetime30d.יוצרים מאגר CA עם משך חיים מקסימלי תואם:
יוצרים קובץ YAML בשם
capool_compliant.yamlעםmaximumLifetimeשל 30 ימים (2,592,000 שניות). השדהmaximumLifetimeמוגדר בשניות.# capool_compliant.yaml maximumLifetime: 2592000sכדי ליצור את מאגר ה-CA, מריצים את הפקודה הבאה:
gcloud privateca pools create POOL_NAME \ --location "LOCATION" \ --project "PROJECT_ID" \ --issuance-policy capool_compliant.yamlהפקודה הושלמה בהצלחה.
מנסים לעדכן את מאגר ה-CA לתקופת תוקף מקסימלית שלא עומדת בדרישות:
מריצים את הפקודה הבאה כדי להחיל את ההגדרות מ-
capool_violating.yaml:# This update is blocked by the policy gcloud privateca pools update POOL_NAME \ --location "LOCATION" \ --project "PROJECT_ID" \ --issuance-policy capool_violating.yamlהפקודה הזו נכשלת עם השגיאה
FAILED_PRECONDITION, שמציינת הפרה של האילוץcustomConstraints/custom.enforceCasMaxLifetime30d.עדכון מאגר ה-CA לתקופת תוקף מקסימלית אחרת שתואמת למדיניות
יוצרים קובץ YAML בשם
capool_compliant_update.yamlעםmaximumLifetimeשל 15 ימים (1,296,000 שניות). השדהmaximumLifetimeמוגדר בשניות.# capool_compliant_update.yaml maximumLifetime: 1296000sכדי לעדכן את מאגר ה-CA, מריצים את הפקודה הבאה:
gcloud privateca pools update POOL_NAME \ --location "LOCATION" \ --project "PROJECT_ID" \ --issuance-policy capool_compliant_update.yamlהפקודה הושלמה בהצלחה.
מחיקת משאבי הבדיקה.
מוחקים את מאגר ה-CA שנוצר במהלך הבדיקה:
gcloud privateca pools delete POOL_NAME \ --location "LOCATION" \ --project "PROJECT_ID" \
דוגמאות למדיניות ארגונית בהתאמה אישית לתרחישים נפוצים
בטבלה הבאה מופיעות דוגמאות לתחביר של כמה אילוצים נפוצים בהתאמה אישית.
| תיאור | תחביר האילוץ |
|---|---|
| אכיפה של אלגוריתמים ספציפיים של מפתחות לכל רשויות האישורים (CA) |
מוודאת שכל רשות אישורים חדשה משתמשת באחד מאלגוריתמי המפתחות המותרים. name: organizations/ORGANIZATION_ID/customConstraints/custom.casAllowedKeyAlgos resourceTypes: - privateca.googleapis.com/CertificateAuthority methodTypes: - CREATE - UPDATE condition: "resource.keySpec.algorithm in ['EC_P256_SHA256', 'RSA_PSS_3072_SHA256']" actionType: ALLOW displayName: Restrict CA Key Algorithms description: Only allows specific key algorithms for new CAs. |
| דרישה לשם ארגון ספציפי בנושא של רשות האישורים (CA) |
מוודא שבכל רשויות האישורים החדשות יש שדה name: organizations/ORGANIZATION_ID/customConstraints/custom.casRequireSubjectOrg resourceTypes: - privateca.googleapis.com/CertificateAuthority methodTypes: - CREATE - UPDATE condition: "resource.config.subjectConfig.subject.organization == 'Example Company Inc.'" actionType: ALLOW displayName: Enforce CA Subject Organization description: Requires new CAs to have the specified organization name. |
| אכיפת משך החיים המקסימלי של אישורים ב-CaPools |
מוודא שמאגרי ה-CA מוגדרים להנפיק אישורים עם משך חיים מקסימלי של עד 30 ימים. name: organizations/ORGANIZATION_ID/customConstraints/custom.enforceCasMaxLifetime30d resourceTypes: - privateca.googleapis.com/CaPool methodTypes: - CREATE - UPDATE condition: "!has(resource.issuancePolicy.maximumLifetime) || duration(resource.issuancePolicy.maximumLifetime) > duration('2592000s')" actionType: DENY displayName: Enforce Max Certificate Lifetime (30 Days) description: Only allows CaPools where the issuancePolicy.maximumLifetime field is set to 30 days (2592000 seconds) or less. |
המאמרים הבאים
- מידע נוסף על שירות מדיניות הארגון
- איך יוצרים ומנהלים את מדיניות הארגון
- רשימה מלאה של אילוצים מנוהלים של מדיניות הארגון