1. Packages
  2. Zscaler Internet Access (ZIA)
  3. API Docs
  4. BrowserControlPolicy
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler
Schema (JSON)
zscaler/pulumi-zia

zia.BrowserControlPolicy

zia logo
Viewing docs for pulumi-resource-zia v1.3.8
published on Friday, Mar 13, 2026 by Zscaler
Schema (JSON)
zscaler/pulumi-zia

    The zia_browser_control_policy resource manages browser control policy settings in the Zscaler Internet Access (ZIA) cloud service. This is a singleton resource — only one browser control policy exists per tenant. Deleting the Pulumi resource does not remove the underlying settings.

    Example Usage

    Browser Control Policy

    Example coming soon!

    Example coming soon!

    Example coming soon!

    import * as zia from "@bdzscaler/pulumi-zia";

const example = new zia.BrowserControlPolicy("example", {
    allowAllBrowsers: true,
    enableWarnings: true,
    enableSmartBrowserIsolation: false,
});

    import zscaler_pulumi_zia as zia

example = zia.BrowserControlPolicy("example",
    allow_all_browsers=True,
    enable_warnings=True,
    enable_smart_browser_isolation=False,
)

    resources:
  example:
    type: zia:BrowserControlPolicy
    properties:
      allowAllBrowsers: true
      enableWarnings: true
      enableSmartBrowserIsolation: false

    Create BrowserControlPolicy Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new BrowserControlPolicy(name: string, args?: BrowserControlPolicyArgs, opts?: CustomResourceOptions);
    @overload
def BrowserControlPolicy(resource_name: str,
                         args: Optional[BrowserControlPolicyArgs] = None,
                         opts: Optional[ResourceOptions] = None)

@overload
def BrowserControlPolicy(resource_name: str,
                         opts: Optional[ResourceOptions] = None,
                         allow_all_browsers: Optional[bool] = None,
                         blocked_chrome_versions: Optional[Sequence[str]] = None,
                         blocked_firefox_versions: Optional[Sequence[str]] = None,
                         blocked_internet_explorer_versions: Optional[Sequence[str]] = None,
                         blocked_opera_versions: Optional[Sequence[str]] = None,
                         blocked_safari_versions: Optional[Sequence[str]] = None,
                         bypass_all_browsers: Optional[bool] = None,
                         bypass_applications: Optional[Sequence[str]] = None,
                         bypass_plugins: Optional[Sequence[str]] = None,
                         enable_smart_browser_isolation: Optional[bool] = None,
                         enable_warnings: Optional[bool] = None,
                         plugin_check_frequency: Optional[str] = None,
                         smart_isolation_groups: Optional[Sequence[int]] = None,
                         smart_isolation_profile: Optional[SmartIsolationProfileInputArgs] = None,
                         smart_isolation_users: Optional[Sequence[int]] = None)
    func NewBrowserControlPolicy(ctx *Context, name string, args *BrowserControlPolicyArgs, opts ...ResourceOption) (*BrowserControlPolicy, error)
    public BrowserControlPolicy(string name, BrowserControlPolicyArgs? args = null, CustomResourceOptions? opts = null)
    public BrowserControlPolicy(String name, BrowserControlPolicyArgs args)
public BrowserControlPolicy(String name, BrowserControlPolicyArgs args, CustomResourceOptions options)

    type: zia:BrowserControlPolicy
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args BrowserControlPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args BrowserControlPolicyArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args BrowserControlPolicyArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BrowserControlPolicyArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BrowserControlPolicyArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var browserControlPolicyResource = new Zia.BrowserControlPolicy("browserControlPolicyResource", new()
{
    AllowAllBrowsers = false,
    BlockedChromeVersions = new[]
    {
        "string",
    },
    BlockedFirefoxVersions = new[]
    {
        "string",
    },
    BlockedInternetExplorerVersions = new[]
    {
        "string",
    },
    BlockedOperaVersions = new[]
    {
        "string",
    },
    BlockedSafariVersions = new[]
    {
        "string",
    },
    BypassAllBrowsers = false,
    BypassApplications = new[]
    {
        "string",
    },
    BypassPlugins = new[]
    {
        "string",
    },
    EnableSmartBrowserIsolation = false,
    EnableWarnings = false,
    PluginCheckFrequency = "string",
    SmartIsolationGroups = new[]
    {
        0,
    },
    SmartIsolationProfile = new Zia.Inputs.SmartIsolationProfileInputArgs
    {
        Id = "string",
    },
    SmartIsolationUsers = new[]
    {
        0,
    },
});

    example, err := zia.NewBrowserControlPolicy(ctx, "browserControlPolicyResource", &zia.BrowserControlPolicyArgs{
	AllowAllBrowsers: pulumi.Bool(false),
	BlockedChromeVersions: pulumi.StringArray{
		pulumi.String("string"),
	},
	BlockedFirefoxVersions: pulumi.StringArray{
		pulumi.String("string"),
	},
	BlockedInternetExplorerVersions: pulumi.StringArray{
		pulumi.String("string"),
	},
	BlockedOperaVersions: pulumi.StringArray{
		pulumi.String("string"),
	},
	BlockedSafariVersions: pulumi.StringArray{
		pulumi.String("string"),
	},
	BypassAllBrowsers: pulumi.Bool(false),
	BypassApplications: pulumi.StringArray{
		pulumi.String("string"),
	},
	BypassPlugins: pulumi.StringArray{
		pulumi.String("string"),
	},
	EnableSmartBrowserIsolation: pulumi.Bool(false),
	EnableWarnings:              pulumi.Bool(false),
	PluginCheckFrequency:        pulumi.String("string"),
	SmartIsolationGroups: pulumi.IntArray{
		pulumi.Int(0),
	},
	SmartIsolationProfile: &pulumizia.SmartIsolationProfileInputArgs{
		Id: pulumi.String("string"),
	},
	SmartIsolationUsers: pulumi.IntArray{
		pulumi.Int(0),
	},
})

    var browserControlPolicyResource = new BrowserControlPolicy("browserControlPolicyResource", BrowserControlPolicyArgs.builder()
    .allowAllBrowsers(false)
    .blockedChromeVersions("string")
    .blockedFirefoxVersions("string")
    .blockedInternetExplorerVersions("string")
    .blockedOperaVersions("string")
    .blockedSafariVersions("string")
    .bypassAllBrowsers(false)
    .bypassApplications("string")
    .bypassPlugins("string")
    .enableSmartBrowserIsolation(false)
    .enableWarnings(false)
    .pluginCheckFrequency("string")
    .smartIsolationGroups(0)
    .smartIsolationProfile(SmartIsolationProfileInputArgs.builder()
        .id("string")
        .build())
    .smartIsolationUsers(0)
    .build());

    browser_control_policy_resource = zia.BrowserControlPolicy("browserControlPolicyResource",
    allow_all_browsers=False,
    blocked_chrome_versions=["string"],
    blocked_firefox_versions=["string"],
    blocked_internet_explorer_versions=["string"],
    blocked_opera_versions=["string"],
    blocked_safari_versions=["string"],
    bypass_all_browsers=False,
    bypass_applications=["string"],
    bypass_plugins=["string"],
    enable_smart_browser_isolation=False,
    enable_warnings=False,
    plugin_check_frequency="string",
    smart_isolation_groups=[0],
    smart_isolation_profile={
        "id": "string",
    },
    smart_isolation_users=[0])

    const browserControlPolicyResource = new zia.BrowserControlPolicy("browserControlPolicyResource", {
    allowAllBrowsers: false,
    blockedChromeVersions: ["string"],
    blockedFirefoxVersions: ["string"],
    blockedInternetExplorerVersions: ["string"],
    blockedOperaVersions: ["string"],
    blockedSafariVersions: ["string"],
    bypassAllBrowsers: false,
    bypassApplications: ["string"],
    bypassPlugins: ["string"],
    enableSmartBrowserIsolation: false,
    enableWarnings: false,
    pluginCheckFrequency: "string",
    smartIsolationGroups: [0],
    smartIsolationProfile: {
        id: "string",
    },
    smartIsolationUsers: [0],
});

    type: zia:BrowserControlPolicy
properties:
    allowAllBrowsers: false
    blockedChromeVersions:
        - string
    blockedFirefoxVersions:
        - string
    blockedInternetExplorerVersions:
        - string
    blockedOperaVersions:
        - string
    blockedSafariVersions:
        - string
    bypassAllBrowsers: false
    bypassApplications:
        - string
    bypassPlugins:
        - string
    enableSmartBrowserIsolation: false
    enableWarnings: false
    pluginCheckFrequency: string
    smartIsolationGroups:
        - 0
    smartIsolationProfile:
        id: string
    smartIsolationUsers:
        - 0

    BrowserControlPolicy Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The BrowserControlPolicy resource accepts the following input properties:

    AllowAllBrowsers bool
    Whether to allow all browsers.
    BlockedChromeVersions List<string>
    List of blocked Chrome versions.
    BlockedFirefoxVersions List<string>
    List of blocked Firefox versions.
    BlockedInternetExplorerVersions List<string>
    List of blocked Internet Explorer versions.
    BlockedOperaVersions List<string>
    List of blocked Opera versions.
    BlockedSafariVersions List<string>
    List of blocked Safari versions.
    BypassAllBrowsers bool
    Whether to bypass all browsers.
    BypassApplications List<string>
    List of applications to bypass.
    BypassPlugins List<string>
    List of plugins to bypass.
    EnableSmartBrowserIsolation bool
    Whether to enable Smart Browser Isolation.
    EnableWarnings bool
    Whether to enable browser warnings for unsupported browsers.
    PluginCheckFrequency string
    How often to check for browser plugins. Valid values: NEVER, ALWAYS, DAILY, WEEKLY, MONTHLY.
    SmartIsolationGroups List<int>
    IDs of groups for Smart Browser Isolation.
    SmartIsolationProfile zscaler.PulumiPackage.Zia.Inputs.SmartIsolationProfileInput
    The Cloud Browser Isolation profile to use for Smart Browser Isolation.
    SmartIsolationUsers List<int>
    IDs of users for Smart Browser Isolation.
    AllowAllBrowsers bool
    Whether to allow all browsers.
    BlockedChromeVersions []string
    List of blocked Chrome versions.
    BlockedFirefoxVersions []string
    List of blocked Firefox versions.
    BlockedInternetExplorerVersions []string
    List of blocked Internet Explorer versions.
    BlockedOperaVersions []string
    List of blocked Opera versions.
    BlockedSafariVersions []string
    List of blocked Safari versions.
    BypassAllBrowsers bool
    Whether to bypass all browsers.
    BypassApplications []string
    List of applications to bypass.
    BypassPlugins []string
    List of plugins to bypass.
    EnableSmartBrowserIsolation bool
    Whether to enable Smart Browser Isolation.
    EnableWarnings bool
    Whether to enable browser warnings for unsupported browsers.
    PluginCheckFrequency string
    How often to check for browser plugins. Valid values: NEVER, ALWAYS, DAILY, WEEKLY, MONTHLY.
    SmartIsolationGroups []int
    IDs of groups for Smart Browser Isolation.
    SmartIsolationProfile SmartIsolationProfileInputArgs
    The Cloud Browser Isolation profile to use for Smart Browser Isolation.
    SmartIsolationUsers []int
    IDs of users for Smart Browser Isolation.
    allowAllBrowsers Boolean
    Whether to allow all browsers.
    blockedChromeVersions List<String>
    List of blocked Chrome versions.
    blockedFirefoxVersions List<String>
    List of blocked Firefox versions.
    blockedInternetExplorerVersions List<String>
    List of blocked Internet Explorer versions.
    blockedOperaVersions List<String>
    List of blocked Opera versions.
    blockedSafariVersions List<String>
    List of blocked Safari versions.
    bypassAllBrowsers Boolean
    Whether to bypass all browsers.
    bypassApplications List<String>
    List of applications to bypass.
    bypassPlugins List<String>
    List of plugins to bypass.
    enableSmartBrowserIsolation Boolean
    Whether to enable Smart Browser Isolation.
    enableWarnings Boolean
    Whether to enable browser warnings for unsupported browsers.
    pluginCheckFrequency String
    How often to check for browser plugins. Valid values: NEVER, ALWAYS, DAILY, WEEKLY, MONTHLY.
    smartIsolationGroups List<Integer>
    IDs of groups for Smart Browser Isolation.
    smartIsolationProfile SmartIsolationProfileInput
    The Cloud Browser Isolation profile to use for Smart Browser Isolation.
    smartIsolationUsers List<Integer>
    IDs of users for Smart Browser Isolation.
    allowAllBrowsers boolean
    Whether to allow all browsers.
    blockedChromeVersions string[]
    List of blocked Chrome versions.
    blockedFirefoxVersions string[]
    List of blocked Firefox versions.
    blockedInternetExplorerVersions string[]
    List of blocked Internet Explorer versions.
    blockedOperaVersions string[]
    List of blocked Opera versions.
    blockedSafariVersions string[]
    List of blocked Safari versions.
    bypassAllBrowsers boolean
    Whether to bypass all browsers.
    bypassApplications string[]
    List of applications to bypass.
    bypassPlugins string[]
    List of plugins to bypass.
    enableSmartBrowserIsolation boolean
    Whether to enable Smart Browser Isolation.
    enableWarnings boolean
    Whether to enable browser warnings for unsupported browsers.
    pluginCheckFrequency string
    How often to check for browser plugins. Valid values: NEVER, ALWAYS, DAILY, WEEKLY, MONTHLY.
    smartIsolationGroups number[]
    IDs of groups for Smart Browser Isolation.
    smartIsolationProfile SmartIsolationProfileInput
    The Cloud Browser Isolation profile to use for Smart Browser Isolation.
    smartIsolationUsers number[]
    IDs of users for Smart Browser Isolation.
    allow_all_browsers bool
    Whether to allow all browsers.
    blocked_chrome_versions Sequence[str]
    List of blocked Chrome versions.
    blocked_firefox_versions Sequence[str]
    List of blocked Firefox versions.
    blocked_internet_explorer_versions Sequence[str]
    List of blocked Internet Explorer versions.
    blocked_opera_versions Sequence[str]
    List of blocked Opera versions.
    blocked_safari_versions Sequence[str]
    List of blocked Safari versions.
    bypass_all_browsers bool
    Whether to bypass all browsers.
    bypass_applications Sequence[str]
    List of applications to bypass.
    bypass_plugins Sequence[str]
    List of plugins to bypass.
    enable_smart_browser_isolation bool
    Whether to enable Smart Browser Isolation.
    enable_warnings bool
    Whether to enable browser warnings for unsupported browsers.
    plugin_check_frequency str
    How often to check for browser plugins. Valid values: NEVER, ALWAYS, DAILY, WEEKLY, MONTHLY.
    smart_isolation_groups Sequence[int]
    IDs of groups for Smart Browser Isolation.
    smart_isolation_profile SmartIsolationProfileInputArgs
    The Cloud Browser Isolation profile to use for Smart Browser Isolation.
    smart_isolation_users Sequence[int]
    IDs of users for Smart Browser Isolation.
    allowAllBrowsers Boolean
    Whether to allow all browsers.
    blockedChromeVersions List<String>
    List of blocked Chrome versions.
    blockedFirefoxVersions List<String>
    List of blocked Firefox versions.
    blockedInternetExplorerVersions List<String>
    List of blocked Internet Explorer versions.
    blockedOperaVersions List<String>
    List of blocked Opera versions.
    blockedSafariVersions List<String>
    List of blocked Safari versions.
    bypassAllBrowsers Boolean
    Whether to bypass all browsers.
    bypassApplications List<String>
    List of applications to bypass.
    bypassPlugins List<String>
    List of plugins to bypass.
    enableSmartBrowserIsolation Boolean
    Whether to enable Smart Browser Isolation.
    enableWarnings Boolean
    Whether to enable browser warnings for unsupported browsers.
    pluginCheckFrequency String
    How often to check for browser plugins. Valid values: NEVER, ALWAYS, DAILY, WEEKLY, MONTHLY.
    smartIsolationGroups List<Number>
    IDs of groups for Smart Browser Isolation.
    smartIsolationProfile Property Map
    The Cloud Browser Isolation profile to use for Smart Browser Isolation.
    smartIsolationUsers List<Number>
    IDs of users for Smart Browser Isolation.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the BrowserControlPolicy resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    Id string
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.
    id string
    The provider-assigned unique ID for this managed resource.
    id str
    The provider-assigned unique ID for this managed resource.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    SmartIsolationProfileInput, SmartIsolationProfileInputArgs

    Id string
    Id string
    id String
    id string
    id str
    id String

    Import

    This is a singleton resource. Import is not applicable because there is no unique API identifier.

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    zia zscaler/pulumi-zia
    License
    zia logo
    Viewing docs for pulumi-resource-zia v1.3.8
    published on Friday, Mar 13, 2026 by Zscaler
    Schema (JSON)
    zscaler/pulumi-zia
      Try Pulumi Cloud free. Your team will thank you.