1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
'\" t
.TH "NSS\-SYSTEMD" "8" "" "systemd 254" "nss-systemd"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
nss-systemd, libnss_systemd.so.2 \- UNIX user and group name resolution for user/group lookup via Varlink
.SH "SYNOPSIS"
.PP
libnss_systemd\&.so\&.2
.SH "DESCRIPTION"
.PP
\fBnss\-systemd\fR
is a plug\-in module for the GNU Name Service Switch (NSS) functionality of the GNU C Library (\fBglibc\fR), providing UNIX user and group name resolution for services implementing the
\m[blue]\fBUser/Group Record Lookup API via Varlink\fR\m[]\&\s-2\u[1]\d\s+2, such as the system and service manager
\fBsystemd\fR(1)
(for its
\fIDynamicUser=\fR
feature, see
\fBsystemd.exec\fR(5)
for details),
\fBsystemd-homed.service\fR(8), or
\fBsystemd-machined.service\fR(8)\&.
.PP
This module also ensures that the root and nobody users and groups (i\&.e\&. the users/groups with the UIDs/GIDs 0 and 65534) remain resolvable at all times, even if they aren\*(Aqt listed in
/etc/passwd
or
/etc/group, or if these files are missing\&.
.PP
This module preferably utilizes
\fBsystemd-userdbd.service\fR(8)
for resolving users and groups, but also works without the service running\&.
.PP
To activate the NSS module, add
"systemd"
to the lines starting with
"passwd:",
"group:",
"shadow:"
and
"gshadow:"
in
/etc/nsswitch\&.conf\&.
.PP
It is recommended to place
"systemd"
after the
"files"
or
"compat"
entry of the
/etc/nsswitch\&.conf
lines so that
/etc/passwd,
/etc/group,
/etc/shadow
and
/etc/gshadow
based mappings take precedence\&.
.SH "STATIC DROP\-IN JSON USER/GROUP RECORDS"
.PP
Besides user/group records acquired via the aforementioned Varlink IPC interfaces and the synthesized root and nobody accounts, this module also makes user and group accounts available to the system that are defined in static drop\-in files in the
/etc/userdb/,
/run/userdb/,
/run/host/userdb/
and
/usr/lib/userdb/
directories\&.
.PP
This is a simple mechanism to provide static user and group records via JSON drop\-in files\&. Such user records should be defined in the format described by the
\m[blue]\fBJSON User Records\fR\m[]\&\s-2\u[2]\d\s+2
specification and be placed in one of the aforementioned directories under a file name composed of the user name suffixed with
\&.user, with a world\-readable access mode\&. A symlink named after the user record\*(Aqs UID formatted in decimal and suffixed with
\&.user
pointing to the primary record file should be created as well, in order to allow both lookups by username and by UID\&. Privileged user record data (e\&.g\&. hashed UNIX passwords) may optionally be provided as well, in a pair of separate companion files with the
\&.user\-privileged
suffix\&. The data should be stored in a regular file named after the user name, suffixed with
\&.user\-privileged, and a symlink pointing to it, named after the used numeric UID formatted in decimal with the same suffix\&. These companion files should not be readable to anyone but root\&. Example:
.sp
.if n \{\
.RS 4
.\}
.nf
\-rw\-r\-\-r\-\-\&. 1 root root 723 May 10 foobar\&.user
\-rw\-\-\-\-\-\-\-\&. 1 root root 123 May 10 foobar\&.user\-privileged
lrwxrwxrwx\&. 1 root root 19 May 10 4711\&.user \-> foobar\&.user
lrwxrwxrwx\&. 1 root root 19 May 10 4711\&.user\-privileged \-> foobar\&.user\-privileged
.fi
.if n \{\
.RE
.\}
.PP
Similarly, group records following the format described in
\m[blue]\fBJSON Group Record\fR\m[]\&\s-2\u[3]\d\s+2
may be defined, using the file suffixes
\&.group
and
\&.group\-privileged\&.
.PP
The primary user/group record files (i\&.e\&. those with the
\&.user
and
\&.group
suffixes) should not contain the
"privileged"
section as described in the specifications\&. The privileged user/group record files (i\&.e\&. those with the
\&.user\-privileged
and
\&.group\-privileged
suffixes) should contain this section, exclusively\&.
.PP
Note that static user/group records generally do not override conflicting records in
/etc/passwd
or
/etc/group
or other account databases\&. In fact, before dropping in these files a reasonable level of care should be taken to avoid user/group name and UID/GID conflicts\&.
.SH "CONFIGURATION IN /ETC/NSSWITCH\&.CONF"
.PP
Here is an example
/etc/nsswitch\&.conf
file that enables
\fBnss\-systemd\fR
correctly:
.sp
.if n \{\
.RS 4
.\}
.nf
passwd: compat \fBsystemd\fR
group: compat [SUCCESS=merge] \fBsystemd\fR
shadow: compat \fBsystemd\fR
gshadow: files \fBsystemd\fR
hosts: mymachines resolve [!UNAVAIL=return] files myhostname dns
networks: files
protocols: db files
services: db files
ethers: db files
rpc: db files
netgroup: nis
.fi
.if n \{\
.RE
.\}
.SH "EXAMPLE: MAPPINGS PROVIDED BY SYSTEMD\-MACHINED\&.SERVICE"
.PP
The container
"rawhide"
is spawned using
\fBsystemd-nspawn\fR(1):
.sp
.if n \{\
.RS 4
.\}
.nf
# systemd\-nspawn \-M rawhide \-\-boot \-\-network\-veth \-\-private\-users=pick
Spawning container rawhide on /var/lib/machines/rawhide\&.
Selected user namespace base 20119552 and range 65536\&.
\&.\&.\&.
$ machinectl \-\-max\-addresses=3
MACHINE CLASS SERVICE OS VERSION ADDRESSES
rawhide container systemd\-nspawn fedora 30 169\&.254\&.40\&.164 fe80::94aa:3aff:fe7b:d4b9
$ getent passwd vu\-rawhide\-0 vu\-rawhide\-81
vu\-rawhide\-0:*:20119552:65534:vu\-rawhide\-0:/:/usr/sbin/nologin
vu\-rawhide\-81:*:20119633:65534:vu\-rawhide\-81:/:/usr/sbin/nologin
$ getent group vg\-rawhide\-0 vg\-rawhide\-81
vg\-rawhide\-0:*:20119552:
vg\-rawhide\-81:*:20119633:
$ ps \-o user:15,pid,tty,command \-e|grep \*(Aq^vu\-rawhide\*(Aq
vu\-rawhide\-0 692 ? /usr/lib/systemd/systemd
vu\-rawhide\-0 731 ? /usr/lib/systemd/systemd\-journald
vu\-rawhide\-192 734 ? /usr/lib/systemd/systemd\-networkd
vu\-rawhide\-193 738 ? /usr/lib/systemd/systemd\-resolved
vu\-rawhide\-0 742 ? /usr/lib/systemd/systemd\-logind
vu\-rawhide\-81 744 ? /usr/bin/dbus\-daemon \-\-system \-\-address=systemd: \-\-nofork \-\-nopidfile \-\-systemd\-activation \-\-syslog\-only
vu\-rawhide\-0 746 ? /usr/sbin/sshd \-D \&.\&.\&.
vu\-rawhide\-0 752 ? /usr/lib/systemd/systemd \-\-user
vu\-rawhide\-0 753 ? (sd\-pam)
vu\-rawhide\-0 1628 ? login \-\- zbyszek
vu\-rawhide\-1000 1630 ? /usr/lib/systemd/systemd \-\-user
vu\-rawhide\-1000 1631 ? (sd\-pam)
vu\-rawhide\-1000 1637 pts/8 \-zsh
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBsystemd\fR(1),
\fBsystemd.exec\fR(5),
\fBnss-resolve\fR(8),
\fBnss-myhostname\fR(8),
\fBnss-mymachines\fR(8),
\fBsystemd-userdbd.service\fR(8),
\fBsystemd-homed.service\fR(8),
\fBsystemd-machined.service\fR(8),
\fBnsswitch.conf\fR(5),
\fBgetent\fR(1)
.SH "NOTES"
.IP " 1." 4
User/Group Record Lookup API via Varlink
.RS 4
\%https://systemd.io/USER_GROUP_API
.RE
.IP " 2." 4
JSON User Records
.RS 4
\%https://systemd.io/USER_RECORD
.RE
.IP " 3." 4
JSON Group Record
.RS 4
\%https://systemd.io/GROUP_RECORD
.RE
|
