gac_settings.md

page_title	subcategory	description
citrix_gac_settings Resource - citrix		Manages the Global App Configuration settings for a service url.

citrix_gac_settings (Resource)

Manages the Global App Configuration settings for a service url.

Example Usage

// Currently, only settings objects with value type of integer, boolean, strings and list of strings is supported.
resource "citrix_gac_settings" "test_settings_configuration" {
    service_url = "https://<your_service_url>:443"
    name = "test-settings"
    description = "Test settings configuration"
    app_settings = {
        windows = [
            {
                user_override = false,
                category = "ICA Client",
                settings = [
                    {
                        name = "Allow Client Clipboard Redirection",
                        value_string = "true"
                    }
                ]
            },
            {
                user_override = false,
                category = "Browser",
                settings = [
                    {
                        name = "delete browsing data on exit",
                        value_list = [
                            "browsing_history",
                            "download_history"
                        ]
                    },
                    {
                        name = "relaunch notification period",
                        value_string = "3600000"
                    }
                ]
            }
        ],
        html5 = [
            {
                category = "Virtual Channel",
                user_override = false,
                settings = [
                    {
                        name = "Clipboard Operations Between VDA And Local Device",
                        value_string = "true"
                    }  
                ]
            }
        ],
        ios = [
            {
                category = "Audio",
                user_override = false,
                settings = [
                    {
                        name = "audio",
                        value_string = "true"
                    }  
                ]
            }
        ],
        macos = [
            {
                category = "ica client",
                user_override = false,
                settings = [
                    {
                        name = "Reconnect Apps and Desktops",
                        value_list = [
                            "startWorkspace",
                            "refreshApps"
                        ]
                    }
                ]
            }
        ]
    }
}

Schema

Required

• app_settings (Attributes) Defines the device platform and the associated settings. Currently, only settings objects with value type of integer, boolean, strings and list of strings is supported. (see below for nested schema)
• description (String) Description of the settings record.
• name (String) Name of the settings record.
• service_url (String) Citrix workspace application store url for which settings are to be configured. The value is case sensitive and requires the protocol ("https" or "http") and port number.

Optional

• use_for_app_config (Boolean) Defines whether to use the settings for app configuration or not. Defaults to true.

Nested Schema for app_settings

Optional:

• android (Attributes List) Settings to be applied for users using android platform. (see below for nested schema)
• chromeos (Attributes List) Settings to be applied for users using chrome os platform. (see below for nested schema)
• html5 (Attributes List) Settings to be applied for users using html5. (see below for nested schema)
• ios (Attributes List) Settings to be applied for users using ios platform. (see below for nested schema)
• macos (Attributes List) Settings to be applied for users using mac os platform. (see below for nested schema)
• windows (Attributes List) Settings to be applied for users using windows platform. (see below for nested schema)

Nested Schema for app_settings.android

Required:

• category (String) Defines the category of the setting.
• settings (Attributes List) A list of name value pairs for the settings. Please refer to the following table for the supported settings name and their values per platform. (see below for nested schema)
• user_override (Boolean) Defines if users can modify or change the value of as obtained settings from the Global App Citrix Workspace configuration service.

Nested Schema for app_settings.android.settings

Required:

• name (String) Name of the setting.

Optional:

• value_list (List of String) List value (if any) associated with the setting.
• value_string (String) String value (if any) associated with the setting.

Nested Schema for app_settings.chromeos

Required:

• category (String) Defines the category of the setting.
• settings (Attributes List) A list of name value pairs for the settings. Please refer to the following table for the supported settings name and their values per platform. (see below for nested schema)
• user_override (Boolean) Defines if users can modify or change the value of as obtained settings from the Global App Citrix Workspace configuration service.

Nested Schema for app_settings.chromeos.settings

Required:

• name (String) Name of the setting.

Optional:

• value_list (List of String) List value (if any) associated with the setting.
• value_string (String) String value (if any) associated with the setting.

Nested Schema for app_settings.html5

Required:

• category (String) Defines the category of the setting.
• settings (Attributes List) A list of name value pairs for the settings. Please refer to the following table for the supported settings name and their values per platform. (see below for nested schema)
• user_override (Boolean) Defines if users can modify or change the value of as obtained settings from the Global App Citrix Workspace configuration service.

Nested Schema for app_settings.html5.settings

Required:

• name (String) Name of the setting.

Optional:

• value_list (List of String) List value (if any) associated with the setting.
• value_string (String) String value (if any) associated with the setting.

Nested Schema for app_settings.ios

Required:

• category (String) Defines the category of the setting
• settings (Attributes List) A list of name value pairs for the settings. Please refer to the following table for the supported settings name and their values per platform. (see below for nested schema)
• user_override (Boolean) Defines if users can modify or change the value of as obtained settings from the Global App Citrix Workspace configuration service.

Nested Schema for app_settings.ios.settings

Required:

• name (String) Name of the setting.

Optional:

• value_string (String) String value (if any) associated with the setting.

Nested Schema for app_settings.macos

Required:

• category (String) Defines the category of the setting.
• settings (Attributes List) A list of name value pairs for the settings. Please refer to the following table for the supported settings name and their values per platform. (see below for nested schema)
• user_override (Boolean) Defines if users can modify or change the value of as obtained settings from the Global App Citrix Workspace configuration service.

Nested Schema for app_settings.macos.settings

Required:

• name (String) Name of the setting.

Optional:

• value_list (List of String) List value (if any) associated with the setting.
• value_string (String) String value (if any) associated with the setting.

Nested Schema for app_settings.windows

Required:

• category (String) Defines the category of the setting.
• settings (Attributes List) A list of name value pairs for the settings. Please refer to table for the supported settings name and their values per platform. (see below for nested schema)
• user_override (Boolean) Defines if users can modify or change the value of as obtained settings from the Global App Citrix Workspace configuration service.

Nested Schema for app_settings.windows.settings

Required:

• name (String) Name of the setting.

Optional:

• value_list (List of String) List value (if any) associated with the setting.
• value_string (String) String value (if any) associated with the setting.

Import

Import is supported using the following syntax:

# Global App Configuration settings can be imported by specifying the service url
terraform import citrix_gac_settings.test_gac_settings https://example.com:443