Skip to content
master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

IE Cookbook

Cookbook Version win

The following recipes are available for configuring Internet Explorer:

  • BFCache - Enable/Disable IE Feature Back-Forward Cache
  • ESC - Enable/Disable IE Enhanced Security Configuration
  • FirstRun - Enable/Disable IE 8 & 9 First Run Set Up Pop-up
  • Zone - Configure IE Security Zones; Local Home, Internet, Local Internet, Trusted Sites, and Restricted Sites
  • Zoom - Configure IE Zoom Level

A ie_version method is also available to retrieve the exact version of Internet Explorer installed.

Tested against:

  • IE 11 on Windows Server 2012 R2
  • IE 10 on Windows Server 2012
  • IE 9 on Windows Server 2008 R1 SP2

Requirements

  • Chef 11.6+ (includes a built-in registry_key resource)

Platforms

  • Windows

Usage

See ie_test cookbook for examples. Include ie as a dependency to make ie_version method available. Note that there is no default recipe.

A library method ie_version is provided to retrieve the IE version installed:

v = ie_version

Tip: use allow_any_instance_of to stub ie_version method when testing with rspec:

allow_any_instance_of(Chef::Recipe).to receive(:ie_version).and_return('11.0.0.0')

BFCache

Enable/Disable IE Feature Back-Forward Cache. Allows drivers to maintain a connection to IE.

Attributes

  • node['ie']['bfcache'] - Defaults to true (enabled)

Example

Enable bfcache:

include_recipe 'ie::bfcache'

ESC

Enable/Disable Internet Explorer Enhanced Security Configuration (ESC).

Attributes

  • node['ie']['esc'] - Defaults to false (disabled)

Example

Disable enhanced security configuration:

include_recipe 'ie::esc'

FirstRun

Enable/Disable Internet Explorer 8 & 9 First Run Set Up Pop-up.

Attributes

  • node['ie']['firstrun'] - Defaults to false (disabled)

Example

Disable first run:

include_recipe 'ie::firstrun'

Zone

Configure IE Security Zones (REG_DWORD types only); Local Home, Internet, Local Internet, Trusted Sites, and Restricted Sites.

See Zones section in http://support.microsoft.com/kb/182569 for a complete listing of security zone settings.

A setting of zero sets a specific action as permitted, a setting of one causes a prompt to appear, and a setting of three prohibits the specific action.

Attributes

  • node['ie']['zone']['local_home'] - Defaults to {}
  • node['ie']['zone']['internet'] - Defaults to {}
  • node['ie']['zone']['local_internet'] - Defaults {}
  • node['ie']['zone']['trusted_sites'] - Defaults to {}
  • node['ie']['zone']['restricted_sites'] - Defaults to {}

Example

Enable both protected mode for main zones and active scripting for internet zone only:

node.set['ie']['zone']['internet'] = {
  '1400' => 0, # enable active scripting
  '2500' => 0 # enable protected mode
}

node.set['ie']['zone']['local_internet'] = {
  '2500' => 0 # enable protected mode
}

node.set['ie']['zone']['trusted_sites'] = {
  '2500' => 0 # enable protected mode
}

node.set['ie']['zone']['restricted_sites'] = {
  '2500' => 0 # enable protected mode
}

include_recipe 'ie::zone'

Zoom

Configure IE Zoom level.

Attributes

  • node['ie']['zoom'] - Defaults to 100_000 (100%)

Example

Set zoom level to 125%:

node.set['ie']['zoom'] = 125_000

include_recipe 'ie::zoom'

Getting Help

Contributing

Please refer to CONTRIBUTING.

License

MIT - see the accompanying LICENSE file for details.

About

Chef cookbook to configure Internet Explorer browser

Topics

Resources

License

Packages

No packages published

Languages