Agent Configuration

Agent.xml

The agent.xml file allows for configuration of the Liquit agent. Below you will find a complete agent.xml configuration.

The agent.xml is normally found at: C:\Program Files (x86)\Liquit Workspace\Agent\Agent.xml

Custom Server

    <Server>https://company.liquit.com/</Server>
    <CustomServer>False</CustomServer>

Register

These settings will allow the device to register itself with Liquit Workspace without requiring a user login. This allows you to manage the device without a user signed in. The user account used to register the agent only requires "Register device" privileges. When using this option, the user doesn't need the "Register device" privilege, while they can still use the agent when installed with this option.

    <Register>
        <Type>1</Type>
        <Username><![CDATA[LOCAL\wksimport]]></Username>
        <Password><![CDATA[P@ssw0rd]]></Password>
    </Register>

Deployments

These settings allow you to utilize deployments. Device Register settings needs to be configured with type 1 for the Deployment configuration to work.

    <Deployment>
        <Enabled>True</Enabled>
        <Start>True</Start>
        <Cancel>True</Cancel>
        <Events>False</Events>
        <Context>User</Context>
        <AutoStart>
            <Enabled>True</Enabled>
            <Timer>30</Timer>
            <Deployment>test</Deployment>
        </AutoStart>
    </Deployment>

Autostart

Log

The Liquit agent logs events initiated by the Liquit agent.

    <Log Id="agent">
        <Level>Debug</Level>
        <Path>Agent.log</Path>
        <RotateCount>5</RotateCount>
        <RotateSize>1048576</RotateSize>
    </Log>

Content

This element contains configuration for the way Liquit handles files form the content store

    <Content>
        <Hash>True</Hash>
    </Content>

Login

This element controls the login behaviour for the Liquit agent.

    <Login>
        <Enabled>True</Enabled>
        <SSO>True</SSO>
        <IdentitySource>LIQUIT</IdentitySource>
        <Timeout>4</Timeout>
    </Login>

Icon

Controls the behaviour of the tray icon.

    <Icon>
        <Enabled>True</Enabled>
        <Exit>True</Exit>
    </Icon>

Cache

This element controls settings for Cache.

    <Cache>
        <Enabled>True</Enabled>
        <Offline>True</Offline>
        <Path>Cache</Path>
        <TempPath>Temp</TempPath>
    </Cache>

Native Icons

Control whether or not Liquit is allowed to influence windows icons (Start Menu/Desktop).

    <NativeIcons>
        <Enabled>True</Enabled>
        <Primary>True</Primary>
        <ProgramsPath>${Programs}\Liquit</ProgramsPath>
    </NativeIcons>

Events

    <Events>
        <Enabled>True</Enabled>
        <Primary>False</Primary>
    </Events>

Refresh

    <Refresh>
        <Manual>True</Manual>
        <Interval>3600</Interval>
    </Refresh>

Launcher

    <Launcher>
        <Enabled>True</Enabled>
        <State>0</State>
        <Close>True</Close>
        <Start>True</Start>
        <Minimal>False</Minimal>
        <Tiles>False</Tiles>
        <StartConnected>False</StartConnected>
        <ContextMenu>True</ContextMenu>
        <SideMenu>tags</SideMenu>
    </Launcher>

ResolveDNS

    <ResolveDNS>True</ResolveDNS>

If this value of this element is set to true, Liquit will use the locally configured DNS servers to resolve servers before sending out the requests.
This allows for DNS load balancing to be performed by the agent, if the local device is configured with a proxy server, requests will be seen going to an IP address instead of the DNS name.
Setting this element to false, will disable the agent from resolving DNS itself and instead let Windows or the configured Proxy server resolve the DNS. Default value is false.

ServerValidation

    <ServerValidation>True</ServerValidation>

If this value of this element is set to true, Liquit will validate the zone certificate to ensure its trusted by the local certificate store. By setting this option to false, self-signed certificates which are not trusted by the local certificate store will be accepted as well, this causes a security issue for production environments. Therefore we recommend leaving this option on its default value: true.

RestrictServers

    <RestrictServers>True</RestrictServers>

If this value of this element is set to true, this will restrict which zones are allowed to access the local agent. The zone that is specified within the Server option is always allowed to communicate with the agent. If this option is set to False, a warning will be displayed asking the user if the zone where the user navigated to is allowed to access the agent. Default value is false.

TrustedServers

    <TrustedServers>
        <Server>zone1.liquit.com</Server>
        <Server>zone2.liquit.com</Server>
        <Server>*.dev.liquit.com</Server>
    </TrustedServers>

This element allows you to add additionally trusted zones. Each zone DNS entry needs to be added within a separate Server element. Wildcards can be used within the name to trust/match multiple zones within a single domain. This option is used in combination with RestrictServers.