Crear grupos de seguridad

En esta página se explica cómo crear grupos de seguridad. Puedes crear un grupo de seguridad o convertir un grupo de Google en un grupo de seguridad.

Antes de empezar

Realiza las siguientes tareas antes de continuar con la información de esta página:

Requisitos de los grupos de seguridad

Los grupos de seguridad solo pueden contener lo siguiente:

  • Usuarios de dentro o fuera de tu dominio (mientras estén asociados a un servicio de Google)
  • Cuentas de servicio dentro o fuera de tu dominio
  • Grupos de seguridad de tu dominio

No puedes aplicar la etiqueta de grupo de seguridad a un grupo de Google que no cumpla estas condiciones.

Solo los superadministradores o administradores de grupos predefinidos tienen permisos para actualizar grupos de seguridad.

Crear un grupo de seguridad

REST

Para crear un grupo de seguridad, llama a groups.create() con una instancia del nuevo grupo. La instancia de grupo debe incluir un groupKey, Parent y labels definidos como cloudidentity.googleapis.com/groups.security y cloudidentity.googleapis.com/groups.discussion_forum.

Python

En el siguiente ejemplo se muestra una función auxiliar para crear un grupo de Google con la biblioteca de cliente de Python:

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)

Convertir grupos de Google en grupos de seguridad

REST

Para convertir un Grupo de Google en un grupo de seguridad, llama a groups.patch() con updateMask definido como cloudidentity.googleapis.com/groups.security y cloudidentity.googleapis.com/groups.discussion_forum.

Cuerpo de solicitud de ejemplo

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

Python

En el siguiente ejemplo se muestra una función auxiliar para actualizar un grupo de Google a un grupo de seguridad mediante la biblioteca de cliente de Python:

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)