Creazione e ricerca di gruppi con mappatura delle identità

Questa pagina spiega come creare e cercare gruppi con mappatura delle identità. Un gruppo mappato alle identità è un tipo di gruppo che rispecchia un gruppo in un' origine identità esterna, ad esempio un gruppo Active Directory. I gruppi mappati alle identità vengono utilizzati per creare un connettore di identità per Google Cloud Search.

Per saperne di più sui gruppi mappati alle identità, consulta la panoramica dell'API Groups.

Le sezioni seguenti mostrano come gestire i gruppi con mappatura delle identità.

Prima di iniziare

Prima di procedere con le informazioni riportate in questa pagina, svolgi le seguenti attività:

Creazione di un gruppo con mappatura delle identità

REST

Per creare un gruppo con mappatura delle identità, chiama groups.create() con un istanza del nuovo gruppo. L'istanza di gruppo deve includere un groupKey, Parent e label impostati su system/groups/external. groupKey è una combinazione di namespace e groupId che identifica in modo univoco il gruppo.

Python

L'esempio seguente mostra una funzione di supporto per creare un gruppo di identità utilizzando la libreria client Python. Utilizza l'ID origine identità ottenuto quando hai creato l'origine identità nella Console di amministrazione Google per chiamare la funzione di assistenza e creare un gruppo:

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"
  )

Fornendo lo spazio dei nomi, eviterai collisioni di nomi e inserirai il gruppo con mappatura delle identità nel contesto corretto degli altri gruppi della stessa origine identità esterne.

Ricerca di gruppi con mappatura delle identità

REST

Per cercare gruppi con mappatura delle identità, chiama groups.search() con una stringa di query. Per cercare tutti i gruppi, devi solo fornire l'etichettasystem/groups/external.

Python

L'esempio seguente mostra una funzione di supporto utilizzata per eseguire ricerche di gruppi con mappatura delle identità utilizzando la libreria client 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

Passaggi successivi

Una volta creato un gruppo, puoi creare le relative iscrizioni. Per creare le appartenenze per un gruppo con mappatura delle identità, consulta Gestire le appartenenze ai gruppi con mappatura delle identità.