Login Window Custom Branding Settings

Jamf Connect Documentation
Solution
Application
Jamf Connect
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US
  • Domain —com.jamf.connect.login
  • Description —

    Used to customize the Jamf Connect login window for your organization

Setting

Description

Background Image

BackgroundImage

Specifies a path to a locally stored image to use as a background for the login window. This image file must be stored in a location that can be read from the login window.

If this setting does not contain an image file path, the default background is the macOS wallpaper. 

<key>BackgroundImage</key>
<string>/usr/local/shared/background.jpg</string>

Login Logo

LoginLogo

Specifies a path to a locally stored image to use as a logo during password validation or local password creation.

Note:
  • A 250 height pixel image is recommended with variable width capabilities for non-square logos.
  • Do not include a backslash "\" in your file path.
  • The image file and its file path must be assigned a permissions set that can be read from the login window, such as 444.
<key>LoginLogo</key>
<string>/usr/local/images/logo.png</string>
Note:

The LoginLogo is only displayed via Okta login with OIDCProvider set to Okta or OktaIdentityEngine, password synchronization, and password verification when OIDCUsePassthroughAuth is not configured.

Login Window Message

LoginWindowMessage

Specifies a custom message to display in the lower-center of the login window.

When Microsoft Entra ID is the identity provider, this message only displays when a user selects Local login.

Note:

This text is displayed in a single line. Line breaks are not supported, and messages that are too long may not display as expected.

<key>LoginWindowMessage</key>
<string>Log in with your company username and password.</string>
Login Window Size

LoginWindowSize

Specifies the resolution of the webview that appears in the Jamf Connect login window. The default webview is set to Wide and additional configuration settings are Compact and Max. The login window will scale based on the screen size in use.
<key>LoginWindowSize</key>
<string>Wide</string>