יצירה וחיפוש של קבוצות עם מיפוי זהויות

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

מידע נוסף על קבוצות עם מיפוי זהויות זמין במאמר סקירה כללית על Groups API.

בקטעים הבאים מוסבר איך לנהל קבוצות שממופות לזהויות.

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

לפני שממשיכים לקרוא את המידע בדף הזה, צריך לבצע את המשימות הבאות:

יצירת קבוצה עם מיפוי זהויות

REST

כדי ליצור קבוצה עם מיפוי זהויות, קוראים ל-groups.create() עם מופע של הקבוצה החדשה. מופע הקבוצה צריך לכלול את הערכים groupKey,‏ Parent ו-label שמוגדרים ל-system/groups/external. הערך groupKey הוא שילוב של namespace ו-groupId שמזהה באופן ייחודי את הקבוצה.

Python

בדוגמה הבאה מוצגת פונקציית עזר ליצירת קבוצת זהויות באמצעות ספריית הלקוח של Python. משתמשים במזהה של מקור הזהויות, שמתקבל כשיוצרים את מקור הזהויות במסוף Google Admin, כדי לקרוא לפונקציית העזר וליצור קבוצה:

def create_identity_group(service, identity_source_id, group_id, group_display_name,
  group_description):
  namespace = "identitysources/" + identity_source_id
  group_key = {"id": group_id, "namespace": namespace}
  group = {
    "parent": namespace,
    "description": group_description,
    "displayName": group_display_name,
    "groupKey": group_key,
    "labels": {
      # Set the label to specify creation of an identity group.
      "system/groups/external": ""
    }
  }

  try:
    response = service.groups().create(body=group).execute()
    print response
  except Exception, e:
    print e

  myNewGroup = create_identity_group(
    idSvc,
    "ABC1234",
    "zebra",
    "Zebra external group",
    "The Zebra group is an identity group representing the Zooland
      external identity"
  )

ציון מרחב השמות מבטיח שלא יהיו התנגשויות בשמות, וממקם את הקבוצה שממופה לזהות בהקשר המתאים של קבוצות אחרות מאותו מקור זהויות חיצוני.

חיפוש קבוצות עם מיפוי זהויות

REST

כדי לחפש קבוצות עם מיפוי זהויות, מתקשרים אל groups.search() עם מחרוזת שאילתה. כדי לחפש את כל הקבוצות, צריך לציין רק את התווית system/groups/external.

Python

בדוגמה הבאה מוצגת פונקציית עזר שמשמשת לחיפוש קבוצות עם מיפוי זהויות באמצעות ספריית הלקוח של Python:

def search_identity_groups(service, identity_source_id, pageSize, view):
  # Set the label to search for all identity groups
  searchQuery = "&query=namespace=identitysources/" + identity_source_id \
    + "%20AND%20" + "labels:system/groups/external" \
    + "&pageSize=" + pageSize + "&view=" + view
  try:
    searchGroupsRequest = service.groups().search()
    searchGroupsRequest.uri += searchQuery
    response = searchGroupsRequest.execute()
    print response
  except Exception, e:
    print e

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

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