Google Cloud IAM
Versión de integración: 12.0
Casos de uso
Administrar permisos y cuentas de servicio en Google Cloud
Permiso del producto
Crea una cuenta de servicio:
- Abre el Google Cloud portal del proyecto y, en el panel de la izquierda, haz clic en IAM y administración > Roles.
- Haz clic en Create Role para crear un rol personalizado que tendrá los permisos necesarios para la integración.
- En la página que se abrió, proporciona el título, la descripción, el ID y la etapa de lanzamiento del rol a la disponibilidad general.
Agrega los siguientes permisos al rol creado:
- iam.serviceAccounts.list
- iam.serviceAccounts.create
- iam.serviceAccounts.get
- iam.serviceAccounts.getIamPolicy
- iam.serviceAccounts.setIamPolicy
- iam.serviceAccounts.disable
- iam.serviceAccounts.enable
- iam.serviceAccounts.delete
- iam.roles.list
- iam.roles.get
- iam.roles.create
- iam.roles.delete
Haz clic en Crear para crear un nuevo rol personalizado.
A continuación, ve a la documentación de Google y sigue el procedimiento que se indica en la sección Cómo crear una cuenta de servicio. Después de crear una cuenta de servicio, se descarga un archivo de claves privadas de la cuenta de servicio.
Otorga el rol que creaste anteriormente a la cuenta de servicio para que tenga los permisos necesarios para la integración.
Configura la integración de Google Cloud IAM con el contenido JSON del archivo que descargaste en el paso 1.
Configura la integración de Google Cloud IAM en Google Security Operations
Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.
Parámetros de integración
Usa los siguientes parámetros para configurar la integración:
Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
---|---|---|---|---|
Tipo de cuenta | String | service_account | No | Tipo de cuenta de Google Cloud . Se encuentra en el parámetro "type" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
ID del proyecto | String | N/A | No | Es el ID del proyecto de la cuenta de Google Cloud . Se encuentra en el parámetro "project_id" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
ID de clave privada | Contraseña | N/A | No | Es el ID de la clave privada de la cuenta de Google Cloud . Se encuentra en el parámetro "private_key_id" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
Clave privada | Contraseña | N/A | No | Clave privada de la cuenta de Google Cloud . Se encuentra en el parámetro "private_key" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
Correo electrónico del cliente | String | N/A | No | Es el correo electrónico del cliente de la cuenta de Google Cloud . Se encuentra en el parámetro "client_email" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
ID de cliente | String | N/A | No | ID de cliente de la cuenta de Google Cloud . Se encuentra en el parámetro "client_id" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
URI de autenticación | String | https://accounts.google.com/o/oauth2/auth | No | Es el URI de autorización de la cuenta de Google Cloud . Se encuentra en el parámetro "auth_uri" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
URI de token | String | https://oauth2.googleapis.com/token |
No | Es el URI del token de la cuenta de Google Cloud . Se encuentra en el parámetro "token_uri" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
URL de X509 del proveedor de autenticación | String | https://www.googleapis.com/oauth2/v1/certs |
No | Es la URL X509 del proveedor de autenticación de la cuenta de Google Cloud . Se encuentra en el parámetro "auth_provider_x509_cert_url" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
URL del certificado X509 del cliente | String | N/A | No | URL del certificado X509 del cliente de la cuenta de Google Cloud . Se encuentra en el parámetro "client_x509_cert_url" del archivo JSON de autenticación. Debes copiar el valor y colocarlo en este parámetro de configuración de la integración. |
Contenido del archivo JSON de la cuenta de servicio | String | N/A | No | Opcional: En lugar de especificar el ID de clave privada, la clave privada y otros parámetros, especifica aquí el contenido JSON completo del archivo de la cuenta de servicio. Si se proporciona este parámetro, se ignoran los demás parámetros de conexión. |
Verificar SSL | Casilla de verificación | Marcado | No | Si está habilitada, la integración verifica que el certificado SSL para la conexión al servicio de Google Cloud sea válido. |
Acciones
Ping
Descripción
Prueba la conectividad con el servicio de Identity and Access Management con los parámetros proporcionados en la página de configuración de la integración en la pestaña Google Security Operations Marketplace.
Parámetros
N/A
Ejecutar en
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía:
|
General |
Enriquece entidades
Descripción
Enriquecer las entidades de usuarios de Google SecOps con información de cuentas de servicio de Identity and Access Management La acción espera el correo electrónico de la cuenta de servicio de Identity and Access Management como una entidad de usuario de Google SecOps.
Ejecutar en
Esta acción se ejecuta en la entidad User.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"name": "projects/silver-shift-275007/serviceAccounts/dmitrystestsa@silver-shift-275007.iam.gserviceaccount.com",
"projectId": "silver-shift-275007",
"uniqueId": "104627053409757134782",
"email": "dmitrystestsa@silver-shift-275007.iam.gserviceaccount.com",
"displayName": "dmitrys Test SA displayName",
"etag": "MDEwMjE5MjA=",
"description": "Service account description",
"oauth2ClientId": "104627053409757134782"
}
Enriquecimiento de entidades
Nombre del campo de enriquecimiento | Lógica: Cuándo aplicar |
---|---|
Google_IAM_name | |
Google_IAM_project_id | .. |
Google_IAM_unique_id | |
Google_IAM_email | |
Google_IAM_display_name | |
Google_IAM_description | |
Google_IAM_oauth2_client_id |
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: Si se trata de un error fatal o del SDK, como credenciales incorrectas, falta de conexión al servidor o algún otro: "Error al ejecutar la acción "Enrich Entities". Reason: {0}''.format(error.Stacktrace) |
General |
Tabla (enriquecimiento) | Nombre de la tabla: Tabla de enriquecimiento de {entidad} Columnas: Clave, Valor |
Entidad |
Enumerar cuentas de servicio
Descripción
Enumera las cuentas de servicio de Identity and Access Management según los criterios de búsqueda especificados. Ten en cuenta que la acción no funciona en las entidades de Google SecOps.
Parámetros
Nombre visible del parámetro | Tipo | Valor predeterminado | Is Mandatory | Descripción |
---|---|---|---|---|
Nombre visible de la cuenta de servicio | String | N/A | No | Especifica el nombre visible de la cuenta de servicio que se devolverá. El parámetro acepta varios valores como una cadena separada por comas. |
Correo electrónico de la cuenta de servicio | String | N/A | No | Especifica el correo electrónico de la cuenta de servicio que se devolverá. El parámetro acepta varios valores como una cadena separada por comas. |
Cantidad máxima de filas que se devolverán | Número entero | 50 | No | Especifica cuántos roles debe devolver la acción. |
Ejecutar en
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"accounts": [
{
"name": "projects/silver-shift-275007/serviceAccounts/dmitrystestsa@silver-shift-275007.iam.gserviceaccount.com",
"projectId": "silver-shift-275007",
"uniqueId": "104627053409757134782",
"email": "dmitrystestsa@silver-shift-275007.iam.gserviceaccount.com",
"displayName": "dmitrys Test SA displayName",
"etag": "MDEwMjE5MjA=",
"description": "Service account description",
"oauth2ClientId": "104627053409757134782"
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: if fatal error, invalid zone, SDK error, like wrong credentials, no connection to server, other: "Error executing action "List Service Accounts". Reason: {0}''.format(error.Stacktrace) |
General |
Tabla | Nombre de la tabla: Google Cloud Cuentas de servicio Columnas de la tabla: Nombre de la cuenta de servicio ID único de la cuenta de servicio Correo electrónico de la cuenta de servicio Nombre visible de la cuenta de servicio Descripción de la cuenta de servicio ID de cliente de OAuth2 de la cuenta de servicio |
General |
Crear una cuenta de servicio.
Descripción
Crea una cuenta de servicio de Identity and Access Management.
Parámetros
Nombre visible del parámetro | Tipo | Valor predeterminado | Is Mandatory | Descripción |
---|---|---|---|---|
ID de la cuenta de servicio | String | String | Sí | Especifica el ID de la cuenta de servicio que se creará. |
Nombre visible de la cuenta de servicio | String | String | No | Especifica el nombre visible de la cuenta de servicio que se creará. |
Descripción de la cuenta de servicio | String | String | No | Especifica la descripción de la cuenta de servicio que se creará. |
Ejecutar en
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"name": "projects/silver-shift-275007/serviceAccounts/dmitrystestsa@silver-shift-275007.iam.gserviceaccount.com",
"projectId": "silver-shift-275007",
"uniqueId": "104627053409757134782",
"email": "dmitrystestsa@silver-shift-275007.iam.gserviceaccount.com",
"displayName": "dmitrys Test SA displayName",
"etag": "MDEwMjE5MjA=",
"description": "Service account description",
"oauth2ClientId": "104627053409757134782"
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: Si se trata de un error fatal o del SDK, como credenciales incorrectas, falta de conexión con el servidor o algún otro: "Error al ejecutar la acción "Crear cuenta de servicio". Reason: {0}''.format(error.Stacktrace) |
General |
Obtén la política de IAM de la cuenta de servicio
Descripción
Obtiene la política de control de acceso de la cuenta de servicio. La acción espera el correo electrónico de la cuenta de servicio de Identity and Access Management como una entidad de usuario de Google SecOps. Ten en cuenta que la política puede estar vacía si no se le asignó ninguna política a la cuenta de servicio.
Ejecutar en
Esta acción se ejecuta en la entidad User.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"version": 1,
"etag": "BwXBuNg8cMA=",
"bindings": [
{
"role": "roles/iam.securityReviewer",
"members": [
"user:dmitrys@siemplify.co"
]
}
]
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Get Service Account IAM Policy". Reason: {0}''.format(error.Stacktrace) |
General |
Configura la política de IAM de la cuenta de servicio
Descripción
Establece la política de control de acceso en la cuenta de servicio especificada. La acción espera el correo electrónico de la cuenta de servicio de Identity and Access Management como una entidad de cuenta de Google SecOps. Ten en cuenta que la política proporcionada en la acción reemplaza cualquier política existente.
Parámetros
Nombre visible del parámetro | Tipo | Valor predeterminado | Is Mandatory | Descripción |
---|---|---|---|---|
Política | String | N/A | Sí | Especifica el documento de política JSON que se configurará para la cuenta de servicio. |
Ejecutar en
Esta acción se ejecuta en la entidad Account.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"version": 1,
"etag": "BwXBuNg8cMA=",
"bindings": [
{
"role": "roles/iam.securityReviewer",
"members": [
"user:dmitrys@siemplify.co"
]
}
]
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Set Service Account IAM Policy". Reason: {0}''.format(error.Stacktrace) |
General |
Inhabilita la cuenta de servicio
Descripción
Inhabilita la cuenta de servicio. La acción espera el correo electrónico de la cuenta de servicio de Identity and Access Management como una entidad de usuario de Google SecOps.
Ejecutar en
Esta acción se ejecuta en la entidad User.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Disable Service Account". Reason: {0}''.format(error.Stacktrace) |
General |
Habilitar la cuenta de servicio.
Descripción
Habilita la cuenta de servicio. La acción espera el correo electrónico de la cuenta de servicio de Identity and Access Management como una entidad de usuario de Google SecOps.
Ejecutar en
Esta acción se ejecuta en la entidad User.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal o un error del SDK, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema: "Error al ejecutar la acción "Habilitar cuenta de servicio". Reason: {0}''.format(error.Stacktrace) |
General |
Borrar cuenta de servicio
Descripción
Borra la cuenta de servicio. La acción espera el correo electrónico de la cuenta de servicio de Identity and Access Management como una entidad de usuario de Google SecOps.
Ejecutar en
Esta acción se ejecuta en la entidad User.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal o un error del SDK, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción "Borrar cuenta de servicio". Reason: {0}''.format(error.Stacktrace) |
General |
Enumera roles
Descripción
Enumera los roles de Identity and Access Management según los criterios de búsqueda especificados. Ten en cuenta que la acción no funciona en las entidades de SecOps de Google.
Parámetros
Nombre visible del parámetro | Tipo | Valor predeterminado | Is Mandatory | Descripción |
---|---|---|---|---|
Ver | DDL | Básico | No | Especifica qué vista se debe usar para devolver la información del rol. |
Cantidad máxima de filas que se devolverán | Número entero | 50 | No | Especifica cuántos roles debe devolver la acción. |
¿Solo roles personalizados del proyecto? | Casilla de verificación | Desmarcado | No | Si se habilita, la acción solo devolverá los roles personalizados definidos para el ID del proyecto actual. |
Mostrar borradas | Casilla de verificación | Desmarcado | No | Si se habilita, la acción también devolverá los roles borrados. |
Ejecutar en
La acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"roles": [
{
"name": "roles/accessapproval.approver",
"title": "Access Approval Approver",
"description": "Ability to view or act on access approval requests and view configuration",
"stage": "BETA",
"etag": "AA=="
},
{
"name": "roles/accessapproval.configEditor",
"title": "Access Approval Config Editor",
"description": "Ability update the Access Approval configuration",
"stage": "BETA",
"etag": "AA=="
}
]
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: Si se trata de un error fatal, una zona no válida, un error del SDK (como credenciales incorrectas, falta de conexión con el servidor o algún otro problema): "Error al ejecutar la acción "List Roles". Reason: {0}''.format(error.Stacktrace) |
General |
Tabla | Nombre de la tabla: Roles de Google Cloud IAM Columnas de la tabla: Nombre del rol Título del rol Descripción del Cargo Etapa del rol ETag del rol Permisos del rol |
General |
Crear rol
Descripción
Crea un rol de Identity and Access Management.
Parámetros
Nombre visible del parámetro | Tipo | Valor predeterminado | Is Mandatory | Descripción |
---|---|---|---|---|
ID de función | String | N/A | Sí | Especifica el ID del rol de Identity and Access Management recién creado. |
Definición del rol | String | N/A | Sí | Especifica el documento de política JSON que se usará como definición del rol. |
Ejecutar en
La acción no se ejecuta en entidades.
Ejemplo de JSON de política de rol
{
"name": "projects/silver-shift-275007/roles/iam_test_role_api",
"title": "iam_test_role_api",
"description": "test role",
"includedPermissions": [
"storagetransfer.projects.getServiceAccount"
],
"stage": "GA",
"etag": "BwXBu1RHiPw="
}
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"name": "projects/silver-shift-275007/roles/iam_test_role_api",
"title": "iam_test_role_api",
"description": "test role",
"includedPermissions": [
"storagetransfer.projects.getServiceAccount"
],
"stage": "GA",
"etag": "BwXBu1RHiPw="
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Role". Reason: {0}''.format(error.Stacktrace) |
General |
Borrar rol
Descripción
Borra un rol de Identity and Access Management.
Parámetros
Nombre visible del parámetro | Tipo | Valor predeterminado | Is Mandatory | Descripción |
---|---|---|---|---|
ID de función | String | N/A | Sí | Especifica el ID del rol de Identity and Access Management recién creado. |
Ejecutar en
Esta acción no se ejecuta en entidades.
Resultados de la acción
Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos | Opciones de valor |
---|---|
is_success | is_success=False |
is_success | is_success=True |
Resultado de JSON
{
"name": "projects/silver-shift-275007/roles/iam_test_role_api",
"title": "iam_test_role_api",
"description": "test role",
"includedPermissions": [
"storagetransfer.projects.getServiceAccount"
],
"stage": "GA",
"etag": "BwXDDgKFx7M=",
"deleted": true
}
Muro de casos
Tipo de resultado | Valor/Descripción | Tipo |
---|---|---|
Mensaje de salida* | La acción no debe fallar ni detener la ejecución de una guía:
La acción debería fallar y detener la ejecución de la guía: Si se produce un error fatal o un error del SDK, como credenciales incorrectas, falta de conexión al servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción "Borrar rol"". Reason: {0}''.format(error.Stacktrace) |
General |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.