summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorpbuetow <35781042+pbuetow@users.noreply.github.com>2020-02-08 18:47:15 +0000
committerGitHub <noreply@github.com>2020-02-08 18:47:15 +0000
commitca28ba95a74706ad3620f6a1980db45c1a92ad4a (patch)
tree03c0a302b006aa08a63d986fdabcb3810ddc48aa
parent80867e437900ae995175d108c593059525e650e6 (diff)
parent95bae52787162b869ecb021e2bbc841bb8b6a65c (diff)
Merge pull request #9 from snonux/master
add systemd update keycache timer example
-rw-r--r--doc/installation.md20
-rw-r--r--samples/dserver-update-keycache.service.sample6
-rw-r--r--samples/dserver-update-keycache.timer.sample5
3 files changed, 28 insertions, 3 deletions
diff --git a/doc/installation.md b/doc/installation.md
index 8781130..6e2c8cc 100644
--- a/doc/installation.md
+++ b/doc/installation.md
@@ -38,14 +38,14 @@ uid=670(dserver) gid=670(dserver) groups=670(dserver)
```console
% sudo mkdir /etc/dserver
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dtail.json.sample |
- sudo tee /etc/dserver/dtail.json >/dev/null
+ sudo tee /etc/dserver/dtail.json
```
5. It is recommended to configure DTail server as a service to ``systemd``. An example unit file for ``systemd`` can be found [here](../samples/dserver.service.sample).
```console
% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dserver.service.sample |
- sudo tee /etc/systemd/system/dserver.service >/dev/null
+ sudo tee /etc/systemd/system/dserver.service
% sudo systemctl daemon-reload
% sudo systemctl enable dserver
```
@@ -77,7 +77,21 @@ To start the DTail server via ``systemd`` run:
The DTail server now runs as a ``systemd`` service under system user ``dserver``. The system user ``dserver`` however has no permissions to read the SSH public keys from ``/home/USER/.ssh/authorized_keys``. Therefore, no user would be able to establish a SSH session to DTail server. As an alternative path DTail server also checks for public SSH key files in ``/var/run/dserver/cache/USER.authorized_keys``.
-It is recommended to execute [update_key_cache.sh](../samples/update_key_cache.sh.sample) periodically to update the key cache. In case you manage your public SSH keys via Puppet you could subscribe the script to corresponding module. Or alternatively just configure a cron job to run every once in a while.
+It is recommended to execute [update_key_cache.sh](../samples/update_key_cache.sh.sample) periodically to update the key cache. In case you manage your public SSH keys via Puppet you could subscribe the script to corresponding module. Or alternatively just configure a cron job or a systemd timer to run every once in a while, e.g. every 30 minutes:
+
+```console
+% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/update_key_cache.sh.sample |
+ sudo tee /var/run/dserver/update_key_cache.sh
+% sudo chmod 755 /var/run/dserver/update_key_cache.sh
+% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dserver-update-keycache.service.sample |
+ sudo tee /etc/systemd/system/dserver-update-keycache.service
+% curl https://raw.githubusercontent.com/mimecast/dtail/master/samples/dserver-update-keycache.timer.sample |
+ sudo tee /etc/systemd/system/dserver-update-keycache.timer
+% sudo systemctl daemon-reload
+% sudo systemctl start dserver-update-keycache.service
+% sudo systemctl enable dserver-update-keycache.timer
+% sudo systemctl start dserver-update-keycache.timer
+```
# Run DTail client
diff --git a/samples/dserver-update-keycache.service.sample b/samples/dserver-update-keycache.service.sample
new file mode 100644
index 0000000..7e6144c
--- /dev/null
+++ b/samples/dserver-update-keycache.service.sample
@@ -0,0 +1,6 @@
+[Unit]
+Description=Refresh DServer SSH Key Cache
+
+[Service]
+Type=oneshot
+ExecStart=/var/run/dserver/update_key_cache.sh
diff --git a/samples/dserver-update-keycache.timer.sample b/samples/dserver-update-keycache.timer.sample
new file mode 100644
index 0000000..e7158ca
--- /dev/null
+++ b/samples/dserver-update-keycache.timer.sample
@@ -0,0 +1,5 @@
+[Unit]
+Description=Refresh DServer SSH Key Cache every 30 minutes.
+
+[Timer]
+OnCalendar=*:0/30