Mac OS X Login Agent:

ADSelfService Plus login agent for Mac OS X lets Active Directory domain users using Mac clients to reset their passwords and unlock their accounts from the OS X login screen itself. Please follow the steps given below to deploy the password self-service login agent to Mac clients:

Note: The ADSelfService Plus login agent for Mac supports clients running OS X 10.6 and above.

Installation Steps:

1. Locate the Mac OS X login agent for password self-service in ADSelfService Plus installation folder. It can be found at <install_dir>/bin/ADSelfServicePlusMacLoginAgent.pkg.

2. Copy the ADSelfServicePlusMacLoginAgent.pkg file to the Mac clients.

3. Double-click the ADSelfServicePlusMacLoginAgent.pkg file to begin the installation process.

4. In the Introduction window, click Continue



5. In the Installation Type window, select the install location and click Install.



6. After you click the Install button you will be asked to enter your username and password. Please use the account information you used to log on to your Mac.



7. Enter the ADSelfService Plus server name and port number when prompted





8. In the Summary window, click Close to complete the installation.



9. Once the installation is complete, a Reset Password/Unlock Account button will appear on the login screen.

Customization Steps:

This section describes how to customize the various features of the ADSelfService Plus's Mac OS X login agent. Features such as Server Name, Port Number, Button Text & Icon can be customized by editing the file config.plist stored in /Library/Application Support/ADSSPLoginAgent/. Follow the steps below to customize the login agent:

Steps to configure Server Name & Port Number:

1. Open Terminal

2. Run this script to change the server name: sudo /usr/libexec/PlistBuddy -c 'set :SERVERNAME 192.168.43.90' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace 192.168.43.90 with the server name or IP address of ADSelfService Plus server.

3. Please enter the username and password you used to log on to your Mac client when asked for user credentials.

4. Run this script to change the port number: sudo /usr/libexec/PlistBuddy -c 'set :PORTNUMBER 8443' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace 8443 with the port number of ADSelfService Plus.

5. Go to login screen and confirm the changes.

Steps to customize the Icon & Button Text:

1. Open Terminal

2. To change the icon, use this script: sudo /usr/libexec/PlistBuddy -c 'set :IMAGEPATH /Users/testuser/Desktop/sample-icon.png' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace the path to the image with the path to your own icon.

3. Please enter the username and password you used to log on to your Mac client when asked for user credentials.

4. To change the button text(Reset Password/Unlock Account text which will be displayed on the logon screen), use this script: sudo /usr/libexec/PlistBuddy -c 'set :BUTTONTEXT Forgot Password?' "/Library/Application Support/ADSSPLoginAgent/config.plist". Replace Forgot Password? with your own text.

5. Go to login screen and confirm the changes.

Note: In case, the specified icon source is not available default icon will be loaded.

Uninstallation Steps:

1. Open Terminal

2. Open /Library/PrivilegedHelperTools/

3. Del ADSSPLoginAgent

4. Go to login screen and confirm the changes.