Vai al contenuto principale
GET
/
security-groups
Elenca gruppi di sicurezza
curl --request GET \
  --url https://api.altostrat.io/security-groups \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw",
    "name": "Server Web Predefiniti",
    "description": "Consente traffico HTTP/HTTPS in entrata da qualsiasi origine.",
    "status": "active",
    "sites": [],
    "rules": []
  },
  {
    "id": "sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpz",
    "name": "Gestione Interna",
    "description": "Consente SSH e RDP dalla lista di prefissi dell'ufficio principale.",
    "status": "syncing",
    "sites": [],
    "rules": []
  }
]

Authorizations

​
Authorization
string
header
required

L'autenticazione viene eseguita tramite un JSON Web Token (JWT) emesso da Auth0. Fornire il token nell'header Authorization con lo schema Bearer.

Response

Un elenco di gruppi di sicurezza.

​
id
string

L'identificatore univoco per il gruppo di sicurezza, con prefisso sec_grp_.

Example:

"sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw"

​
name
string

Un nome leggibile per il gruppo di sicurezza.

Example:

"Server Web Predefiniti"

​
description
string

Una descrizione opzionale per il gruppo di sicurezza, che fornisce maggior contesto.

Example:

"Consente traffico HTTP/HTTPS in entrata da qualsiasi origine."

​
status
enum<string>

Lo stato di sincronizzazione attuale del gruppo di sicurezza. syncing significa che le modifiche sono in fase di applicazione e la risorsa è bloccata da modifiche.

Opzioni disponibili:
active,
syncing,
failed
Example:

"active"

​
sites
string[]

Un elenco di ID di siti a cui questo gruppo di sicurezza è attualmente applicato.

​
rules
object[]

Un elenco ordinato di regole firewall che definiscono la policy di sicurezza.