Common Custom Branding Settings for Jamf Connect and Self Service+

Jamf Connect Documentation

Solution
Application
Jamf Connect
Content Type
Technical Documentation
Utilities & Services
ft:locale
en-US

Login Window Custom Branding Settings

  • Domaincom.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>

Self Service+ Sign-in Settings

  • Domaincom.jamf.connect
  • DictionarySignIn
  • Description

    Used to configure the sign-in user experience and multifactor authentication (MFA) options for Okta.

Setting

Description

Sign-in Window Title

WindowTitle

Specifies a custom title for the sign-in window.

<key>WindowTitle</key>
<string>Connect</string>

Username Field Label

UsernameLabel

Specifies custom text for the Username field in the sign-in window.

<key>UsernameLabel</key>
<string>Username:</string>

Password Field Label

PasswordLabel

Specifies custom text for the Password field in the sign-in window.

<key>PasswordLabel</key>
<string>Password:</string>

MFA Option Names

MFARename

(Okta only) Specifies custom names for each MFA option used with Okta authentication in your organization. For more information about the types of MFA options you can configure with Jamf Connect and Okta, see Multifactor Authentication.

<key>MFARename</key>

<dict>
   <key>push</key>
   <string>Okta Verify app: Push Notification</string>
   <key>question</key>
   <string>Okta Verify app: Security Question</string>
   <key>token:hardware</key>
   <string>USB Security Key</string>
   <key>okta:token:software:totp</key>
   <string>Okta Verification Code</string>
   <key>google:token:software:totp</key>

   <string>Google Verification Code</string>
   <key>web</key>
   <string>Duo Mobile app</string>
</dict>

Self Service+ Custom Branding Settings

  • Domaincom.jamf.connect
  • DictionaryAppearance
  • Description

    Used to customize Self Service+ (formerly the Jamf Connect menu bar app) for your organization

Setting

Description

Light Mode Icon

MenubarIcon

Specifies the file path to a custom icon for the Self Service+ menu bar icon when Light Mode is enabled.

Jamf recommends using a 16x16 pixel image without color, as any colors in the image will be converted to greyscale. Using an image with solid colors may affect how the image is displayed.

<key>MenubarIcon</key>
<string>/usr/local/icon.png</string>

Use Unbranded App Icon

AlternateBranding
Specifies using the alternate app icon for Self Service+ rather than the default Jamf logo and company name. This setting is disabled (set to false) by default.
<key>AlternateBranding</key>
<false/>

Show Welcome Window

ShowWelcomeWindow

Displays the Welcome window each time Self Service+ is opened.

<key>ShowWelcomeWindow</key>
<true/>

Menu Item Customization Settings

  • Domaincom.jamf.connect
  • DictionaryCustomMenuItems
  • Description

    Used to customize the names of menu items in Self Service+

Setting

Description

Connect Menu Text

Connect

Specifies the title of the Connect menu item.

<key>Connect</key>
<string>Connect</string>