Security Advisory Configuration

Last modified by Simon Urli on 2026/11/13 10:24

Reference

The settings of the Security Advisory Application are in "Administer Wiki" > "Other" > "Security Advisory", which requires admin right on the wiki.

The Security Advisory entry of the Other category in the wiki administration, opening the Data migration and GitHub users mapping sections

Section Purpose
Data migrationMoves the advisories still using the legacy data model to the current one: impacted packages in dedicated objects, and the CVE identifier. Shows how many advisories need it, and runs as a background job when you click "Migrate advisories". Safe to run several times.
GitHub users mappingLists the GitHub users found in imported advisories, to map them to XWiki users or ignore them.
Publish disclosed advisoriesPublishes in the disclosed entries space the disclosed advisories that are not there yet: those disclosed before the application published them, and those imported from GitHub as already published. Shows how many there are, and runs as a background job when you click "Publish disclosed advisories". Warns when the disclosed entries space cannot be viewed by all users.
GitHub TokensOne token per GitHub organization, used to import the advisories of its repositories, as set up.
ConfigurationThe settings below.

Configuration

Field Description Default
Unit of the duration to use for the embargo computationUnit of the embargo duration: minutes, hours, days, weeks, months, or any other Java ChronoUnit name.days
Duration value to use for the embargo computationDelay of the embargo date, in the unit above.90
The group of targeted users for advisories notificationsGroup whose members receive the advisory notifications.XWiki.XWikiAdminGroup
Security entries space locationSpace holding the advisories.SecurityAdvisoryApplication.SecurityEntries
Disclosed entries space locationSpace holding the public copies of the disclosed advisories. It must not be inside the security entries space.SecurityAdvisoryApplication.DisclosedEntries
Importer userUser set as author of the imported advisories.XWiki.Admin
Github TokenNot used by the import, which takes the tokens of the "GitHub Tokens" section.(empty)
Github RepositoriesRepositories whose advisories are imported, each as organization/repository (xwiki/xwiki-platform) or as a whole organization (xwiki).(empty)

Scheduler Jobs

The application runs three daily jobs, listed in the Scheduler application.

Job Runs at Does
SecurityAdvisoryGithubImporter18:00Imports the advisories of the "Github Repositories".
SecurityAdvisoryEmbargoDateComputer20:00Computes the embargo date of the announced advisories whose patched versions are all released.
SecurityAdvisoryDisclosableComputer12:00Sets the "Disclosable" status on the announced advisories whose embargo date is reached.

Single Advisory Import

The page SecurityAdvisoryApplication.Code.SingleAdvisoryImportPage, available to administrators only, imports one GitHub advisory without waiting for the daily import. Enter its "Advisory URL", such as https://github.com/xwiki/xwiki-platform/security/advisories/GHSA-xxxx-xxxx-xxxx, and click "Import advisory": the imported advisory opens. Its organization needs a token in the "GitHub Tokens" section.

Related

Get Connected