Usar el simulador de guías
El simulador de guías ofrece un enfoque optimizado para desarrollar guías con menos tiempo y esfuerzo.
El simulador de guías ofrece varias funciones clave que te permiten hacer lo siguiente:
- Trabajar en un entorno de preproducción, lo que te permite probar acciones y observar resultados sin que afecten a los datos de producción activos (sobre todo cuando el manual está desactivado).
- Facilita la prueba de cada paso o bloque del manual de procedimientos para confirmar que el flujo de trabajo funciona correctamente.
- Prueba todas las ramas de condiciones posibles de tu cuaderno de estrategias para confirmar que la cobertura es completa y que el comportamiento es predecible.
Usar el simulador de guías con tu guía
Cuando trabajes con guías, tanto si usas una que ya tengas como si creas una nueva, empieza siempre activando el simulador de guías. Verás un indicador verde en la parte superior que confirma que está activo.
Si usas el simulador de guías en una guía activa, afectará a todas las alertas entrantes que activen esa guía. Esto se debe a que, al guardar una guía con datos simulados, esos datos se aplican a los casos activos en producción, lo que puede afectar a los resultados reales.
- Coloca el puntero sobre una alerta de caso, haz clic en more_vert Opciones de alerta y selecciona Ingerir alerta como caso de prueba. Esta acción crea un caso de prueba para ejecutar el cuaderno de estrategias simulado. Las entidades modificadas en los casos de prueba no influyen en las entidades de los casos normales.
- Coloca el puntero en la parte inferior de la página Guías y selecciona un caso de prueba. Asegúrate de que el caso de prueba seleccionado coincida con el manual que quieres ejecutar. Para confirmarlo, haz clic en Entidades y comprueba que la guía pueda procesar las entidades presentes en ese caso de prueba.
- Haz clic en Ejecutar. El simulador procesa los pasos, ejecuta las acciones definidas y proporciona los resultados.
Interpretar los resultados del simulador de cada paso
Después de hacer clic en Ejecutar, la primera fila de la consola se muestra como si fuera un manual de estrategias activo. En cada paso simulado se ofrecen opciones, que suelen incluir Datos del caso, Ver resultados y Fijar resultados (o Insertar resultados). Los pasos manuales muestran un botón para introducir parámetros, proporcionar respuestas y ejecutar el paso.
Datos del caso
El icono Datos del caso abre un cuadro de diálogo para mostrar la información del caso en esa fase concreta, después de que se haya completado la acción actual. Este cuadro de diálogo se actualiza dinámicamente con los resultados del paso actual. Si una acción ha añadido información adicional al caso, se reflejará aquí. Como muestra el estado del caso después de la ejecución de un paso, los datos varían en cada paso de la consola de simulación. Inspeccionar los datos del caso en los diferentes pasos te ayuda a comprender los cambios que se han aplicado al caso durante la ejecución del cuaderno de estrategias. En las distintas pestañas del cuadro de diálogo se ofrece información adicional.
Ver resultados
La opción Ver resultados muestra los resultados de la acción específica del paso actual. La información que se muestra es similar a la de un resumen o un muro de casos, y también incluye detalles sobre los enriquecimientos.
Puedes acceder a los siguientes tipos de información:
- En la pestaña principal se muestran el mensaje de salida, las tablas, los enlaces y los archivos adjuntos.
- En la pestaña Detalles técnicos se muestra el resultado de la acción y el resultado en JSON (si está disponible).
Al igual que con otras opciones, puedes hacer clic en los datos para analizarlos en profundidad. En la página Ver resultados, también puede hacer clic en Definir resultado JSON. Esta función te permite sustituir el ejemplo de JSON de la acción actual. Puede modificar este ejemplo de JSON directamente desde el entorno de desarrollo integrado (IDE) y, a continuación, usarlo en el creador de expresiones para extraer datos específicos del resultado JSON.
Fijar resultados
La opción Fijar resultados está disponible cuando un paso se ejecuta correctamente. Se trata de una función muy útil que te permite tratar el resultado de una acción como fijo.
Fijar resultados puede ahorrarte tiempo de las siguientes formas:
- Elimina la necesidad de esperar los resultados de servicios de terceros.
- Reducir el número de consultas realizadas a estos servicios, lo que ayuda a conservar las credenciales.
Básicamente, cuando vuelves a ejecutar el playbook, se "salta" cualquier paso con resultados fijados: su código no se vuelve a ejecutar y los resultados fijados se usan tal cual. También puedes modificar este resultado insertando tus propios datos de prueba. Cuando habilitas Fijar resultados, la acción entra en el modo de simulación y la representación visual del paso suele cambiar de un fondo azul a uno gris, lo que indica claramente que el modo Simular está activo en ese paso.
Insertar resultados
La opción Insertar resultados estará disponible si se produce un error en un paso. Esta función te permite insertar datos de simulación manualmente. La próxima vez que ejecutes este paso concreto, devolverá los datos que hayas proporcionado manualmente como resultado.
Cuando hagas clic en esta opción, la acción tendrá automáticamente habilitado el modo Simular. La representación visual del paso cambia de un fondo azul a uno gris, lo que indica claramente que el modo Simular está activo. El campo Script Result (Resultado de la secuencia de comandos) es obligatorio en todos los pasos cuando se está en el modo Simulate (Simular).
Insertar datos simulados
Para insertar datos simulados, puedes tener en cuenta los siguientes casos prácticos:
- Crear y probar tu guía de estrategias sobre la marcha: puedes ejecutar un paso, ver los resultados y saber de inmediato cómo puedes usar esos datos más adelante en tu guía.
- Ahorrar tiempo después de una ejecución correcta: puede que quieras fijar los resultados del paso. De esta forma, ahorrarás tiempo, ya que se evita que el paso se ejecute repetidamente en APIs de terceros durante las pruebas posteriores.
- Probar diferentes situaciones: puedes cambiar los resultados de los pasos para probar tu cuaderno de estrategias en diferentes condiciones. Si defines datos de simulación diferentes, puedes influir en las condiciones y acciones posteriores que dependan de los resultados anteriores. Por ejemplo, si tu cuaderno de estrategias tiene una condición que se ramifica en dos o más rutas, puedes experimentar con datos de simulación para "forzar" que el cuaderno de estrategias tome una rama específica.
Insertar datos de simulación
Puedes insertar datos de simulación (ficticios) en tu manual de procedimientos de dos formas principales: a través del cuadro de diálogo de configuración del paso del manual de procedimientos o mediante la opción Fijar resultados (o Insertar resultados) después de ejecutar un simulador.
Usar el cuadro de diálogo de configuración de pasos de Playbook
- Haz clic en el cuadro de diálogo de configuración del paso de tu guía.
- Activa el interruptor Simular modo para habilitarlo. La representación visual de la acción cambia a gris, lo que indica que está en el modo Simulación.
- En la sección Resultados de la acción, puedes insertar los datos de simulación. Entre los datos que recoge se incluyen los siguientes:
- Resultado de la secuencia de comandos: proporciona un resultado simulado para las acciones basadas en secuencias de comandos.
- Resultado JSON: introduce datos JSON, posiblemente extrayendo datos específicos de código JSON. También puedes cargar un resultado de ejemplo haciendo clic en Cargar ejemplo. De esta forma, se carga el resultado JSON esperado de la acción, lo que es especialmente útil si:
- La simulación aún no se ha ejecutado y la salida está vacía.
- No se ha podido hacer la simulación y no se muestran resultados.
- Quieres sustituir los resultados (de fijaciones o inserciones anteriores) por la muestra.
- Enriquecimientos: puedes usar enriquecimientos de simulaciones anteriores o crear tus propias claves de enriquecimiento personalizadas.
Usar los resultados después de ejecutar un simulador
Fijar resultados
Si un paso se ejecuta correctamente, puedes hacer clic en Fijar resultados junto a esa acción. Esto es lo que ocurre a continuación:
- El paso se abre automáticamente en el modo Simular. .
- Los resultados de la última simulación correcta se fijan al paso. Puedes usar estos resultados o editarlos.
- Puedes editar el resultado JSON con el editor JSON o hacer clic en Cargar muestra para sobrescribirlo.
- Puedes usar los enriquecimientos de simulaciones anteriores o crear claves de enriquecimiento personalizadas.
Insertar resultados
Si un paso ha fallado, puedes hacer clic en Insertar resultados junto a esa acción. Esto es lo que ocurre a continuación:
- Estos datos se devolverán cada vez que se ejecute el paso.
Desactivar el simulador de guías
Si desactivas el simulador de guías, se oculta la consola inferior y cualquier paso del modo Simulación vuelve al modo "en directo" normal. La excepción son los bloques de guías: debes desactivar el simulador de bloques para cerrar su modo de simulación. Los datos de simulación (falsos) que insertes se guardarán para que puedas usarlos la próxima vez que actives el simulador.
Trabajar con bloques de guiones
También puedes usar el simulador de guías para crear y probar un nuevo bloque de guía. Cuando un bloque está en modo de simulación, todas las guías principales que lo usen también usarán los datos simulados del bloque.
¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.