Agent customizations
Overview
This tutorial explains how to apply customized co-branding, login field labels, and in-app messaging to Code42 agents in your Code42 environment.
Considerations
- Managing customization templates requires the Security Administrator role.
Before you begin
For customizations to appear on the login screen the first time the Code42 agent is launched on a new device (before the user signs in), you must install a Code42 deployment policy on each device. Without a deployment policy, customizations do not appear until after the user signs in for the first time.
Create and edit a customization template
Customizations for login field labels, co-branding images, and in-app messages are all optional. Follow the steps below for only the aspects you want to customize.
- Sign in to the Code42 console.
- Navigate to Administration > Agent Management > Customizations.
- To create a new template, click Add Template. If no templates exist yet, click Create New Template.
- To edit an existing template, click the template's name.
- Enter a name for the template.
- Select an organization to customize. To apply the template to all organizations, select the name of the organization at the top of your hierarchy.
Customizations apply to child organizations unless a child organization has its own template. - (Optional) Enter a custom label for the username field on the Code42 agent sign in screen.
The default label is "Username." You can customize the label to provide more direction if necessary (for example, "Your directory services username"). - (Optional) Enter a custom label for the password field on the Code42 agent sign in screen.
The default label is "Password." You can customize the label to provide more direction if necessary (for example, "Your directory services password"). - (Optional) Upload a co-branding image to display next to the Code42 logo on the About screen in the Code42 agent.
The image must be a .png or .jpg file type and be 50 KB or less. Maximum image dimensions (W x H) are 242 x 36 pixels. - (Optional) Upload a co-branding image to display next to the Code42 logo in the Code42 agent login screen and header.
The image must be a .png or .jpg file type and be 50 KB or less. Maximum image dimensions (W x H) are 400 x 24 pixels. - (Optional) Add a custom message to the Code42 agent home screen. Basic html formatting tags are allowed.
See the Agent Management Customizations reference guide for detailed requirements. - (Optional) Select to allow users to dismiss the message (if you change the message, the new message appears to users even if the previous message was dismissed). If not selected, the message is permanently displayed in the Code42 agent.
- Click Save.
Changes to customization settings for a specific organization appear on user devices immediately.
Delete a customization template
Deleting a template removes the customizations from devices in the applicable organizations. If another template exists for a parent organization, devices will start displaying the parent organization's customizations. If no other templates apply, the Code42 agent returns to the default appearance.
To delete a customization template:
- Sign in to the Code42 console.
- Navigate to Administration > Agent Management > Customizations.
- Click the template's name.
- Click Delete Template.
To preserve customization settings for future use:
- Edit the template.
- In the Select an organization to customize dropdown, click the currently selected organization's name.
This removes the organization, resulting in a template that doesn't apply to any organizations. - Click Save.