Customize your environment with PowerTags

PowerTags are a powerful feature for customizing virtualized application environments. PowerTags are metatags that can be assigned to various entities within a virtualized environment, including users, user groups, apps, servers, clusters, or the entire account (global). For example, you can use a PowerTag to define custom behavior for sessions or to inject environment variables directly into the Windows session.

Custom behavior with PowerTags

PowerTags offer granular control and can be applied at different levels:

  • Individual users
  • User groups
  • Individual apps
  • Specific servers
  • Server clusters
  • Company account

How to use a PowerTag

To use a PowerTag to customize a feature or a component, you locate the relevant option on the Cameyo Admin console and add a line to the  input field.

For example: Prevent accidental tab closure with the CLOSECONFIRM PowerTag
During Cameyo sessions, users can accidentally close the tab they are working in, resulting in unexpected closure of the Cameyo session. This could potentially lead to a loss of work and require the user to relaunch the application session. 
  1. On the Cameyo Admin console, click Servers .
  2. To open the Details page of your chosen server, click the hyperlinked server name.
  3. Navigate to General > PowerTags.
  4. On a new line, enter !CLOSECONFIRM=1 to set a server-wide setting.
  5. At the bottom, click Save.
  6. Restart your Cameyo server for the new PowerTag value to take effect for apps running on that server.

Once CLOSECONFIRM is switched on, every time a user closes a tab, a message displays prompting them to click Leave to confirm that they do want to close the tab, or Cancel to return to the app.

!CLOSECONFIRM=0/1 can be placed at an application, server, cluster, user, usergroup or company-wide level.

Supported PowerTags and their functions

These are the supported PowerTags that you can use to control various aspects of the virtualized environment and user sessions.

Users and Cameyo portal

PowerTag Description

!INACTIVEUSERS=[delete_days/report_days]

Delete or report inactive users (company-level PowerTag only).

delete_days

Number of inactivity days after which to automatically delete users (minimum allowed: 14), or 0 for never.

report_days

Number of inactivity days after which to report users as inactive. Report is submitted by email, or 0 for never.

!USERSETTINGS=0

Disables the ability for end users to access My Profile.

!PWDEXPIRE=X

Cameyo logins only passwords expire after X number of days, after which they must be changed.

!PWDREGEX=regex

Cameyo logins only regular expression for password strength validation.

!UKRAINE=1

Ukraine-supportive theme and colors for the portal, to be applied at the company level.

!FAVICON

Changes browser icon from Cameyo icon to an online ICO file, for example, !FAVICON=https://someurl.com/favicon.ico, allowing customization of portal favicon.

!AUTHTTL=[minutes]

Company-level PowerTag for setting the authentication cache cookie duration after which the user is logged off and re-authentication is necessary (by default 10 days).

Note: This takes effect after a sign-in (so if you're already signed in, sign out and sign in again after applying this PowerTag).

File dialogs and storage for user groups

PowerTag Description

!STORAGEFILEDIALOG 
!STORAGEFILEDIALOGPATHS 
!FILEDIALOG_EXTRA
!FILEDIALOG_MYFILES

Controls the Cameyo File Dialog, set to either "1" (enable) or "0" (disable).

!USERPROFILE_DRIVE=X

Virtual drive letter for user profile.

!PUBLIC_DRIVE=P

Virtual drive letter for the Public dir.

!UPCS_ENABLED=0/1

Controls Session Sync for data persistence and cloud-based user profile synchronization.

!UPCS_INCLUDE 
!UPCS_EXCLUDE

Controls data persistence and its include and exclude filters.

!UPCS_MINSPACE

Defines the minimum hard-drive space when caching data persistence locally (C:\UserData). See Session Sync data persistence.

UPCS_EXCLUDE2 Controls data persistence and its include and exclude filters.
UPCS_FILTERS Controls data persistence and its include and exclude filters.

Windows and app behavior

PowerTag Description

!STOPFILES

Block access to specific files and executables.

For example: 
!STOPFILES=file1.ext;file2.ext;fullpath\file.ext

!CLIENTNAME
!USERNAME
!COMPUTERNAME

Client, user and machine name virtualization.

!CHROME=1

Sets Chrome as the default browser.

!STARTINGDIR

Defines the starting directory for the session app's execution.

!EXECREDIR=[app-name={dir}\appname]

Substitutes the execution of an app from a specified directory path. For example, if you want to specify to run org.exe only from this directory path c:\new\new.exe.
!EXECREDIR=org.exe=c:\new\new.exe

!SHELL_LOCKDOWN=1 or 0

Blocks hard-disk Explorer navigation and basic system commands.

Requires !USERPROFILE_DRIVE to be set (for example, !USERPROFILE_DRIVE=X).

Has to be set at the server level (or cluster or company) but cannot be on a single app or user, as it's a server-global security feature and not per-session.

Requires service restart to be applied, for the same reason.

!URLREDIR=1 or [url_prefix]

URLs launched by the session's app will be redirected directly as a new tab within the user's browser, outside the session itself. The url_prefix is in the form:
https://example.com/example

!WEBFS=1

Controls whether Cameyo allows file system integration.
Possible values:
!WEBFS=1, this means file system integration is allowed. (Default)
!WEBFS=0, this means file system integration is not allowed.
For more details, see Integrate with a local file system.

!FILEEXT=1

File handling using PWA's (File Association)

!WEBUSB=1

USB redirection using WebUSB

!UPCS_SILO=%app_silo%

Using SILOs (Persistence)

Session behavior and appearance

PowerTag Description

!TASKBAR_QUICKLAUNCH

Controls Cameyo's task bar.

!EXTRATOOLBTNS

Controls extra tool bar buttons.

!CLIPBOARD=1 or 0

Enables or disables clipboard support (from session to client - client to session is always permitted)

!CONNECT_RESOLUTION=800x600

Defines a fixed session width and height.

!KEYLOCK=1

When in full screen mode, session will capture all system keyboard keys including the Windows key, Alt-Tab as well as certain reserved control keys.

!CLOUDDRIVE=1 or 0

Controls user's cloud drives virtualization, if configured.

!CLOSECONFIRM=1 or 0

Controls accidental tab closure.

!KBLAYOUT=en-us-qwerty

Setting Cameyo keyboard layout.

!GRACEFULDISCOSEC
!
STARTUP_GRACEFULDISCO_PS1
See Graceful application closing.
!STARTUP_AFTER_xxxx Controls session scripting.
!STARTUP_BEFORE_SYNC_xxx Controls session scripting.
!STARTUP_GLOBAL Controls session scripting.

Session connectivity and initiation

PowerTag Description

!CLOUDTUNNEL=1 or 0

Switches Cloud Tunneling on or off.

!ADMINMAIL=1

Sends a notification email to the technical contacts every time an Admin session is initiated on a Cameyo server, for increased account security.

!ALLOW_COUNTRY=[2-letter country code]

This is an allow-list of countries from which sessions can be requested (2-letter ISO country codes), at a company-wide, application, server, cluster, user or usergroup level.

For example, !ALLOW_COUNTRY=FR,PT will allow access to users connecting from France and PortugalAn error code will appear for a user attempting to connect from an unauthorized country. 

!ALLOW_IP=[list of IP addresses, separated by semicolon]

This is list of IP addresses, separated by semicolon, from which sessions can be requested. Takes precedence over !ALLOW_COUNTRY so the two PowerTags can be used together to allow specific IP addresses from blocked countries.

Session token security

PowerTag Description

!TOKEN_TTL

Timeout in seconds after which a session's token can no longer be used. Note that this also neutralizes connection resiliency after the timeout expires.

!TOKEN_MULTI_AUTH=0

Revokes a session's token a few seconds after session authentication.

!TOKEN_MULTI_IP=0

Prevents a session's token from being used from an IP different than the initial one. Note that this also neutralizes connection resiliency if the user's IP changes during session time. Also note that this prevents a session's token from being used from an IP different than the initial one when the Cameyo server uses direct connections, not cloud tunneling.

!TOKENHIDE=1

Hides the session token out of the URL bar. In some cases people like to hide the token ID, either because they project or share their screens, or because they feel better this way. Take into account though that this makes page refresh (F5) not be able to reconnect to the session.

Server properties

PowerTag Description

!SUPPORT=0 or -1

Blocks server access to Cameyo's support team.

  •  0 blocks admin access
  • -1 blocks admin and regular app sessions.

!MAXDISCONNECT

Time, in seconds, to keep sessions alive in case of disconnection. Equivalent to Windows RDS' MaxDisconnectionTime parameter. Cameyo's default is 120.

!MAXIDLETIME

Maximum idle time in minutes. Overrides the session policy settings. Requires service restart.

!CLOUDTAGS (GCP only)
!CLOUDLABELS
!CLOUDVPC 
!CLOUDSUBNETS

Custom cloud tags and labels, VPC and subnets for created instances.

!CLOUDSECUREBOOT=1 (GCP only)

Forces Secure Boot to be enabled on created instances.

!CLOUDINSTANCE Specifies a custom machine type. For more information, see Google Cloud's General-purpose machine family for Compute Engine.
!CLOUDCPUGEN

Specifies the CPU generation type.

!CLOUDSERIES Specifies the CPU series type. C4D VMs are available as predefined configurations in standard, highcpu, and highmem sizes ranging from 2 vCPU to 384 vCPUs and up to 3,024 GB of memory.
!CLOUDIP Specifies the IP format, IPv4 or IPv6.

Configuration and order of precedence

PowerTags are dynamic, meaning they can vary from one session to another and take effect immediately, without requiring service nor server restart (except server-level PowerTags).

The order of precedence, from highest priority to least, is:

  • User
  • User group
  • App
  • Server
  • Cluster
  • Company (Account)

Example 1:

If a user has the tag 'MY_NAME=John' defined while the server has 'MY_NAME=Server' defined, a session run by this user on that server will have 'MY_NAME' defined as 'John'.

Example 2:

If the server has tag 'MY_NAME=SERVER' defined while the server's cluster has 'MY_NAME=CLUSTER' defined, sessions will run on this server with 'MY_NAME' defined as 'SERVER'.

Example 3:

If an application has tag 'MY_NAME=SomeApp' while the same global Cameyo account's PowerTag is defined as 'MY_NAME=CameyoAccount' then a session running this app will have 'MY_NAME' defined as 'SomeApp'.

Multiple tags

When multiple tags exist for a given session (for example, cluster + server + user + app), the session will be started with the combination of all relevant tags.

Multiple tags can be defined on each line, for example:

MY_VAR1=Some value
MY_VAR2=Some other value

Custom PowerTags

You use PowerTags to inject custom values into Cameyo sessions as environment variables. For more advanced control, sticky PowerTags can be used to create persistent, server-wide environment variables.

'+' sticky PowerTags: persistent server-wide environment variables (advanced): apply globally to an entire server, including system processes outside of a Cameyo session, and are defined by adding a + prefix.

  • Function: To create global system variables. For example, +MY_GLOBAL_VAR=Some value creates a system variable named "MY_GLOBAL_VAR" with the value "Some value" on the affected servers.
  • Scope: These tags can be set for servers, clusters, or entire accounts.
  • Activation: A sticky PowerTag only takes effect after the server's Cameyo service (re)starts.
  • Removal: To remove a sticky tag, you must set it to an empty value (for example, +MY_GLOBAL_VAR=). The removal takes effect after the Cameyo service restarts and the system is rebooted, which is a Windows requirement.
Search
Clear search
Close search
Main menu
15316169570517290221
true
Search Help Center
false
true
true
true
false
false
false
false