Skip to content

Commit

Permalink
Update install notes about the BSDs.
Browse files Browse the repository at this point in the history
  • Loading branch information
divVerent committed Sep 27, 2018
1 parent a5bccb7 commit 2789d16
Showing 1 changed file with 27 additions and 1 deletion.
28 changes: 27 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,9 +51,35 @@ cd xsecurelock
sh autogen.sh
./configure --with-pam-service-name=SERVICE-NAME
make
make install
sudo make install
```

## Special notes for FreeBSD

On FreeBSD, in order to authenticate with PAM, you must be root so you can read
the shadow password database. The `authproto_pam` binary can be made to acquire
these required privileges like this:

```
chmod +s /usr/local/libexec/xsecurelock/authproto_pam
```

## Special notes for OpenBSD

On OpenBSD, in order to authenticate with PAM, you must be in the `auth` group
so you can run a setuid helper called `login_passwd` that can read the shadow
password database. The `authproto_pam` binary can be made to acquire these
required privileges like this:

```
chgrp auth /usr/local/libexec/xsecurelock/authproto_pam
chmod g+s /usr/local/libexec/xsecurelock/authproto_pam
```

Note that this adds substantially less attack surface than adding your own user
to the `auth` group, as the `login_passwd` binary can try out passwords of any
user, while `authproto_pam` is restricted to trying your own user.

# Setup

Pick one of the [authentication modules](#authentication-modules) and one of the
Expand Down

0 comments on commit 2789d16

Please sign in to comment.