GINA/Mac/Linux customization

Login agent customization steps

  1. Go to the  Configuration → Administrative Tools → GINA/Mac/Linux (Ctrl+Alt+Del).
  2. Select GINA/Mac/Linux Customization. 
  3. Upload the icon in the Icon field
  4. Update the button and frame text to show it in the logon screen.
  5. Configure Acces URL in case of hosting ADSelfService Server behind proxy server.
  6. gina-mac-customization
  7. Enter the  Access URL.
    Note: If you are using a reverse proxy for ADSelfService Plus server or have blocked direct access to the ADSelfService Plus server for end-users, then please configure Access URL. Click here for the steps to configure access URL.
  8. Click  Save.
  9. Note:
    • Only BMP files (with size 48 * 48) can be used as the GINA/macOS/Linux icon.
    • Only the future GINA/macOS/Linux OS installations will be affected.
    • Run the customization scheduler to customize the already configured GINA/macOS/Linux OS installations.

Configuring GINA Advanced Settings

  1. Select Show Reset Password/Unlock Account Link , to show Reset Password/Unlock Link in the logon screen.
  2. Select Show Reset Password/Unlock Account Tile , to show Reset Password/Unlock Tile in the logon screen.
  3. Select the Restrict user access when there is an invalid SSL certificate checkbox to restrict access to the ADSelfService Plus server from the GINA Logon agent whenever there is an expired or invalid SSL certificate on the workstation. This is supported for all versions of Windows and Linux, and up to macOS version 12. Learn how to configure this for macOS 13 and above.
  4. Choose the way to install the GINA machine using sAMAccountName or dNSHostName.
  5. Select Display the enforced password rules to show the password policy rules in the dialog view when user tries to perform GINA/CP screen
  6. gina-advance

The ADSelfService Plus SSL certificate should be trusted in the Keychain Accessapp on macOS. This is mandatory for machines running macOS 13 (Ventura) and above.

  • Open the Keychain Access app on the Mac running macOS 13 (Ventura) or later.
  • Download and include ADSelfService Plus' CA certificate in the System Keychain, under the Certificates tab.
  • Expand the trust section of the certificate and mark When using the certificate to Always Trust.
Learn how to configure this for macOS 13 and above

Localizing Windows login agent's user interface language

The Windows login agent can be customized to display the ADSelfService Plus portal in languages other than English.The information derived from the ADSelfService Plus server can be displayed in any of the 21 supported languages byfollowing the steps in this guide.

Other information that is derived from the login agent in the specific machine including the offline MFA feature andcustom password policies can be displayed in 7 languages - Simplified Chinese, Japanese, French, German, Turkish,Spanish, and Polish. By default, the information displayed by the login agent follows the welcome screen displaylanguage settings (Start > Settings > Time & Language > Administrative language settings > Welcome screenand new user accounts > Copy settings > Welcome screen display language). If the admin wishes tooverride this, they will have to alter the Windows registry in the required user machines as when machine isoffline, it won't be able to fetch custom language details from the product server.

Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\ZOHO Corp\ADSelfService Plus Client Software in 64-bit machines or HKEY_LOCAL_MACHINE\SOFTWARE\ZOHO Corp\ADSelfService Plus Client Software in 32-bit machines. Create a new String Value namedLocaleID and provide the value corresponding to your preferred language as the ValueData from the table below:

Offline MFA portal Language Corresponding value for LocaleID

Simplified Chinese














Note:Localization of the login agent is only supported for Windows machines.Linux and macOS login agents only support the English language. To request other languages for the Windows loginagent, or additional language support for the Linux and macoS login agents, click here.
Disclaimer: To ensure streamlined functionality and consistency of theADSelfService Plus login agent across the user machines, admins are not recommended to alter the Windows Registrykeys in the user machines directly except for certain cases mentioned in the product resources. Doing so could causean inconsistency between the user machine and the server. It is recommended to use the ADSelfService Plus adminportal to make any changes to the login agent and its features, and run the GINA customization scheduler orreinstall the login agent to update the changes in all the user machines. For further clarification, please reach toour support team.


Your request has been submitted to the ADSelfService Plus technical support team. Our technical support people will assist you at the earliest.


Need technical assistance?

  • Enter your email ID
  • Talk to experts
    By clicking 'Talk to experts', you agree to processing of personal data according to the Privacy Policy.

Don't see what you're looking for?


    Visit our community

    Post your questions in the forum.


    Request additional resources

    Send us your requirements.


    Need implementation assistance?

    Try onboarding


Copyright © 2023, ZOHO Corp. All Rights Reserved.