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:
Consulta la descripción general de la API Groups.
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)