Files
EvoFirewall/docs/integrate-evobgp.md
T
Denozordec fac2ed4d2d
Build and Push EvoFirewall Docker Image / build-and-push (push) Successful in 1m42s
Build and Push EvoFirewall Docker Image / create-release (push) Skipped
feat(api, web): enhance EvoBGP community handling and UI integration
- Introduced a new function to resolve EvoBGP community IDs, allowing for better handling of legacy labels and UUIDs.
- Updated `fetchEvobgpCommunity` to return both resolved community IDs and CIDRs, improving data retrieval.
- Enhanced the ListsPage component to manage community IDs separately from user input, ensuring accurate configuration during list creation.
- Updated documentation to reflect changes in community ID resolution and integration with the UI.

This update improves the user experience by ensuring that community IDs are correctly resolved and stored, facilitating smoother interactions with the EvoBGP API.
2026-07-23 11:30:56 +07:00

33 lines
1.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Интеграция EvoBGP → EvoFirewall
EvoFirewall использует EvoBGP как **источник префиксов** для списков типа `evobgp_community`.
## Настройка
В UI Settings или `settings` table:
- `evobgp_api_url` — base URL EvoBGP API
- `evobgp_api_token` — API key (viewer+ / `bgp:directories:read`)
## Refresh списка
При refresh списка `evobgp_community`:
1. Если `config.community_id` не UUID (legacy: Autocomplete сохранил label) — resolve через `GET /v1/communities`
2. `GET {api}/v1/communities/{id}/prefixes?limit=5000` (id — UUID; EvoBGP также принимает community/label)
3. Ответ: `{ items: [{ prefix }], prefixes: string[], has_more, next_cursor }`
4. Entries заменяются; generation агентов с правилами на этот list бампится
5. В config пишется resolved UUID, если был label
## Autocomplete в UI
`GET /api/v1/integrations/evobgp/communities` — proxy к EvoBGP `GET /v1/communities?limit=200` (нужны settings выше).
В форме создания списка Base UI Autocomplete показывает label, а в `config.community_id` сохраняется UUID.
## Список
Создайте IP list type `evobgp_community` с `config.community_id`. Cron / кнопка Refresh обновляет entries.
Firewall-подсистема в EvoBGP **удалена** (hard cutover) — клиенты переустанавливаются на EvoFirewall agents.