Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

RSS

privacy_services_manager (6) Versions 1.1.2

Configures Mac OS X Accessibility, Calendar, Contacts, iCloud, Location Services and Reminders

Berkshelf/Librarian
Policyfile
Knife
cookbook 'privacy_services_manager', '~> 1.1.2'
cookbook 'privacy_services_manager', '~> 1.1.2', :supermarket
knife cookbook site install privacy_services_manager
knife cookbook site download privacy_services_manager
README
Dependencies
Changelog
Quality 67%

Privacy Services Manager Cookbook

Cookbook Version Build Status

Configures Mac OS X Accessibility, Calendar, Contacts, iCloud, Location Services and Reminders using univ-of-utah-marriott-library-apple/privacy_services_manager.

Requirements

  • Chef 11+

Platforms

  • Mac OS X 10.8+

Usage

This cookbook wraps univ-of-utah-marriott-library-apple/privacy_services_manager. Please read their documentation thoroughly before using this cookbook.

Actions

There are four actions available:

  • add Creates an entry for the specified application and enable the application for the service.
  • enable Effectively just calls add, ensuring that the application has been added and enabled.
  • remove Deletes the application's entry within the service. There will no longer be a record of that application therein.
  • disable Leaves the application's record intact, but will disallow the application from utilizing the given service.

Attributes

  • services There are six services that can be modified:
    • accessibility deals with behind-the-scenes systems that Apple believes require extra privileges to enable. Applications that interface with your computer experience, such as BetterSnapTool or the Steam in-game overlay, require access through this service. These privileges must be granted by a privileged user via sudo.
    • calendar is the service responsible for allowing applications to inject events into your calendar. This can be used to schedule recurring events, among other things.
    • contacts handles requests to access a user's address book. Many web browsers use this to store login information for various websites. This service is handled on a per-user basis, so any user has the ability to modify this service for themselves.
    • icloud manages access to a user's iCloud storage and settings. Examples would be any text editing application that is able to save to your iCloud, such as TextEdit or iA Writer. Because of the nature of this request (access to a user's personal files and settings).
    • location manages any application that desires to report on your physical location. Apple's own Maps application will request access to this, as well as web browsers once you visit a website that asks for your location (such as Google Maps).
    • reminders gives an application the ability to access your Reminders (which are usually handled manually via the Reminders application).
  • template Modify privacy services for Apple's User Template. Only applies to certain services.
  • forceroot Force the script to allow the creation/modification of the root user's own TCC database file.
  • no_check_bin Enable administrative override for binaries.
  • log_dest Redirect logging to the specified file.
  • user Modify privacy services for a specific user named "user".
  • language When changing privacy services for the Apple's User Template, modify the lang template. (Apple provides many User Template folder for different languages.)

Note the user, template, and language flags only affect those services which use the TCC system, i.e. contacts, icloud, and accessibility. Providing these options for Location Services will have no effect.

Examples

Add an application to your own contacts service permissions

Most web browsers will ask you for permission to look at your contacts.

Let's add Safari as a trusted application for vagrant user:

privacy_services_manager 'grant safari access to contacts' do
  service 'contacts'
  user 'vagrant'
  applications ['com.apple.Safari']
  action :add
end

Add an application to the global location service permissions

For this part of the walkthrough we will be adding Apple's Maps application to Location Services, but know that the process is the same for Accessibility.

First, because Location Services is handled a bit differently under-the-hood, we have to enable the system globally.

privacy_services_manager 'enable location services globally' do
  service 'location'
  action :enable
end

Now we will add Maps to the database. To do this, simply do:

privacy_services_manager 'add location services for maps' do
  service 'location'
  applications ['maps']
  action :add
end

ChefSpec Matchers

This cookbook includes a custom ChefSpec matcher you can use to test your own cookbooks.

Example Matcher Usage

expect(chef_run).to add_privacy_services_manager('grant safari access to contacts').with(
  service: 'contacts',
  user: 'vagrant',
  applications: ['com.apple.Safari'])

Cookbook Matchers

  • add_privacy_services_manager(resource_name)
  • enable_privacy_services_manager(resource_name)
  • remove_privacy_services_manager(resource_name)
  • disable_privacy_services_manager(resource_name)

Getting Help

Contributing

Please refer to CONTRIBUTING.

License

MIT - see the accompanying LICENSE file for details.

Changelog

1.1.2

  • Restrict dmg to 2.x

1.1.1

  • Relax dmg cookbook constraint

1.1.0

  • Fix #3 Updates to the administrative override
  • Fix #2 Users Application Support directory gets set with root permissions

1.0.2

  • Fix #1 ERROR: AttributeError: 'module' object has no attribute 'abspah'

1.0.1

  • BID not updating tccdb

1.0.0

  • Initial release

Collaborator Number Metric
            

1.1.2 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric
            

1.1.2 passed this metric

Foodcritic Metric
            

1.1.2 passed this metric

License Metric
            

1.1.2 passed this metric

No Binaries Metric
            

1.1.2 passed this metric

Publish Metric
            

1.1.2 failed this metric

privacy_services_manager is up for adoption

Supported Platforms Metric
            

1.1.2 passed this metric

Testing File Metric
            

1.1.2 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file

Version Tag Metric
            

1.1.2 passed this metric