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:
- Analizza il file del certificato CA in una stringa Base64.
- Apri la pagina dei parametri di configurazione dell'integrazione.
- Inserisci la stringa nel campo CA Certificate File (File certificato CA).
- 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
- IP o HOST - Report mail_sender_ip_hostname_detail e mail_incoming_ip_hostname_detail
- USER - Report mail_users_detail
- 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.