ניהול אזורים

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

בדף הזה מוסבר איך להקצות אזור חדש ל-Application Integration ולערוך אזור קיים בפרויקט ב- Google Cloud .

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

מפעילים את ממשקי ה-API הבאים:

הקצאת אזור חדש

כדי להקצות אזור חדש ל-Application Integration בפרויקט ב- Google Cloud , בוחרים אחת מהאפשרויות הבאות:

המסוף

  1. נכנסים לדף Application Integration.

    כניסה ל-Application Integration

  2. בתפריט הניווט, לוחצים על אזורים.

    מופיע הדף Regions, שבו מפורטים כל האזורים שהוקצו בפרויקט.

  3. לוחצים על הקצאת אזור חדש.
  4. מגדירים את השדות הבאים בדף Provision new region:
    1. Region: בוחרים את המיקום האזורי החדש שרוצים להקצות.

      מידע על האזורים שנתמכים ב-Application Integration זמין במאמר מיקומי Application Integration.

    2. הגדרות מתקדמות: אפשר להרחיב את הקטע הזה כדי להפעיל או להשבית את הגישה ל-HTTP בשביל שילובים, ולהגדיר את שיטת ההצפנה לאזור שנבחר.
      • ‫HTTP: לוחצים על המתג Enable HTTP כדי לאפשר גישת HTTP לשילובים באזור שנבחר. כשהאפשרות הזו מופעלת, אפשר לגשת לאינטגרציות באזור הזה דרך HTTP.
      • תכונות מבוססות-AI: לוחצים על המתג הפעלת תכונות מבוססות-AI כדי להפעיל את התכונות האלה באזור שנבחר. מידע נוסף על פתרון בעיות באמצעות Gemini AI זמין במאמר פתרון בעיות ביומני ביצוע שנכשלו באמצעות AI.
      • הצפנה: בוחרים את שיטת ההצפנה לאזור שנבחר. יש שתי אפשרויות:
        • Google-owned and Google-managed encryption key: זו שיטת ההצפנה שמוגדרת כברירת מחדל. השיטה הזו מתאימה אם אתם רוצים ש-Google תנהל את מפתחות ההצפנה שמגנים על הנתונים שלכם באזור שנבחר.
        • מפתח הצפנה בניהול הלקוח (CMEK): השתמשו בשיטה הזו אם אתם רוצים לנהל את מפתחות ההצפנה שמגנים על הנתונים שלכם באזור שנבחר.

          כשאתם קובעים את הגדרות ההצפנה, יש לכם שתי אפשרויות לניהול CMEK: ‏Application Integration ו-Connectors ‏(CMEK), ושימוש ב-CMEK אחר ל-Integration Connectors, באופן הבא:

          • ‫Application Integration and Connectors - CMEK: זו אפשרות ברירת המחדל, והיא מתאימה אם רוצים להשתמש באותו מפתח הצפנה גם ל-Application Integration וגם ל-Integration Connectors. כדי להשתמש באפשרות הזו:
            1. לוחצים על בחירת מפתח Cloud KMS ובוחרים מפתח CMEK קיים שזמין באזור שנבחר. אתם יכולים גם ליצור מפתח חדש או להשתמש במזהה המשאב ב-KMS של המפתח הקיים.
            2. לוחצים על Verify כדי לבדוק אם לחשבון השירות שמוגדר כברירת מחדל יש גישה ל-CryptoKey של מפתח ה-CMEK שנבחר.
            3. אם האימות נכשל, לוחצים על Grant כדי להקצות את תפקיד ה-IAM "הצפנה/פענוח של CryptoKey" לחשבון השירות שמוגדר כברירת מחדל.
          • Use different CMEK for Integration Connectors: מסמנים את התיבה הזו אם רוצים להשתמש במפתחות הצפנה נפרדים ל-Application Integration ול-Integration Connectors. אם בוחרים באפשרות הזו, מופיעות האפשרויות הבאות:
            • Application Integration – CMEK
              1. לוחצים על Select a Cloud KMS key ובוחרים מפתח CMEK קיים ל-Application Integration באזור שנבחר. לחלופין, אתם יכולים ליצור מפתח חדש או להשתמש במזהה המשאב של מפתח קיים.
              2. לוחצים על Verify כדי לסיים את הגדרת ה-CMEK ל-Application Integration.
            • Integration Connectors – CMEK
              1. לוחצים על Select a Cloud KMS key ובוחרים מפתח CMEK קיים ל-Integration Connectors באזור שנבחר. לחלופין, אתם יכולים ליצור מפתח חדש או להשתמש במזהה המשאב של מפתח קיים.
              2. לוחצים על Verify כדי לבדוק אם לחשבון השירות שמוגדר כברירת מחדל יש גישה ל-CryptoKey של ה-CMEK שנבחר.
              3. אם האימות של מפתח ה-CMEK שנבחר נכשל, לוחצים על Grant כדי להקצות את תפקיד ה-IAM של CryptoKey Encrypter/Decrypter לחשבון השירות שמוגדר כברירת מחדל.

          מידע נוסף על CMEK מופיע במאמר מפתחות הצפנה בניהול הלקוח.

  5. לוחצים על סיום.

Terraform

משתמשים במשאב google_integrations_client. בדוגמה הבאה מוקצה האזור us-east1: 

resource "random_id" "default" {
  byte_length = 8
}

resource "google_kms_key_ring" "default" {
  name     = "${random_id.default.hex}-example-keyring"
  location = "us-east1"
}

resource "google_kms_crypto_key" "default" {
  name            = "crypto-key-example"
  key_ring        = google_kms_key_ring.default.id
  rotation_period = "7776000s"
}

resource "google_kms_crypto_key_version" "default" {
  crypto_key = google_kms_crypto_key.default.id
}

resource "google_service_account" "default" {
  account_id   = "service-account-id"
  display_name = "Service Account"
}

resource "google_integrations_client" "example" {
  location                   = "us-east1"
  create_sample_integrations = true
  run_as_service_account     = google_service_account.default.email
  cloud_kms_config {
    kms_location   = "us-east1"
    kms_ring       = basename(google_kms_key_ring.default.id)
    key            = basename(google_kms_crypto_key.default.id)
    key_version    = basename(google_kms_crypto_key_version.default.id)
    kms_project_id = data.google_project.default.project_id
  }
}

עריכת האזור

אתם יכולים לערוך אזור קיים כדי להפעיל או להשבית את ניהול השילוב, ולעדכן את שיטת הצפנת הנתונים של האזור.

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

  1. נכנסים לדף Application Integration במסוף Google Cloud .

    כניסה ל-Application Integration

  2. בתפריט הניווט, לוחצים על אזורים.

    3. מופיע הדף Regions, שבו מפורטים האזורים שהוקצו ב-Application Integration.

  3. בעמודה פעולות, לוחצים על פעולות באזור ובוחרים באפשרות עריכה.

    החלונית Edit region תופיע.

  4. מרחיבים את הקטע הגדרות מתקדמות.
  5. כדי להפעיל או להשבית את ניהול השילובים באזור שנבחר, לוחצים על המתג Enable governance.
  6. כדי להפעיל או להשבית את הגישה ל-HTTP לאינטגרציות באזור שנבחר, לוחצים על המתג Enable HTTP. כשהאפשרות הזו מופעלת, אפשר לגשת לאינטגרציות באזור הזה דרך HTTP.
  7. כדי להפעיל או להשבית את תכונות ה-AI בשילובים באזור שנבחר, לוחצים על המתג הפעלת תכונות AI. כשההגדרה מופעלת, אתם יכולים להשתמש בתכונות מבוססות-AI כמו פתרון בעיות באמצעות Gemini AI באזור שנבחר.
  8. כדי להפעיל הסתרה של משתנים, בקטע Variable Masking לוחצים על המתג Enable Variable Masking in logs.

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

  9. כדי להפעיל הצפנת CMEK באזור שנבחר, לוחצים על Customer-managed encryption key (CMEK) ומבצעים את הפעולות הבאות:
    1. בוחרים CMEK מהרשימה הנפתחת. מפתחות ה-CMEK שמופיעים בתפריט הנפתח מבוססים על האזור שהוקצה. כדי ליצור מפתח חדש, קראו את המאמר יצירת CMEK חדש.
    2. לוחצים על Verify כדי לבדוק אם לחשבון השירות שמוגדר כברירת מחדל יש גישה ל-CryptoKey של ה-CMEK שנבחר.
    3. אם האימות של ה-CMEK שנבחר נכשל, לוחצים על Grant כדי להקצות את תפקיד ה-IAM‏ CryptoKey Encrypter/Decrypter לחשבון השירות שמוגדר כברירת מחדל.
  10. כדי להפעיל הצפנת CMEK ל-Integration Connectors, בוחרים באפשרות Use different CMEK for Integration connectors ומבצעים את הפעולות הבאות:
    1. בוחרים CMEK מהרשימה הנפתחת. מפתחות ה-CMEK שמופיעים בתפריט הנפתח מבוססים על האזור שהוקצה. כדי ליצור מפתח חדש, קראו את המאמר יצירת CMEK חדש.
    2. לוחצים על Verify כדי לסיים את הגדרת ה-CMEK של Integration Connectors.
  11. כדי לסיים את עריכת האזור, לוחצים על סיום.