Debian Codegraph @

upstream/debian-trixie/man7/systemd.system-credentials.7

raw
1 '\" t
2 .TH "SYSTEMD\&.SYSTEM\-CREDENTIALS" "7" "" "systemd 257.13" "systemd.system-credentials"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 systemd.system-credentials \- System Credentials
24 .SH "DESCRIPTION"
25 .PP
26 \m[blue]\fBSystem and Service Credentials\fR\m[]\&\s-2\u[1]\d\s+2
27 are data objects that may be passed into booted systems or system services as they are invoked\&. They can be acquired from various external sources, and propagated into the system and from there into system services\&. Credentials may optionally be encrypted with a machine\-specific key and/or locked to the local TPM2 device, and are only decrypted when the consuming service is invoked\&.
28 .PP
29 System credentials may be used to provision and configure various aspects of the system\&. Depending on the consuming component credentials are only used on initial invocations or are needed for all invocations\&.
30 .PP
31 Credentials may be used for any kind of data, binary or text, and may carry passwords, secrets, certificates, cryptographic key material, identity information, configuration, and more\&.
32 .SH "WELL KNOWN SYSTEM CREDENTIALS"
33 .PP
34 \fIfirstboot\&.keymap\fR
35 .RS 4
36 The console key mapping to set (e\&.g\&.
37 "de")\&. Read by
38 \fBsystemd-firstboot\fR(1), and only honoured if no console keymap has been configured before\&.
39 .sp
40 Added in version 252\&.
41 .RE
42 .PP
43 \fIfirstboot\&.locale\fR, \fIfirstboot\&.locale\-messages\fR
44 .RS 4
45 The system locale to set (e\&.g\&.
46 "de_DE\&.UTF\-8")\&. Read by
47 \fBsystemd-firstboot\fR(1), and only honoured if no locale has been configured before\&.
48 \fIfirstboot\&.locale\fR
49 sets
50 "LANG", while
51 \fIfirstboot\&.locale\-message\fR
52 sets
53 "LC_MESSAGES"\&.
54 .sp
55 Added in version 252\&.
56 .RE
57 .PP
58 \fIfirstboot\&.timezone\fR
59 .RS 4
60 The system timezone to set (e\&.g\&.
61 "Europe/Berlin")\&. Read by
62 \fBsystemd-firstboot\fR(1), and only honoured if no system timezone has been configured before\&.
63 .sp
64 Added in version 252\&.
65 .RE
66 .PP
67 \fIlogin\&.issue\fR
68 .RS 4
69 The data of this credential is written to
70 /etc/issue\&.d/50\-provision\&.conf, if the file does not exist yet\&.
71 \fBagetty\fR(8)
72 reads this file and shows its contents at the login prompt of terminal logins\&. See
73 \fBissue\fR(5)
74 for details\&.
75 .sp
76 Consumed by
77 /usr/lib/tmpfiles\&.d/provision\&.conf, see
78 \fBtmpfiles.d\fR(5)\&.
79 .sp
80 Added in version 252\&.
81 .RE
82 .PP
83 \fIlogin\&.motd\fR
84 .RS 4
85 The data of this credential is written to
86 /etc/motd\&.d/50\-provision\&.conf, if the file does not exist yet\&.
87 \fBpam_motd\fR(8)
88 reads this file and shows its contents as "message of the day" during terminal logins\&. See
89 \fBmotd\fR(5)
90 for details\&.
91 .sp
92 Consumed by
93 /usr/lib/tmpfiles\&.d/provision\&.conf, see
94 \fBtmpfiles.d\fR(5)\&.
95 .sp
96 Added in version 252\&.
97 .RE
98 .PP
99 \fInetwork\&.hosts\fR
100 .RS 4
101 The data of this credential is written to
102 /etc/hosts, if the file does not exist yet\&. See
103 \fBhosts\fR(5)
104 for details\&.
105 .sp
106 Consumed by
107 /usr/lib/tmpfiles\&.d/provision\&.conf, see
108 \fBtmpfiles.d\fR(5)\&.
109 .sp
110 Added in version 252\&.
111 .RE
112 .PP
113 \fInetwork\&.dns\fR, \fInetwork\&.search_domains\fR
114 .RS 4
115 DNS server information and search domains\&. Read by
116 \fBsystemd-resolved.service\fR(8)\&.
117 .sp
118 Added in version 253\&.
119 .RE
120 .PP
121 \fInetwork\&.conf\&.*\fR, \fInetwork\&.link\&.*\fR, \fInetwork\&.netdev\&.*\fR, \fInetwork\&.network\&.*\fR
122 .RS 4
123 Configures network devices\&. Read by
124 \fBsystemd-network-generator.service\fR(8)\&. These credentials should contain valid
125 \fBnetworkd.conf\fR(5),
126 \fBsystemd.link\fR(5),
127 \fBsystemd.netdev\fR(5),
128 \fBsystemd.network\fR(5)
129 configuration data\&. From each matching credential a separate file is created\&. Example: the contents of a credential
130 network\&.link\&.50\-foobar
131 will be copied into a file
132 50\-foobar\&.link\&.
133 .sp
134 Note that the resulting files are created world\-readable, it is hence recommended to not include secrets in these credentials, but supply them via separate credentials directly to
135 systemd\-networkd\&.service, e\&.g\&.
136 \fInetwork\&.wireguard\&.*\fR
137 as described below\&.
138 .sp
139 Added in version 256\&.
140 .RE
141 .PP
142 \fInetwork\&.wireguard\&.*\fR
143 .RS 4
144 Configures secrets for WireGuard netdevs\&. Read by
145 \fBsystemd-networkd.service\fR(8)\&. For more information, refer to the
146 \fB[WireGuard]\fR
147 section of
148 \fBsystemd.netdev\fR(5)\&.
149 .sp
150 Added in version 256\&.
151 .RE
152 .PP
153 \fIpasswd\&.hashed\-password\&.root\fR, \fIpasswd\&.plaintext\-password\&.root\fR
154 .RS 4
155 May contain the password (either in UNIX hashed format, or in plaintext) for the root users\&. Read by both
156 \fBsystemd-firstboot\fR(1)
157 and
158 \fBsystemd-sysusers\fR(8), and only honoured if no root password has been configured before\&.
159 .sp
160 Added in version 252\&.
161 .RE
162 .PP
163 \fIpasswd\&.shell\&.root\fR
164 .RS 4
165 The path to the shell program (e\&.g\&.
166 "/bin/bash") for the root user\&. Read by both
167 \fBsystemd-firstboot\fR(1)
168 and
169 \fBsystemd-sysusers\fR(8), and only honoured if no root shell has been configured before\&.
170 .sp
171 Added in version 252\&.
172 .RE
173 .PP
174 \fIssh\&.ephemeral\-authorized_keys\-all\fR
175 .RS 4
176 Provides additional public keys, given in the customary
177 authorized_keys
178 format, for all users, for incoming connections via the generated
179 \fBAF_VSOCK\fR
180 and
181 \fBAF_UNIX\fR
182 socket units\&.
183 .sp
184 The intended use of this is for a host system (in either VM or container configurations) to generate a keypair and inject the public key into the guest, using the private key to connect to any user account on the guest via ssh, without further authentication\&.
185 .sp
186 Consumed by
187 \fBsystemd-ssh-generator\fR(8)\&.
188 .sp
189 Added in version 256\&.
190 .RE
191 .PP
192 \fIssh\&.authorized_keys\&.root\fR
193 .RS 4
194 The data of this credential is written to
195 /root/\&.ssh/authorized_keys, if the file does not exist yet\&. This allows provisioning SSH access for the system\*(Aqs root user\&.
196 .sp
197 Consumed by
198 /usr/lib/tmpfiles\&.d/provision\&.conf, see
199 \fBtmpfiles.d\fR(5)\&.
200 .sp
201 Added in version 252\&.
202 .RE
203 .PP
204 \fIssh\&.listen\fR
205 .RS 4
206 May be used to configure SSH sockets the system shall be reachable on\&. See
207 \fBsystemd-ssh-generator\fR(8)
208 for details\&.
209 .sp
210 Added in version 256\&.
211 .RE
212 .PP
213 \fIsysusers\&.extra\fR
214 .RS 4
215 Additional
216 \fBsysusers.d\fR(5)
217 lines to process during boot\&.
218 .sp
219 Added in version 252\&.
220 .RE
221 .PP
222 \fIsysctl\&.extra\fR
223 .RS 4
224 Additional
225 \fBsysctl.d\fR(5)
226 lines to process during boot\&.
227 .sp
228 Added in version 252\&.
229 .RE
230 .PP
231 \fItmpfiles\&.extra\fR
232 .RS 4
233 Additional
234 \fBtmpfiles.d\fR(5)
235 lines to process during boot\&.
236 .sp
237 Added in version 252\&.
238 .RE
239 .PP
240 \fIfstab\&.extra\fR
241 .RS 4
242 Additional mounts to establish at boot\&. For details, see
243 \fBsystemd-fstab-generator\fR(8)\&.
244 .sp
245 Added in version 254\&.
246 .RE
247 .PP
248 \fIvconsole\&.keymap\fR, \fIvconsole\&.keymap_toggle\fR, \fIvconsole\&.font\fR, \fIvconsole\&.font_map\fR, \fIvconsole\&.font_unimap\fR
249 .RS 4
250 Console settings to apply, see
251 \fBsystemd-vconsole-setup.service\fR(8)
252 for details\&.
253 .sp
254 Added in version 253\&.
255 .RE
256 .PP
257 \fIgetty\&.ttys\&.serial\fR, \fIgetty\&.ttys\&.container\fR
258 .RS 4
259 Used for spawning additional login prompts, see
260 \fBsystemd-getty-generator\fR(8)
261 for details\&.
262 .sp
263 Added in version 254\&.
264 .RE
265 .PP
266 \fIjournal\&.forward_to_socket\fR
267 .RS 4
268 Used by
269 \fBsystemd-journald\fR(8)
270 to determine where to forward log messages for socket forwarding, see
271 \fBjournald.conf\fR(5)
272 for details\&.
273 .sp
274 Added in version 256\&.
275 .RE
276 .PP
277 \fIjournal\&.storage\fR
278 .RS 4
279 Used by
280 \fBsystemd-journald\fR(8)
281 to determine where to store journal files, see
282 \fBjournald.conf\fR(5)
283 for details\&.
284 .sp
285 Added in version 256\&.
286 .RE
287 .PP
288 \fIvmm\&.notify_socket\fR
289 .RS 4
290 Configures an
291 \fBsd_notify\fR(3)
292 compatible
293 \fBAF_VSOCK\fR
294 socket the service manager will report status information, ready notification and exit status on\&. For details see
295 \fBsystemd\fR(1)\&.
296 .sp
297 Added in version 253\&.
298 .RE
299 .PP
300 \fIshell\&.prompt\&.prefix\fR, \fIshell\&.prompt\&.suffix\fR
301 .RS 4
302 Defines strings to prefix and suffix any interactive UNIX shell prompt with\&. For details see
303 \fBpam_systemd\fR(8)\&.
304 .sp
305 Added in version 257\&.
306 .RE
307 .PP
308 \fIshell\&.welcome\fR
309 .RS 4
310 Define a string to print when an interactive UNIX shell initializes\&. For details see
311 \fBpam_systemd\fR(8)\&.
312 .sp
313 Added in version 257\&.
314 .RE
315 .PP
316 \fIsystem\&.machine_id\fR
317 .RS 4
318 Takes a 128bit ID to initialize the machine ID from (if it is not set yet)\&. Interpreted by the service manager (PID 1)\&. For details see
319 \fBsystemd\fR(1)\&.
320 .sp
321 Added in version 254\&.
322 .RE
323 .PP
324 \fIsystem\&.hostname\fR
325 .RS 4
326 Accepts a (transient) hostname to configure during early boot\&. The static hostname specified in
327 /etc/hostname, if configured, takes precedence over this setting\&. Interpreted by the service manager (PID 1)\&. For details see
328 \fBsystemd\fR(1)\&.
329 .sp
330 Added in version 254\&.
331 .RE
332 .PP
333 \fIhome\&.create\&.*\fR
334 .RS 4
335 Creates a home area for the specified user with the user record data passed in\&. For details see
336 \fBhomectl\fR(1)\&.
337 .sp
338 Added in version 256\&.
339 .RE
340 .PP
341 \fIcryptsetup\&.passphrase\fR, \fIcryptsetup\&.tpm2\-pin\fR, \fIcryptsetup\&.fido2\-pin\fR, \fIcryptsetup\&.pkcs11\-pin\fR, \fIcryptsetup\&.luks2\-pin\fR
342 .RS 4
343 Specifies the passphrase/PINs to use for unlock encrypted storage volumes\&. For details see
344 \fBsystemd-cryptsetup\fR(8)\&.
345 .sp
346 Added in version 256\&.
347 .RE
348 .PP
349 \fIsystemd\&.extra\-unit\&.*\fR, \fIsystemd\&.unit\-dropin\&.*\fR
350 .RS 4
351 These credentials specify extra units and drop\-ins to add to the system\&. For details see
352 \fBsystemd-debug-generator\fR(8)\&.
353 .sp
354 Added in version 256\&.
355 .RE
356 .PP
357 \fIudev\&.conf\&.*\fR, \fIudev\&.rules\&.*\fR
358 .RS 4
359 Configures udev configuration file and udev rules\&. Read by
360 systemd\-udev\-load\-credentials\&.service, which invokes
361 \fBudevadm control \-\-load\-credentials\fR\&. These credentials directly translate to a matching
362 \fBudev.conf\fR(5)
363 or
364 \fBudev\fR(7)
365 rules file\&. Example: the contents of a credential
366 udev\&.conf\&.50\-foobar
367 will be copied into a file
368 /run/udev/udev\&.conf\&.d/50\-foobar\&.conf, and
369 udev\&.rules\&.50\-foobar
370 will be copied into a file
371 /run/udev/rules\&.d/50\-foobar\&.rules\&. See
372 \fBudev\fR(7),
373 \fBudev.conf\fR(5), and
374 \fBudevadm\fR(8)
375 for details\&.
376 .sp
377 Added in version 256\&.
378 .RE
379 .PP
380 \fIimport\&.pull\fR
381 .RS 4
382 Specified disk images (tarballs and DDIs) to automatically download and install at boot\&. For details see
383 \fBsystemd-import-generator\fR(8)\&.
384 .sp
385 Added in version 257\&.
386 .RE
387 .SH "SEE ALSO"
388 .PP
389 \fBsystemd\fR(1), \fBkernel-command-line\fR(7), \fBsmbios-type-11\fR(7)
390 .SH "NOTES"
391 .IP " 1." 4
392 System and Service Credentials
393 .RS 4
394 \%https://systemd.io/CREDENTIALS
395 .RE