Changes between Version 1 and Version 2 of campuswifiandeduroam2023Agenda/pwden

Timestamp:

Jul 24, 2024, 5:19:27 PM (8 weeks ago)

Author:

tuwan

Comment:

--

campuswifiandeduroam2023Agenda/pwden

@@ -172 +172 @@
 rm -rf ${tmp_dir}
 rm -rf ${tmp_dir_stats}
-exit 0}}}
+exit 0
+}}}
+
+'''The Script Requirements'''
+
+As outlined on the LTB page, the script requires;
+
+- gawk (GNU awk) (which gawk)
+- ldapsearch (which ldapsearch)
+- mailx (provides mail command, which mailx)
+- date (which date)
+
+which utility enables you to check if the command is installed and the full path to its location.
+
+'''The Script Variables'''
+
+Also, update the following variables on the script accordingly.
+
+- MY_LDAP_HOSTURI: LDAP URI
+- MY_LDAP_ROOTDN (optional): DN to use to bind. No DN means anonymous
+- MY_LDAP_ROOTPW: Password
+- MY_LDAP_DEFAULTPWDPOLICYDN: Default password policy DN. Do not set if no default policy is used. In this case, the script will only affect users with password policy in their entry (pwdPolicySubentry)
+- MY_LDAP_SEARCHBASE: Users search base
+- MY_LDAP_SEARCHFILTER: Users search filter
+- MY_LDAP_SEARCHBIN: Path to ldapsearch binary
+- MY_MAIL_DELAY: Time before expiration where a mail is sent. No mail sent after expiration. If no value, the script will take the pwdExpireWarning of the password policy
+- MY_LDAP_NAME_ATTR: attribute containing user’s name
+- MY_LDAP_LOGIN_ATTR: attribute containing user’s login
+- MY_LDAP_MAIL_ATTR:attribute containing user’s name
+- MY_MAIL_BODY: message body
+- MY_MAIL_SUBJECT: message subject
+- MY_MAIL_BIN: mail binary
+- MY_LOG_HEADER: log header
+- MY_GAWK_BIN: path to gawk binary
+
+'''Sample LDAP User entry'''
+
+Below is our sample OpenLDAP user entry. Note the following attributes;
+
+- MY_LDAP_NAME_ATTR=cn
+- MY_LDAP_LOGIN_ATTR=uid
+- MY_LDAP_MAIL_ATTR=mail
+
+{{{
+ldapsearch -Y EXTERNAL -H ldapi:/// -s one -b "ou=people,dc=ldapmaster,dc=kifarunix-demo,dc=com" -LLL -Q uid=janedoe 
+}}}
+
+{{{
+dn: uid=janedoe,ou=people,dc=ldapmaster,dc=kifarunix-demo,dc=com
+objectClass: inetOrgPerson
+objectClass: posixAccount
+objectClass: shadowAccount
+objectClass: extensibleObject
+uid: janedoe
+cn: Jane
+sn: Doe
+loginShell: /bin/bash
+uidNumber: 10010
+gidNumber: 10010
+homeDirectory: /home/janedoe
+shadowMax: 60
+shadowMin: 1
+shadowWarning: 7
+shadowInactive: 7
+shadowLastChange: 0
+userPassword:: e1NTSEF9dmczUGpBa0EybUtOanJ4QWc1dWN5d20wNnlmOGg4cE8=
+mail: janedoe@kifarunix-demo.com
+}}}
+
+'''Testing the LDAP Password Expiration Notification Script'''
+
+To check the script can get us what is expected of it, simply execute it on the LDAP server as follows;
+
+{{{
+bash checkLdapPwdExpiration.sh
+}}}
+
+Our script writes output to, /tmp/ldap-password-stats, file.
+
+{{{
+cat /tmp/ldap-password-stats
+}}}
+
+{{{
+Hello Admin,
+Find the LDAP users account password expiry status as Jun 13,2020 21:19:18.
+
+Password warning for janedoe (expiry date, Thursday 18, June 2020 at 11:12:37). Mail sent to janedoe@kifarunix-demo.com
+Password expired for koromicha on Friday 08, May 2020 at 21:34:02. Mail sent to koromicha@kifarunix-demo.com
+No password change date for johndoe (johndoe@kifarunix-demo.com)
+
+===== Statistics =====
+Total User Accounts checked: 4
+Accounts with Expired Passwords: 1
+Accounts with Passwords in Warning state: 1
+}}}
+
+From the output above, we can see that;
+
+- A total of fours users, in the directory, were checked.
+- Password for user koromicha, has expired on Friday 08, May 2020 at 21:34:02. Notification email sent to user.
+- Password for the user, janedoe, will expire on Thursday 18, June 2020 at 11:12:37. Notification email sent to user.
+- No password change date for johndoe (johndoe@kifarunix-demo.com)
+
+Since we do not have any mail utility installed, you may get such an output;
+
+{{{
+mail: command not found
+}}}
+
+'''Configure your LDAP Server to Send Mails'''
+
+In order for your OpenLDAP server to be able to send mails out, you need to have an MTA installed and configured. If you noticed above, the script tried use sendmail. In this demo, we will be using postfix instead.
+
+{{{
+sudo apt install postfix
+}}}
+
+{{{
+vim /etc/postfix/main.cf
+}}}
+
+Make the following adjustments;
+
+{{{
+myhostname = ldap.kifarunix-demo.com
+inet_protocols = ipv4 (or all)
+relayhost = [smtp.gmail.com]:587
+smtp_use_tls = yes
+smtp_sasl_auth_enable
+smtp_sasl_password_maps = hash:/etc/postfix/sasl_passwd
+smtp_sasl_security_options = noanonymous
+}}}
+
+Save and exit the configuration.
+
+Enter the authentication credentials on the file, /etc/postfix/sasl_passwd in the format;
+
+{{{
+[smtp.gmail.com]:587 userid@gmail:password
+}}}
+
+Hash the credentials file.
+
+{{{
+postmap /etc/postfix/sasl_passwd
+}}}
+
+Set the proper permissions on the credentials file,
+
+{{{
+chown root:postfix /etc/postfix/sasl_passwd*
+chmod 640 /etc/postfix/sasl_passwd*
+}}}
+
+Start the Postfix configuration.
+
+{{{
+systemctl enable --now postfix
+}}}
+
+'''Test Email Delivery'''
+
+{{{
+echo "Test Postfix gmail relay" | mail -s "Test postfix gmail relay" admin@kifarunix-demo.com
+}}}
+
+Check the logs.
+
+{{{
+tail /var/log/maillog
+}}}
+
+If you see this line, all is well;
+
+{{{
+...to=admin@kifarunix-demo.com, relay=smtp.gmail.com[74.125.133.108]:587, ...status=sent (250 2.0.0 OK ..
+}}}
+
+Once the email relay configuration is done, rerun the script.
+
+{{{
+bash checkLdapPwdExpiration.sh
+}}}
+
+Check the administrator inbox, which in this demo is set to, admin@kifarunix-demo.com, and the inbox for the user whose password is in warning state, janedoe@kifarunix-demo.com.
+
+On Admin Mailbox, this is the email from LDAP;
+
+{{{
+Subject: LDAP Password Expiration Status
+
+Hello Admin,
+Find the LDAP users account password expiry status as Jun 13,2020 21:31:11.
+
+Password warning for janedoe (expiry date, Thursday 18, June 2020 at 11:12:37). Mail sent to janedoe@kifarunix-demo.com
+Password expired for koromicha on Friday 08, May 2020 at 21:34:02. Mail sent to koromicha@kifarunix-demo.com
+No password change date for johndoe (johndoe@kifarunix-demo.com)
+
+===== Statistics =====
+Total User Accounts checked: 4
+Accounts with Expired Passwords: 1
+Accounts with Passwords in Warning state: 1
+}}}
+
+On the User’s inbox (Janedoe and Koromicha in this case);
+
+{{{
+Subject: LDAP Account Password Expiry Status
+
+Hi jane,
+
+ Your password will expire in 4 days on Thursday 18, June 2020 at 11:12:37.
+
+ Visit Kifarunix-demo Self Service Password site, https://ldap-ssp.kifarunix-demo.com to reset your password.
+
+ As a reminder, ensure that your password conforms to the company outlined password policies.
+
+ Kifarunix-demo IT team,
+ Regards.
+}}}
+
+{{{
+Subject: LDAP Account Password Expiry Status
+
+Hi koromicha,
+
+ Your password expired on Friday 08, May 2020 at 21:34:02.
+
+ Kindly contact Kifarunix-demo IT team to help reset the password.
+
+ Kifarunix-demo IT team,
+ Regards.
+}}}
+
+And there you go. You are now receiving the status of the LDAP accounts password expiry as the administrator. At the same time, users whose passwords are yet to expire are notified via their respective emails as defined on their LDAP entries. We hope that was informative.
+
+'''Create Daily Cron Job for the Script'''
+
+To ensure that the script is executed regularly, all you need to do is to create a cron job to execute the script at a specific regular time and have the LDAP accounts passwords status sent to users.
+
+Before you can install a cron job, ensure that the script is executable.
+
+{{{
+chmod +x /home/kifarunix/checkLdapPwdExpiration.sh
+}}}
+
+To install a cron job, run the command below;
+
+{{{
+crontab -e
+}}}
+
+Enter the line below, to have the script executed every day from Monday-Friday at 0800 hrs.
+
+{{{
+0 8 * * 1-5 /home/kifarunix/checkLdapPwdExpiration.sh
+}}}
+
+That marks the end of our guide on how to send OpenLDAP password expiry notifications via email.
+