Vai al contenuto principale
GET
/
security-groups
/
{securityGroupId}
Recupera un gruppo di sicurezza
curl --request GET \
  --url https://api.altostrat.io/security-groups/{securityGroupId} \
  --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": [
    "site_12345"
  ],
  "rules": [
    {
      "id": "fltr_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "direction": "inbound",
      "order": 10,
      "protocol": 6,
      "port": "443",
      "address": "0.0.0.0/0",
      "description": "Consenti traffico HTTPS in entrata"
    }
  ]
}

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.

Path Parameters

​
securityGroupId
string
required

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

Example:

"sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw"

Response

L'oggetto del gruppo di sicurezza richiesto.

Rappresenta un contenitore per un ruleset firewall stateful.

​
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.