Integra Akeyless con Google SecOps

Questo documento spiega come integrare Akeyless con Google Security Operations.

Casi d'uso

L'integrazione di Akeyless utilizza le funzionalità di Google SecOps per supportare i seguenti casi d'uso:

  • Sincronizza le credenziali di integrazione: aggiorna automaticamente le credenziali e i parametri sensibili in tutte le istanze, i connettori e i job di integrazione di Google SecOps utilizzando i secret archiviati in Akeyless.

  • Recupera i secret nei playbook: recupera secret statici o versioni specifiche dei secret da Akeyless on demand durante l'esecuzione del playbook per l'autenticazione con servizi esterni.

  • Automatizza la rotazione delle credenziali: propaga chiavi API, token e password ruotati da Akeyless alle integrazioni, ai connettori e ai job di Google SecOps mappando i parametri alla versione del secret latest, evitando interruzioni causate da credenziali scadute.

  • Controlla gli aggiornamenti delle credenziali con il blocco della versione: blocca i parametri di integrazione, connettore o job a una versione specifica del secret in Akeyless per convalidare le modifiche alle credenziali o eseguire il rollback a una versione precedente, se necessario.

  • Elimina i secret hardcoded nei flussi di lavoro: centralizza le credenziali sensibili in Akeyless anziché incorporarle direttamente negli input del playbook o negli script personalizzati, riducendo l'esposizione delle credenziali nei flussi di lavoro SOC.

Prima di iniziare

Prima di configurare l'integrazione nella piattaforma Google SecOps, verifica di disporre di quanto segue:

  • Credenziali della chiave API: un ID accesso e una chiave di accesso Akeyless per l'autenticazione.

    Per saperne di più, consulta Autenticazione con chiave API Akeyless.

  • Autorizzazioni di accesso: autorizzazioni in lettura concesse al tuo metodo di autenticazione per i secret recuperati da Google SecOps.

    Per saperne di più, consulta Controllo degli accessi basato su ruoli (RBAC) di Akeyless.

  • Connettività di rete: accesso alla rete dalla tua istanza Google SecOps o dall'agente remoto all'URL dell'API Gateway Akeyless.

Parametri di integrazione

L'integrazione Akeyless richiede i seguenti parametri:

Parametro Descrizione
API Gateway URL

Facoltativo.

L'URL del tuo API Gateway Akeyless.

Il valore predefinito è https://api.akeyless.io.
Access ID

Obbligatorio.

L'ID di accesso per il metodo di autenticazione con chiave API Akeyless.
Access Key

Obbligatorio.

La chiave di accesso associata al tuo ID di accesso Akeyless.
Verify SSL

Obbligatorio.

Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Akeyless.

Abilitato per impostazione predefinita.

Per istruzioni su come configurare un'integrazione in Google SecOps, consulta Configura le integrazioni.

Se necessario, puoi apportare modifiche in un secondo momento. Dopo aver configurato un'istanza di integrazione, puoi utilizzarla nei playbook. Per saperne di più su come configurare e supportare più istanze, consulta Supporto di più istanze.

Azioni

Per ulteriori informazioni sulle azioni, vedi Rispondere alle azioni in attesa dalla tua scrivania e Eseguire un'azione manuale.

Ottieni valore secret

Utilizza l'azione Ottieni valore secret per recuperare un valore secret da Akeyless da utilizzare nei playbook.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

L'azione Recupera valore secret richiede i seguenti parametri:

Parametro Descrizione
Secret Name

Obbligatorio.

Il nome o il percorso del secret da recuperare da Akeyless.

Per recuperare l'ultima versione, inserisci SECRET_NAME o SECRET_NAME:latest.

Per recuperare una versione specifica, inserisci SECRET_NAME:VERSION_NUMBER, dove VERSION_NUMBER è un numero intero positivo (ad esempio, /prod/api-key:2).

Output azione

L'azione Ottieni valore secret fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Risultato JSON

L'esempio seguente mostra l'output del risultato JSON ricevuto quando utilizzi l'azione Recupera valore secret:

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
Messaggi di output

Nella bacheca richieste, l'azione Ottieni valore secret fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. L'azione è andata a buon fine.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

L'azione non è riuscita.

Verifica che il percorso e la versione del secret esistano in Akeyless e che le tue credenziali di autenticazione dispongano dell'accesso in lettura 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').

L'azione non è riuscita.

Verifica il formato del parametro Secret Name.
Risultato dello script

La tabella seguente elenca il valore per l'output del risultato dello script quando utilizzi l'azione Recupera valore secret:

Nome del risultato dello script Valore
is_success true o false

Dindin

Utilizza l'azione Ping per testare la connettività al server Akeyless.

Questa azione non viene eseguita sulle entità Google SecOps.

Input azione

Nessuno.

Output azione

L'azione Ping fornisce i seguenti output:

Tipo di output dell'azione Disponibilità
Allegato della bacheca richieste Non disponibile
Link alla bacheca casi Non disponibile
Tabella della bacheca casi Non disponibile
Tabella di arricchimento Non disponibile
Risultato JSON Non disponibile
Messaggi di output Disponibile
Risultato dello script Disponibile
Messaggi di output

Nella Bacheca delle richieste, l'azione Ping fornisce i seguenti messaggi di output:

Messaggio di output Descrizione del messaggio
Successfully connected to the Akeyless server with the provided connection parameters! L'azione è andata a buon fine.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

L'azione non è riuscita.

Verifica le impostazioni di API Gateway URL, Access ID, Access Key e SSL.
Risultato dello script

La tabella seguente elenca il valore dell'output del risultato dello script quando si utilizza l'azione Ping:

Nome del risultato dello script Valore
is_success true o false

Job

Per saperne di più sui job, consulta Configura un nuovo job e Pianificazione avanzata.

Job di sincronizzazione delle credenziali di integrazione

Utilizza il job Sincronizza credenziali di integrazione per sincronizzare automaticamente i secret archiviati in Akeyless con le istanze, i connettori e i job di integrazione di Google SecOps configurati.

Parametri del job

Il job di sincronizzazione delle credenziali di integrazione richiede i seguenti parametri:

Parametro Descrizione
API Gateway URL

Facoltativo.

L'URL del tuo API Gateway Akeyless.

Il valore predefinito è https://api.akeyless.io.
Access ID

Obbligatorio.

L'ID di accesso per il metodo di autenticazione con chiave API Akeyless.
Access Key

Obbligatorio.

La chiave di accesso associata al tuo ID di accesso Akeyless.
Verify SSL

Obbligatorio.

Se selezionata, l'integrazione convalida il certificato SSL durante la connessione al server Akeyless.

Abilitato per impostazione predefinita.
Environment Name

Obbligatorio.

L'ambiente Google SecOps in cui sono configurati i connettori, i job e le istanze di integrazione di destinazione.

Il valore predefinito è Default Environment.
Credential Mapping

Obbligatorio.

Un dizionario JSON o YAML che mappa le istanze di integrazione, i connettori e i job di destinazione ai secret Akeyless contenenti i valori dei parametri.

Includi almeno un parametro mappato nelle chiavi integration_instances, connectors o jobs.

Per un esempio, vedi Esempio Credential Mapping.

Il valore predefinito è {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

Esempio Credential Mapping

L'esempio seguente mostra come mappare i parametri per istanze di integrazione, connettori e job nel parametro 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"
    }
  }
}

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.