summaryrefslogtreecommitdiff
path: root/contrib
diff options
context:
space:
mode:
authorJakob Unterwurzacher2016-10-08 18:12:09 +0200
committerJakob Unterwurzacher2016-10-08 22:30:19 +0200
commit22f96bfce63249870a5c068c27a58ec90a4fee22 (patch)
tree2ff8bdfca110b972ecb4a3475b4d70045b8f1c61 /contrib
parent610a242ec6429436b37b47dd357b0c777c620d65 (diff)
contrib: pam_mount: add instructions for whole-home-dir encryption
Diffstat (limited to 'contrib')
-rw-r--r--contrib/pam_mount/README.md18
1 files changed, 17 insertions, 1 deletions
diff --git a/contrib/pam_mount/README.md b/contrib/pam_mount/README.md
index 9a64869..8b87f71 100644
--- a/contrib/pam_mount/README.md
+++ b/contrib/pam_mount/README.md
@@ -31,6 +31,8 @@ path="/usr/local/bin/gocryptfs_pam_mount.bash#/home/%(USER)/cipher"
mountpoint="/home/%(USER)/plain" />
```
+Replace `testuser` with your user name.
+
If you want to disable the display of the masterkey on mount, replace
`options="defaults"` with `options="quiet"`.
@@ -39,7 +41,8 @@ PAM config
An example `/etc/pam.d/login` on Fedora 24 is shown below. pam_mount
MUST be called AFTER `pam_selinux.so open` because that puts us in the
-right SELinux context.
+right SELinux context. If are logging in via gcm, also add the line in
+`/etc/pam.d/gdm-password`.
```
#%PAM-1.0
@@ -61,3 +64,16 @@ session include system-auth
session include postlogin
-session optional pam_ck_connector.so
```
+
+Encrypting the whole home directory
+-----------------------------------
+
+Use this volume definition in `/etc/security/pam_mount.conf.xml`:
+
+```
+<volume user="testuser-whole-home" fstype="fuse" options="nonempty,allow_other"
+path="/usr/local/bin/gocryptfs_pam_mount.bash#/home/%(USER).cipher"
+mountpoint="/home/%(USER)" />
+```
+
+Replace `testuser-whole-home` with your user name.