Skip to content
Chef cookbook to configure Internet Explorer browser
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
attributes
libraries
recipes
spec
test/fixtures/cookbooks/ie_test
.gitignore
.kitchen.appveyor.yml
.rubocop.yml
Berksfile
CHANGELOG.md
CONTRIBUTING.md
CONTRIBUTORS.md
Gemfile
LICENSE.md
README.md
Rakefile
appveyor.yml
chefignore
metadata.rb

README.md

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.

You can’t perform that action at this time.