Перейти до вмісту
NimbusNexus

Групи безпеки

Групи безпеки — це набори правил фаєрвола з відстеженням стану. Ви підʼєднуєте одну або кілька груп до мережевого інтерфейсу VM; застосовується обʼєднання правил усіх груп. Поведінка за замовчуванням: заборонити весь вхідний трафік, дозволити весь вихідний — явний список дозволеного для вхідного трафіку, а вихідний відкритий, доки ви не вирішите інакше.

Що означає «з відстеженням стану»

Ви пишете правила лише для напрямку, у якому ініціюється зʼєднання. Якщо ви дозволили вхідний TCP на порт 443, пакети відповіді клієнту дозволяються автоматично — окреме правило для вихідного зворотного трафіку не потрібне.

Порівняйте з ACL без відстеження стану (напр., AWS Network ACLs), де потрібні симетричні правила в обох напрямках. З групами безпеки простіше міркувати про фаєрвол на рівні застосунку; з ACL без відстеження стану простіше міркувати про політики мережі тенанта на рівні нижче VM.

Будова правила

Кожне правило має:

  • Напрямок — ingress або egress
  • EtherType — ether: IPv4 або IPv6
  • Протокол — any, назва, як-от tcp, udp, icmp, ipv6-icmp чи sctp, або custom з номером протоколу (0–255) у protocol_custom
  • Діапазон портів — port_min і port_max, кожен 0–65535. Для одного порту (80) задайте лише port_min, для діапазону (від 8000 до 9000) — обидва, а для будь-якого порту — жодного
  • Джерело / призначення — CIDR-блок у remote_cidr (0.0.0.0/0, 10.0.0.0/8), інша група безпеки в remote_sec_grp або група адрес в remote_addr_grp

Найважливіше знати про режим «джерело — інша група безпеки». Правило на кшталт «дозволити порт 5432 з web-tier-sg» дає кожній VM у групі web-tier-sg змогу звертатися до вашої VM з Postgres на порт 5432 — без потреби перелічувати IP, і правило продовжує працювати, коли VM додаються до web-tier-sg або вилучаються з неї під час масштабування.

Поширений патерн

Для трирівневого вебзастосунку:

  1. web-tier-sg — вхідний трафік: дозволити tcp/80 і tcp/443 з 0.0.0.0/0 (публічно)
  2. app-tier-sg — вхідний трафік: дозволити tcp/8080 з web-tier-sg (лише вебрівень може звертатися до рівня застосунку)
  3. db-tier-sg — вхідний трафік: дозволити tcp/5432 з app-tier-sg (лише рівень застосунку може звертатися до бази даних)

Це добре поєднується: можна додати 4-ту групу для операційного VPN, яка дозволяє SSH з IP вашого офісу, і підʼєднати її разом із db-tier-sg до VM бази даних, не чіпаючи правил застосунку.

Що далі

Reference

GET/api/v1/security_group/

Groups List

Lists security groups visible to the project, including their rules.

Parameters

NameInTypeDescription
admin_domainquerystring | null—
admin_projectquerystring | null—
projectquerystring | null—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/security_group/" \
  -H "Authorization: Bearer $NIMBUS_KEY"
POST/api/v1/security_group/

Group Create

Creates a new security group in the scoped project.

Request body

FieldTypeDescription
admin_domainstring | null—
admin_projectstring | null—
projectstring | null—
name*string—
descriptionstring | null—

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/security_group/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example"
  }'
DELETE/api/v1/security_group/

Group Delete

Deletes a security group, rejecting the request when it is still in use.

Request body

FieldTypeDescription
id*string—

Responses

  • 204Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X DELETE "https://api.nimbusnexus.net/api/v1/security_group/" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "example"
  }'
GET/api/v1/security_group/instance

Instance Groups List

Lists security groups annotated with whether they are linked to a given instance.

Parameters

NameInTypeDescription
admin_domainquerystring | null—
admin_projectquerystring | null—
projectquerystring | null—
id*querystring—
show_allqueryboolean—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X GET "https://api.nimbusnexus.net/api/v1/security_group/instance?id=example" \
  -H "Authorization: Bearer $NIMBUS_KEY"
PUT/api/v1/security_group/instance

Instance Groups Update

Synchronizes an instance attached security groups with the supplied desired set.

Request body

FieldTypeDescription
instance_id*string—
desired_group_ids*array of string—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X PUT "https://api.nimbusnexus.net/api/v1/security_group/instance" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_id": "<instance_id>",
    "desired_group_ids": [
      "<desired_group_id>"
    ]
  }'
POST/api/v1/security_group/rule

Rule Create

Adds an ingress or egress rule to an existing security group.

Request body

FieldTypeDescription
security_group_id*string—
direction*Directions—
ether*Ethers—
protocol*integer | Protocols—
protocol_custominteger | string | null—
port_mininteger | null—
port_maxinteger | null—
icmp_typeinteger | null—
icmp_codeinteger | null—
remote_cidrstring | null—
remote_sec_grpstring | null—
remote_addr_grpstring | null—
descriptionstring | null—

Responses

  • 201Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X POST "https://api.nimbusnexus.net/api/v1/security_group/rule" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "security_group_id": "<security_group_id>",
    "direction": "ingress",
    "ether": "IPv4",
    "protocol": 1
  }'
DELETE/api/v1/security_group/rule/delete

Rule Delete

Deletes one or more security group rules by ID.

Request body

FieldTypeDescription
ids*array of string—

Responses

  • 204Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X DELETE "https://api.nimbusnexus.net/api/v1/security_group/rule/delete" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      "example"
    ]
  }'
PUT/api/v1/security_group/{security_group_id}

Group Update

Updates a security group in the scoped project.

Parameters

NameInTypeDescription
security_group_id*pathstring—

Request body

FieldTypeDescription
namestring | null—
descriptionstring | null—

Responses

  • 200Successful Response
  • 400Bad Request
  • 401Unauthorized
  • 403Forbidden
  • 404Not Found
  • 409Conflict
  • 422Validation Error
  • 429Too Many Requests
  • 500Internal Server Error

Example

curl -X PUT "https://api.nimbusnexus.net/api/v1/security_group/<security_group_id>" \
  -H "Authorization: Bearer $NIMBUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Need to make a real call? Try these endpoints in the live Swagger UI →