Menu AuthGuardHelp centre
Portuguêsauthguard.pt

Administrators · Windows sign-in

Install the Windows agent silently and through Group Policy (GPO)

  • 2 min read
  • SaaS · Self-hosted · Windows
  • Video
Tutorial 11Windows sign-in2:45 · Narrated in Portuguese, with English captions.Transcript and details

The MSI installs silently with properties. In an Active Directory domain, deploy it through Group Policy and configure its behaviour with the ADMX templates.

MSI properties

PropertyMeaning
TENANT_ORIGIN (required)Your organization's https address
INSTALL_TOKENThe install token; the service enrols the computer and then deletes it
SUPPORT_CONTACTThe contact the recovery screen shows
ORGANIZATION_NAMEShown on the sign-in panel
PANEL_LANGUAGEpt-PT or en; without it, follows Windows
FAIL_MODE_SAFEBehaviour in Safe Mode
AUTO_UPDATE1 (default) installs signed updates; 0 turns them off
OFFLINE_INSTALL1 skips the check that the organization responds

Before finishing, the installer checks that the organization responds and loads the provider exactly as the sign-in screen does. A failure ends the installation, so a broken provider is never left behind.

Silent install

msiexec /i AuthGuardDesktop-x64.msi /qn /norestart `
  TENANT_ORIGIN=https://example.example.com INSTALL_TOKEN=agei1_... `
  SUPPORT_CONTACT="IT Support · ext. 4357" ORGANIZATION_NAME="Example" PANEL_LANGUAGE=en

Group Policy

  1. Copy AuthGuardDesktop.admx and the en-US and pt-PT ADML files into the central store (\\<domain>\SYSVOL\<domain>\Policies\PolicyDefinitions).
  2. Deploy the MSI by software installation with an MST transform that sets TENANT_ORIGIN and INSTALL_TOKEN, or by a startup script with the command above.
  3. Configure under Computer Configuration › Administrative Templates › AuthGuard › Desktop:
SettingEffect
ScenarioMaskWhere it is required: 1 sign-in, 2 unlock, 4 elevation
RemoteRequiresMfaRemote desktop with a second factor (on by default)
UnlockGraceMinutesUnlock grace (0 to 60)
PrecheckPasswordA wrong password ends before contacting the phone
UpdateRingcanary, early or broad
ProxyModeSystem proxy (default) or direct connection
ExcludeCredUILeave UAC and run-as to Windows (on by default)

Security settings (offline window, break-glass accounts, password-only accounts) come from the console's signed policy; a GPO cannot widen them.

Check

The computer appears under «Manage» › «Computers». On the computer: authguard-desktop.exe status and selftest, in an elevated PowerShell.

Error codes in this article

Article referencead-windows-msi-gpoquote it to support to identify this article. Checked against the product at commit 5f6607a8.