Configuring Mail (and Slack) for SSH Login Notifications
This is the final part of four in a series of articles about Linux system security.
- Text Processing Tools in UNIX
- Parsing SSH Logs
- Configuring fail2ban
- Configuring mail (and Slack) for SSH Login Notifications
This part will focus on configuring notifications on system login.
Why Login Notifications?
After configuring fail2ban with SSH key-based or two factor authentication login, a system is pretty secure. Random offenders are banned after too many failed login attempts, accounts require a complex key or token.
The paranoid part of me just wants a little more book keeping so I keep track of when I logged in, especially on a dedicated system that I am the only one using.
For example, if an intruder does gain access to the system, there is no way of knowing until I notice something is funny, if I look for it, or the intruder does something stupid.
An easy way to keep track if an intruder has gained access: have a notification sent on every successful login, even for myself.
If I get a login notification and I did not login, I immediately know something is wrong and take immediate action.
Approach for Mail Notifications
The way I will develop notifications on login: on successful PAM authorization, send an email using a script.
To accomplish this, these are the steps I took on a new Linux system:
- Install mailutils
- Create script for
- Modify PAM to execute script
- Add in info from PAM variables to the email
mailutils includes a simple mail program, called
Other UNIX mail programs can work, like
sendmail, the important part
is to be able to email from a prompt or script.
Now, to send message from command prompt using
Check your inbox and the spam folder as well.
Now, putting this command into a script so any program can use it,
Make sure the script has executable permissions:
To run the script:
The result is the same as the command prompt execution, emails from a command prompt!
Send email on login
With a script to send email, let’s configure PAM, the Pluggable Authentication Module, to call the script on any SSH activiy:
In PAM’s SSH configuration file:
/etc/pam.d/sshd, add this line at
the bottom of the file:
optional keyword is very important here as PAM will still allow
login, even if the email script fails.
The other value allowed is:
required, which will always execute the
script on login. If the script fails when the setting is
login will fail, even with proper login authentication.
Logout of the system and login again to verify email notifications are being sent.
Enhanced PAM script
Now basic emails are being sent upon any PAM SSH activity. Let’s make the email script to only email upon successful login and use some of the environment variables set by PAM when it is executing the script.
send_email.sh script to become:
I originally found this script from here
This script will email only upon successful logins and include some nice details:
sshd login on ip-127-31-49-100 for account ubuntu
User: ubuntu Remote Host: mf52436d1.tmodns.net Service: sshd TTY: ssh Date: Tue Mar 7 07:49:15 EST 2017 Server: Linux ip-127-31-49-100 3.13.0-100-generic #147-Ubuntu SMP Tue Oct 18 16:48:51 UTC 2016 x86_64 GNU/Linux
Having login notifications sent to a messaging service such as Slack
is also possible. Slack supports messages to be posted from the
command prompt using
curl with a properly configured Incoming
Approach Slack Notifications
The approach to set up login notifications on Slack:
- configure Slack to accept external messages
- send Slack message from command prompt
- put Slack message command into a script
- have PAM also execute the script on SSH activity
- update script to include PAM variables
Configure Slack for External Messages
Note: For this, one needs to be able to add an integration to a Slack.
Go to this page to add an Incoming Webhook to your Slack and send a message privately to yourself.
Send Slack Message from Command Prompt
There will be an example
curl command in the Example section of
the page, which will look like:
Run this to ensure messages are going from the command prompt to the #general room in your slack (magical, isn’t it?!)
Pare down the script to only send message to yourself:
Message Slack from Script
Let’s put this into a script,
Running at the command prompt:
Will put a message into your private slack. Great, isn’t it?
Configure PAM to Send Slack Notifications
Add this script to also be executable by PAM:
Logout and login again to check.
Now your private slack channel will receive a message on any PAM SSH activity. Yay!
Adjust Slack Script with PAM Variables
Let’s fine tune the script and make it better suited for SSH logins and include some PAM variables:
post_to_slack function originally from
Now, wherever there is Slack, there can be notifications:
Pretty handy! :-)
Adding a simple email script upon successful login is a great way to keep track of server logins (and notice when oneself did not login!)
mailutils and sending an email on successful PAM authorization
is easy to configure, hooking up scripts together.
With the ability to post login messages to slack ensures any system administrator is always on top of who is logging in or out of their system at any time.