This article has been archived and is no longer updated by Apple.

OS X Server: Managing Safari plug-in options using a configuration profile

In Safari 6.1.2 and 7.0.2, Safari plug-in options can be managed using the configuration profiles feature of OS X Server.

Use Profile Manager in OS X Server to create a Custom Settings payload. Type in the preference domain name "com.apple.Safari", and add a ManagedPlugInPolicies key as described below.

Key

Type

Content

ManagedPlugInPolicies

Dictionary

Information for each managed plug-in is stored in this dictionary. The key is the plug-in's bundle identifier and the value is a dictionary with plug-in info, described below. Common plug-in bundle identifiers include:

  • com.apple.QuickTime Plugin.plugin

  • com.oracle.java.JavaAppletPlugin

  • com.macromedia.Flash Player.plugin

Plug-In dictionary

Each plug-in information dictionary can contain the following keys:

Key

Type

Value

PlugInFirstVisitPolicy

String

Optional. Determines plug-in policy for the first visit to websites that uses this plug-in. Based on this policy, Safari will allow the plug-in to run, block the plug-in from running, or ask the user if the plug-in should be allowed to run.

The following values are accepted:

  • PlugInPolicyAsk = Ask

  • PlugInPolicyBlock = Block

  • PlugInPolicyAllowWithSecurityRestrictions = Allow

  • PlugInPolicyAllowNoSecurityRestrictions = Allow Always

PlugInPreventPerSitePolicyChange

Boolean

Optional. If present and set to true, the user may not change plug-in settings for websites defined under PlugInHostnamePolicies.

PlugInRunUnsandboxedOnFirstVisit

Boolean

Optional. If present and set to true, a plug-in can run in unsafe mode when visiting a website for the first time. The default value is false.

PlugInHostnamePolicies

Array of Dictionaries

Optional. This array stores settings for individual websites. The dictionary format for each website is described below.

Website dictionary

Each website dictionary can contain the following keys:

Key

Type

Value

PlugInHostname

String

The hostname of the website.

PlugInPolicy

String

Determines plugin policy used when visiting this website. Allowed values are the same as the PlugInFirstVisitPolicy key described above.

PlugInRunUnsandboxed

Boolean

Optional. If present and set to true, the plugin is allowed to run in unsafe mode. The default value is false.

Learn more

For a sample of the Safari plug-in settings, you can look at the source of this sample configuration profile.

Published Date: