‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

שימוש באימות MD5

‫Cloud Router משתמש בפרוטוקול Border Gateway Protocol ‏ (BGP) כדי להחליף מסלולים בין רשת של ענן וירטואלי פרטי (VPC) לבין רשת שכנה. כברירת מחדל, סשנים של Cloud Router BGP לא מאומתים. עם זאת, כשמשתמשים ב-Cloud Router עם מוצרים מסוימים, אפשר להגדיר את סשני ה-BGP כך שישתמשו באימות MD5.

מוצרים שאפשר להשתמש בהם באימות MD5:

‫HA VPN
Cloud Interconnect

אפשר גם להשתמש באימות MD5 עם מכשירי רשת וירטואליים של צד שלישי. מידע נוסף זמין במאמר בנושא נתב וירטואלי במסמכי התיעוד של NCC.

כשמגדירים סשן לשימוש באימות MD5, מספקים מפתח סודי משותף – מפתח שמשתמשים בו כשמגדירים את Cloud Router ושוב כשמגדירים את נתב ה-peer. אחרי שתשלימו את שלבי ההגדרה הנדרשים, Cloud Router ישתמש במפתח הזה כדי לאמת את נקודת הקצה (peer) של BGP. ‫Cloud Router אוכף אימות MD5 באמצעות המודל שמתואר ב-RFC 2385.

אפשר להוסיף אימות MD5 כשיוצרים עמית. אפשר גם להוסיף אימות לפעילות קיימת, לשנות את המפתח שבו הפעילות משתמשת או להסיר את האימות.

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

נכנסים לחשבון 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 the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

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 the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

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

אם אתם משתמשים ב-Google Cloud CLI, מריצים את הפקודה הבאה כדי להגדיר את מזהה הפרויקט. ההוראות של gcloud בדף הזה מבוססות על ההנחה שהגדרתם את מזהה הפרויקט.
```
gcloud config set project PROJECT_ID
    
```

מריצים את הפקודה הבאה כדי לוודא שהמזהה הוגדר:
```
gcloud config list --format='text(core.project)'
    
```

יצירת סשן שמשתמש באימות

בחלק מהמוצרים של Network Connectivity, אפשר להגדיר עמית BGP כך שישתמש באימות MD5 בזמן שיוצרים את המשאב. המוצרים האלה כוללים HA VPN ו-Dedicated Interconnect.

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

אם יוצרים קובץ מצורף של VLAN Partner Interconnect בשכבה 2, קודם יוצרים את הקובץ המצורף ואז מעדכנים את עמית ה-BGP כדי להוסיף אימות MD5. מידע על הוספת אימות במהלך עדכון של סשן BGP מופיע בקטע הבא. אם יש לכם חיבור שכבה 3, פנו לספק השירות שלכם לקבלת הוראות.

הוספת אימות לסשן קיים

כדי להוסיף אימות ל-BGP peer קיים, משתמשים באחד מהתהליכים הבאים. כשמוסיפים אימות, צריך לוודא שהמפתח שבו משתמשים זהה למפתח שבו משתמש נתב העמיתים.

‫Google Cloud לא מוצג מפתח האימות MD5 ורק שם המפתח מוצג אחרי שההגדרה הושלמה בהצלחה.

אם מגדירים אימות MD5 באמצעות gcloud או ממשק משתמש, Google Cloud המערכת יוצרת באופן אוטומטי את שם המפתח בתבנית PEER_NAME-key.
אם מגדירים אימות MD5 דרך API, אפשר לציין את שם המפתח.

המסוף

נכנסים לדף Cloud Routers במסוף Google Cloud .

כניסה לדף Cloud Routers
בשדה Name (שם), לוחצים על השם של Cloud Router המתאים.
בדף פרטי הנתב, לוחצים על השם של סשן ה-BGP שרוצים לשנות.
בדף BGP session details (פרטי סשן BGP), לוחצים על Edit (עריכה).
כדי להוסיף אימות MD5:
1. בקטע MD5 Authentication (אימות MD5), בוחרים באפשרות Enabled (מופעל). הדף מתעדכן וכולל שדה טקסט.
2. מזינים מפתח אבטחה או לוחצים על יצירה והעתקה כדי ליצור מפתח אבטחה חדש.
3. רושמים את המפתח. אחרי שתצאו מהדף הזה, לא תוכלו לאחזר את המפתח.
לוחצים על שמירה.

gcloud

כדי לעדכן את הסשן באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud compute routers update-bgp-peer:

  gcloud compute routers update-bgp-peer ROUTER_NAME \
     --peer-name=PEER_NAME \
     --region=REGION \
     --md5-authentication-key=SECRET_KEY

מחליפים את הערכים הבאים:

‫ROUTER_NAME: השם של Cloud Router
‫PEER_NAME: השם של עמית ה-BGP
‫REGION: האזור של Google Cloud
‫SECRET_KEY: מפתח האימות הסודי המשותף של MD5

API

כדי לעדכן את הסשן באמצעות ה-API, משתמשים ב-method‏ compute.routers.patch. כשמשתמשים בשיטה הזו כדי להוסיף אימות לסשן, הבקשה צריכה לעשות שני דברים:

מוסיפים רשומה למפתח במערך md5AuthenticationKeys. כשמוסיפים את הרשומה, צריך לציין גם שם וגם ערך למפתח.
מעדכנים את המערך bgpPeers כך שיכלול ערך בשדה md5AuthenticationKeyName. השדה הזה מפנה למפתח לפי השם שלו.

כשמבצעים תיקון (patch) למערך md5AuthenticationKeys, צריך לספק את name של כל פריט במערך (אלא אם רוצים להסיר חלק מהפריטים). עם זאת, אתם לא חייבים לציין את הערך בשדה key של כל פריט. אם לא מציינים ערך, Cloud Router ישתמש בערך הקודם. ההתנהגות הזו נועדה להגן על סודיות המפתחות. היא שונה משיטות תיקון אחרות, שבדרך כלל דורשות לציין ערך לכל שדה בפריט במערך.

כשמבצעים תיקון למערך bgpPeers, צריך לספק ערכים לכל שדה בכל פריט (אלא אם רוצים להסיר חלק מהעמיתים או חלק מהערכים).

לדוגמה, נניח של-Cloud Router יש שני עמיתים, שאחד מהם משתמש באימות MD5 והשני לא. אם רוצים להשאיר את העמית הראשון ללא שינוי אבל להוסיף אימות MD5 לעמית השני, צריך להשתמש בבקשה כמו הבקשה הבאה:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "md5AuthenticationKeys": [
      {
        "name": "KEY_NAME_1",
      },
      {
        "name": "KEY_NAME_2",
        "key": "SECRET_KEY"
      }
    ],
    "bgpPeers": [
      {
        "name": "PEER_NAME_1",
        "md5AuthenticationKeyName": "KEY_NAME_1",
        "interfaceName": "INTERFACE_NAME_1",
        "ipAddress": "IP_ADDRESS_1",
        "peerIpAddress": "PEER_IP_ADDRESS_1",
        "peerAsn": "PEER_ASN_1"
      },
      {
        "name": "PEER_NAME_2",
        "md5AuthenticationKeyName": "KEY_NAME_2",
        "interfaceName": "INTERFACE_NAME_2",
        "ipAddress": "IP_ADDRESS_2",
        "peerIpAddress": "PEER_IP_ADDRESS_2",
        "peerAsn": "PEER_ASN_2"
      }
    ],
  }

מחליפים את הערכים הבאים:

‫PROJECT_ID: הפרויקט שמכיל את Cloud Router
‫REGION: האזור Google Cloud
‫ROUTER_NAME: השם של Cloud Router
‫KEY_NAME_1: השם של המפתח שנמצא בשימוש כרגע (על ידי PEER_NAME_1)
‫KEY_NAME_2: השם של המפתח החדש שרוצים להוסיף ל-PEER_NAME_2. רושמים את השם. אם תרצו לבצע שינויים בהמשך באמצעות ה-API, תצטרכו את השם.
‫SECRET_KEY: מפתח האימות הסודי של MD5 שאתם מוסיפים ל-PEER_NAME_2
‫PEER_NAME_1: השם של הקישור בין רשתות שכנות באמצעות BGP שלא משנים
‫INTERFACE_NAME_1: השם של הממשק של סשן ה-BGP Peering שלא משתנה
‫IP_ADDRESS_1: כתובת ה-IP ב-Cloud Router (עבור ה-peer שלא משתנה)
‫PEER_IP_ADDRESS_1: כתובת ה-IP של העמית שלא משתנה
‫PEER_ASN_1: מספר המערכת האוטונומית (ASN) של BGP של נקודת הקצה שלא משתנה
‫PEER_NAME_2: השם של המערכת המקושרת באמצעות BGP שרוצים לעדכן כדי שתשתמש באימות MD5
‫INTERFACE_NAME_2: השם של הממשק של סשן ה-BGP
‫IP_ADDRESS_2: כתובת ה-IP ב-Cloud Router
‫PEER_IP_ADDRESS_2: כתובת ה-IP של נתב ה-BGP של העמית
‫PEER_ASN_2: מספר המערכת האוטונומית (ASN) של BGP עבור עמית ה-BGP הזה

עדכון מפתח האימות

כדי לשנות את המפתח שבו Cloud Router משתמש עבור סשן של שותפות, משתמשים באחת מהפרוצדורות הבאות. כשמעדכנים את המפתח ב-Cloud Router, צריך לוודא שהמפתח שבו משתמשים זהה למפתח שבו משתמש הנתב העמית.

Google Cloud לא מציג את מפתח האימות MD5, ורק את שם המפתח אחרי שההגדרה הושלמה.

אם מגדירים אימות MD5 באמצעות gcloud או ממשק משתמש, Google Cloud המערכת יוצרת באופן אוטומטי את שם המפתח בתבנית PEER_NAME-key.
אם מגדירים אימות MD5 דרך API, אפשר לציין את שם המפתח.

המסוף

נכנסים לדף Cloud Routers במסוף Google Cloud .

כניסה לדף Cloud Routers
בשדה Name (שם), לוחצים על השם של Cloud Router המתאים.
בדף פרטי הנתב, לוחצים על השם של סשן ה-BGP שרוצים לשנות.
בדף BGP session details, לוחצים על Edit.
בקטע MD5 Authentication, לוחצים על Update MD5 Authentication Key.
בשדה MD5 Authentication key, מזינים את מפתח האימות הסודי החדש, או לוחצים על Generate and copy כדי לאכלס את השדה.
רושמים את המפתח. אחרי שיוצאים מהדף הזה, אי אפשר לאחזר את המפתח.
לוחצים על Save.

gcloud

כדי לעדכן את הסשן, משתמשים בפקודה gcloud compute routers update-bgp-peer.

  gcloud compute routers update-bgp-peer ROUTER_NAME \
     --peer-name=PEER_NAME \
     --region=REGION \
     --md5-authentication-key=SECRET_KEY

מחליפים את הערכים הבאים:

‫ROUTER_NAME: השם של Cloud Router
‫PEER_NAME: השם של עמית ה-BGP
‫REGION: האזור Google Cloud
‫SECRET_KEY: מפתח האימות החדש מסוג MD5 שרוצים להשתמש בו

API

כדי לעדכן את הסשן, משתמשים ב-method‏ compute.routers.patch. לדוגמה, אפשר להשתמש בבקשה כמו זו שבהמשך.

בדוגמה הזו, כל מערך העמיתים מוחלף, ולא רק העמית הספציפי שמזוהה. כלומר, היא מסירה את כל העמיתים מלבד PEER_NAME. היא מסירה את כל המפתחות חוץ מ-KEY_NAME ומעדכנת את KEY_NAME עם הערך החדש UPDATED_SECRET_KEY.

  POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "md5AuthenticationKeys": [
       {
        "name": "KEY_NAME",
        "key": "UPDATED_SECRET_KEY"
      }
    ],

    "bgpPeers": [
      {
        "name": "PEER_NAME",
        "md5AuthenticationKeyName": "KEY_NAME",
        "interfaceName": "INTERFACE_NAME",
        "ipAddress": "IP_ADDRESS",
        "peerIpAddress": "PEER_IP_ADDRESS",
        "peerAsn": "PEER_ASN"
      }
    ],
  }

מחליפים את הערכים הבאים:

‫PROJECT_ID: הפרויקט שמכיל את Cloud Router
‫REGION: האזור Google Cloud
‫ROUTER_NAME: השם של Cloud Router
‫KEY_NAME: השם של המפתח שרוצים לעדכן. כשעובדים עם אימות MD5 באמצעות ה-API, צריך להתייחס למפתח לפי השם שלו.
‫UPDATED_SECRET_KEY: מפתח האימות החדש שלכם מסוג MD5
‫PEER_NAME: השם של קישור ה-BGP בין רשתות שכנות
‫INTERFACE_NAME: השם של הממשק של סשן ה-BGP
‫IP_ADDRESS: כתובת ה-IP ב-Cloud Router
‫PEER_IP_ADDRESS: כתובת ה-IP של נתב ה-BGP של העמית
‫PEER_ASN: מספר המערכת האוטונומית (ASN) של BGP עבור הקישור בין רשתות שכנות באמצעות BGP הזה

בדיקת סטטוס האימות

כדי לבדוק את הסטטוס של אימות MD5: מידע נוסף זמין במאמר בנושא צפייה בפרטים של Cloud Router.

המסוף

נכנסים לדף Cloud Routers במסוף Google Cloud .

מעבר אל Cloud Routers
בשדה Name, לוחצים על השם של ה-Cloud Router המתאים.
בדף פרטי הנתב, מחפשים את העמודה אימות MD5. הערך בעמודה הזו מציין אם אימות MD5 מופעל בכל סשן.

gcloud

כדי לבדוק את הסשן באמצעות ה-CLI של gcloud, משתמשים בפקודה gcloud compute routers get-status.

  gcloud compute routers get-status ROUTER_NAME \
     --project=PROJECT \
     --region=REGION \

מחליפים את הערכים הבאים:

‫ROUTER_NAME: השם של Cloud Router
‫PROJECT: שם הפרויקט
‫REGION: האזור Google Cloud

הפלט כולל את האובייקט result.bgpPeerStatus[], שמכיל מידע על סשני ה-BGP של Cloud Router. הנתונים על כל סשן כוללים את שני השדות הבאים:

‫md5AuthEnabled – שדה בוליאני שמציין אם אימות MD5 מופעל בסשן
‫statusReason – שדה שמתאר את הסטטוס של הסשן

API

משתמשים בשיטה routers.getRouterStatus:

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME/getRouterStatus

מחליפים את מה שכתוב בשדות הבאים:

‫PROJECT_ID: הפרויקט שמכיל את Cloud Router
‫REGION: האזור שבו נמצא Cloud Router
‫ROUTER_NAME: השם של Cloud Router

הפלט כולל מידע על כל סשן BGP. הנתונים על כל סשן כוללים את שני השדות הבאים:

‫md5AuthEnabled: שדה בוליאני שמציין אם אימות MD5 מופעל בסשן
‫statusReason: שדה שמתאר את סטטוס הסשן. השדה הזה מוצג רק אם יש בעיה באימות MD5. (במקרה כזה, הערך של השדה הוא MD5_AUTH_INTERNAL_PROBLEM).

כדי להגדיר מעקב רציף אחרי סשנים של BGP, משתמשים ב-Cloud Logging. הרישום ביומן מתעד מידע על סטטוס האימות של MD5 באירוע BGP, שהוא חלק מיומן המידע.

הסרת אימות מסשן

אם רוצים להסיר אימות MD5 מסשן BGP, צריך להסיר את האימות גם מ-Cloud Router וגם מנתב ה-peer.

כדי להסיר את אימות MD5 מהסשן של BGP ב-Cloud Router, משתמשים באחת מהפרוצדורות הבאות.

המסוף

נכנסים לדף Cloud Routers במסוף Google Cloud .

מעבר אל Cloud Routers
בשדה Name (שם), לוחצים על השם של Cloud Router המתאים.
בדף פרטי הנתב, לוחצים על השם של סשן ה-BGP שרוצים לשנות.
בדף BGP session details, לוחצים על Edit.
באפשרות MD5 Authentication (אימות MD5), לוחצים על Disabled (מושבת).
לוחצים על Save. מופיעה תיבת הדו-שיח Disable MD5 Authentication key.
בתיבת הדו-שיח לאישור, לוחצים על אישור.

gcloud

כדי להסיר את אימות ה-MD5, משתמשים בפקודה gcloud compute routers update-bgp-peer:

   gcloud compute routers update-bgp-peer ROUTER_NAME \
     --peer-name=PEER_NAME \
     --region=REGION \
     --clear-md5-authentication-key

מחליפים את הערכים הבאים:

‫ROUTER_NAME: השם של Cloud Router
‫PEER_NAME: השם של עמית ה-BGP
‫REGION: האזור Google Cloud

API

כדי להסיר אימות MD5, משתמשים בשיטה compute.routers.patch.

כשמסירים אימות באמצעות ה-API, העדכון צריך לבצע שני דברים:

מעדכנים את המערך md5AuthenticationKeys
מסירים את הערך md5AuthenticationKey מהרשומה הרלוונטית של bgpPeers

לדוגמה, אם ל-Cloud Router יש שני עמיתי BGP ואתם רוצים להסיר אימות MD5 מאחד מהם. במקרה כזה, משתמשים בבקשה כמו הבקשה הבאה:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "md5AuthenticationKeys": [
        "name": "KEY_NAME_FOR_UNCHANGED_PEER",
        ],
    "bgpPeers": [
      {
        "name": "NAME_OF_UPDATED_PEER",
        "interfaceName": "INTERFACE_NAME_FOR_UPDATED_PEER",
        "ipAddress": "IP_ADDRESS_FOR_UPDATED_PEER",
        "peerIpAddress": "PEER_IP_ADDRESS_FOR_UPDATED_PEER",
        "peerAsn": "PEER_ASN_FOR_UPDATED_PEER"
      },
      {
        "name": "NAME_OF_UNCHANGED_PEER",
        "interfaceName": "INTERFACE_NAME_FOR_UNCHANGED_PEER",
        "ipAddress": "IP_ADDRESS_FOR_UNCHANGED_PEER",
        "peerIpAddress": "PEER_IP_ADDRESS_FOR_UNCHANGED_PEER",
        "peerAsn": "PEER_ASN_FOR_UNCHANGED_PEER"
        "md5AuthenticationKeyName": "KEY_NAME_FOR_UNCHANGED_PEER"
      }
    ],
    ],
  }

מחליפים את הערכים הבאים:

‫PROJECT_ID: הפרויקט שמכיל את Cloud Router
‫REGION: האזור ב- Google Cloud שבו נמצא ה-Cloud Router
‫ROUTER_NAME: השם של Cloud Router
‫NAME_OF_UPDATED_PEER: השם של סשן ה-peering שרוצים לשנות
‫INTERFACE_NAME_FOR_UPDATED_PEER: השם של הממשק של נקודת הקצה (peer) של BGP שרוצים לשנות
‫IP_ADDRESS_FOR_UPDATED_PEER: כתובת ה-IP ב-Cloud Router שמשמשת את עמית ה-BGP שרוצים לשנות
‫PEER_IP_ADDRESS_FOR_UPDATED_PEER: כתובת ה-IP של הנתב השותף של סשן ה-peering שרוצים לשנות
‫PEER_ASN: מספר המערכת האוטונומית (ASN) של BGP עבור הקישור בין רשתות שכנות באמצעות BGP שרוצים לשנות
‫NAME_OF_UNCHANGED_PEER: השם של סשן ה-peering שרוצים להשאיר כמו שהוא
‫INTERFACE_NAME_FOR_UNCHANGED_PEER: השם של הממשק של עמית ה-BGP שרוצים לשמור כמו שהוא
‫IP_ADDRESS_FOR_UNCHANGED_PEER: כתובת ה-IP ב-Cloud Router שמשמשת את נקודת הקצה שרוצים להשאיר כמו שהיא
‫PEER_IP_ADDRESS_FOR_UNCHANGED_PEER: כתובת ה-IP של נתב ה-Peering עבור סשן ה-Peering שרוצים לשמור כמו שהוא
‫PEER_ASN_FOR_UNCHANGED_PEER: מספר המערכת האוטונומית (ASN) של BGP עבור עמית BGP שרוצים לשמור כמו שהוא
‫KEY_NAME_FOR_UNCHANGED_PEER: השם של מפתח האימות MD5 של עמית ה-BGP שרוצים לשמור כמו שהוא

הסרה של סשן שמשתמש באימות

כדי להסיר סשן של שיתוף פעולה בין רשתות שמשתמש באימות MD5, משתמשים באחד מההליכים הבאים.

המסוף

נכנסים לדף Cloud Routers במסוף Google Cloud .

מעבר אל Cloud Routers
בוחרים את הנתב שממנו רוצים להסיר סשן BGP.
בסשנים של BGP, בוחרים את הסשן של BGP שרוצים להסיר.
בחלק העליון של הדף, לוחצים על מחיקה ומאשרים את המחיקה.

gcloud

כדי להסיר סשן BGP שמופעל בו אימות MD5, משתמשים בפקודה gcloud compute routers remove-bgp-peer.

מידע נוסף זמין במאמר השבתה או הסרה של סשנים של BGP.

API

כדי להסיר סשן BGP עם אימות MD5 מופעל, משתמשים בשיטה compute.routers.patch.

כשמסירים סשן BGP עם אימות MD5 באמצעות ה-API, העדכון צריך לבצע שתי פעולות: להסיר את המפתח ממערך md5AuthenticationKeys ולהסיר את bgpPeer עצמו.

לדוגמה, נניח של-Cloud Router יש שני עמיתים ואתם רוצים להסיר אחד מהם. במקרה כזה, משתמשים בבקשה כמו הבקשה הבאה:

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/routers/ROUTER_NAME
  {
    "md5AuthenticationKeys": [
        "name": "KEY_NAME_FOR_RETAINED_PEER",
        ],
    "bgpPeers": [
      {
        "name": "NAME_OF_RETAINED_PEER",
        "interfaceName": "INTERFACE_FOR_RETAINED_PEER",
        "ipAddress": "IP_ADDRESS_FOR_RETAINED_PEER",
        "peerIpAddress": "PEER_IP_ADDRESS_FOR_RETAINED_PEER",
        "peerAsn": "PEER_ASN_FOR_RETAINED_PEER",
        "md5AuthenticationKeyName": "KEY_NAME_FOR_RETAINED_PEER"
      }
    ],
  }

מחליפים את הערכים הבאים:

‫PROJECT_ID: הפרויקט שמכיל את Cloud Router
‫REGION: האזור של Google Cloud
‫ROUTER_NAME: השם של Cloud Router
‫KEY_NAME_FOR_RETAINED_PEER: השם של המפתח שבו השתמש העמית שאתם משאירים
‫NAME_OF_RETAINED_PEER: השם של עמית ה-BGP שאתם רוצים לשמור
‫INTERFACE_FOR_RETAINED_PEER: השם של הממשק של עמית ה-BGP שאתם רוצים לשמור
‫IP_ADDRESS_FOR_RETAINED_PEER: כתובת ה-IP ב-Cloud Router של הנתב העמית שרוצים לשמור
‫PEER_IP_ADDRESS_FOR_RETAINED_PEER: כתובת ה-IP של נקודת הקצה שרוצים לשמור
‫PEER_ASN_FOR_RETAINED_PEER: מספר המערכת האוטונומית (ASN) של פרוטוקול BGP עבור העמית שרוצים לשמור
‫KEY_NAME_FOR_RETAINED_PEER: השם של מפתח האימות MD5 של עמית ה-BGP שרוצים לשמור

לדוגמה, נניח שיצרתם את עמיתי ה-P2P הבאים:

  PATCH https://compute.googleapis.com/compute/v1/projects/project_id/regions/region_name/routers/cloud_router_name
  {
    "md5AuthenticationKeys": [
      {
        "name":  "first_key_name",
        "key":  "first_secret_key_value"
      },
      {
        "name":  "second_key_name",
        "key":  "second_secret_key_value"
      }
    ],
    "bgpPeers": [
      {
        "name": "first_peer",
        "md5AuthenticationKeyName": "first_key_name",
        "interfaceName": "first_interface",
        "ipAddress": "first_address",
        "peerIpAddress": "first_peer_interface",
        "peerAsn": "first_peer_asn"
      },
      {
        "name": "second_peer",
        "md5AuthenticationKeyName": "second_key_name",
        "interfaceName": "second_interface",
        "ipAddress": "second_address",
        "peerIpAddress": "second_peer_interface",
        "peerAsn": "second_peer_asn"
      }
    ],
  }

אם תרצו להסיר את העמית השני, תצטרכו להשתמש בבקשה כמו הבקשה הבאה:

  PATCH https://compute.googleapis.com/compute/v1/projects/project_id/regions/region_name/routers/cloud_router_name
  {
    "md5AuthenticationKeys": [
      {
        "name":  "first_key_name",
      }
    ],
    "bgpPeers": [
      {
        "name": "first_peer",
        "md5AuthenticationKeyName": "first_key_name",
        "interfaceName": "first_interface",
        "ipAddress": "first_address",
        "peerIpAddress": "first_peer_interface",
        "peerAsn": "first_peer_asn"
      }
    ],
  }