Utilizzare l'IDE

Supportato in:

Google SecOps SOAR

Questo documento spiega la modalità di produzione dell'ambiente di sviluppo integrato (IDE). L'IDE è un framework per la visualizzazione, la modifica e il test del codice. Puoi visualizzare il codice di integrazione delle integrazioni commerciali e creare integrazioni personalizzate da zero o duplicando il codice di integrazione delle integrazioni commerciali.

L'IDE è l'ambiente in cui gestisci, importi ed esporti le integrazioni personalizzate.

Apri l'IDE

Per aprire l'IDE:

• Per aprire l'IDE, nel menu principale, vai a Risposta > IDE. Si apre la pagina IDE.

Nella pagina IDE, puoi accedere alle seguenti opzioni:

Opzione	Descrizione
Integrazioni Tipi	Scegli tra Integrazioni o Tipi (connettori, azioni, job, amministratori).
Esporta Importa	Esportare uno o più elementi da un'integrazione. Gli elementi dipendenti sono inclusi quando esporti singoli elementi, ma non quando esporti un pacchetto completo. Il file esportato è un file ZIP contenente un file JSON. Durante l'importazione, puoi aggiungere singoli elementi a un'integrazione esistente o importare un pacchetto completo. Per il formato di esportazione/importazione legacy (V1 - dataplane disabilitato), il pacchetto deve includere un file integrations.def e le cartelle: ActionsDefinitions, ActionsScripts, Dependencies e Managers. Per il nuovo formato di esportazione/importazione (V2 - dataplane abilitato), la cartella del pacchetto deve includere un file metadata.json e può includere le cartelle: actions, connectors, jobs e dependencies. Tieni presente che l'esportazione di un'integrazione da un ambiente con il dataplane abilitato e l'importazione in un ambiente in cui il dataplane non è abilitato non sono supportate. È supportato il contrario (esportazione da un ambiente in cui il piano dati non è abilitato a un ambiente in cui il piano dati è abilitato).
	Fai clic sul pulsante di attivazione/disattivazione Nascondi non attivi/Mostra tutti per mostrare o nascondere gli elementi disattivati (azioni, connettori).
	Aggiungi una nuova integrazione personalizzata, un nuovo connettore, una nuova azione, un nuovo job o un nuovo gestore.

Aggiungi un connettore

Per aggiungere un connettore:

1. Fai clic su Crea nuovo elemento e seleziona Connettore.
2. Inserisci un nome e l'integrazione richiesta.
3. Fai clic su Crea.
4. Aggiungi i dettagli dell'integrazione.
5. Aggiungi i parametri richiesti.
6. Fai clic sul pulsante di attivazione/disattivazione Connettore per attivare il connettore.
7. Al termine, fai clic su Salva o premi Ctrl + S.

Nella scheda Dettagli sono disponibili le seguenti opzioni:

Opzione	Descrizione
Elimina	Disponibile solo per gli elementi delle integrazioni personalizzate.
Play	Esegue il metodo di test dello script. I risultati vengono visualizzati nella scheda Test e l'output di debug viene visualizzato nella sezione Output di debug.
file_json Gestisci esempio JSON	Nella finestra di dialogo di importazione/esportazione dell'esempio JSON, assicurati che l'opzione Includi risultato JSON sia attivata. Puoi quindi importare o esportare esempi di risultati JSON per le azioni.
Dettagli	Inserisci l'input fornito dall'utente e altri parametri, ad esempio il nome dell'integrazione.
Controllo della versione	Controllo delle versioni - Seleziona un'azione/un job/un connettore e fai clic per visualizzare le seguenti opzioni: Salva come nuova versione: salva l'oggetto come nuova versione con commenti facoltativi. Visualizza cronologia delle versioni: visualizza e ripristina le versioni precedenti. Disponibile solo se è stata salvata almeno una versione. Fai clic su Ripristina per tornare a una delle versioni precedenti in qualsiasi momento. Questa opzione è disponibile solo se in precedenza hai fatto clic su Salva come nuova versione per un'azione, un job, un connettore o un gestore.
Duplica elemento	Duplicare un elemento (job, azione, connettore, gestore). Dopo il salvataggio, il duplicato viene visualizzato nell'elenco senza l'icona lucchetto .

Crea un'integrazione personalizzata

1. Fai clic su Crea nuovo elemento e seleziona Integrazione.
2. Inserisci un nome e fai clic su Crea.
3. Seleziona l'integrazione creata dall'elenco e fornisci le seguenti informazioni:
   • Descrizione: viene visualizzata in Content Hub ed è visibile a tutti gli utenti di Google Security Operations.
   • Icona SVG: carica un'icona SVG che viene visualizzata con l'integrazione.
   • Immagine: carica un'immagine di Content Hub per gli utenti di Google SecOps.
   • Librerie: aggiungi librerie Python utilizzando pip.
   • Dipendenze degli script: carica file ".WHL", ".PY", ".TAR" o ".GZ". Questi script aggiungono ulteriori funzionalità alla tua integrazione.
   • Parametro: aggiungi campi configurabili con tipi definiti, valori predefiniti e stato obbligatorio.
4. Al termine, fai clic su Salva.

Nota: puoi aggiungere job, azioni, gestori e connettori alla tua integrazione personalizzata e utilizzarli per inviare o raccogliere informazioni in base alle tue esigenze. Ti basta creare una nuova azione e scegliere l'integrazione personalizzata. Una best practice consiste nel creare un'azione **Ping** per testare l'integrazione nell'hub dei contenuti.

Crea un job

Per creare un job, segui questi passaggi:

1. Fai clic su Crea nuovo elemento e seleziona Job.
2. Inserisci un nome e l'integrazione richiesta.
3. Fai clic su Crea.
4. (Facoltativo) Aggiungi parametri per l'input dell'utente o dello script.
5. Fai clic su Salva o premi Ctrl + S.
6. Fai clic su arrow_right Esegui elemento per eseguire lo script.
7. Vai a Risposta > Pianificatore lavori.
8. Fai clic su Aggiungi Crea nuovo job e seleziona il job che hai appena creato.
9. In Risposta >Utilità di pianificazione dei job, scegli l'ora richiesta per eseguire il job (script) che hai creato.

Crea una nuova azione da utilizzare in un playbook

Per creare una nuova azione per un playbook:

1. Fai clic su Crea nuovo elemento e seleziona Azione.
2. Inserisci un nome e l'integrazione richiesta > fai clic su Crea.
3. Modifica il codice in base alle esigenze.
4. Attiva Includi risultato JSON se l'azione deve restituire un risultato JSON in un playbook.
5. (Facoltativo) Aggiungi parametri da visualizzare come campi di immissione.
6. Attiva l'azione e fai clic su Salva.
7. In Configurazione polling, puoi impostare un timeout e un valore di ritorno predefinito se l'azione va in timeout. Puoi anche impostare un valore predefinito da restituire se l'azione non viene completata entro il periodo di timeout definito.

L'azione è ora disponibile per l'utilizzo in Playbook > Azioni.

Creare un gestore personalizzato

Per creare un gestore personalizzato:

1. Fai clic su Crea nuovo elemento e seleziona Amministratore. Inserisci un nome e l'integrazione richiesta.
2. Fai clic su Crea.
3. Modifica il codice in base alle esigenze.
4. Fai clic su Salva.

Sicurezza del codice personalizzato dell'IDE

Per garantire un ambiente di esecuzione di codice sicuro, tutto il codice Python personalizzato all'interno dell'IDE viene eseguito in un ambiente sandbox. Questo ambiente è isolato dal server principale e opera con un utente con privilegi limitati. L'accesso al sistema operativo sottostante è strettamente limitato a una lista consentita di comandi e directory non amministrativi necessari per le tipiche attività di integrazione e automazione. Questo approccio di sandboxing consente una sicurezza solida, offrendo al contempo la flessibilità di eseguire un'ampia gamma di codice Python.

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