Sicherheitsgruppen erstellen

Auf dieser Seite wird erläutert, wie Sie Sicherheitsgruppen erstellen. Sie können eine neue Sicherheitsgruppe erstellen oder eine Google-Gruppe auf eine Sicherheitsgruppe aktualisieren.

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, die mit einem Google-Dienst verknüpft sind
  • Dienstkonten innerhalb oder außerhalb Ihrer Domain
  • Sicherheitsgruppen innerhalb 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 groupKey, Parent und labels enthalten, die auf cloudidentity.googleapis.com/groups.security und cloudidentity.googleapis.com/groups.discussion_forum festgelegt sind

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)