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
| Option | How 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. |
| GitLab | Paste a token. Use gitlab.com or the https address of your own GitLab host. |
| One repository | Any 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.
| Ecosystem | Files read |
|---|---|
| JavaScript | package.json, package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock |
| Python | poetry.lock, uv.lock, pdm.lock, Pipfile.lock |
| Go | go.sum |
| Rust | Cargo.lock |
| Ruby | Gemfile.lock, gems.locked |
| PHP | composer.lock |
| Java and Kotlin | gradle.lockfile and *.gradle.lockfile |
| .NET | packages.lock.json |
| Elixir | mix.lock |
| Dart | pubspec.lock |
| Swift | Package.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
| Method | Path | Role | What it does |
|---|---|---|---|
GET | /api/orgs/:orgId/dependencies | viewer | Connections and repositories, or feature: false when the plan lacks it. |
POST | /api/orgs/:orgId/dependencies/github/start | admin | Returns the GitHub authorization URL. |
POST | /api/orgs/:orgId/dependencies/github | admin | Connect GitHub with a token. |
POST | /api/orgs/:orgId/dependencies/gitlab | admin | Body: token and optional origin. |
POST | /api/orgs/:orgId/dependencies/git | admin | Body: url and optional token. |
DELETE | /api/orgs/:orgId/dependencies/connections/:connectionId | admin | Disconnect. |
POST | /api/orgs/:orgId/dependencies/connections/:connectionId/refresh | admin | Refresh the repository list. |
PUT | /api/orgs/:orgId/dependencies/repos | admin | Body: selectedIds. |
PATCH | /api/orgs/:orgId/dependencies/repos/:repoId | admin | Body: paused. |
POST | /api/orgs/:orgId/dependencies/connections/:connectionId/scan | admin | Scan every selected repository. Answers 202. |
POST | /api/orgs/:orgId/dependencies/repos/:repoId/scan | admin | Scan one repository. 202, or 409 if already running. |
GET | /api/orgs/:orgId/dependencies/advisories | viewer | Grouped, paginated advisories. Query: repo, q, status, severity, page. |
POST | /api/orgs/:orgId/dependencies/advisories/:advisoryId/accept | admin | Body: reason and until. |
POST | /api/orgs/:orgId/dependencies/advisories/:advisoryId/reopen | admin | Reopen an accepted advisory. |