API REST HTTP

Versión de integración: 10.0

Configurar la integración de la API REST HTTP en Google Security Operations

Para obtener instrucciones detalladas sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Acciones

Obtener datos

Descripción

Envía una solicitud HTTP y recibe una respuesta.

Parámetros

Parámetros Tipo Valor predeterminado Es obligatorio Descripción
URL Cadena N/A Sí La URL a la que se enviará la solicitud.
Nombre de usuario Cadena N/A No N/A
Contraseña Cadena N/A No N/A
Verificación SSL Casilla Desmarcada No Indica si se debe verificar el certificado SSL del servidor de destino.
JSON de encabezados Cadena N/A No Un objeto JSON de los encabezados HTTP que se enviarán con la solicitud.
Ignorar códigos de error HTTP Casilla Desmarcada No Si está habilitada, la acción debe ignorar los códigos de error HTTP 4xx o 5xx y no devolver ningún error.

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en la entidad URL.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
response_data N/A N/A
Resultado de JSON
{
  "redirects": [
    "http://blank.org/"
  ],
  "response_code": 200,
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

Obtener datos de URL

Descripción

Envía solicitudes HTTP GET a entidades de URL.

Parámetros

Parámetros Tipo Valor predeterminado Es obligatorio Descripción
Nombre de usuario Cadena N/A No Nombre de usuario para la autenticación básica. Opcional.
Contraseña Cadena N/A No Contraseña para la autenticación básica. Opcional.
Verificación SSL Casilla N/A No Indica si se debe verificar el certificado SSL del servidor de destino.

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en la entidad URL.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero/Falso is_success:False
Resultado de JSON
[
    {
        "EntityResult": {
            "redirects": ["http://blank.org/"],
            "data": "<html>\\n\\n<head>\\n<title>\\nblank\\n</title>\\n</head>\\n\\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<center>\\n<a style=\\\"text-decoration:none\\\" href=\\\"blank.html\\\">.</a>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n<br>\\n</center>\\n</body>\\n</html>\\n"
        },
        "Entity": "http://blank.org/"
    }
]

Ping

Descripción

Prueba de conectividad.

Parámetros

N/A

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_succeed Verdadero/Falso is_succeed:False
Resultado de JSON
N/A

Datos de POST

Descripción

Envía solicitudes HTTP y POST.

Parámetros

Parámetro Tipo Valor predeterminado Descripción
URL Cadena N/A Sí La URL a la que se enviará la solicitud.
Datos Cadena N/A Sí Los datos que se enviarán con la solicitud.
Nombre de usuario Cadena N/A No N/A
Contraseña Cadena N/A No N/A
Verificación SSL Casilla N/A Desmarcada Indica si se debe verificar el certificado SSL del servidor de destino.
JSON de encabezados Cadena N/A No Un objeto JSON de los encabezados HTTP que se enviarán con la solicitud.
Tipo de contenido Cadena N/A No Tipo de contenido. Si se define como application o JSON, los datos de entrada deben ser una cadena JSON.

Casos prácticos

N/A

Fecha de ejecución

Esta acción se ejecuta en todas las entidades.

Resultados de la acción

Enriquecimiento de entidades

N/A

Estadísticas

N/A

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
response_data N/A N/A
Resultado de JSON
{
  "redirects": [
    "http://blank.org/"
  ],
  "data": "<html>\n\n<head>\n<title>\nblank\n</title>\n</head>\n\n<body bgcolor=#ffffff text=#2222ff link=#ff0000 vlink=#880000 alink=#00ff00>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<center>\n<a style=\"text-decoration:none\" href=\"blank.html\">.</a>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n<br>\n</center>\n</body>\n</html>\n"
}

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