בדף הזה מוסבר איך לאבטח את האפליקציה באמצעות כותרות חתומות של רכישות מתוך האפליקציה (IAP). כשמוגדר שרת proxy לאימות זהויות (IAP), הוא משתמש באסימוני אינטרנט מסוג JSON (JWT) כדי לוודא שהבקשה לאפליקציה מורשית. ההגנה הזו עוזרת לאפליקציה מפני הסיכונים הבאים:
- התכונה 'רכישות מתוך האפליקציה' מושבתת בטעות
- חומות אש שהוגדרו באופן שגוי
- גישה לא מורשית מתוך הפרויקט
כדי לאבטח את האפליקציה, צריך להשתמש בכותרות חתומות לכל סוגי האפליקציות.
לחלופין, אם יש לכם אפליקציה בסביבת ברירת המחדל ב-App Engine, אתם יכולים להשתמש ב-Users API.
בבדיקות תקינות של Compute Engine ו-GKE לא נכללות כותרות JWT, ו-IAP לא מעבד בדיקות תקינות. אם בדיקת התקינות מחזירה שגיאות גישה, צריך לוודא שבדיקת התקינות מוגדרת בצורה נכונה במסוף Google Cloud , ושהאימות של כותרת ה-JWT מאפשר את הנתיב של בדיקת התקינות. מידע נוסף זמין במאמר יצירת חריג לבדיקת תקינות.
לפני שמתחילים
כדי לאבטח את האפליקציה באמצעות כותרות חתומות, תצטרכו את הדברים הבאים:
- אפליקציה שרוצים שהמשתמשים יתחברו אליה.
- ספריית JWT של צד שלישי בשפה שלכם שתומכת באלגוריתם
ES256.
אבטחת האפליקציה באמצעות כותרות IAP
כדי לאבטח את האפליקציה באמצעות ה-JWT של IAP, צריך לאמת את הכותרת, את המטען הייעודי (payload) ואת החתימה של ה-JWT. ה-JWT נמצא בכותרת בקשת ה-HTTP x-goog-iap-jwt-assertion. אם תוקף עוקף את IAP, הוא יכול לזייף את כותרות הזהות הלא חתומות של IAP, x-goog-authenticated-user-{email,id}. JWT של IAP מספק חלופה מאובטחת יותר.
כותרות חתומות מספקות אבטחה משנית למקרה שמישהו עוקף את IAP. כש-IAP מופעל, הוא מסיר את הכותרות x-goog-* שסופקו על ידי הלקוח כשהבקשה עוברת דרך תשתית ההגשה של IAP.
אימות כותרת ה-JWT
מוודאים שהכותרת של ה-JWT עומדת בהגבלות הבאות:
| הצהרות בכותרת JWT | ||
|---|---|---|
alg |
אלגוריתם | ES256 |
kid |
מזהה המפתח |
המפתח צריך להתאים לאחד מהמפתחות הציבוריים שמופיעים בקובץ המפתחות של IAP, שזמין בשני פורמטים שונים:
https://www.gstatic.com/iap/verify/public_key
ו
https://www.gstatic.com/iap/verify/public_key-jwk
|
מוודאים שה-JWT נחתם על ידי המפתח הפרטי שתואם להצהרה kid של האסימון. קודם כל, מאחזרים את המפתח הציבורי מאחד משני המקומות הבאים:
https://www.gstatic.com/iap/verify/public_key. כתובת ה-URL הזו מכילה מילון JSON שממפה את ההצהרותkidלערכים של המפתח הציבורי.-
https://www.gstatic.com/iap/verify/public_key-jwk. כתובת ה-URL הזו מכילה את המפתחות הציבוריים של IAP בפורמט JWK.
אחרי שמקבלים את המפתח הציבורי, משתמשים בספריית JWT כדי לאמת את החתימה.
שירות IAP מבצע רוטציה של המפתחות הציבוריים שלו באופן תקופתי. כדי לוודא שתמיד תוכלו לאמת את ה-JWT, כדאי לעיין במאמר בנושא אוטומציה של שמירת מפתחות ציבוריים במטמון.
אימות מטען הייעודי (payload) של ה-JWT
מוודאים שה-payload של ה-JWT עומד במגבלות הבאות:
| הצהרות במטען הייעודי (payload) של JWT | ||
|---|---|---|
exp |
שעת התפוגה | התאריך חייב להיות בעתיד. הזמן נמדד בשניות מאז ראשית זמן יוניקס (Unix epoch). מאפשרים 30 שניות להטיה. משך החיים המקסימלי של אסימון הוא 10 דקות + 2 * הטיה. |
iat |
השעה שבה הונפק | התאריך חייב להיות בעבר. הזמן נמדד בשניות מאז ראשית זמן יוניקס (Unix epoch). מאפשרים 30 שניות להטיה. |
aud |
קהל |
הערך חייב להיות מחרוזת עם הערכים הבאים:
|
iss |
מנפיק |
חייב להיות https://cloud.google.com/iap.
|
hd |
הדומיין של החשבון |
אם חשבון שייך לדומיין מארח, מצוין hd כדי להבדיל בין הדומיין שהחשבון משויך אליו.
|
google |
טענה בנושא הפרת זכויות יוצרים ב-Google |
אם רמת גישה אחת או יותר חלות על הבקשה, השמות שלהן מאוחסנים באובייקט ה-JSON של התביעה google, במפתח access_levels, כמערך של מחרוזות.
כשמציינים מדיניות מכשיר ולארגון יש גישה לנתוני המכשיר, גם |
כדי לקבל את הערכים של המחרוזת aud שצוינה למעלה, אפשר להיכנס אלGoogle Cloud המסוף או להשתמש בכלי שורת הפקודה של Google Cloud.
כדי לקבל ערכי מחרוזת aud מהמסוף Google Cloud , עוברים אל ההגדרות של Identity-Aware Proxy בפרויקט, לוחצים על עוד לצד משאב איזון העומסים ובוחרים באפשרות קהל היעד של JWT בכותרת חתומה. בתיבת הדו-שיח Signed Header JWT שמופיעה, מוצגת טענת aud של המשאב שנבחר.
אם רוצים להשתמש ב-CLI של gcloud, כלי שורת הפקודה של gcloud, כדי לקבל את ערכי המחרוזת aud, צריך לדעת את מזהה הפרויקט. אפשר למצוא את מזהה הפרויקט בכרטיס Project info במסוףGoogle Cloud , ואז להריץ את הפקודות שצוינו לכל ערך.
מספר הפרויקט
כדי לקבל את מספר הפרויקט באמצעות כלי שורת הפקודה של Google Cloud, מריצים את הפקודה הבאה:
gcloud projects describe PROJECT_ID
הפלט של הפקודה אמור להיראות כך:
createTime: '2016-10-13T16:44:28.170Z' lifecycleState: ACTIVE name: project_name parent: id: '433637338589' type: organization projectId: PROJECT_ID projectNumber: 'PROJECT_NUMBER'
Service ID
כדי לקבל את מזהה השירות באמצעות כלי שורת הפקודה של Google Cloud, מריצים את הפקודה הבאה:
gcloud compute backend-services describe SERVICE_NAME --project=PROJECT_ID --global
הפלט של הפקודה אמור להיראות כך:
affinityCookieTtlSec: 0 backends: - balancingMode: UTILIZATION capacityScaler: 1.0 group: https://www.googleapis.com/compute/v1/projects/project_name/regions/us-central1/instanceGroups/my-group connectionDraining: drainingTimeoutSec: 0 creationTimestamp: '2017-04-03T14:01:35.687-07:00' description: '' enableCDN: false fingerprint: zaOnO4k56Cw= healthChecks: - https://www.googleapis.com/compute/v1/projects/project_name/global/httpsHealthChecks/my-hc id: 'SERVICE_ID' kind: compute#backendService loadBalancingScheme: EXTERNAL name: my-service port: 8443 portName: https protocol: HTTPS selfLink: https://www.googleapis.com/compute/v1/projects/project_name/global/backendServices/my-service sessionAffinity: NONE timeoutSec: 3610
אחזור זהות המשתמש
אם כל האימותים הקודמים בוצעו בהצלחה, מאחזרים את זהות המשתמש. ה-payload של הטוקן המזהה מכיל את פרטי המשתמש הבאים:
| מטען ייעודי (payload) של טוקן של מזהה: זהות המשתמש | ||
|---|---|---|
sub |
נושא |
מזהה ייחודי ויציב של המשתמש. במקום להשתמש בכותרת x-goog-authenticated-user-id, צריך להשתמש בערך הזה.
|
email |
כתובת האימייל של המשתמש | כתובת האימייל של המשתמש.
|
בהמשך מופיע קוד לדוגמה להגנה על אפליקציה באמצעות כותרות חתומות של רכישות מתוך האפליקציה:
C#
Go
Java
Node.js
PHP
Python
Ruby
בדיקה של קוד האימות
אם תיכנס לאפליקציה שלך באמצעות secure_token_test פרמטרים של שאילתה, הרכיב IAP יכלול JWT לא תקין. אפשר להשתמש בזה כדי לוודא שהלוגיקה של אימות ה-JWT מטפלת בכל מקרי הכשל השונים, וכדי לראות איך האפליקציה מתנהגת כשהיא מקבלת JWT לא תקין.
יצירת חריג לבדיקת תקינות
כמו שצוין קודם, בדיקות תקינות ב-Compute Engine וב-GKE לא משתמשות בכותרות JWT, ו-IAP לא מטפל בבדיקות תקינות. תצטרכו להגדיר את בדיקת התקינות ואת האפליקציה כדי לאפשר גישה לבדיקת התקינות.
הגדרת בדיקת התקינות
אם עדיין לא הגדרתם נתיב לבדיקת התקינות, אתם יכולים להשתמש ב Google Cloud מסוף כדי להגדיר נתיב לא רגיש לבדיקת התקינות. חשוב לוודא שאף משאב אחר לא משתף את הנתיב הזה.
- נכנסים לדף Health checks במסוף Google Cloud .
מעבר לדף Health checks - לוחצים על בדיקת התקינות שבה אתם משתמשים לאפליקציה, ואז לוחצים על עריכה.
- בקטע נתיב הבקשה מוסיפים שם נתיב לא רגיש. הפרמטר הזה מציין את נתיב כתובת ה-URL שמשמש את Google Cloud כששולחים בקשות לבדיקת תקינות.
אם לא מציינים כתובת, בקשת בדיקת תקינות נשלחת אל
/. - לוחצים על Save.
הגדרת אימות ה-JWT
בקוד שקורא לשגרת האימות של JWT, מוסיפים תנאי להצגת סטטוס HTTP 200 עבור נתיב הבקשה של בדיקת התקינות. לדוגמה:
if HttpRequest.path_info = '/HEALTH_CHECK_REQUEST_PATH' return HttpResponse(status=200) else VALIDATION_FUNCTION
אוטומציה של שמירת המפתח הציבורי במטמון
מערכת IAP מבצעת רוטציה של המפתחות הציבוריים שלה מדי פעם. כדי לוודא שתמיד תוכלו לאמת את ה-JWT של הרכישה מתוך האפליקציה, מומלץ לשמור במטמון את המפתחות כדי להימנע מאחזור שלהם מכתובת ה-URL הציבורית עבור כל בקשה, וגם להפוך את תהליך העדכון של המפתח ששמור במטמון לאוטומטי. הגישה הזו שימושית במיוחד לאפליקציות שפועלות בסביבה עם הגבלות על הרשת, כמו היקף של VPC Service Controls.
אזור של VPC Service Controls יכול למנוע גישה ישירה לכתובת ה-URL הציבורית של המפתחות. על ידי שמירת המפתחות במטמון בקטגוריה של Cloud Storage, האפליקציות יכולות לאחזר אותם ממיקום בתוך המתחם ההיקפי של VPC-SC.
ההגדרה הבאה של Terraform פורסת פונקציה ב-Cloud Run שמביאה את המפתחות הציבוריים העדכניים של IAP מ-https://www.gstatic.com/iap/verify/public_key-jwk ומאחסנת אותם בקטגוריה של Cloud Storage. משימה של Cloud Scheduler מפעילה את הפונקציה הזו כל 12 שעות כדי לוודא שהמפתחות מעודכנים.
ההגדרה הזו כוללת את הפריטים הבאים:
- ממשקי API Google Cloud נדרשים שמופעלים כדי להשתמש ב-Cloud Run ולאחסן ולשמור במטמון מפתחות
- קטגוריה של Cloud Storage לאחסון המפתחות הציבוריים של IAP שאוחזרו
- קטגוריה של Cloud Storage לאחסון זמני של קוד המקור של פונקציות Cloud Run
- חשבונות שירות לפונקציות של Cloud Run ול-Cloud Scheduler עם הרשאות IAM מתאימות
- פונקציית Python לאחזור ולאחסון מפתחות
- משימה ב-Cloud Scheduler להפעלת הפונקציה כל 12 שעות
מבנה הספרייה
├── function_source/ │ ├── main.py │ └── requirements.txt ├── main.tf ├── outputs.tf ├── variables.tf └── terraform.tfvars
function_source/main.py
import functions_framework import requests from google.cloud import storage import os # Environment variables to be set in the function configuration BUCKET_NAME = os.environ.get("BUCKET_NAME") OBJECT_NAME = os.environ.get("OBJECT_NAME", "iap_public_keys.jwk") IAP_KEYS_URL = "https://www.gstatic.com/iap/verify/public_key-jwk" @functions_framework.http def update_iap_keys(request): """Fetches IAP public keys from the public URL and stores them in a Cloud Storage bucket.""" if not BUCKET_NAME: print("Error: BUCKET_NAME environment variable not set.") return "BUCKET_NAME environment variable not set.", 500 try: # Fetch the keys response = requests.get(IAP_KEYS_URL) response.raise_for_status() # Raise an exception for bad status codes keys_content = response.text print(f"Successfully fetched keys from {IAP_KEYS_URL}") # Store in Cloud Storage storage_client = storage.Client() bucket = storage_client.bucket(BUCKET_NAME) blob = bucket.blob(OBJECT_NAME) blob.upload_from_string(keys_content, content_type='application/json') print(f"Successfully wrote IAP keys to gs://{BUCKET_NAME}/{OBJECT_NAME}") return f"Successfully updated {OBJECT_NAME} in bucket {BUCKET_NAME}", 200 except requests.exceptions.RequestException as e: print(f"Error fetching keys from {IAP_KEYS_URL}: {e}") return f"Error fetching keys: {e}", 500 except Exception as e: print(f"Error interacting with Cloud Storage: {e}") return f"Error interacting with Cloud Storage: {e}", 500
מחליפים את מה שכתוב בשדות הבאים:
-
BUCKET_NAME: שם הקטגוריה של Cloud Storage -
OBJECT_NAME: השם של האובייקט שבו רוצים לאחסן את המפתחות
function_source/requirements.txt
functions-framework==3.* requests google-cloud-storage
variables.tf
variable "project_id" { description = "The Google Cloud project ID." type = string default = PROJECT_ID } variable "region" { description = "The Google Cloud region." type = string default = "REGION" } variable "iap_keys_bucket_name" { description = "The name of the Cloud Storage bucket to store IAP keys." type = string default = BUCKET_NAME" } variable "function_source_bucket_name" { description = "The name of the Cloud Storage bucket to store the function source code." type = string default = "BUCKET_NAME_FUNCTION" }
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud -
REGION: האזור שבו רוצים לפרוס את המשאבים – לדוגמה,us-central1 -
BUCKET_NAME: השם של קטגוריית Cloud Storage שבה מאוחסנים מפתחות IAP -
BUCKET_NAME_FUNCTION: השם של קטגוריית Cloud Storage שבה מאוחסן קוד המקור של פונקציות Cloud Run
main.tf
terraform { required_providers { google = { source = "hashicorp/google" version = ">= 4.50.0" } google-beta = { source = "hashicorp/google-beta" version = ">= 4.50.0" } } } provider "google" { project = var.project_id region = var.region } provider "google-beta" { project = var.project_id region = var.region } # Enable necessary APIs resource "google_project_service" "services" { for_each = toset([ "storage.googleapis.com", "cloudfunctions.googleapis.com", "run.googleapis.com", # Cloud Functions v2 uses Cloud Run "cloudscheduler.googleapis.com", "iamcredentials.googleapis.com", "cloudbuild.googleapis.com" # Needed for Cloud Functions deployment ]) service = each.key disable_on_destroy = false } # Cloud Storage Bucket to store the IAP public keys resource "google_storage_bucket" "iap_keys_bucket" { name = var.iap_keys_bucket_name location = var.region uniform_bucket_level_access = true versioning { enabled = true } lifecycle { prevent_destroy = false # Set to true in production to prevent accidental deletion } } # Cloud Storage Bucket to store the Cloud Function source code resource "google_storage_bucket" "function_source_bucket" { name = var.function_source_bucket_name location = var.region uniform_bucket_level_access = true } # Archive the function source code data "archive_file" "function_source_zip" { type = "zip" source_dir = "${path.module}/function_source" output_path = "${path.module}/function_source.zip" } # Upload the zipped source code to the source bucket resource "google_storage_bucket_object" "function_source_object" { name = "function_source.zip" bucket = google_storage_bucket.function_source_bucket.name source = data.archive_file.function_source_zip.output_path } # Service Account for the Cloud Function resource "google_service_account" "iap_key_updater_sa" { account_id = "iap-key-updater" display_name = "IAP Key Updater Function SA" } # Grant the function's SA permission to write to the IAP keys bucket resource "google_storage_bucket_iam_member" "keys_bucket_writer" { bucket = google_storage_bucket.iap_keys_bucket.name role = "roles/storage.objectAdmin" member = "serviceAccount:${google_service_account.iap_key_updater_sa.email}" } # Cloud Function (v2) resource "google_cloudfunctions2_function" "update_iap_keys_func" { provider = google-beta # CFv2 often has newer features in google-beta name = "update-iap-keys-function" location = var.region build_config { runtime = "python312" entry_point = "update_iap_keys" source { storage_source { bucket = google_storage_bucket.function_source_bucket.name object = google_storage_bucket_object.function_source_object.name } } } service_config { max_instance_count = 1 available_memory = "256M" timeout_seconds = 60 ingress_settings = "ALLOW_ALL" service_account_email = google_service_account.iap_key_updater_sa.email environment_variables = { BUCKET_NAME = google_storage_bucket.iap_keys_bucket.name OBJECT_NAME = "iap_public_keys.jwk" } } depends_on = [ google_project_service.services, google_storage_bucket_iam_member.keys_bucket_writer ] } # Service Account for the Cloud Scheduler job resource "google_service_account" "iap_key_scheduler_sa" { account_id = "iap-key-scheduler" display_name = "IAP Key Update Scheduler SA" } # Grant the Scheduler SA permission to invoke the Cloud Function resource "google_cloudfunctions2_function_iam_member" "invoker" { provider = google-beta project = google_cloudfunctions2_function.update_iap_keys_func.project location = google_cloudfunctions2_function.update_iap_keys_func.location cloud_function = google_cloudfunctions2_function.update_iap_keys_func.name role = "roles/cloudfunctions.invoker" member = "serviceAccount:${google_service_account.iap_key_scheduler_sa.email}" } # Cloud Scheduler Job resource "google_cloud_scheduler_job" "iap_key_update_schedule" { name = "iap-key-update-schedule" description = "Fetches IAP public keys and stores them in Cloud Storage every 12 hours" schedule = "0 */12 * * *" # Every 12 hours time_zone = "Etc/UTC" region = var.region http_target { uri = google_cloudfunctions2_function.update_iap_keys_func.service_config[0].uri http_method = "POST" oidc_token { service_account_email = google_service_account.iap_key_scheduler_sa.email } } depends_on = [ google_cloudfunctions2_function_iam_member.invoker, google_project_service.services ] }
outputs.tf
output "iap_keys_bucket_url" { description = "The Cloud Storage bucket URL where IAP public keys are stored." value = "gs://${google_storage_bucket.iap_keys_bucket.name}" } output "cloud_function_url" { description = "The URL of the Cloud Function endpoint that triggers key updates." value = google_cloudfunctions2_function.update_iap_keys_func.service_config[0].uri }
terraform.tfvars
יוצרים קובץ terraform.tfvars כדי לציין את מזהה הפרויקט ולהתאים אישית את שמות הקטגוריות, אם צריך:
project_id = "your-gcp-project-id" # Optional: Customize bucket names # iap_keys_bucket_name = "custom-iap-keys-bucket" # function_source_bucket_name = "custom-func-src-bucket"
פריסה באמצעות Terraform
- שומרים את הקבצים במבנה הספרייה שמתואר למעלה.
- מנווטים לספרייה במסוף ומאתחלים את Terraform:
terraform init - תכנון השינויים:
terraform plan - מחילים את השינויים:
terraform apply
כך פורסים את התשתית. המשימה של Cloud Scheduler מפעילה את הפונקציה כל 12 שעות, מאחזרת את מפתחות ה-IAP ומאחסנת אותם ב-gs://BUCKET_NAME/iap_public_keys.jwk כברירת מחדל. האפליקציות שלכם יכולות עכשיו לאחזר את המפתחות מהמאגר הזה.
מחיקת משאבים
כדי להסיר את המשאבים שנוצרו על ידי Terraform, מריצים את הפקודות הבאות:
gsutil rm -a gs://BUCKET_NAME/** terraform destroy -auto-approve
מחליפים את BUCKET_NAME בקטגוריית Cloud Storage של המפתחות.
JWTs לזהויות חיצוניות
אם אתם משתמשים ב-IAP עם זהויות חיצוניות, מערכת IAP עדיין תנפי JWT חתום בכל בקשה מאומתת, בדיוק כמו שהיא עושה עם Google Identity. עם זאת, יש כמה הבדלים.
פרטי הספק
כשמשתמשים בזהויות חיצוניות, מטען ה-JWT יכיל הצהרה בשם gcip. הטענה הזו מכילה מידע על המשתמש, כמו כתובת האימייל, כתובת ה-URL של התמונה וכל מאפיין נוסף שספציפי לספק.
הנה דוגמה ל-JWT של משתמש שהתחבר באמצעות פייסבוק:
"gcip": '{
"auth_time": 1553219869,
"email": "facebook_user@gmail.com",
"email_verified": false,
"firebase": {
"identities": {
"email": [
"facebook_user@gmail.com"
],
"facebook.com": [
"1234567890"
]
},
"sign_in_provider": "facebook.com",
},
"name": "Facebook User",
"picture: "https://graph.facebook.com/1234567890/picture",
"sub": "gZG0yELPypZElTmAT9I55prjHg63"
}',
השדות email ו-sub
אם משתמש עבר אימות על ידי Identity Platform, השדות email ו-sub של ה-JWT יתחילו בקידומת של מנפיק האסימון של Identity Platform ובמזהה הדייר שבו נעשה שימוש (אם יש כזה). לדוגמה:
"email": "securetoken.google.com/PROJECT-ID/TENANT-ID:demo_user@gmail.com", "sub": "securetoken.google.com/PROJECT-ID/TENANT-ID:gZG0yELPypZElTmAT9I55prjHg63"
שליטה בגישה באמצעות sign_in_attributes
מערכת IAM לא תומכת בזהויות חיצוניות, אבל אפשר להשתמש בטענות שמוטמעות בשדה sign_in_attributes כדי לשלוט בגישה. לדוגמה,
נניח שמשתמש נכנס לחשבון באמצעות ספק SAML:
{
"aud": "/projects/project_number/apps/my_project_id",
"gcip": '{
"auth_time": 1553219869,
"email": "demo_user@gmail.com",
"email_verified": true,
"firebase": {
"identities": {
"email": [
"demo_user@gmail.com"
],
"saml.myProvider": [
"demo_user@gmail.com"
]
},
"sign_in_attributes": {
"firstname": "John",
"group": "test group",
"role": "admin",
"lastname": "Doe"
},
"sign_in_provider": "saml.myProvider",
"tenant": "my_tenant_id"
},
"sub": "gZG0yELPypZElTmAT9I55prjHg63"
}',
"email": "securetoken.google.com/my_project_id/my_tenant_id:demo_user@gmail.com",
"exp": 1553220470,
"iat": 1553219870,
"iss": "https://cloud.google.com/iap",
"sub": "securetoken.google.com/my_project_id/my_tenant_id:gZG0yELPypZElTmAT9I55prjHg63"
}
אפשר להוסיף לאפליקציה לוגיקה שדומה לקוד שבהמשך כדי להגביל את הגישה למשתמשים עם תפקיד תקף:
const gcipClaims = JSON.parse(decodedIapJwtClaims.gcip);
if (gcipClaims &&
gcipClaims.firebase &&
gcipClaims.firebase.sign_in_attributes &&
gcipClaims.firebase.sign_in_attribute.role === 'admin') {
// Allow access to admin restricted resource.
} else {
// Block access.
}
אתם יכולים לגשת למאפייני משתמשים נוספים מספקי SAML ו-OIDC של Identity Platform באמצעות gcipClaims.gcip.firebase.sign_in_attributes nested
claim.
מגבלות על גודל הטענות של ספק הזהויות
אחרי שהמשתמש מתחבר באמצעות Identity Platform, מאפייני המשתמש הנוספים מועברים למטען הייעודי (payload) של טוקן של מזהה של Identity Platform בלי שמירת מצב, שמועבר בצורה מאובטחת ל-IAP. לאחר מכן, IAP ינפיק קובץ Cookie אטום משלו בלי שמירת מצב, שמכיל גם את אותן הצהרות. מערכת IAP תיצור את הכותרת של ה-JWT החתום על סמך התוכן של קובץ ה-Cookie.
כתוצאה מכך, אם סשן מתחיל עם הרבה טענות, יכול להיות שהוא יחרוג מגודל קובץ ה-Cookie המקסימלי המותר, שהוא בדרך כלל כ-4KB ברוב הדפדפנים. הפעולה הזו תגרום לכך שפעולת הכניסה תיכשל.
חשוב לוודא שרק הטענות הנחוצות מועברות במאפייני SAML או OIDC של ספק ה-IdP. אפשרות נוספת היא להשתמש בפונקציות חסימה כדי לסנן את הטענות שלא נדרשות לבדיקת ההרשאה.
const gcipCloudFunctions = require('gcip-cloud-functions');
const authFunctions = new gcipCloudFunctions.Auth().functions();
// This function runs before any sign-in operation.
exports.beforeSignIn = authFunctions.beforeSignInHandler((user, context) => {
if (context.credential &&
context.credential.providerId === 'saml.my-provider') {
// Get the original claims.
const claims = context.credential.claims;
// Define this function to filter out the unnecessary claims.
claims.groups = keepNeededClaims(claims.groups);
// Return only the needed claims. The claims will be propagated to the token
// payload.
return {
sessionClaims: claims,
};
}
});