Bermward

Dependencies

Connect your source code and Bermward reads the packages you actually pin, checks them against public vulnerability data, and tells you which repository, manifest and version is affected and what fixes it.

Connecting a source

OptionHow it works
GitHub (sign in)Authorize through GitHub, then choose repositories. Available when GitHub sign-in is configured on the server.
GitHub (token)Paste an access token instead of using the sign-in flow.
GitLabPaste a token. Use gitlab.com or the https address of your own GitLab host.
One repositoryAny https Git URL with an optional token, for hosts that are not GitHub or GitLab, or for a single public repository.

Only admins connect and disconnect sources, and both are recorded in the audit log. Disconnecting asks for confirmation. After connecting, pick the repositories to watch. You can select up to 30.

What a scan reads

A scan reads dependency manifests and lockfiles from the repository tree and skips node_modules. Locked files give exact versions. Manifests without a lock list their ranges, which cannot be matched to a specific advisory, so they are reported as unpinned instead.

EcosystemFiles read
JavaScriptpackage.json, package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock
Pythonpoetry.lock, uv.lock, pdm.lock, Pipfile.lock
Gogo.sum
RustCargo.lock
RubyGemfile.lock, gems.locked
PHPcomposer.lock
Java and Kotlingradle.lockfile and *.gradle.lockfile
.NETpackages.lock.json
Elixirmix.lock
Dartpubspec.lock
SwiftPackage.resolved
C and C++conan.lock, conanfile.txt, conanfile.py, vcpkg.json, CMakeLists.txt, CPM.cmake, dependencies.cmake, deps.cmake
Git submodules.gitmodules, with the submodules read from the tree

Scan schedule

  • Scans start on demand for one repository or for a whole connection, and answer immediately while they run in the background.
  • A running scan is shown as a status banner and survives a page reload. The page polls every few seconds and tells you when it finishes.
  • Selected repositories are also re-scanned automatically once they are more than a day old. A background job runs hourly and takes a few repositories each time.
  • Pause a repository to exclude it from automatic scans.

Advisories

Advisories are grouped by package and advisory so one vulnerable package in several repositories reads as one issue. Each group shows affected versions, the repository and manifest path, severity, and the version that fixes it. Advisories without a severity score show as Unscored.

Filter by repository, status and severity, and search by package or advisory ID. Filters live in the address bar, so a view can be shared as a link.

Accepting a risk needs a reason (up to 1,000 characters) and an expiry date at most a year away. When the date passes, the advisory reopens on the next scan. Admins are told once, two weeks before an accepted risk expires, so they can review it or accept it again. Reopen an acceptance at any time.

Alerts

New advisories raise the dependencies.advisories event for chat channels and webhooks, with the repository and the most severe advisories listed first. See Webhooks and alert channels.

API

MethodPathRoleWhat it does
GET/api/orgs/:orgId/dependenciesviewerConnections and repositories, or feature: false when the plan lacks it.
POST/api/orgs/:orgId/dependencies/github/startadminReturns the GitHub authorization URL.
POST/api/orgs/:orgId/dependencies/githubadminConnect GitHub with a token.
POST/api/orgs/:orgId/dependencies/gitlabadminBody: token and optional origin.
POST/api/orgs/:orgId/dependencies/gitadminBody: url and optional token.
DELETE/api/orgs/:orgId/dependencies/connections/:connectionIdadminDisconnect.
POST/api/orgs/:orgId/dependencies/connections/:connectionId/refreshadminRefresh the repository list.
PUT/api/orgs/:orgId/dependencies/reposadminBody: selectedIds.
PATCH/api/orgs/:orgId/dependencies/repos/:repoIdadminBody: paused.
POST/api/orgs/:orgId/dependencies/connections/:connectionId/scanadminScan every selected repository. Answers 202.
POST/api/orgs/:orgId/dependencies/repos/:repoId/scanadminScan one repository. 202, or 409 if already running.
GET/api/orgs/:orgId/dependencies/advisoriesviewerGrouped, paginated advisories. Query: repo, q, status, severity, page.
POST/api/orgs/:orgId/dependencies/advisories/:advisoryId/acceptadminBody: reason and until.
POST/api/orgs/:orgId/dependencies/advisories/:advisoryId/reopenadminReopen an accepted advisory.