macOS - Tray Notification - Customize Trusted Message

What the tray notification customizer does

This Automox Worklet™ configures custom branding text for the Automox agent UI notifications on macOS endpoints. The Worklet uses the amagent command-line tool to apply your custom message, which then appears in the notification footer when the agent displays system notifications to users.

The Worklet verifies that the Automox agent tray application is installed at /Library/Application Support/Automox/agent-ui.app or /Library/Application Support/Automox/agent-ui before proceeding. Once the tray is confirmed present, the Worklet executes amagent notifications set_branding_message with your specified text parameter. The character limit for branding text is 75 characters, and the Worklet enforces this constraint.

Your custom branding message replaces the default "Managed by your IT Administrators" text, allowing you to display your organization's name, department messaging, or support contact information directly in user-visible notifications.

Why customize agent notification messaging

Generic Automox agent notifications displaying default text like "Managed by your IT Administrators" create confusion for users who need to contact support about updates or compliance actions, particularly in multi-tenant environments or organizations with distributed IT teams where users cannot identify which team manages their endpoint. This lack of context leads to misdirected support requests, users dismissing critical notifications, or questioning legitimate management activities because the messaging lacks organizational identity. This Automox Worklet customizes the notification footer with your company name, department identity, or support contact information, providing immediate IT team recognition that reduces support confusion, strengthens brand consistency across your fleet, and reinforces your security posture by clearly identifying authorized endpoint management sources.

How notification customization works

1. Evaluation phase: The Worklet checks whether the Automox agent tray application is installed on the endpoint by verifying the presence of either /Library/Application Support/Automox/agent-ui.app or /Library/Application Support/Automox/agent-ui. If the tray directory exists, remediation proceeds. If the agent tray is not installed, the Worklet exits without making changes.

2. Remediation phase: The Worklet locates the amagent executable at /usr/local/bin/amagent and verifies it exists before executing. It then runs amagent notifications set_branding_message with your custom branding text parameter. If the command succeeds, the notification footer text is immediately updated. If the amagent command fails or returns an error, the Worklet reports the failure with the exit code and error details.

Tray notification customization requirements

• macOS 10.12 (Sierra) or later

• Automox agent installed with tray UI enabled at /Library/Application Support/Automox/agent-ui

• amagent command-line tool available at /usr/local/bin/amagent

• Bash shell availability for script execution

• Custom branding text must not exceed 75 characters

• FixNow enabled in the Automox console for immediate deployment

Expected notification messaging state

After successful remediation, you can expect these specific outcomes:

• All Automox agent notifications will display your custom branding text in the footer

• The custom text will appear for updates, compliance checks, remediation actions, and other agent events

• The branding persists across agent updates unless explicitly changed

• You can verify by triggering a test notification or checking Worklet logs for "Successfully set branding text" message

How to validate customize trusted message changes

1. Run this Worklet on a pilot macOS endpoint and review evaluation output for customize trusted message.

2. Confirm Automox activity logs show successful completion and exit code 0.

3. Verify endpoint state using checks aligned to evaluation script logic, such as exit, else.

4. Validate remediation effects from script operations such as set_amagent_branding_text, local, return, then rerun evaluation for compliance.