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.

| Section | Purpose |
|---|---|
| Data migration | Moves 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 mapping | Lists the GitHub users found in imported advisories, to map them to XWiki users or ignore them. |
| Publish disclosed advisories | Publishes 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 Tokens | One token per GitHub organization, used to import the advisories of its repositories, as set up. |
| Configuration | The settings below. |
Configuration
| Field | Description | Default |
|---|---|---|
| Unit of the duration to use for the embargo computation | Unit of the embargo duration: minutes, hours, days, weeks, months, or any other Java ChronoUnit name. | days |
| Duration value to use for the embargo computation | Delay of the embargo date, in the unit above. | 90 |
| The group of targeted users for advisories notifications | Group whose members receive the advisory notifications. | XWiki.XWikiAdminGroup |
| Security entries space location | Space holding the advisories. | SecurityAdvisoryApplication.SecurityEntries |
| Disclosed entries space location | Space holding the public copies of the disclosed advisories. It must not be inside the security entries space. | SecurityAdvisoryApplication.DisclosedEntries |
| Importer user | User set as author of the imported advisories. | XWiki.Admin |
| Github Token | Not used by the import, which takes the tokens of the "GitHub Tokens" section. | (empty) |
| Github Repositories | Repositories 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 |
|---|---|---|
| SecurityAdvisoryGithubImporter | 18:00 | Imports the advisories of the "Github Repositories". |
| SecurityAdvisoryEmbargoDateComputer | 20:00 | Computes the embargo date of the announced advisories whose patched versions are all released. |
| SecurityAdvisoryDisclosableComputer | 12:00 | Sets 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.