IronPort

Questo documento fornisce indicazioni su come integrare IronPort con Google SecOps.

Autorizzazione del prodotto

L'API AsyncOS è un sistema basato sui ruoli. L'ambito delle query API è definito dal ruolo dell'utente. Gli utenti dell'appliance Cisco Content Security Management con i seguenti ruoli possono accedere all'API AsyncOS:

  • Amministratore
  • Operatore
  • Technician
  • Operatore di sola lettura
  • Ospite
  • Amministratore web
  • Web Policy Administrator
  • URL Filtering Administrator
  • Email Administrator
  • Utente Help Desk

Configura l'integrazione di IronPort in Google SecOps

Configura l'integrazione di IronPort con un certificato CA

Se necessario, puoi verificare la connessione con un file del certificato CA.

Prima di iniziare, assicurati di avere quanto segue:

  • Il file del certificato CA
  • L'ultima versione dell'integrazione di IronPort

Per configurare l'integrazione con un certificato CA, completa i seguenti passaggi:

  1. Analizza il file del certificato CA in una stringa Base64.
  2. Apri la pagina dei parametri di configurazione dell'integrazione.
  3. Inserisci la stringa nel campo CA Certificate File (File certificato CA).
  4. Per verificare che l'integrazione sia configurata correttamente, seleziona la casella di controllo Verifica SSL e fai clic su Test.

Configura l'integrazione di IronPort in Google SecOps

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

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Nome istanza Stringa N/D No Nome dell'istanza per cui intendi configurare l'integrazione.
Descrizione Stringa N/D No Descrizione dell'istanza.
Indirizzo server IronPort Stringa x.x.x.x Sì Indirizzo del server IronPort a cui connettersi.
Porta API IronPort AsyncOS Stringa 6443 Vero Porta dell'API IronPort AsyncOS a cui connettersi.
Porta SSH Ironport Stringa 22 Sì Porta SSH IronPort a cui connettersi.
Nome utente Stringa N/D Sì Account IronPort da utilizzare con l'integrazione.
Passphrase (password) Password N/D Sì Password dell'account.
File del certificato CA: analizzato in una stringa Base64 Stringa N/D No N/D
Use SSL (Usa SSL) Casella di controllo Selezionata No Specifica se utilizzare HTTPS per connetterti all'API AsyncOS.
Verifica SSL Casella di controllo Deselezionata No Specifica se la convalida del certificato deve essere abilitata (verrà verificato se il certificato configurato per l'API AsyncOS è valido).
Esegui da remoto Casella di controllo Deselezionata No Seleziona il campo per eseguire l'integrazione configurata da remoto. Una volta selezionata, viene visualizzata l'opzione per selezionare l'utente remoto (agente).

Azioni

Recupera tutti i destinatari per mittente

Descrizione

Ottieni un elenco di destinatari che hanno ricevuto email da un determinato mittente.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Mittente Stringa N/D Sì L'indirizzo email del mittente in base al quale filtrare.
Cerca email per l'ultimo X Numero intero 7 Sì Specifica un periodo di tempo per la ricerca delle email. Tieni presente che questo valore deve essere impostato in base alla quantità di email elaborate da IronPort. Se il valore fornito è sufficientemente grande, l'azione potrebbe scadere.
Imposta il periodo di ricerca delle email in DDL Giorni Sì Specifica se la ricerca delle email deve essere eseguita in base al periodo di giorni o ore.
Numero massimo di destinatari da restituire Numero intero 20 Sì Specifica il numero di destinatari che l'azione deve restituire.
Dimensioni pagina Numero intero 100 Sì Specifica le dimensioni della pagina che l'azione deve utilizzare durante la ricerca delle email.

Esempi di casi d'uso dei playbook

Cerca i destinatari delle email in base all'indirizzo email del mittente fornito nell'azione.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
risultati N/D N/D
Risultato JSON
​{
    "attributes": {
        "direction": "",
        "hostName": "",
        "senderGroup": "N/A",
        "sender": "reporting@smtp.inside-ironport.local",
        "replyTo": "N/A",
        "timestamp": "20 May 2020 01:00:04 (GMT +00:00)",
        "serialNumber": "42225C72BFBA18A2257D-C143F31DFB78",
        "mid": [
            229
        ],
        "senderIp": "N/A",
        "icid": 0,
        "messageStatus": {
            "229": "Delivered"
        },
        "mailPolicy": [],
        "isCompleteData": "N/A",
        "verdictChart": {
            "229": "00000000"
        },
        "senderDomain": "N/A",
        "recipient": [
            "test.user1@inside-ironport.local"
        ],
        "sbrs": "N/A",
        "subject": "IronPort Report: Outgoing Mail Daily Report (smtp.inside-ironport.local)"
    }
}

Recupera tutti i destinatari per oggetto

Descrizione

Ricevi un elenco di destinatari che hanno ricevuto un'email con lo stesso oggetto.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito Is Mandatory Descrizione
Oggetto Stringa N/D Sì L'oggetto in base al quale filtrare.
Cerca email per l'ultimo X Numero intero 7 Sì

Specifica un intervallo di tempo per la ricerca delle email.Tieni presente che questo valore deve essere impostato in base alla quantità di email elaborate da IronPort. Se il valore fornito è sufficientemente grande, l'azione potrebbe scadere.

Imposta il periodo di ricerca delle email in DDL Giorni Sì Specifica se la ricerca delle email deve essere eseguita con un periodo di giorni o ore.
Numero massimo di destinatari da restituire Numero intero 20 Sì Specifica il numero di destinatari che l'azione deve restituire.
Dimensioni pagina Numero intero 100 Sì Specifica le dimensioni della pagina che l'azione deve utilizzare durante la ricerca delle email.

Esempi di casi d'uso dei playbook

Cerca le informazioni sulle email in IronPort quando le email contengono caratteri Unicode nell'oggetto.

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
destinatari N/D N/D
Risultato JSON
{
    "attributes": {
        "direction": "",
        "hostName": "",
        "senderGroup": "N/A",
        "sender": "reporting@smtp.inside-ironport.local",
        "replyTo": "N/A",
        "timestamp": "20 May 2020 01:00:04 (GMT +00:00)",
        "serialNumber": "42225C72BFBA18A2257D-C143F31DFB78",
        "mid": [
            229
        ],
        "senderIp": "N/A",
        "icid": 0,
        "messageStatus": {
            "229": "Delivered"
        },
        "mailPolicy": [],
        "isCompleteData": "N/A",
        "verdictChart": {
            "229": "00000000"
        },
        "senderDomain": "N/A",
        "recipient": [
            "test.user1@inside-ironport.local"
        ],
        "sbrs": "N/A"
}

Scarica report

Descrizione

Recupera informazioni specifiche sui report IronPort.

Parametri

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione

Tipo di report

Elenco a discesa Valore predefinito: nessuno Sì

Il tipo di report da recuperare.

Nota: i report mail_sender_ip_hostname_detail e mail_incoming_ip_hostname_detail funzionano in base alle entità IP o host di Google SecOps; mail_users_detail funziona sull'entità utente di Google SecOps (con indirizzo email). Altri report funzionano senza entità Google SecOps.

Cerca nei dati dei report degli ultimi X giorni Numero intero 7 Sì Specifica un periodo di tempo in giorni per la ricerca dei dati dei report. Per impostazione predefinita, è impostato sugli ultimi 7 giorni.
Numero massimo di record da restituire Numero intero 20 Sì Specifica il numero di record che l'azione deve restituire.

Esempi di casi d'uso dei playbook

Ricevere informazioni sui report dal server IronPort per l'analisi degli avvisi in Google SecOps.

Esegui il

  1. IP o HOST - Report mail_sender_ip_hostname_detail e mail_incoming_ip_hostname_detail
  2. USER - Report mail_users_detail
  3. NONE: altri tipi di report funzionano senza entità Google SecOps.

Risultati dell'azione

Arricchimento delle entità

L'arricchimento delle entità dovrebbe funzionare come nell'azione esistente: se il report ha restituito dati per un'entità Google SecOps specifica, utilizza i dati restituiti per l'arricchimento.

Per riferimento, consulta il codice dell'azione esistente.

Insight

N/D

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
operazione riuscita Vero/Falso success:False
Risultato JSON
{
    "meta": {
        "totalCount": -1
    },
    "data": {
        "type": "mail_sender_ip_hostname_detail",
        "resultSet": {
            "time_intervals": [
                {
                    "end_timestamp": 1590969599.0,
                    "counter_values": [
                        {
                            "counter_values": [
                                0,
                                0,
                                0,
                                0,
                                8,
                                8,
                                0,
                                0
                            ],
                            "ip_domain": "172.30.203.100",
                            "key": "irp-d1-dc01.inside-ironport.local"
                        }
                    ],
                    "begin_timestamp": 1588291200.0,
                    "end_time": "2020-05-31T23:59:00.000Z",
                    "begin_time": "2020-05-01T00:00:00.000Z"
                },
                {
                    "end_timestamp": 1593561599.0,
                    "counter_values": [
                        {
                            "counter_values": [
                                0,
                                0,
                                6,
                                0,
                                5,
                                11,
                                6,
                                0
                            ],
                            "ip_domain": "172.30.203.100",
                            "key": "irp-d1-dc01.inside-ironport.local"
                        }
                    ],
                    "begin_timestamp": 1590969600.0,
                    "end_time": "2020-06-30T23:59:00.000Z",
                    "begin_time": "2020-06-01T00:00:00.000Z"
                }
            ],
            "counter_names": [
                "detected_virus",
                "detected_spam",
                "threat_content_filter",
                "total_dlp_incidents",
                "total_clean_recipients",
                "total_recipients_processed",
                "total_threat_recipients",
                "detected_amp"
            ]
        }
    }
}

Dindin

Descrizione

Testa la connettività al server IronPort con i parametri forniti nella pagina di configurazione dell'integrazione nella pagina Google SecOps Content Hub.

Parametri

N/D

Esegui il

Questa azione non viene eseguita sulle entità.

Risultati dell'azione

Arricchimento delle entità

N/D

Insight

N/D

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
N/A

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