IE Cookbook

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

• Ask specific questions on Stack Overflow.
• Report bugs and discuss potential features in Github issues.

Contributing

Please refer to CONTRIBUTING.

License

MIT - see the accompanying LICENSE file for details.