קישור ל-Secure Source Manager

בדף הזה מוסבר איך ליצור חיבורים ל-Secure Source Manager ואיך לקשר למאגרים של Secure Source Manager. השילוב הזה מאפשר לכם להשתמש בתכונות של Developer Connect, כמו תצוגות של לוח הבקרה של מאגרי Secure Source Manager, ולהשתמש בשרת ה-proxy של Developer Connect כדי לבצע פעולות של git, כמו פעולות קריאה מאובטחות.

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

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.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

3. Enable the Developer Connect, Secret Manager 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. אופציונלי: יוצרים מפתח הצפנה בניהול הלקוח (CMEK) כדי להצפין את סודות האימות שנוצרים על ידי Developer Connect.
5. אופציונלי: כדי להשתמש בהוראות של שורת הפקודה במדריך הזה, מבצעים את השלבים הבאים:
   1. מתקינים את Google Cloud CLI. אם כבר התקנתם את ה-CLI של gcloud, צריך לוודא שפועלת אצלכם הגרסה העדכנית ביותר של gcloud components update.
   2. יוצרים חשבון שירות של Developer Connect באמצעות הפקודה הבאה, כאשר PROJECT_ID הוא Google Cloud מזהה הפרויקט:

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

הדרישות של Secure Source Manager

• מוודאים שיש לכם מכונה פעילה של Secure Source Manager שנפרסה באזור Google Cloud .
• חיבור Developer Connect והמכונה של Secure Source Manager צריכים להיות באותו אזור.
• מקצים לסוכן השירות של Developer Connect‏ (P4SA) את התפקיד roles/securesourcemanager.developerConnectLinker בפרויקט של המכונה של Secure Source Manager.

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

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

• כדי ליצור חיבור ולקשר למאגר: אדמין ב-Developer Connect ‏(roles/developerconnect.admin) בפרויקט שבו רוצים ליצור משאבים של Developer Connect.
• כדי לתת הרשאות לסוכן השירות של Developer Connect: צריך לקבל את התפקיד אדמין IAM של פרויקט (roles/resourcemanager.projectIamAdmin) בפרויקט שבו פועל Secure Source Manager.

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

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

יצירת חיבור

בקטע הזה מוסבר איך ליצור חיבור בין Developer Connect לבין Secure Source Manager. אם אתם משתמשים במסוף Google Cloud , אתם יכולים גם להתחיל להוסיף קישורים למאגרים כשתסיימו להגדיר את החיבור.

כדי ליצור חיבור חדש ל-Secure Source Manager, בוחרים באחת מהאפשרויות הבאות:

המסוף

1. פותחים את Developer Connect במסוף Google Cloud .

   כניסה ל-Developer Connect

2. לוחצים על יצירת חיבור.

3. בוחרים באפשרות Secure Source Manager כספק המקור.

4. בשדה Region, בוחרים אזור לחיבור. האזור צריך להיות זהה לאזור של המכונה של Secure Source Manager.

5. בקטע Name, נותנים שם לחיבור.

6. ברשימה Instance, בוחרים מכונה.

7. לוחצים על הצגת הגדרות נוספות כדי לראות הגדרות אישיות אופציונליות.

8. אופציונלי: כדי להשבית את שרת ה-proxy של Developer Connect, מבטלים את הסימון בתיבה Enable Developer Connect proxy.

   הערה: כשמשתמשים בשרת ה-proxy של Developer Connect עם Secure Source Manager, אפשר לבצע רק פעולות קריאה של git. פונקציונליות של שרת proxy ל-HTTP לא נתמכת ב-Secure Source Manager.

9. לוחצים על Continue.

10. אפשר לקשר למאגרים עכשיו, או לעשות את זה מאוחר יותר על ידי עריכת החיבור. כדי לקשר למאגרים, בוחרים מאגרים מהרשימה.

11. לוחצים על קישור.

הקישורים למאגרים נוצרים ב-Developer Connect ומוצגים במסוף Google Cloud .

gcloud

כדי ליצור חיבור של Developer Connect באמצעות Google Cloud CLI, מריצים את הפקודה הבאה:

gcloud developer-connect connections create CONNECTION_ID \
  --location=REGION \
  --project=CONNECTION_PROJECT_ID \
  --secure-source-manager-instance-config=projects/INSTANCE_PROJECT_ID/locations/REGION/instances/INSTANCE_ID

כאשר:

• ‫CONNECTION_ID הוא המזהה של חיבור Developer Connect שרוצים ליצור.
• ‫REGION הוא האזור של החיבור. האזור צריך להיות זהה לאזור של המכונה של Secure Source Manager.
• ‫CONNECTION_PROJECT_ID הוא המזהה של הפרויקט ב- Google Cloud שבו רוצים ליצור את החיבור.
• ‫INSTANCE_PROJECT_ID הוא מזהה הפרויקט ב- Google Cloud שבו נמצא המכונה של Secure Source Manager.
• ‫INSTANCE_ID הוא המזהה של המכונה של Secure Source Manager.

curl

כדי ליצור חיבור Developer Connect עם curl, מבצעים את הקריאה הבאה ל-API:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://developerconnect.googleapis.com/v1/projects/CONNECTION_PROJECT_ID/locations/REGION/connections?connection_id=CONNECTION_ID \
-X POST -H "Content-Type: application/json" \
-d '{"secure_source_manager_instance_config":{"instance":"projects/INSTANCE_PROJECT_ID/locations/REGION/instances/INSTANCE_ID"}}'

כאשר:

• ‫CONNECTION_ID הוא המזהה של חיבור Developer Connect שרוצים ליצור.
• ‫REGION הוא האזור של החיבור. האזור צריך להיות זהה לאזור של המכונה של Secure Source Manager.
• ‫CONNECTION_PROJECT_ID הוא המזהה של הפרויקט ב- Google Cloud שבו רוצים ליצור את החיבור.
• ‫INSTANCE_PROJECT_ID הוא מזהה הפרויקט ב- Google Cloud שבו נמצא המכונה של Secure Source Manager.
• ‫INSTANCE_ID הוא המזהה של המכונה של Secure Source Manager.

הוספת קישורים למאגרים לחיבורים קיימים

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

כדי ליצור קישורים למאגרים בחיבור קיים ל-Secure Source Manager, בוחרים באחת מהאפשרויות הבאות:

המסוף

1. פותחים את הדף Repositories במסוף Google Cloud .

   פותחים את הדף Repositories.

2. לוחצים על קישור המאגר.

   החלונית Link Git repositories נפתחת.

3. ברשימת החיבורים, בוחרים את החיבור ל-Secure Source Manager.

4. לוחצים על Continue.

5. ברשימת המאגרים, בוחרים את המאגרים שרוצים לקשר.

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

הקישורים למאגרים נוצרים ב-Developer Connect ומוצגים במסוף Google Cloud .

gcloud

מידע נוסף על ניהול קישורים למאגרי Git באמצעות gcloud זמין במאמר gcloud developer-connect connections git-repository-links.

שימוש בשרת proxy של Developer Connect ב-Cloud Build

כדי להשתמש בשרת ה-proxy של Developer Connect ב-Cloud Build:

1. מקצים לסוכן השירות של Secure Source Manager את התפקיד roles/developerconnect.viewer, או כל תפקיד עם ההרשאה developerconnect.gitRepositoryLinks.get, בפרויקט Developer Connect.
2. מקשרים את המאגר ב-Secure Source Manager ל-gitRepositoryLink ב-Developer Connect. הוראות מפורטות זמינות במאמר קישור למאגר של Secure Source Manager.

3. בקובץ .cloudbuild/trigger.yaml בתיקיית השורש של המאגר, מוסיפים רשומה חדשה שמפנה למשאב היעד gitRepositoryLink.

   לדוגמה:

   triggers:
   - name: test-trigger
     project: my-project
     configFilePath: cloudbuild.yaml
     eventType: push
     serviceAccount: projects/my-project/serviceAccounts/my-sa@my-project.
     devConnectGitRepositoryLink: projects/my-project/locations/us-central1/connections/my-ssm-connection/gitRepositoryLinks/my-repo-link
   

היקף הפעילות והמגבלות

אחרי שמגדירים את החיבור, אפשר לבצע פעולות קריאה מאובטחות של git, כמו clone, במכונות של Secure Source Manager באמצעות ה-URI של שרת ה-proxy של Developer Connect.

שרת ה-proxy של Developer Connect לא תומך בפעולות git push. המערכת מונעת פעולות כתיבה שמשתמשות בזהות של DevConnect P4SA.

אתם יכולים לעדכן הגדרות אחרות של החיבור, למשל להפעיל או להשבית את שרת ה-proxy של Developer Connect, אבל אתם לא יכולים להפנות את החיבור הקיים למכונה אחרת של Secure Source Manager.

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

• מידע נוסף על Developer Connect
• מידע נוסף על Secure Source Manager