Sicherheitsgruppen erstellen

Auf dieser Seite wird erläutert, wie Sie Sicherheitsgruppen erstellen. Sie können ein neues Wertpapier oder eine Google-Gruppe zu einer Sicherheitsgruppe.

Hinweise

Führen Sie folgende Aufgaben aus, bevor Sie die Informationen auf dieser Seite umsetzen:

Anforderungen an Sicherheitsgruppen

Sicherheitsgruppen dürfen nur Folgendes enthalten:

  • Nutzer innerhalb oder außerhalb Ihrer Domain (während sie mit einem Google-Dienst)
  • Dienstkonten innerhalb oder außerhalb Ihrer Domain
  • Sicherheitsgruppen in Ihrer Domain

Sie können das Sicherheitsgruppenlabel nicht auf eine Google-Gruppe anwenden, die diese Bedingungen nicht erfüllt.

Nur vordefinierte Super Admins oder Groups Admins haben die Berechtigung zum Aktualisieren von Sicherheitsgruppen.

Neue Sicherheitsgruppe erstellen

REST

Rufen Sie zum Erstellen einer Sicherheitsgruppe groups.create() mit einer Instanz der neuen Gruppe auf. Die Gruppeninstanz muss einen groupKey, einen Parent und ein labels enthalten, das auf cloudidentity.googleapis.com/groups.security und cloudidentity.googleapis.com/groups.discussion_forum festgelegt ist.

Python

Im folgenden Beispiel wird eine Hilfsfunktion zum Erstellen einer Google Groups mithilfe der Python-Clientbibliothek gezeigt:

def create_google_group(service, customer_id, group_id, group_display_name, group_description):
  group_key = {"id": group_id}
  group = {
    "parent": "customers/" + customer_id,
    "description": group_description,
    "displayName": group_display_name,
    "groupKey": group_key,
    # Set the label to specify creation of a Google Group.
    "labels": {
      "cloudidentity.googleapis.com/groups.security": "",
      "cloudidentity.googleapis.com/groups.discussion_forum": ""
    }
  }

  try:
    request = service.groups().create(body=group)
    request.uri += "&initialGroupConfig=WITH_INITIAL_OWNER"
    response = request.execute()
    print(response)
  except Exception as e:
    print(e)

Eine Google Groups-Gruppe auf eine Sicherheitsgruppe aktualisieren

REST

Um eine Google Groups-Gruppe auf eine Sicherheitsgruppe zu aktualisieren, rufen Sie groups.patch() auf und setzen Sie updateMask auf cloudidentity.googleapis.com/groups.security und cloudidentity.googleapis.com/groups.discussion_forum.

Beispiel für einen Anfragetext

{
  "labels": {
    "cloudidentity.googleapis.com/groups.security": "",
    "cloudidentity.googleapis.com/groups.discussion_forum": ""
  }
}

Python

Das folgende Beispiel zeigt eine Hilfsfunktion zum Aktualisieren einer Google Group zu einer Sicherheitsgruppe mit der Python-Clientbibliothek:

def add_security_label_to_group(service, group_name):
  group = {
    "labels": {
      "cloudidentity.googleapis.com/groups.security": "",
      "cloudidentity.googleapis.com/groups.discussion_forum": ""
    }
  }
  try:
    request = service.groups().patch(name=group_name, body=group)
    request.uri = request.uri + '&updateMask=labels'
    response = request.execute()
    print(response)
  except Exception as e:
    print(e)