← AUXILIUM-ITPodatnościIncydentyBlogRSS

6 listopada 2026 · 6 min czytania · Oktawian Żebrowski

Tenable Vulnerability Management + Jira – trzy sposoby integracji i jak wybrać właściwy

TenableJirazarządzanie podatnościamiautomatyzacja

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:

  1. W Settings otwórz kafelek Jira Cloud, podaj nazwę integracji, adres instancji, użytkownika i token API.
  2. Przetestuj połączenie.
  3. Ustaw domyślnego przypisanego, zgłaszającego, etykiety i mapowanie priorytetów (waga podatności → priorytet w Jira) dla projektu.
  4. 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:

  1. 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”).
  2. W zakładce Ticketing Automation wybierz Jira, projekt, typ zgłoszenia, szablon tytułu i przypisanego.
  3. 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 build tworzy 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 600 i 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:

  1. 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.
  2. 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.
  3. 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ć.
  4. 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”.
  5. 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.

Oktawian Żebrowski – AUXILIUM-IT, Poznań. Ponad 25 lat w administracji systemami krytycznymi (bankowość, infrastruktura wodociągowa); zarządzanie podatnościami, SIEM, hardening i zgodność z KSC/NIS2. Porozmawiajmy o Twojej infrastrukturze.

Artykuł ma charakter informacyjny i nie stanowi porady prawnej. Masz pytania? Skontaktuj się.