6 listopada 2026 · 6 min czytania · Oktawian Żebrowski
Tenable Vulnerability Management + Jira – trzy sposoby integracji i jak wybrać właściwy
Jak połączyć Tenable Vulnerability Management (Tenable One) z Jira: natywne Initiatives w Exposure Response, narzędzie tenb2jira i własna integracja przez API. Konfiguracja, pułapki, dobre praktyki.
Skaner wykrywa podatności, ale usuwają je ludzie – administratorzy, zespoły aplikacyjne, dostawcy. A oni pracują w systemie zgłoszeń, nie w konsoli skanera. Integracja Tenable z Jira zamyka tę lukę: podatność trafia do właściwego zespołu jako zadanie z terminem, a po naprawie zgłoszenie zamyka się na podstawie wyniku skanu, a nie deklaracji.
W tym artykule porównuję trzy sposoby integracji Tenable Vulnerability Management (części platformy Tenable One) z Jira i opisuję, na co uważać przy wdrożeniu. Szerzej o samym procesie piszę w artykule Proces i procedura zarządzania podatnościami.
Trzy drogi w skrócie
| Natywnie: Exposure Response | tenb2jira (open source) | Własna integracja (API) | |
|---|---|---|---|
| Gdzie działa | w konsoli Tenable | skrypt na Twoim serwerze | Twój kod na Twoim serwerze |
| Jira | Jira Cloud | Jira Cloud | Cloud i Data Center |
| Źródło danych | Tenable Vulnerability Management | Tenable VM lub Tenable Security Center | dowolne (+ KEV, EPSS, CMDB) |
| Zakres zgłoszeń | wybrane podatności i zasoby (initiative) | wszystkie podatności z zakresu | dokładnie to, co zaprogramujesz |
| Zamykanie po naprawie | tak (synchronizacja) | tak (automatycznie) | do zaprogramowania |
| Wysiłek wdrożenia | niski | średni | wysoki |
1. Natywnie: Exposure Response i Initiatives
Tenable Vulnerability Management ma moduł Exposure Response, w którym tworzy się inicjatywy (initiatives) – projekty usuwania wybranych podatności. Tenable nazywa ten proces mobilizacją. Inicjatywa ma zakres (tagi zasobów i kombinacje warunków), właściciela, SLA – i może automatycznie tworzyć zgłoszenia w Jira Cloud.
Konfiguracja połączenia z Jira:
- W Settings otwórz kafelek Jira Cloud, podaj nazwę integracji, adres instancji, użytkownika i token API.
- Przetestuj połączenie.
- Ustaw domyślnego przypisanego, zgłaszającego, etykiety i mapowanie priorytetów (waga podatności → priorytet w Jira) dla projektu.
- Opcjonalnie włącz synchronizację zamknięć – podatności oznaczone jako naprawione zamykają powiązane zgłoszenia. Wymaga to statusu typu „Done” w workflow projektu.
Tworzenie inicjatywy:
- W zakładce Basic Setup nadaj nazwę, właściciela, zakres zasobów, SLA i kombinacje warunków (np. „podatności krytyczne i wysokie na serwerach z tagiem Produkcja”).
- W zakładce Ticketing Automation wybierz Jira, projekt, typ zgłoszenia, szablon tytułu i przypisanego.
- Wybierz sposób agregacji: osobne zgłoszenie dla każdego wyniku albo podzadania pod jednym zgłoszeniem.
Status, priorytet i zamknięcie pozostają powiązane z wynikiem w Tenable, a błędy synchronizacji widać w logach aktywności i zgłoszeń. Podobna integracja jest dostępna dla ServiceNow.
Kiedy wybrać: masz Jira Cloud i chcesz najszybciej uruchomić obieg zgłoszeń dla konkretnych celów – np. „wszystkie podatności z katalogu KEV na zasobach dostępnych z internetu” albo „krytyczne na kontrolerach domeny”.
2. tenb2jira – oficjalne narzędzie open source
Tenable udostępnia na GitHubie narzędzie tenb2jira, które synchronizuje podatności z Tenable Vulnerability Management lub Tenable Security Center do Jira Cloud.
Model zgłoszeń:
- każda podatność (wtyczka) to jedno zadanie – np.
[156032] Apache Log4j RCE, - każde wystąpienie na zasobie to podzadanie – np.
[10.10.20.15/443/tcp] [156032] ..., - podzadanie zamyka się samo, gdy Tenable uzna podatność za naprawioną; zadanie – gdy wszystkie podzadania są zamknięte,
- jeśli podatność wróci, powstają nowe zgłoszenia (stare nie są ponownie otwierane).
Instalacja i uruchomienie:
python3 -m venv /opt/tenb2jira && /opt/tenb2jira/bin/pip install tenb2jira
/opt/tenb2jira/bin/tenb2jira validate /etc/tenb2jira/config.toml # sprawdzenie konfiguracji
/opt/tenb2jira/bin/tenb2jira build /etc/tenb2jira/config.toml # projekt, pola, typy zgłoszeń
/opt/tenb2jira/bin/tenb2jira sync /etc/tenb2jira/config.toml # synchronizacja
Minimalna konfiguracja (config.toml):
[tenable]
platform = "tvm" # "tvm" (Vulnerability Management) albo "tsc" (Security Center)
access_key = "..."
secret_key = "..."
[jira]
api_username = "integracja@firma.pl"
api_token = "..."
url = "https://firma.atlassian.net"
Dobre praktyki:
- Narzędzie wymaga Pythona 3.10+ – na starszych dystrybucjach użyj osobnego środowiska.
- Krok
buildtworzy projekt i pola – wymaga uprawnień administratora Jira. Do codziennej synchronizacji użyj osobnego konta z minimalnymi uprawnieniami (tworzenie, edycja, przejścia i zamykanie zgłoszeń w tym projekcie). - Klucz API Tenable powinien mieć tylko uprawnienia do odczytu, a plik konfiguracyjny – prawa
600i właściciela będącego kontem usługowym. - Synchronizację uruchamiaj cyklicznie (cron, timer systemd) po zakończeniu harmonogramu skanów.
Kiedy wybrać: chcesz pełne, automatyczne odwzorowanie podatności w Jira – albo korzystasz z Tenable Security Center, a nie z wersji chmurowej. Uwaga: przy dużym środowisku pełna synchronizacja potrafi wygenerować tysiące zgłoszeń. Zacznij od zawężonego zakresu (np. tylko krytyczne i wysokie).
3. Własna integracja przez API
Gdy potrzebujesz czegoś, czego gotowe narzędzia nie dają – np. Jira Data Center, priorytetów opartych o KEV i EPSS, przypisania właściciela z CMDB albo raportów – możesz zbudować własny „most” z biblioteką pyTenable i API Jira.
Szkic logiki:
from tenable.io import TenableIO
import requests
tio = TenableIO(ACCESS_KEY, SECRET_KEY)
jira = requests.Session()
jira.auth = (JIRA_USER, JIRA_TOKEN) # Cloud: e-mail + token API
# Data Center: osobisty token (nagłówek Bearer)
for v in tio.exports.vulns(severity=["critical", "high"], state=["OPEN", "REOPENED"]):
key = f'{v["asset"]["uuid"]}:{v["plugin"]["id"]}' # klucz deduplikacji
if already_tracked(key): # np. lokalna baza lub wyszukiwanie JQL
continue
prio = priorytet(v) # Twoja logika: KEV, EPSS, krytyczność zasobu
jira.post(f"{JIRA_URL}/rest/api/2/issue", json={"fields": {
"project": {"key": "VULN"},
"issuetype": {"name": "Task"},
"summary": f'[{prio}] {v["plugin"]["name"]} – {v["asset"].get("hostname")}',
"description": opis(v), # rozwiązanie, CVE, termin SLA
"labels": ["tenable", prio],
}}).raise_for_status()
To szkielet – w praktyce trzeba jeszcze obsłużyć:
- deduplikację i stan (żeby nie tworzyć tego samego zgłoszenia przy każdym uruchomieniu),
- zamykanie zgłoszeń po potwierdzeniu naprawy (eksport z
state=["FIXED"]), - limity API i ponawianie zapytań,
- mapowanie właścicieli – tagi zasobów w Tenable albo CMDB → zespół w Jira,
- bezpieczeństwo – klucze w menedżerze sekretów, konto usługowe z minimalnymi uprawnieniami, log działań.
Kiedy wybrać: masz nietypowe wymagania albo Jira Data Center, a w zespole są kompetencje programistyczne do utrzymania kodu.
Decyzje projektowe, które warto podjąć przed wdrożeniem
Niezależnie od wybranej drogi te pytania wracają zawsze:
- Jedno zgłoszenie na co? Na podatność na zasobie (dużo zgłoszeń, łatwe zamykanie), na podatność we wszystkich zasobach (mniej zgłoszeń, trudniejsze zamykanie częściowe) czy na zasób/zespół (wygodne dla administratorów)? Dla poprawek systemowych dobrze sprawdza się jedno zgłoszenie na wtyczkę z podzadaniami.
- Co w ogóle trafia do Jira? Nie wszystko. Zacznij od P1/P2 – podatności z KEV, wysoki EPSS, krytyczne zasoby. Zalewanie zespołów tysiącami zgłoszeń o niskim priorytecie zabija proces szybciej niż brak integracji.
- Kto jest właścicielem? Bez dobrego tagowania zasobów w Tenable (np. Właściciel: Zespół Windows) zgłoszenia będą lądować w jednej kolejce i tam umierać.
- Kto zamyka? Zamknięcie powinno wynikać z ponownego skanu, nie z ręcznej zmiany statusu. Jeśli administrator może zamknąć zgłoszenie bez weryfikacji, wprowadź status pośredni typu „Do weryfikacji”.
- Jak mierzysz SLA? Data wykrycia w Tenable, data utworzenia zgłoszenia i data zamknięcia to podstawa wskaźników dla zarządu i dowód dla audytora KSC/NIS2.
Podsumowanie
- Masz Jira Cloud i chcesz szybko zacząć? Exposure Response i inicjatywy dla najważniejszych celów.
- Potrzebujesz pełnego odwzorowania lub korzystasz z Security Center? tenb2jira – z rozsądnie zawężonym zakresem.
- Masz nietypowe wymagania albo Jira Data Center? Własna integracja przez API.
Najważniejsze nie jest jednak narzędzie, tylko to, żeby zgłoszenia trafiały do właściwych ludzi, z jasnym priorytetem i terminem, i zamykały się na podstawie dowodu.
Wdrażałem integrację Tenable z Jira w środowisku produkcyjnym – od konfiguracji skanów i tagowania zasobów, przez automatyzację w Pythonie, po raporty SLA dla zarządu. Jeśli planujesz takie wdrożenie, porozmawiajmy.
Źródła: Tenable – Initiatives w Exposure Response (dokumentacja); Tenable Connect – Jira Cloud ticketing; GitHub – tenable/integration-jira-cloud (tenb2jira); Tenable and Jira Cloud Integration Guide (PDF); pyTenable – dokumentacja. Nazwy menu i funkcje mogą się zmieniać wraz z wersjami produktu – sprawdź aktualną dokumentację Tenable.