Módulo smp_io

TIPCommon.smp_io.read_and_repair_existing_ids

TIPCommon.smp_io.read_and_repair_existing_ids(siemplify: SiemplifyAction | SiemplifyConnectorExecution | SiemplifyJob, default_value_to_return: dict = None, identifier: str = None, ids_file_name: str = 'ids.json', db_key: str = 'ids')→ list

Lee los IDs de alerta que ya existen y los convierte en una lista si son un diccionario. Esto es necesario para evitar regresiones.

Parámetros

Parámetros
siemplify SiemplifyAction | SiemplifyConnectorExecution | SiemplifyJob

Una instancia del SDK de Google Security Operations SOAR.

default_value_to_return dict | list | string

Valor predeterminado que se asignará cuando se cree un archivo o una clave. Si no se indica ningún valor, se asignará el valor predeterminado interno [] (list).

identifier str

Atributo de identificador del conector.

ids_file_name str

El nombre del archivo en el que se deben guardar los IDs cuando se haya creado un objeto FileStream.

db_key str

Nombre de la clave en la que se deben guardar los IDs cuando se haya creado un objeto FileStream.

Devoluciones

Lista de IDs del objeto DataStream.

Tipo de devolución

list

TIPCommon.smp_io.read_content

TIPCommon.smp_io.read_content(siemplify, file_name, db_key, default_value_to_return=None, identifier=None)

Leer el contenido de un objeto ConnectorStream. Si el objeto no contiene datos o no existe, devuelve un valor predeterminado.

Parámetros
siemplify obj

Una instancia de la clase SiemplifyConnectorExecution del SDK.

file_name str

Nombre del archivo que se va a validar (cuando la plataforma usa archivos).

db_key str

Nombre de la clave que se va a validar (cuando la plataforma usa una base de datos).

default_value_to_return dict/list/str

Valor predeterminado definido cuando se crean un archivo y una clave. Si no se proporciona ningún valor, se asigna el valor predeterminado interno {} (dict).

identifier str

Atributo de identificador del conector.

Devoluciones

(dict) El contenido del objeto DataStream. El contenido pasa por json.loads antes de volver.

TIPCommon.smp_io.read_ids

TIPCommon.smp_io.read_ids(siemplify, default_value_to_return=None, identifier=None, ids_file_name='ids.json', db_key='ids')

Lee los IDs de un objeto ConnectorStream. Si el objeto no contiene datos o no existe, devuelve un valor predeterminado.

Parámetros
siemplify obj

Una instancia de la clase SiemplifyConnectorExecution del SDK.

ids_file_name sttr

Nombre del archivo en el que se deben guardar los IDs cuando se haya creado un objeto FileStream.

db_key str

Nombre de la clave en la que se deben guardar los IDs cuando se haya creado un objeto FileStream.

default_value_to_return dict/list/str

El valor predeterminado que se asignará en caso de que se creen un archivo y una clave. Si no se proporciona ningún valor, se asigna el valor predeterminado interno [] (list) como nuevo valor predeterminado.

identifier str

Atributo de identificador del conector.

Devoluciones

(list) Una lista de IDs dentro del objeto DataStream. El contenido pasa por json.loads antes de volver.

TIPCommon.smp_io.read_ids_by_timestamp

TIPCommon.smp_io.read_ids_by_timestamp(siemplify, offset_in_hours=72, default_value_to_return=None, convert_to_milliseconds=False, cast_keys_to_integers=False, offset_is_in_days=False, identifier=None, ids_file_name='ids.json', db_key='ids')

Lee los IDs de un objeto ConnectorStream. Si el objeto no contiene datos o no existe, devuelve un valor predeterminado.

Parámetros
siemplify obj

Una instancia de la clase SiemplifyConnectorExecution del SDK.

offset_in_hours int

El límite de tiempo (valor de desplazamiento) del ID en horas.

convert_to_milliseconds bool

Transforma la marca de tiempo (Unix) de cada ID de segundos a milisegundos.

cast_keys_to_integers bool

Convierte las claves en números enteros.

offset_is_in_days bool

Si el desfase proporcionado a este método está en días, asigna el valor True al parámetro para convertir los días de desfase en horas.

ids_file_name str

Nombre del archivo en el que se deben guardar los IDs cuando se haya creado un objeto FileStream.

db_key str

Nombre de la clave en la que se deben guardar los IDs cuando se haya creado un objeto FileStream.

default_value_to_return dict/list/str

El valor predeterminado que se asignará en caso de que se creen un archivo y una clave.

identifier str

Atributo de identificador del conector.

Devoluciones

(list) Una lista de IDs dentro del objeto DataStream. El contenido pasa por json.loads antes de volver.

TIPCommon.smp_io.write_content

TIPCommon.smp_io.write_content(siemplify, content_to_write, file_name, db_key, default_value_to_set=None, identifier=None)

Escribe contenido en un objeto ConnectorStream.

Parámetros
siemplify obj

Una instancia de la clase SiemplifyConnectorExecution del SDK.

content_to_write dict/list/str

El contenido que se va a escribir en el flujo de datos dedicado.

file_name str

El nombre del archivo.

db_key str

Nombre de la clave.

default_value_to_set dict/list/str

Valor predeterminado definido cuando se crean un archivo y una clave.

identifier str

Atributo de identificador del conector.

Devoluciones

Ninguno

TIPCommon.smp_io.write_ids

TIPCommon.smp_io.write_ids(siemplify, ids, default_value_to_set=None, stored_ids_limit=1000, identifier=None, ids_file_name='ids.json', db_key='ids')

Escribe los últimos 1000 IDs en un objeto ConnectorStream.

Parámetros
siemplify obj

Una instancia de la clase SiemplifyConnectorExecution del SDK.

ids list/str

Los IDs que se escribirán en el flujo de datos específico.

stored_ids_limit int

Número de IDs recientes de los IDs existentes que se escribirán.

ids_file_name str

Nombre del archivo en el que se deben guardar los IDs cuando se haya creado un objeto FileStream.

db_key str

Nombre de la clave en la que se deben guardar los IDs cuando se haya creado un objeto FileStream.

default_value_to_set dict/list/str

Valor predeterminado definido cuando se crean un archivo y una clave.

identifier str

Atributo de identificador del conector.

Devoluciones

Ninguno

TIPCommon.smp_io.write_ids_with_timestamp

TIPCommon.smp_io.write_ids_with_timestamp(siemplify, ids, default_value_to_set=None, identifier=None, ids_file_name='ids.json', db_key='ids')

Escribe IDs en un objeto ConnectorStream con una marca de tiempo.

Parámetros
siemplify obj

Una instancia de la clase SiemplifyConnectorExecution del SDK.

ids list/str

Los IDs que se escribirán en el flujo de datos específico.

ids_file_name str

Nombre del archivo en el que se deben guardar los IDs cuando se haya creado un objeto FileStream.

db_key str

Nombre de la clave en la que se deben guardar los IDs cuando se haya creado un objeto FileStream.

default_value_to_set dict/list/str

El valor predeterminado que se asignará en caso de que se creen un archivo y una clave.

identifier str

Atributo de identificador del conector.

Devoluciones

Ninguno

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.