Integra Akeyless con Google SecOps

En este documento, se explica cómo integrar Akeyless con Google Security Operations.

Casos de uso

La integración de Akeyless usa las capacidades de Google SecOps para admitir los siguientes casos de uso:

  • Sincroniza las credenciales de integración: Actualiza automáticamente las credenciales y los parámetros sensibles en las instancias, los conectores y los trabajos de integración de Google SecOps con los secretos almacenados en Akeyless.

  • Recupera secretos en los playbooks: Recupera secretos estáticos o versiones específicas de secretos de Akeyless a pedido durante la ejecución del playbook para autenticarte con servicios externos.

  • Automatiza la rotación de credenciales: Propaga las claves de API, los tokens y las contraseñas rotados de Akeyless a las integraciones, los conectores y los trabajos de Google SecOps asignando parámetros a la versión del secreto de latest, lo que evita las interrupciones causadas por credenciales vencidas.

  • Controla las actualizaciones de credenciales con la fijación de versiones: Fija los parámetros de integración, conector o trabajo a una versión de secreto específica en Akeyless para validar los cambios de credenciales o revertir a una versión anterior cuando sea necesario.

  • Elimina los secretos codificados en los flujos de trabajo: Centraliza las credenciales sensibles en Akeyless en lugar de incorporarlas directamente en las entradas del playbook o en las secuencias de comandos personalizadas, lo que reduce la exposición de las credenciales en los flujos de trabajo del SOC.

Antes de comenzar

Antes de configurar la integración en la plataforma de Google SecOps, verifica que tengas lo siguiente:

  • Credenciales de clave de API: Un ID de acceso y una clave de acceso de Akeyless para la autenticación.

    Para obtener más información, consulta Autenticación de claves de API de Akeyless.

  • Permisos de acceso: Permisos de lectura otorgados a tu método de autenticación para los secretos que recupera Google SecOps.

    Para obtener más información, consulta Control de acceso basado en roles (RBAC) de Akeyless.

  • Conectividad de red: Acceso de red desde tu instancia de Google SecOps o agente remoto a la URL de la puerta de enlace de la API de Akeyless.

Parámetros de integración

La integración de Akeyless requiere los siguientes parámetros:

Parámetro Descripción
API Gateway URL

Es opcional.

La URL de tu API Gateway de Akeyless.

El valor predeterminado es https://api.akeyless.io.
Access ID

Obligatorio.

Es el ID de acceso para tu método de autenticación de clave de API de Akeyless.
Access Key

Obligatorio.

Es la clave de acceso asociada a tu ID de acceso de Akeyless.
Verify SSL

Obligatorio.

Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Akeyless.

Habilitada de forma predeterminada.

Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.

Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.

Acciones

Para obtener más información sobre las acciones, consulta Cómo responder a las acciones pendientes de Tu escritorio y Cómo realizar una acción manual.

Obtener valor del secreto

Usa la acción Obtener valor del secreto para recuperar un valor de secreto de Akeyless y usarlo en las guías.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

La acción Obtener valor del secreto requiere los siguientes parámetros:

Parámetro Descripción
Secret Name

Obligatorio.

Nombre o ruta de acceso del secreto que se recuperará de Akeyless.

Para recuperar la versión más reciente, ingresa SECRET_NAME o SECRET_NAME:latest.

Para recuperar una versión específica, ingresa SECRET_NAME:VERSION_NUMBER, donde VERSION_NUMBER es un número entero positivo (por ejemplo, /prod/api-key:2).

Resultados de la acción

La acción Get Secret Value proporciona los siguientes resultados:

Tipo de resultado de la acción Disponibilidad
Archivo adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON Disponible
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Resultado de JSON

En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Get Secret Value:

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
Mensajes de salida

En el Muro de casos, la acción Obtener valor del secreto proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. La acción se realizó correctamente.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

No se pudo realizar la acción.

Verifica que la ruta de acceso y la versión del Secret existan en Akeyless y que tus credenciales de autenticación tengan acceso de lectura al Secret.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

No se pudo realizar la acción.

Verifica el formato del parámetro Secret Name.
Resultado de secuencia de comandos

En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener valor del secreto:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false

Ping

Usa la acción Ping para probar la conectividad con el servidor de Akeyless.

Esta acción no se ejecuta en las entidades de Google SecOps.

Entradas de acción

Ninguno

Resultados de la acción

La acción Ping proporciona los siguientes resultados:

Tipo de salida de la acción Disponibilidad
Archivo adjunto del muro de casos No disponible
Vínculo al muro de casos No disponible
Tabla del muro de casos No disponible
Tabla de enriquecimiento No disponible
Resultado de JSON No disponible
Mensajes de salida Disponible
Resultado de secuencia de comandos Disponible
Mensajes de salida

En el Muro de casos, la acción Ping proporciona los siguientes mensajes de salida:

Mensaje de salida Descripción del mensaje
Successfully connected to the Akeyless server with the provided connection parameters! La acción se realizó correctamente.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

No se pudo realizar la acción.

Verifica la configuración de API Gateway URL, Access ID, Access Key y SSL.
Resultado de secuencia de comandos

En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:

Nombre del resultado de la secuencia de comandos Valor
is_success true o false

Trabajos

Para obtener más información sobre los trabajos, consulta Configura un trabajo nuevo y Programación avanzada.

Trabajo de sincronización de credenciales de integración

Usa el trabajo de sincronización de credenciales de integración para sincronizar automáticamente los secretos almacenados en Akeyless con las instancias, los conectores y los trabajos de integración de Google SecOps que configuraste.

Parámetros del trabajo

El trabajo de sincronización de credenciales de integración requiere los siguientes parámetros:

Parámetro Descripción
API Gateway URL

Es opcional.

La URL de tu API Gateway de Akeyless.

El valor predeterminado es https://api.akeyless.io.
Access ID

Obligatorio.

Es el ID de acceso para tu método de autenticación de clave de API de Akeyless.
Access Key

Obligatorio.

Es la clave de acceso asociada a tu ID de acceso de Akeyless.
Verify SSL

Obligatorio.

Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Akeyless.

Habilitada de forma predeterminada.
Environment Name

Obligatorio.

Es el entorno de Google SecOps en el que se configuran las instancias de integración, los conectores y los trabajos de destino.

El valor predeterminado es Default Environment.
Credential Mapping

Obligatorio.

Es un diccionario JSON o YAML que asigna instancias de integración, conectores y trabajos de destino a los secretos de Akeyless que contienen sus valores de parámetros.

Incluye al menos un parámetro asignado en las claves integration_instances, connectors o jobs.

Para ver un ejemplo, consulta Ejemplo de Credential Mapping.

El valor predeterminado es {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

Ejemplo Credential Mapping

En el siguiente ejemplo, se muestra cómo asignar parámetros para instancias de integración, conectores y trabajos en el parámetro Credential Mapping:

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.