Skip to content

Commit 970c942

Browse files
authored
ci: Add cargo-deny security audit workflow (#138)
Configure cargo-deny with license, advisory, ban, and source checks and run it on PRs, main dependency changes, and a daily schedule.
1 parent d8df88c commit 970c942

2 files changed

Lines changed: 272 additions & 0 deletions

File tree

.github/workflows/deny.yml

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
name: Security audit
2+
3+
on:
4+
schedule:
5+
# Runs at 00:00 UTC everyday
6+
- cron: "0 0 * * *"
7+
push:
8+
branches:
9+
- main
10+
paths:
11+
- "**/Cargo.toml"
12+
- "**/Cargo.lock"
13+
pull_request:
14+
15+
permissions: {}
16+
17+
concurrency:
18+
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
19+
cancel-in-progress: true
20+
21+
jobs:
22+
audit:
23+
name: Audit dependencies
24+
runs-on: ubuntu-latest
25+
steps:
26+
- name: Checkout repository
27+
uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
28+
with:
29+
persist-credentials: false
30+
- uses: EmbarkStudios/cargo-deny-action@175dc7fd4fb85ec8f46948fb98f44db001149081 # v2.0.16

deny.toml

Lines changed: 242 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,242 @@
1+
# This template contains all of the possible sections and their default values
2+
3+
# Note that all fields that take a lint level have these possible values:
4+
# * deny - An error will be produced and the check will fail
5+
# * warn - A warning will be produced, but the check will not fail
6+
# * allow - No warning or error will be produced, though in some cases a note
7+
# will be
8+
9+
# The values provided in this template are the default values that will be used
10+
# when any section or field is not specified in your own configuration
11+
12+
# Root options
13+
14+
# The graph table configures how the dependency graph is constructed and thus
15+
# which crates the checks are performed against
16+
[graph]
17+
# If 1 or more target triples (and optionally, target_features) are specified,
18+
# only the specified targets will be checked when running `cargo deny check`.
19+
# This means, if a particular package is only ever used as a target specific
20+
# dependency, such as, for example, the `nix` crate only being used via the
21+
# `target_family = "unix"` configuration, that only having windows targets in
22+
# this list would mean the nix crate, as well as any of its exclusive
23+
# dependencies not shared by any other crates, would be ignored, as the target
24+
# list here is effectively saying which targets you are building for.
25+
targets = [
26+
# The triple can be any string, but only the target triples built in to
27+
# rustc (as of 1.40) can be checked against actual config expressions
28+
#"x86_64-unknown-linux-musl",
29+
# You can also specify which target_features you promise are enabled for a
30+
# particular target. target_features are currently not validated against
31+
# the actual valid features supported by the target architecture.
32+
#{ triple = "wasm32-unknown-unknown", features = ["atomics"] },
33+
]
34+
# When creating the dependency graph used as the source of truth when checks are
35+
# executed, this field can be used to prune crates from the graph, removing them
36+
# from the view of cargo-deny. This is an extremely heavy hammer, as if a crate
37+
# is pruned from the graph, all of its dependencies will also be pruned unless
38+
# they are connected to another crate in the graph that hasn't been pruned,
39+
# so it should be used with care. The identifiers are [Package ID Specifications]
40+
# (https://doc.rust-lang.org/cargo/reference/pkgid-spec.html)
41+
#exclude = []
42+
# If true, metadata will be collected with `--all-features`. Note that this can't
43+
# be toggled off if true, if you want to conditionally enable `--all-features` it
44+
# is recommended to pass `--all-features` on the cmd line instead
45+
all-features = false
46+
# If true, metadata will be collected with `--no-default-features`. The same
47+
# caveat with `all-features` applies
48+
no-default-features = false
49+
# If set, these feature will be enabled when collecting metadata. If `--features`
50+
# is specified on the cmd line they will take precedence over this option.
51+
#features = []
52+
53+
# The output table provides options for how/if diagnostics are outputted
54+
[output]
55+
# When outputting inclusion graphs in diagnostics that include features, this
56+
# option can be used to specify the depth at which feature edges will be added.
57+
# This option is included since the graphs can be quite large and the addition
58+
# of features from the crate(s) to all of the graph roots can be far too verbose.
59+
# This option can be overridden via `--feature-depth` on the cmd line
60+
feature-depth = 1
61+
62+
# This section is considered when running `cargo deny check advisories`
63+
# More documentation for the advisories section can be found here:
64+
# https://embarkstudios.github.io/cargo-deny/checks/advisories/cfg.html
65+
[advisories]
66+
# The path where the advisory databases are cloned/fetched into
67+
#db-path = "$CARGO_HOME/advisory-dbs"
68+
# The url(s) of the advisory databases to use
69+
#db-urls = ["https://github.com/rustsec/advisory-db"]
70+
# A list of advisory IDs to ignore. Note that ignored advisories will still
71+
# output a note when they are encountered.
72+
ignore = [
73+
#"RUSTSEC-0000-0000",
74+
#{ id = "RUSTSEC-0000-0000", reason = "you can specify a reason the advisory is ignored" },
75+
#"a-crate-that-is-yanked@0.1.1", # you can also ignore yanked crate versions if you wish
76+
#{ crate = "a-crate-that-is-yanked@0.1.1", reason = "you can specify why you are ignoring the yanked crate" },
77+
]
78+
# If this is true, then cargo deny will use the git executable to fetch advisory database.
79+
# If this is false, then it uses a built-in git library.
80+
# Setting this to true can be helpful if you have special authentication requirements that cargo-deny does not support.
81+
# See Git Authentication for more information about setting up git authentication.
82+
#git-fetch-with-cli = true
83+
84+
# This section is considered when running `cargo deny check licenses`
85+
# More documentation for the licenses section can be found here:
86+
# https://embarkstudios.github.io/cargo-deny/checks/licenses/cfg.html
87+
[licenses]
88+
# List of explicitly allowed licenses
89+
# See https://spdx.org/licenses/ for list of possible licenses
90+
# [possible values: any SPDX 3.11 short identifier (+ optional exception)].
91+
allow = [
92+
"MIT",
93+
"Apache-2.0",
94+
"Apache-2.0 WITH LLVM-exception",
95+
"Unicode-3.0",
96+
"BSD-3-Clause",
97+
]
98+
# The confidence threshold for detecting a license from license text.
99+
# The higher the value, the more closely the license text must be to the
100+
# canonical license text of a valid SPDX license file.
101+
# [possible values: any between 0.0 and 1.0].
102+
confidence-threshold = 0.8
103+
# Allow 1 or more licenses on a per-crate basis, so that particular licenses
104+
# aren't accepted for every possible crate as with the normal allow list
105+
exceptions = [
106+
# Each entry is the crate and version constraint, and its specific allow
107+
# list
108+
#{ allow = ["Zlib"], crate = "adler32" },
109+
]
110+
111+
# Some crates don't have (easily) machine readable licensing information,
112+
# adding a clarification entry for it allows you to manually specify the
113+
# licensing information
114+
#[[licenses.clarify]]
115+
# The package spec the clarification applies to
116+
#crate = "ring"
117+
# The SPDX expression for the license requirements of the crate
118+
#expression = "MIT AND ISC AND OpenSSL"
119+
# One or more files in the crate's source used as the "source of truth" for
120+
# the license expression. If the contents match, the clarification will be used
121+
# when running the license check, otherwise the clarification will be ignored
122+
# and the crate will be checked normally, which may produce warnings or errors
123+
# depending on the rest of your configuration
124+
#license-files = [
125+
# Each entry is a crate relative path, and the (opaque) hash of its contents
126+
#{ path = "LICENSE", hash = 0xbd0eed23 }
127+
#]
128+
129+
[licenses.private]
130+
# If true, ignores workspace crates that aren't published, or are only
131+
# published to private registries.
132+
# To see how to mark a crate as unpublished (to the official registry),
133+
# visit https://doc.rust-lang.org/cargo/reference/manifest.html#the-publish-field.
134+
ignore = false
135+
# One or more private registries that you might publish crates to, if a crate
136+
# is only published to private registries, and ignore is true, the crate will
137+
# not have its license(s) checked
138+
registries = [
139+
#"https://sekretz.com/registry
140+
]
141+
142+
# This section is considered when running `cargo deny check bans`.
143+
# More documentation about the 'bans' section can be found here:
144+
# https://embarkstudios.github.io/cargo-deny/checks/bans/cfg.html
145+
[bans]
146+
# Lint level for when multiple versions of the same crate are detected
147+
multiple-versions = "warn"
148+
# Lint level for when a crate version requirement is `*`
149+
wildcards = "allow"
150+
# The graph highlighting used when creating dotgraphs for crates
151+
# with multiple versions
152+
# * lowest-version - The path to the lowest versioned duplicate is highlighted
153+
# * simplest-path - The path to the version with the fewest edges is highlighted
154+
# * all - Both lowest-version and simplest-path are used
155+
highlight = "all"
156+
# The default lint level for `default` features for crates that are members of
157+
# the workspace that is being checked. This can be overridden by allowing/denying
158+
# `default` on a crate-by-crate basis if desired.
159+
workspace-default-features = "allow"
160+
# The default lint level for `default` features for external crates that are not
161+
# members of the workspace. This can be overridden by allowing/denying `default`
162+
# on a crate-by-crate basis if desired.
163+
external-default-features = "allow"
164+
# List of crates that are allowed. Use with care!
165+
allow = [
166+
#"ansi_term@0.11.0",
167+
#{ crate = "ansi_term@0.11.0", reason = "you can specify a reason it is allowed" },
168+
]
169+
# If true, workspace members are automatically allowed even when using deny-by-default
170+
# This is useful for organizations that want to deny all external dependencies by default
171+
# but allow their own workspace crates without having to explicitly list them
172+
allow-workspace = false
173+
# List of crates to deny
174+
deny = [
175+
#"ansi_term@0.11.0",
176+
#{ crate = "ansi_term@0.11.0", reason = "you can specify a reason it is banned" },
177+
# Wrapper crates can optionally be specified to allow the crate when it
178+
# is a direct dependency of the otherwise banned crate
179+
#{ crate = "ansi_term@0.11.0", wrappers = ["this-crate-directly-depends-on-ansi_term"] },
180+
]
181+
182+
# List of features to allow/deny
183+
# Each entry the name of a crate and a version range. If version is
184+
# not specified, all versions will be matched.
185+
#[[bans.features]]
186+
#crate = "reqwest"
187+
# Features to not allow
188+
#deny = ["json"]
189+
# Features to allow
190+
#allow = [
191+
# "rustls",
192+
# "__rustls",
193+
# "__tls",
194+
# "hyper-rustls",
195+
# "rustls",
196+
# "rustls-pemfile",
197+
# "rustls-tls-webpki-roots",
198+
# "tokio-rustls",
199+
# "webpki-roots",
200+
#]
201+
# If true, the allowed features must exactly match the enabled feature set. If
202+
# this is set there is no point setting `deny`
203+
#exact = true
204+
205+
# Certain crates/versions that will be skipped when doing duplicate detection.
206+
skip = [
207+
"wit-bindgen"
208+
#"ansi_term@0.11.0",
209+
#{ crate = "ansi_term@0.11.0", reason = "you can specify a reason why it can't be updated/removed" },
210+
]
211+
# Similarly to `skip` allows you to skip certain crates during duplicate
212+
# detection. Unlike skip, it also includes the entire tree of transitive
213+
# dependencies starting at the specified crate, up to a certain depth, which is
214+
# by default infinite.
215+
skip-tree = [
216+
#"ansi_term@0.11.0", # will be skipped along with _all_ of its direct and transitive dependencies
217+
#{ crate = "ansi_term@0.11.0", depth = 20 },
218+
]
219+
220+
# This section is considered when running `cargo deny check sources`.
221+
# More documentation about the 'sources' section can be found here:
222+
# https://embarkstudios.github.io/cargo-deny/checks/sources/cfg.html
223+
[sources]
224+
# Lint level for what to happen when a crate from a crate registry that is not
225+
# in the allow list is encountered
226+
unknown-registry = "warn"
227+
# Lint level for what to happen when a crate from a git repository that is not
228+
# in the allow list is encountered
229+
unknown-git = "warn"
230+
# List of URLs for allowed crate registries. Defaults to the crates.io index
231+
# if not specified. If it is specified but empty, no registries are allowed.
232+
allow-registry = ["https://github.com/rust-lang/crates.io-index"]
233+
# List of URLs for allowed Git repositories
234+
allow-git = []
235+
236+
[sources.allow-org]
237+
# github.com organizations to allow git sources for
238+
github = []
239+
# gitlab.com organizations to allow git sources for
240+
gitlab = []
241+
# bitbucket.org organizations to allow git sources for
242+
bitbucket = []

0 commit comments

Comments
 (0)