Skip to content
Yoann Gini edited this page Apr 21, 2020 · 6 revisions

Function description

Introduced in Hello IT 1.3

Goal

This function is used to display the delay in days before the Active Directory password informations. It will also display a notification to push the user to change the password when needed. This feature come as a complement to the loginwindow built-in feature allowing the password alert to be seen by the user even if the session stay open all the time.

Settings

The settings dictionary contain all informations you can set to use this function. Here is a description of each.

Key Type Description
alertXDaysBefore Integer Number of days before the expiration to display the alert, default value is 15
repeat Integer Seconds between each check
willExpireFormat String Item title with %l representing the number of days before password expiration (like "🔐 %l 📆")
neverExpireInfo String Message used to inform the user for a password with no expiration date
optionalDisplay Boolean Will show the related item only if option key was pressed when Hello-IT menu was shown (supported in Hello-IT 1.4.0+)
tooltip String message to show when the mouse is over the item
offlineTooltip String message to show when the mouse is over the item and the AD isn't reachable
notificationTitle String Notification's title when password change will soon be mandatory
notificationMessageFormat String Notification's message when password change will soon be mandatory
notificationOfflineMessageFormat String Notification's message when password change will soon be mandatory but AD isn't reachable
notificationChangePasswordTitle String Notification's label for the button that will lead the user to the password change
notificationLaterTitle String Notification's label for the button that will dismiss the notification for now

Sample settings

<dict>
	<key>functionIdentifier</key>
	<string>public.ad.pass</string>
	<key>settings</key>
	<dict>
		<key>alertXDaysBefore</key>
		<integer>60</integer>
		<key>repeat</key>
		<integer>3600</integer>
	</dict>
</dict>

More informations

Main implementation

The main implementation of this function is made in the ADPAss plugin from the main project.