כדי ליצור חיבורים מוצפנים ומורשים למכונות של AlloyDB ל-PostgreSQL, אתם יכולים להשתמש ב-AlloyDB Auth Proxy. מידע נוסף זמין במאמר מידע על שרת proxy לאימות של AlloyDB.
כדי להשתמש ב-AlloyDB Auth Proxy, מבצעים כמה שלבי הגדרה חד-פעמיים, ואז מפעילים את לקוח Auth Proxy ומשתמשים בו כדי להתחבר למסד נתונים.
לפני שמתחילים
המארח של הלקוח צריך לעמוד בדרישות הבאות:
ללקוח צריך להיות נתיב רשת למכונה של AlloyDB, בהתאם לשיטת החיבור:
- גישה לשירותים פרטיים (ברירת המחדל): ללקוח צריכה להיות הרשאת גישה לרשת של הענן הווירטואלי הפרטי (VPC) שבה נמצאים המכונות. מארחי לקוח (כמו מכונות Compute Engine) ברשת ה-VPC הזו כוללים את הרשת הזו באופן מובנה. למארחים של לקוחות ברשתות חיצוניות (רשתות מקומיות או רשתות VPC אחרות) יש את החשיפה הזו אם רשת ה-VPC של מכונת AlloyDB מחוברת לרשת החיצונית באמצעות מנהרת Cloud VPN או צירוף ל-VLAN של Dedicated Interconnect או של Partner Interconnect.
- Private Service Connect: לרשת ה-VPC של הלקוח צריכה להיות נקודת קצה (endpoint) של Private Service Connect ורשומת DNS פרטית תואמת, וצריך להפעיל את לקוח Auth Proxy עם הדגל
--psc. - כתובת IP ציבורית: במכונה צריכה להיות כתובת IP ציבורית מופעלת, וצריך להפעיל את לקוח Auth Proxy עם הדגל
--public-ip. כשמתחברים באמצעות שרת ה-proxy לאימות, לא צריך להוסיף את כתובת ה-IP של המארח של הלקוח לרשתות החיצוניות המורשות.
אם למארח הלקוח יש מדיניות חומת אש לתעבורה יוצאת, היא צריכה לאפשר חיבורים יוצאים ליציאה
5433בכתובות ה-IP של המכונות של AlloyDB, ולאפשר חיבורים יוצאים ליציאה443(יציאת ה-HTTPS הרגילה) לכל כתובות ה-IP.אם אתם משתמשים במכונה של Compute Engine כמארח הלקוח, צריך להיות לה היקף הגישה
https://www.googleapis.com/auth/cloud-platformכדי שהיא תוכל להשתמש ב-AlloyDB API. אם צריך, משנים את היקף הגישה כך שיכלול את ההיקף הזה.
הורדת לקוח Auth Proxy
המכונה שאליה מורידים את לקוח Auth Proxy תלויה בשאלה אם רוצים להתחבר למכונות של AlloyDB מתוך רשת ה-VPC או מחוץ לה.
אם אתם רוצים להתחבר לאשכול באמצעות גישה לשירותים פרטיים, אתם יכולים להוריד את לקוח Auth Proxy למכונה וירטואלית (VM) של Compute Engine שפועלת ברשת ה-VPC שיש לה גישה לשירותים פרטיים לאשכול.
אם אתם מתכוונים להתחבר לאשכול מחוץ ל-VPC, המכונה שבה תתקינו אותו תלויה באסטרטגיית החיבור החיצוני שבה אתם משתמשים. לדוגמה, אתם יכולים להתקין את לקוח Auth Proxy במכונת macOS או Windows שנמצאת באופן מקומי באפליקציה, ואז להשתמש בשרת SOCKS שפועל ברשת ה-VPC של AlloyDB כמתווך בחיבור. מידע נוסף זמין במאמר התחברות לאשכול מחוץ ל-VPC שלו.
Linux
64 ביט (AMD)
מורידים את לקוח Auth Proxy:
wget https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy.linux.amd64 -O alloydb-auth-proxyמגדירים את קובץ ההפעלה של לקוח Auth Proxy:
chmod +x alloydb-auth-proxyמוסיפים את לקוח Auth Proxy ל-PATH:
mkdir -p ~/.local/bin mv alloydb-auth-proxy ~/.local/bin/ export PATH="$HOME/.local/bin:$PATH"כדי שהשינויים האלה יישמרו בסשנים, מוסיפים את
export PATH="$HOME/.local/bin:$PATH"לקובץ~/.bashrcאו~/.zshrc.
32 ביט (AMD)
מורידים את לקוח Auth Proxy:
wget https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy.linux.386 -O alloydb-auth-proxyמגדירים את קובץ ההפעלה של לקוח Auth Proxy:
chmod +x alloydb-auth-proxyמוסיפים את לקוח Auth Proxy ל-PATH:
mkdir -p ~/.local/bin mv alloydb-auth-proxy ~/.local/bin/ export PATH="$HOME/.local/bin:$PATH"כדי שהשינויים האלה יישמרו בסשנים, מוסיפים את
export PATH="$HOME/.local/bin:$PATH"לקובץ~/.bashrcאו~/.zshrc.
64 ביט (ARM)
מורידים את לקוח Auth Proxy:
wget https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy.linux.arm64 -O alloydb-auth-proxyמגדירים את קובץ ההפעלה של לקוח Auth Proxy:
chmod +x alloydb-auth-proxyמוסיפים את לקוח Auth Proxy ל-PATH:
mkdir -p ~/.local/bin mv alloydb-auth-proxy ~/.local/bin/ export PATH="$HOME/.local/bin:$PATH"כדי שהשינויים האלה יישמרו בסשנים, מוסיפים את
export PATH="$HOME/.local/bin:$PATH"לקובץ~/.bashrcאו~/.zshrc.
32 ביט (ARM)
מורידים את לקוח Auth Proxy:
wget https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy.linux.arm -O alloydb-auth-proxyמגדירים את קובץ ההפעלה של לקוח Auth Proxy:
chmod +x alloydb-auth-proxyמוסיפים את לקוח Auth Proxy ל-PATH:
mkdir -p ~/.local/bin mv alloydb-auth-proxy ~/.local/bin/ export PATH="$HOME/.local/bin:$PATH"כדי שהשינויים האלה יישמרו בסשנים, מוסיפים את
export PATH="$HOME/.local/bin:$PATH"לקובץ~/.bashrcאו~/.zshrc.
macOS
ARM64
מורידים את לקוח Auth Proxy:
curl -o alloydb-auth-proxy https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy.darwin.arm64מגדירים את קובץ ההפעלה של לקוח Auth Proxy:
chmod +x alloydb-auth-proxyמוסיפים את לקוח Auth Proxy ל-PATH:
mkdir -p ~/.local/bin mv alloydb-auth-proxy ~/.local/bin/ export PATH="$HOME/.local/bin:$PATH"כדי שהשינויים האלה יישמרו בסשנים, מוסיפים את
export PATH="$HOME/.local/bin:$PATH"לקובץ~/.bashrcאו~/.zshrc.
AMD64
מורידים את לקוח Auth Proxy:
curl -o alloydb-auth-proxy https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy.darwin.amd64מגדירים את קובץ ההפעלה של לקוח Auth Proxy:
chmod +x alloydb-auth-proxyמוסיפים את לקוח Auth Proxy ל-PATH:
mkdir -p ~/.local/bin mv alloydb-auth-proxy ~/.local/bin/ export PATH="$HOME/.local/bin:$PATH"כדי שהשינויים האלה יישמרו בסשנים, מוסיפים את
export PATH="$HOME/.local/bin:$PATH"לקובץ~/.bashrcאו~/.zshrc.
Windows
64 סיביות
לוחצים לחיצה ימנית על https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy-x64.exe ובוחרים באפשרות Save Link As כדי להוריד את לקוח ה-Auth Proxy. משנים את שם הקובץ ל-
alloydb-auth-proxy.exe.מוסיפים את לקוח Auth Proxy ל-PATH:
New-Item -ItemType Directory -Force -Path "$HOME\bin" Move-Item -Path .\alloydb-auth-proxy.exe -Destination "$HOME\bin" $userPath = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$userPath;$HOME\bin", "User")
32 סיביות
לוחצים לחיצה ימנית על https://storage.googleapis.com/alloydb-auth-proxy/v1.18.0/alloydb-auth-proxy-x86.exe ובוחרים באפשרות Save Link As כדי להוריד את לקוח ה-Auth Proxy. משנים את שם הקובץ ל-
alloydb-auth-proxy.exe.מוסיפים את לקוח Auth Proxy ל-PATH:
New-Item -ItemType Directory -Force -Path "$HOME\bin" Move-Item -Path .\alloydb-auth-proxy.exe -Destination "$HOME\bin" $userPath = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$userPath;$HOME\bin", "User")
קובץ אימג' של Docker
כדי שיהיה לכם נוח, כמה קובצי אימג' של קונטיינרים שמכילים את לקוח ה-Auth Proxy זמינים ב-Artifact Registry.
אתם יכולים להוריד את קובץ האימג' העדכני למחשב המקומי באמצעות Docker, בעזרת הפקודה הבאה:
docker pull gcr.io/alloydb-connectors/alloydb-auth-proxy:latestמערכת הפעלה אחרת
במערכות הפעלה אחרות שלא נכללות כאן, אפשר להדר את לקוח Auth Proxy מהמקור.
בחירת חשבון המשתמש בניהול הזהויות והרשאות הגישה (IAM) והכנה שלו לאימות
AlloyDB Auth Proxy תומך בשימוש בסוגים הבאים של חשבונות משתמשים ב-IAM כדי לאשר חיבורים בין הלקוח למכונה של AlloyDB:
חשבון שירות מצורף. אם המארח של הלקוח פועל ב-Google Cloud(לדוגמה, במכונה של Compute Engine), אתם יכולים לאשר חיבורים באמצעות חשבון השירות שמצורף למשאב הזה.
מומלץ להשתמש בחשבון שירות לצורך הרשאה בסביבות ייצור. חשבון שירות מקושר הוא האפשרות הכי מאובטחת, כי לא צריך להוריד מפתח.
חשבון המשתמש שלכם. אתם יכולים להשתמש בחשבון המשתמש שלכם ב-IAM כדי לאשר חיבורים.
השימוש בחשבון המשתמש שלכם נוח בסביבות פיתוח שבהן אתם מנהלים את המשאבים של AlloyDB באמצעות ה-CLI של gcloud, מפתחים את מסד הנתונים באמצעות כלי כמו
psqlומפתחים קוד אפליקציה באותו מארח.חשבון שירות שמנוהל על ידי משתמש. אתם יכולים ליצור חשבון שירות ב-IAM לאפליקציה, ואז לאשר חיבורים באמצעות חשבון השירות.
השתמשו בחשבון שירות בניהול המשתמש כשהמארח של הלקוח פועל מחוץ ל-Google Cloud ואי אפשר להשתמש בחשבון שירות מצורף.
אחרי שבוחרים את חשבון המשתמש ב-IAM, מוודאים שיש לו את הרשאות ה-IAM הנדרשות ושפרטי הכניסה שלו זמינים במארח הלקוח.
הרשאות IAM נדרשות
לישות המורשית ב-IAM שבה אתם משתמשים כדי לאשר חיבורים צריכות להיות ההרשאות שניתנות על ידי התפקידים המוגדרים מראש roles/alloydb.client (לקוח AlloyDB) ו-roles/serviceusage.serviceUsageConsumer (Service Usage Consumer).
כדי להקצות את התפקיד "לקוח AlloyDB" לחשבון משתמש ב-IAM:
צריך להפעיל את Cloud Resource Manager API בפרויקט ב- Google Cloud .
אתם צריכים את תפקיד ה-IAM הבסיסי
roles/owner(בעלים) בפרויקט ב-Google Cloud , או תפקיד שמעניק את ההרשאות הבאות:resourcemanager.projects.getresourcemanager.projects.getIamPolicyresourcemanager.projects.setIamPolicy
כדי לקבל את ההרשאות האלה תוך שמירה על העקרון של הרשאות מינימליות, בקשו מהאדמין להקצות לכם את התפקיד
roles/resourcemanager.projectIamAdmin(אדמין IAM בפרויקט).
הפיכת פרטי הכניסה של IAM לזמינים במארח הלקוח
לקוח ה-Auth Proxy משתמש ב-Application Default Credentials (ADC) כדי לאתר את פרטי הכניסה של IAM במארח הלקוח. ברוב הסביבות פרטי הכניסה האלה כבר קיימים, כך שאין צורך להגדיר שום דבר. הלקוח של Auth Proxy מחפש את המקורות הבאים של פרטי הכניסה, לפי הסדר:
חשבון המשתמש שלכם. כשמפתחים באופן מקומי, מאמתים באמצעות חשבון המשתמש שלכם על ידי הפעלת הפקודה הבאה ב-CLI של gcloud:
gcloud auth application-default loginהלקוח של Auth Proxy מזהה את פרטי הכניסה האלה ומשתמש בהם. אין צורך להוריד מפתח לחשבון השירות.
חשבון שירות מצורף. כשהמארח של הלקוח פועל ב-Google Cloud(לדוגמה, במכונה של Compute Engine), שרת המטא-נתונים של הסביבה מספק את פרטי הכניסה מחשבון השירות המצורף. לקוח Auth Proxy מגלה את פרטי הכניסה האלה ומשתמש בהם בלי הגדרה נוספת.
מקורות אחרים של פרטי כניסה
השתמשו בשיטות הבאות רק כשאי אפשר להשתמש ב-Application Default Credentials – לדוגמה, כשמריצים את לקוח Auth Proxy מחוץ ל-Google Cloud, או כשצריך לשנות את פרטי הכניסה בסביבה.
מַפְתח של חשבון שירות. השתמשו במפתח של חשבון שירות כשהמארח של הלקוח פועל מחוץ ל- Google Cloud(לדוגמה, במרכז נתונים מקומי או אצל ספק שירותי ענן אחר) ואי אפשר להשתמש באיחוד שירותי אימות הזהות של עומסי עבודה.
יוצרים מפתח לחשבון שירות בפורמט JSON ומורידים אותו למארח הלקוח. אחר כך מגדירים את משתנה הסביבה
GOOGLE_APPLICATION_CREDENTIALSלנתיב של קובץ המפתח:export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account-key.json"אפשר גם לציין את הנתיב באמצעות הדגל
--credentials-fileכשמפעילים את לקוח Auth Proxy:alloydb-auth-proxy --credentials-file /path/to/service-account-key.json INSTANCE_URIאסימון גישה מסוג OAuth 2.0. כדאי להשתמש בטוקן גישה כשמערכת אחרת כבר מנפיקה בשבילכם טוקנים לטווח קצר – לדוגמה, צינור עיבוד נתונים של שילוב רציף (CI) שמקבל טוקן לפני שהוא מפעיל את לקוח Auth Proxy.
אם כבר יש לכם אסימון גישה תקין מסוג OAuth 2.0, אתם יכולים להעביר אותו ישירות כשאתם מפעילים את לקוח Auth Proxy:
alloydb-auth-proxy --token "ACCESS_TOKEN" INSTANCE_URIפרטי הכניסה ל-CLI של gcloud. השתמשו בדגל
--gcloud-authרק כשאתם צריכים להשתמש שוב בסשןgcloud auth loginקיים ואי אפשר להריץ אתgcloud auth application-default login.הדגל
--gcloud-authגורם ללקוח Auth Proxy להשתמש בחשבון שאימתתם באמצעותgcloud auth loginבמקום להשתמש ב-Application Default Credentials. אנחנו לא ממליצים על הדגל הזה. במקום זאת, צריך להריץ את הפקודהgcloud auth application-default login.
איסוף של מזהי URI לחיבור למכונות AlloyDB
כשמפעילים את לקוח Auth Proxy, מזהים את המכונה או המכונות של AlloyDB שאליהן רוצים להתחבר באמצעות הפורמט הבא של URI לחיבור:
projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID
כדי לראות רשימה של כל מזהי ה-URI של החיבורים של המכונות, משתמשים בפקודה alloydb instances list ב-CLI של gcloud:
gcloud alloydb instances list \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_IDמחליפים את מה שכתוב בשדות הבאים:
-
REGION_ID: האזור שבו נמצאות המכונות -
CLUSTER_ID: מזהה האשכול שבו נמצאים המופעים -
PROJECT_ID: מזהה הפרויקט שבו נמצא האשכול
אוספים את ה-URI של החיבור לכל מכונה שאליה רוצים להתחבר.
הפעלת הלקוח של שרת ה-Proxy לאימות
כשמפעילים את לקוח ה-Auth Proxy, מספקים לו מידע על מכונות AlloyDB שאליהן צריך להתחבר, ובמידת הצורך, פרטי כניסה לשימוש באימות החיבורים האלה.
כשהוא מתחיל, לקוח Auth Proxy:
- מאשר חיבורים למכונות AlloyDB באמצעות פרטי הכניסה והרשאות ה-IAM של חשבון המשתמש ב-IAM שהגדרתם. היא מחפשת פרטי כניסה לפי רצף ספציפי של שלבים.
- מאשרת באופן אוטומטי קישורים דרך IP ציבוריים לרשת המקור, אם במכונה מופעלת כתובת IP ציבורית.
- מגדיר חיבור פרטי ב-mTLS 1.3 לשרת ה-proxy של אימות של כל מכונה.
- מתחיל להאזין לבקשות חיבור של לקוחות מקומיים.
כברירת מחדל, לקוח Auth Proxy מאזין לחיבורי TCP בכתובת ה-IP 127.0.0.1, החל מיציאה 5432, ומוסיף מספר יציאה אחד לכל מכונה של AlloyDB מעבר למכונה הראשונה. כשמפעילים את לקוח Auth Proxy, אפשר לציין כתובת מאזין אחרת ויציאות אחרות.
שורת הפקודה
alloydb-auth-proxy INSTANCE_URI... \
[ --credentials-file PATH_TO_KEY_FILE \ ]
[ --token OAUTH_ACCESS_TOKEN \ ]
[ --port INITIAL_PORT_NUMBER \ ]
[ --address LOCAL_LISTENER_ADDRESS \ ]
[ --auto-iam-authn \ ]
[ --psc \ ]
[ --public-ip \ ]
[ --disable-built-in-telemetry ]מחליפים את מה שכתוב בשדות הבאים:
INSTANCE_URI: ה-URI של החיבור למכונה של AlloyDB שאליה רוצים להתחבר, בפורמט הבא:projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_IDכדי לשנות את יציאת המאזין המקומית שמוגדרת כברירת מחדל, שבה לקוח Auth Proxy ישתמש במכונה, מוסיפים ל-URI את פרמטר השאילתה
port:"projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?port=PORT"אופציונלי:
PATH_TO_KEY_FILE: הנתיב לקובץ מפתח ה-JSON של חשבון השירות בניהול המשתמש, שמשמש לאישור החיבור.
OAUTH_ACCESS_TOKEN(אופציונלי): ערך של אסימון OAuth2 שמשמש לאישור החיבור.אופציונלי:
INITIAL_PORT_NUMBER: מספר היציאה ההתחלתי שבו צריך להשתמש במקום יציאת ברירת המחדל5432כשמאזינים לחיבורי TCP מקומיים.אופציונלי:
LOCAL_LISTENER_ADDRESS: כתובת המאזין שבה צריך להשתמש במקום ברירת המחדל127.0.0.1כשמאזינים לחיבורי TCP מקומיים.
הדגל האופציונלי --auto-iam-authn מאפשר לבצע אימות אוטומטי למכונה. האפשרות הזו פועלת רק למשתמש במסד הנתונים שמשויך לחשבון IAM שמריץ את לקוח Auth Proxy. מידע נוסף זמין במאמר אימות אוטומטי באמצעות שרת proxy לאימות.
הדגל האופציונלי --psc מאפשר ל-Auth Proxy להתחבר למכונה שבה מופעל Private Service Connect. מידע נוסף על הגדרת DNS באמצעות Private Service Connect זמין במאמר הגדרת אזור מנוהל של DNS ורשומת DNS.
הדגל האופציונלי --public-ip מאפשר ל-Auth Proxy להתחבר למכונה שמופעלת בה כתובת IP ציבורית, באמצעות כתובת ה-IP הציבורית של המכונה. מידע נוסף על כתובת IP ציבורית זמין במאמר התחברות באמצעות כתובת IP ציבורית.
הדגל האופציונלי --disable-built-in-telemetry משבית את מדווח המדדים הפנימי שבו משתמש שרת ה-proxy לאימות כדי לדווח על תקינות החיבור והרשת. כברירת מחדל, שרת ה-proxy לאימות מדווח על הפעולות הפנימיות שלו לתחילית של מדד המערכת alloydb.googleapis.com. המדדים האלה עוזרים לשפר את הביצועים של AlloyDB ולזהות בעיות בקישוריות של הלקוח. האפשרות הזו שימושית לאפליקציות שפועלות בסביבות שבהן ייצוא המדדים החוצה מוגבל. כדי לבטל את ההסכמה לאיסוף נתוני הטלמטריה האלה, משתמשים בדגל הזה.
מאגר Docker
מפעילים את לקוח Auth Proxy באמצעות הפקודה docker run.
אם אתם משתמשים בפרטי הכניסה שסופקו על ידי המכונה של Compute Engine, אתם יכולים להשתמש בפקודה דומה לזו:
docker run \
--publish 127.0.0.1:PORT:PORT \
gcr.io/alloydb-connectors/alloydb-auth-proxy:latest \
--address 0.0.0.0 \
--port PORT \
INSTANCE_URIמחליפים את מה שכתוב בשדות הבאים:
PORT: היציאה שמשמשת לחיבורים מקומיים ללקוח Auth Proxy. ערך ברירת המחדל הוא5432.
INSTANCE_URI: ה-URI של החיבור למכונה של AlloyDB שאליה רוצים להתחבר, בפורמט הבא:projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_IDכדי לשנות את יציאת המאזין המקומית שמוגדרת כברירת מחדל, שבה משתמש הלקוח של Auth Proxy במכונה, מוסיפים ל-URI את הפרמטר
portשל השאילתה:"projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID/instances/INSTANCE_ID?port=PORT"
תמיד צריך לציין את הקידומת 127.0.0.1 בדגל --publish כדי שלקוח Auth Proxy לא ייחשף מחוץ למארח המקומי.
הערך 0.0.0.0 בדגל --address נדרש כדי שהמאזין יהיה נגיש מחוץ לקונטיינר של Docker.
כדי לספק פרטי כניסה ששמרתם בקובץ JSON מקומי, צריך לכלול את הדגלים --volume ו---credentials-file כשמריצים את הפקודה docker run:
docker run \
--volume PATH_TO_KEY_FILE:/key.json \
--publish 127.0.0.1:PORT:PORT \
gcr.io/alloydb-connectors/alloydb-auth-proxy:latest \
--address 0.0.0.0 \
--port PORT \
--credentials-file=/key.json \
INSTANCE_URIמחליפים את PATH_TO_KEY_FILE בנתיב לקובץ המפתח בפורמט JSON של חשבון השירות בניהול המשתמש, שבו רוצים להשתמש כדי לאשר את החיבור.
דוגמאות לסטארט-אפים
בדוגמאות הבאות מוצגות דרכים שונות להפעלת לקוח Auth Proxy. הם משתמשים במזהי ה-URI האלה של חיבור למכונה לדוגמה:
projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary
projects/myproject/locations/us-central1/clusters/mycluster/instances/myreadpool
הפעלה בסיסית
alloydb-auth-proxy \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary"בדוגמה הזו, לקוח ה-Auth Proxy מאשר את החיבור לפי רצף שלבי ההרשאה הרגיל שלו, ואז מתחיל להאזין לחיבורים מקומיים למכונה של myprimary ב-127.0.0.1:5432.
הפעלה באמצעות חשבון שירות בניהול המשתמשים
alloydb-auth-proxy \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary" \
--credentials-file "myappaccount/key.json"בדוגמה הזו, הלקוח של Auth Proxy מאשר את החיבור באמצעות מפתח ה-JSON של חשבון השירות בניהול המשתמש שמאוחסן ב-myappaccount/key.json, ואז מתחיל להאזין לחיבורים מקומיים למכונה myprimary ב-127.0.0.1:5432.
הפעלה של חיבור לכמה מופעים
alloydb-auth-proxy \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary" \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myreadpool"בדוגמה הזו, הלקוח של שרת ה-Proxy לאימות מאשר את החיבור לפי רצף שלבי האימות הרגיל שלו, ואז מתחיל להאזין לחיבורים מקומיים למכונה myprimary ב-127.0.0.1:5432 ולמכונה myreadpool ב-127.0.0.1:5433.
האזנה בהפעלה ביציאות בהתאמה אישית
שימוש ביציאות בהתאמה אישית ללקוח Auth Proxy יכול להיות שימושי כשצריך לשמור את יציאה 5432 לחיבורים אחרים של PostgreSQL.
alloydb-auth-proxy \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary?port=5000" \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myreadpool?port=5001"בדוגמה הזו, הלקוח של שרת ה-Proxy לאימות מאשר את החיבור לפי רצף שלבי האימות הרגיל שלו, ואז מתחיל להאזין לחיבורים מקומיים למכונה myprimary ב-127.0.0.1:5000 ולמכונה myreadpool ב-127.0.0.1:5001.
מכיוון שהיציאות האלה בהתאמה אישית הן עוקבות, אפשר להשיג את אותו אפקט באמצעות פקודת ההפעלה הזו:
alloydb-auth-proxy \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary" \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myreadpool" \
--port 5000האזנה להפעלה בכתובת IP מותאמת אישית
alloydb-auth-proxy \
"projects/myproject/locations/us-central1/clusters/mycluster/instances/myprimary" \
--address "0.0.0.0"בדוגמה הזו, לקוח ה-Auth Proxy מאשר את החיבור לפי רצף שלבי ההרשאה הרגיל שלו, ואז מתחיל להאזין לחיבורים מקומיים למכונה של myprimary ב-0.0.0.0:5432.
חיבור אפליקציה למסד נתונים באמצעות שרת proxy לאימות של AlloyDB
בדוגמאות הבאות מוסבר איך לחבר אפליקציה למסד נתונים באמצעות AlloyDB Auth Proxy.
בדוגמה של psql מוסבר איך לחבר כלי שורת פקודה.
בשפות תכנות מסוימות, החיבור למכונה של AlloyDB באמצעות Auth Proxy זהה לחיבור למכונה של Cloud SQL ל-PostgreSQL באמצעות Cloud SQL Auth Proxy, ולכן הדוגמאות לשפות זהות לאלה של Cloud SQL ל-PostgreSQL.
הדוגמאות האלה מבוססות על הפעלה כברירת מחדל של לקוח ה-Auth Proxy, כך שהוא מאזין לחיבורי TCP מקומיים ב-127.0.0.1:5432.
psql
psql -h 127.0.0.1 -p 5432 -U DB_USERמחליפים את DB_USER במשתמש של מסד הנתונים שאליו רוצים להתחבר, לדוגמה postgres.
תתבקשו להזין את הסיסמה של המשתמש DB_USER.
Python
Java
Node.js
המשך
כדי לראות את קטע הקוד הזה בהקשר של אפליקציית אינטרנט, אפשר לעיין בדוגמאות של Go ב-GitHub.
C#
כדי לראות את קטע הקוד הזה בהקשר של אפליקציית אינטרנט, עיינו בקובץ README ב-GitHub.
Ruby
כדי לראות את קטע הקוד הזה בהקשר של אפליקציית אינטרנט, עיינו בקובץ README ב-GitHub.
PHP
כדי לראות את קטע הקוד הזה בהקשר של אפליקציית אינטרנט, עיינו בקובץ README ב-GitHub.