Saltar al contenido principal
GET
/
security-groups
Listar grupos de seguridad
curl --request GET \
  --url https://api.altostrat.io/security-groups \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw",
    "name": "Servidores Web Predeterminados",
    "description": "Permite tráfico entrante HTTP/HTTPS desde cualquier lugar.",
    "status": "active",
    "sites": [],
    "rules": []
  },
  {
    "id": "sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpz",
    "name": "Gestión Interna",
    "description": "Permite SSH y RDP desde la lista de prefijos de la oficina principal.",
    "status": "syncing",
    "sites": [],
    "rules": []
  }
]

Authorizations

​
Authorization
string
header
required

La autenticación se realiza mediante un JSON Web Token (JWT) emitido por Auth0. Proporcione el token en la cabecera Authorization con el esquema Bearer.

Response

Una lista de grupos de seguridad.

​
id
string

El identificador único para el grupo de seguridad, con el prefijo sec_grp_.

Example:

"sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw"

​
name
string

Un nombre legible por humanos para el grupo de seguridad.

Example:

"Servidores Web Predeterminados"

​
description
string

Una descripción opcional para el grupo de seguridad, que proporciona más contexto.

Example:

"Permite tráfico entrante HTTP/HTTPS desde cualquier lugar."

​
status
enum<string>

El estado de sincronización actual del grupo de seguridad. syncing significa que se están desplegando cambios y el recurso está bloqueado para su modificación.

Opciones disponibles:
active,
syncing,
failed
Example:

"active"

​
sites
string[]

Una lista de los IDs de sitios a los que este grupo de seguridad está aplicado actualmente.

​
rules
object[]

Una lista ordenada de reglas de firewall que definen la política de seguridad.