Langsung ke konten utama
POST
/
security-groups
Membuat grup keamanan
curl --request POST \
  --url https://api.altostrat.io/security-groups \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Server Aplikasi Web",
  "description": "Mengizinkan HTTP/S dari seluruh dunia dan SSH dari kantor.",
  "rules": [
    {
      "direction": "inbound",
      "order": 10,
      "protocol": 6,
      "port": "443",
      "address": "0.0.0.0/0",
      "description": "Izinkan HTTPS"
    },
    {
      "direction": "inbound",
      "order": 20,
      "protocol": 6,
      "port": "80",
      "address": "0.0.0.0/0",
      "description": "Izinkan HTTP"
    },
    {
      "direction": "inbound",
      "order": 30,
      "protocol": 6,
      "port": "22",
      "address": "prfx_lst_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "description": "Izinkan SSH dari Kantor"
    }
  ],
  "sites": [
    "site_0ujsswThIGTUYm2K8FjOOfxcYpw",
    "site_0ujsswThIGTUYm2K8FjOOfxcYpz"
  ]
}'
{
  "id": "sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw",
  "name": "Server Web Default",
  "description": "Mengizinkan lalu lintas masuk HTTP/HTTPS dari mana saja.",
  "status": "active",
  "sites": [
    "site_12345"
  ],
  "rules": [
    {
      "id": "fltr_0ujsswThIGTUYm2K8FjOOfxcYpw",
      "direction": "inbound",
      "order": 10,
      "protocol": 6,
      "port": "443",
      "address": "0.0.0.0/0",
      "description": "Izinkan lalu lintas HTTPS masuk"
    }
  ]
}

Authorizations

โ€‹
Authorization
string
header
required

Autentikasi dilakukan melalui JSON Web Token (JWT) yang dikeluarkan oleh Auth0. Sediakan token di header Authorization dengan skema Bearer.

Body

application/json

Detail dari grup keamanan yang baru.

Mendefinisikan properti yang dapat ditulis untuk membuat atau memperbarui grup keamanan.

โ€‹
name
string
required

Nama yang dapat dibaca manusia untuk grup keamanan.

Required string length: 3 - 255
Example:

"Firewall Aplikasi Web"

โ€‹
rules
object[]
required

Daftar aturan firewall. Urutan aturan ditentukan oleh properti order dalam setiap objek aturan. Seluruh daftar aturan diganti saat pembaruan.

Maximum length: 250
โ€‹
sites
string[]
required

Daftar ID situs di mana grup keamanan ini harus diterapkan. Seluruh daftar situs diganti saat pembaruan.

โ€‹
description
string | null

Deskripsi opsional untuk grup keamanan.

Maximum length: 1024
Example:

"Mengizinkan HTTP/S masuk dan memblokir vektor serangan umum."

Response

Grup keamanan berhasil dibuat.

Mewakili sebuah kontainer untuk set aturan firewall stateful.

โ€‹
id
string

Pengidentifikasi unik untuk grup keamanan, diawali dengan sec_grp_.

Example:

"sec_grp_0ujsswThIGTUYm2K8FjOOfxcYpw"

โ€‹
name
string

Nama yang dapat dibaca manusia untuk grup keamanan.

Example:

"Server Web Default"

โ€‹
description
string

Deskripsi opsional untuk grup keamanan, memberikan konteks lebih lanjut.

Example:

"Mengizinkan lalu lintas masuk HTTP/HTTPS dari mana saja."

โ€‹
status
enum<string>

Status sinkronisasi saat ini dari grup keamanan. syncing berarti perubahan sedang diterapkan dan sumber daya dikunci dari modifikasi.

Opsi yang tersedia:
active,
syncing,
failed
Example:

"active"

โ€‹
sites
string[]

Daftar ID situs di mana grup keamanan ini saat ini diterapkan.

โ€‹
rules
object[]

Daftar aturan firewall yang terurut yang mendefinisikan kebijakan keamanan.