מידע נוסף על איחוד שירותי אימות הזהות של כוח עבודה זמין במאמר איחוד שירותי אימות הזהות של כוח עבודה.
מידע נוסף על המגבלות של איחוד שירותי אימות הזהות של כוח העבודה ב-Secure Source Manager מופיע במאמר איחוד שירותי אימות הזהות: מוצרים ומגבלות.
Secure Source Manager הוא שירות לדייר יחיד. מומלץ שמופע יחיד של Secure Source Manager יכלול רק משתמשים מלקוח אחד שלGoogle Cloud , אלא אם כמה חברות שיש ביניהן קשר חוזי צריכות להשתמש במופע יחיד לצורך שיתוף פעולה.
אם אתם עובדים עם כמה חברות ורוצים לשתף איתן פעולה בקוד המקור, מומלץ ליצור מופע נפרד לכל חברה.
לפני שמתחילים
-
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.
Enable the Secure Source Manager API, if it is not already enabled.
Roles required to enable APIs
To enable APIs, you need the
serviceusage.services.enablepermission. 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.-
Install the Google Cloud CLI.
-
Configure the gcloud CLI to use your federated identity.
For more information, see Sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
הצפנת הנתונים
כברירת מחדל, Google Cloud מצפין באופן אוטומטי נתונים במנוחה באמצעותGoogle-owned and Google-managed encryption keys. אם יש לכם דרישות ספציפיות בנושא תאימות או רגולציה שקשורות למפתחות שמגנים על הנתונים שלכם, אתם יכולים ליצור מופעים של Secure Source Manager שמוצפנים באמצעות מפתחות הצפנה בניהול הלקוח (CMEK).
אל תשמרו נתונים רגישים במזהי מופעים או בצמדי מפתח/ערך של תוויות, כי הם לא מוצפנים באמצעות CMEK.
אם אתם יוצרים את המופע הראשון של Secure Source Manager בפרויקט, אתם צריכים ליצור באופן ידני את סוכן השירות של Secure Source Manager על ידי הפעלת הפקודה הבאה:
gcloud beta services identity create \
--service=securesourcemanager.googleapis.com \
--project=PROJECT_ID
PROJECT_ID הוא מזהה הפרויקט שבו יוצרים את המכונה של Secure Source Manager.
אחרי שיוצרים את סוכן השירות של Secure Source Manager, צריך להקצות את התפקיד "סוכן השירות של Secure Source Manager" (roles/securesourcemanager.serviceAgent) לחשבון הראשי service-PROJECT-NUMBER@gcp-sa-sourcemanager., אחרת יצירת המכונה תיכשל.
הגדרת איחוד שירותי אימות הזהות של כוח העבודה
לפני שיוצרים מופע, צריך להגדיר מאגר וספק של איחוד שירותי אימות הזהות של כוח עבודה.
מגדירים את הספק של מאגר הזהויות של כוח העבודה עם מיפויי המאפיינים הבאים:
google.subjectgoogle.email
יצירת מכונה
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- INSTANCE_ID: השם של המכונה שרוצים ליצור.
- LOCATION: האזור שבו רוצים ליצור את המכונה. למידע על מיקומים נתמכים, ראו מיקומים.
- PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המופע.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud source-manager instances create INSTANCE_ID --region=LOCATION --project=PROJECT_ID --enable-workforce-identity-federation
Windows (PowerShell)
gcloud source-manager instances create INSTANCE_ID --region=LOCATION --project=PROJECT_ID --enable-workforce-identity-federation
Windows (cmd.exe)
gcloud source-manager instances create INSTANCE_ID --region=LOCATION --project=PROJECT_ID --enable-workforce-identity-federation
מתחילה פעולה ממושכת של יצירת מכונה. הפלט אמור להיראות כך:
Create request issued for [my-instance].
done: false
metadata:
'@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
apiVersion: v1
createTime: '2023-02-27T20:57:52.315609549Z'
requestedCancellation: false
target: projects/my-project/locations/us-central1/instances/my-instance
verb: create
name: projects/my-project/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
כאשר projects/my-project/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e הוא OPERATION_NAME.
חשוב לרשום את OPERATION_NAME כי תצטרכו להשתמש בו כדי לבדוק את סטטוס הפעולה.
יצירת המכונה נמשכת עד 60 דקות.
API
לפני שמריצים את הפקודה, מחליפים את הערכים הבאים:
- INSTANCE_ID: השם של המכונה שרוצים ליצור.
- LOCATION: האזור שבו רוצים ליצור את המכונה. מידע על מיקומים נתמכים זמין במאמר מיקומים.
- PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את המופע.
מריצים את הפקודה הבאה:
curl \
-X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://securesourcemanager.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?instance_id=INSTANCE_ID \
-H "Content-Type: application/json" \
-d "{workforce_identity_federation_config: {enabled: true}}"
מתחילה פעולה ממושכת של יצירת מכונה. הפלט אמור להיראות כך:
{
"name": "OPERATION_NAME",
"metadata": {
"@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
"createTime": "2022-11-01T14:31:32.420469714Z",
"target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
הפלט לדוגמה כולל את הערכים הבאים:
-
OPERATION_NAME: שם הפעולה, לדוגמה,projects/my-project/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e. -
PROJECT_ID: הפרויקט Google Cloud . -
LOCATION: האזור שבו נמצאת המכונה.
מתעדים את הערך של OPERATION_NAME כי צריך להשתמש בו כדי לבדוק את סטטוס הפעולה.
יצירת המכונה נמשכת עד 60 דקות.
Terraform
בדוגמה הבאה נוצר מופע של Secure Source Manager עם איחוד שירותי אימות הזהות של כוח העבודה:
resource "google_secure_source_manager_instance" "instance" {
instance_id = "INSTANCE_ID"
location = "LOCATION"
project = "PROJECT_ID"
workforce_identity_federation_config {
enabled = true
}
}
בדיקת סטטוס הפעולה
gcloud
לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- OPERATION_NAME: שם הפעולה מהתגובה לפקודת היצירה.
- LOCATION: האזור של המכונה.
מריצים את הפקודה הבאה:
Linux, macOS או Cloud Shell
gcloud source-manager operations describe OPERATION_NAME --region=LOCATION
Windows (PowerShell)
gcloud source-manager operations describe OPERATION_NAME --region=LOCATION
Windows (cmd.exe)
gcloud source-manager operations describe OPERATION_NAME --region=LOCATION
כשהמכונה מוכנה, התגובה תיראה בערך כך:
"name": "projects/my-project/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
"metadata": {
"@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
"createTime": "2022-11-01T14:31:32.420469714Z",
"endTime": "2022-11-01T14:48:34.140378114Z",
"target": "projects/my-project/locations/us-central1/instances/my-instance",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
"name": "projects/my-project/locations/us-central1/instances/my-instance",
"createTime": "2022-11-01T14:31:32.416413630Z",
"updateTime": "2022-11-01T14:31:32.416413630Z",
"labels": {
"ldap": "user",
"source": "manual"
},
"state": "ACTIVE",
"hostConfig": {
"html": "my-instance-098765432109.us-central1.sourcemanager.dev",
"api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
"gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
}
}
כאשר my-instance-098765432109.us-central1.sourcemanager.dev הוא כתובת ה-URL של המכונה ב-HTML.
API
לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:
- OPERATION_NAME: שם הפעולה מהתגובה לפקודת היצירה.
ה-method של ה-HTTP וכתובת ה-URL:
GET https://securesourcemanager.googleapis.com/v1/OPERATION_NAME
כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:
כשהמכונה מוכנה, התגובה תיראה בערך כך:
"name": "projects/my-project/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
"metadata": {
"@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
"createTime": "2024-10-28T15:37:39.009812863Z",
"endTime": "2024-10-28T16:10:58.416640259Z",
"target": "projects/my-project/locations/us-central1/instances/my-instance",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": true,
"response": {
"@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
"name": "projects/my-project/locations/us-central1/instances/my-instance",
"createTime": "2024-10-28T15:37:39.004550840Z",
"updateTime": "2024-10-28T15:37:39.867857246Z",
"state": "ACTIVE",
"hostConfig": {
"html": "my-instance-326202322590.us-central1.sourcemanager.dev",
"api": "my-instance-326202322590-api.us-central1.sourcemanager.dev",
"gitHttp": "my-instance-326202322590-git.us-central1.sourcemanager.dev",
"gitSsh": "my-instance-326202322590-ssh.us-central1.sourcemanager.dev"
},
"workforceIdentityFederationConfig": {
"enabled": true
}
}
כאשר my-instance-098765432109.us-central1.sourcemanager.dev הוא כתובת ה-URL של המכונה ב-HTML.
מעתיקים את כתובת ה-URL של ה-HTML מהתגובה של סטטוס הבדיקה שהצליחה. כתובת ה-URL הזו נדרשת כדי לגשת למופע דרך ממשק האינטרנט שלו.
גישה למכונה
אחרי שיוצרים את המופע, אפשר לגשת אליו דרך ממשק האינטרנט שלו באמצעות דפדפן.
-
כדי לגשת למופע של Secure Source Manager דרך ממשק האינטרנט שלו, מעתיקים את כתובת ה-URL הבאה לסרגל הכתובות בדפדפן.
INSTANCE_ID-PROJECT_NUMBER.LOCATION.sourcemanager.devמחליפים את מה שכתוב בשדות הבאים:
- INSTANCE_ID בשם המכונה.
- PROJECT_NUMBER עם מספר הפרויקט של המופע. Google Cloud מידע על זיהוי פרויקטים זמין במאמר זיהוי פרויקטים.
- LOCATION באזור של המכונה.
מופיע מסך OAuth שבו צריך להזין את שם הספק.
מזינים את השם של ספק הזהויות של כוח העבודה בפורמט הבא:
locations/global/workforcePools/POOL_ID/providers/PROVIDER_IDמחליפים את מה שכתוב בשדות הבאים:
-
POOL_IDבמזהה המאגר של איחוד שירותי אימות הזהות של כוח העבודה. -
PROVIDER_IDעם מזהה הספק של איחוד שירותי אימות הזהות של כוח העבודה.
מידע נוסף על ספקים ומאגרים של איחוד שירותי אימות הזהות של כוח עבודה זמין במאמר ניהול ספקים ומאגרים של איחוד שירותי אימות הזהות של כוח עבודה.
תתבקשו להיכנס באמצעות פרטי הכניסה של הספק.
-
נכנסים באמצעות פרטי הכניסה של הספק.
ממשק האינטרנט של Secure Source Manager נפתח. כאן אפשר ליצור ולראות מאגרים, בעיות ובקשות משיכה.
צריך להיכנס שוב דרך ממשק האינטרנט אחרי שמשך הסשן במאגר של איחוד שירותי אימות הזהות של כוח העבודה מסתיים.
יצירת הגדרות התחברות ב-CLI של gcloud
כדי לבצע אימות במכונה של Secure Source Manager באמצעות פרטי הכניסה של מאגר הזהויות של כוח העבודה, באמצעות פקודות של ה-CLI של gcloud או פקודות Git, צריך ליצור הגדרת התחברות עם מאגר הזהויות של כוח העבודה.
כדי ליצור הגדרת התחברות למאגר הזהויות של כוח העבודה, פועלים לפי ההוראות במאמר קבלת אסימונים לטווח קצר לאיחוד שירותי אימות הזהות של כוח עבודה כדי ליצור כניסה מבוססת-דפדפן באמצעות ה-CLI של gcloud.
אחרי שתבצעו אימות, תוכלו להשתמש בפקודות Git כדי ליצור אינטראקציה עם מופע Secure Source Manager. כדי להתחיל להשתמש ב-Git, אפשר לעיין במאמר בנושא שימוש ב-Git לניהול קוד מקור.