Skip to content

Commit

Permalink
Add a changelog and update the readme (#78)
Browse files Browse the repository at this point in the history
* Add a changelog and update the readme

* Adds reference to adding the changelog to the changelog. So meta!
  • Loading branch information
hisaac authored Sep 29, 2020
1 parent 5a097b2 commit 7838053
Show file tree
Hide file tree
Showing 2 changed files with 98 additions and 12 deletions.
81 changes: 81 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

<!-- Add any information here about changes in master that have yet to be released -->

### Added

- Added this changelog file

## [1.2.1] - 2020-09-17

Thank you to all the contributors in this release!

### Added

- Added swiftlint to the project (@stavares843)
- Added a swiftlint GitHub Action (@stavares843)
- Added some alerts for better error reporting (@BIG-RAT)

### Fixed

- Fixed an issue where buttons could go off the screen in certain circumstances (@BIG-RAT)
- Fixed an issue where PPPC Utility would fail to upload profiles to Jamf Pro version 10.23 and greater (@kkot)

## [1.2.0] - 2020-04-29

### Added

- Added a feature to import existing profiles from disk (@adku)

### Fixed

- TCC properties are ordered alphabetically (@ty-wilson)
- Duplicate apps are not added to the view (@BIG-RAT)
- TCC profile xml properties fixes (@pirkla) - This resolved an issue so profiles created with the PPPC Utility can be added to Jamf Now
- Updated labels and placeholders (@pirkla)

## [1.1.2] - 2019-10-07

### Fixed

- A fix for issue #2 reported by @golbiga and issue #25 reported by @bartreardon, fixed by @adku in pull request #16

## [1.1.1] - 2019-09-20

### Fixed

- A fix for for issue #18 reported by @drunkonmusic, fixed by @adku in pull request #19

## [1.1.0] - 2019-09-10

### Changed

- Updated with the new macOS 10.15 Privacy Preferences Policy Control keys
- Minor user interface updates

## [1.0.1] - 2018-10-03

### Fixed

- Fixed an issue discovered by @Lotusshaney where rules using `SystemPolicySysAdminFiles` were not created correctly.

## [1.0.0] - 2018-09-21

Initial release

<!-- -->

[unreleased]: https://github.com/jamf/PPPC-Utility/compare/1.2.1...master
[1.2.1]: https://github.com/jamf/PPPC-Utility/compare/1.2.0...1.2.1
[1.2.0]: https://github.com/jamf/PPPC-Utility/compare/1.1.2...1.2.0
[1.1.2]: https://github.com/jamf/PPPC-Utility/compare/1.1.1...1.1.2
[1.1.1]: https://github.com/jamf/PPPC-Utility/compare/1.1.0...1.1.1
[1.1.0]: https://github.com/jamf/PPPC-Utility/compare/1.0.1...1.1.0
[1.0.1]: https://github.com/jamf/PPPC-Utility/compare/1.0.1...1.0.1
[1.0.0]: https://github.com/jamf/PPPC-Utility/compare/047786dad486e8cc1e159d3f315adb695a566465...1.0.0
29 changes: 17 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,39 +2,44 @@

[logo]: /Resources/Assets.xcassets/AppIcon.appiconset/PPPC_Logo_32%402x.png "PPPC Utility"

PPPC Utility is a macOS (10.13 and newer) application for creating configuration profiles containing the
Privacy Preferences Policy Control payload for macOS. The profiles can be saved locally signed or unsigned.
Profiles can also be uploaded directly to a Jamf Pro server.
PPPC Utility is a macOS (10.13 and newer) application for creating configuration profiles containing the Privacy Preferences Policy Control payload for macOS. The profiles can be saved locally, signed or unsigned. Profiles can also be uploaded directly to a Jamf Pro server.

All changes to the application are tracked in [the changelog](https://github.com/jamf/PPPC-Utility/blob/master/CHANGELOG.md).

## Installation

#### [Download the latest version here](https://github.com/jamf/PPPC-Utility/releases)
Download the latest version from [the Releases page](https://github.com/jamf/PPPC-Utility/releases).

## Building profile
Start by adding the bundles/executables for the payload by using drag-and-drop or by selecting the add (+)
button in the left corner.

Start by adding the bundles/executables for the payload by using drag-and-drop or by selecting the add (+) button in the left corner.

![Start by adding to the **Applications** table](/Images/Building.png "Building profile")

## Saving
Profiles can be saved locally either signed or unsigned.

Profiles can be saved locally either signed or unsigned.

![Click **Save** button to save a profile](/Images/SavingUnsigned.png "Saving an unsigned profile")

![Choose a **Signing Identity** to save a signed profile](/Images/SavingSigned.png "Saving a signed profile")


## Upload to Jamf Pro

#### Jamf Pro 10.7.1 and newer
### Jamf Pro 10.7.1 and newer

Starting in Jamf Pro 10.7.1 the Privacy Preferences Policy Control Payload can be uploaded to the API without being signed before uploading.

![In 10.7.1 or greater choosing **Signing Identity** is optional before upload](/Images/UploadUnsigned.png "Upload unsigned")

#### Jamf Pro 10.7.0 and below
To upload the Privacy Preferences Policy Control Payload to Jamf Pro 10.7.0 and below,
the profile will need to be signed before uploading.
### Jamf Pro 10.7.0 and below

To upload the Privacy Preferences Policy Control Payload to Jamf Pro 10.7.0 and below, the profile will need to be signed before uploading.

![In 10.7.0 or less **Signing Identity** must be chosen before uploading](/Images/UploadSigned.png "Upload signed")

## Importing

Signed and unsigned profiles can be imported.

![Import any profile](/Images/ImportProfile.png "Import profiles")

0 comments on commit 7838053

Please sign in to comment.