Awesome

JamfKit

JamfKit is an iOS / macOS / tvOS framework to communicate with the JSS API offered by any Jamf host.

Summary

Features
Installation
- Carthage
- CocoaPods
Architecture
- Protocols
- Classes
Usage
- Getting started
Contributing
Code of conduct
FAQ
Credits
License

Features

Includes JSON encoding / decoding support for most of the JSS objects
Includes Objective-C support
Includes Swift 5+ support
Includes ready-for-consumption CRUD URLRequest for JSS endpoints
Includes demonstration playgrounds for class handling or request generation

Installation

Carthage

To integrate JamfKit into your project, add the following line in your Cartfile:

github "Ethenyl/JamfKit"

Then run the following command:

$ carthage update

Cocoapods

To integrate JamfKit into your project, add the following line in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'JAMFKit'
end

Then run the following command:

$ pod install

Architecture

Protocols

Protocol	Description
`Endpoint`	Represents any JSS object that is matched by a JSS endpoint.
`Identifiable`	Represents any JSS object that can be identified (either by ID or by name).
`Requestable`	Represents an object that can be used to perform requests with any JSS endpoint.
`Subset`	Represents any JSS object that contains a general object that can identify it.

Requestable conformance

The class that conform to Requestable exposes the following elements:

An failable initializer that takes a JSON payload and return the instantiated object
A function to return the JSON payload that represents the instance of the object

Classes

Class	Desscription
`BaseObject`	Represents the common denominator between most of the JSS objects which must contains at least an `identifier` and a `name` properties.
`Building`	Represents a physical building.
`Computer`	Represents a computer managed by Jamf, contains the general / location / purchasing information about the hardware.
`ComputerCommand`	Represents a logical command that can be executed on any hardware element manageg by Jamf.
`ComputerConfigurationProfile`	Represents a logical configuration profile that can be applied to any computer managed by Jamf.
`ComputerGroup`	Represents a group of computers managed by Jamf, contains grouping information.
`Department`	Represents a physical department.
`DirectoryBinding`	Represents a logical binding between a computer and an active directory user.
`MobileDeviceConfigurationProfile`	Represents a logical configuration profile that can be applied to any mobile device managed by Jamf.
`MobileDevice`	Represents a mobile device managed by Jamf, contains the general information about the device.
`MobileDeviceGroup`	Represents a group of mobile devices managed by Jamf, contains grouping information.
`NetbootServer`	Represents a physical netboot server, contains information about the server and it's configuration.
`NetworkSegment`	Represents a physical network segment, contains information about the segment and it's configuration.
`Package`	Represents a logical application package, contains information about the application requirements and capabilities.
`Partition`	Represents a logical partition for an hard drive installed inside an hardware element managed by Jamf.
`Policy`	Reprents as logical policy that can be applied to any hardware element managed by Jamf.
`PreciseDate`	Represents a logical date within JSS api, contains 3 properties, the date itself, an epoch variant of the date and an UTC version of the date.
`Printer`	Represents a physical printer, contains information about the printer and it's configuration.
`Script`	Represents a logical script that can be executed on one (or more) machine managed by Jamf.
`Site`	Represents a physical location (building, office, etc.).
`SMTPServer`	Represents the physical SMTP server configuration.
`User`	Represents a Jamf user and contains the identification properties that are required to contact the actual user and identify the hardware devices assigned to him / her.

Usage

Getting started

Playgrounds

To get a quick look on how you can use JamfKit in your Jamf related features, you can check the Playgrounds included within the workspace.

Also check the unit tests, they should cover most of your needs.

Models

Most of the classes can be initialized with the bare minimul values, all the properties are then available for modification.

Requests

By adhering to the different CRUD protocols (Creatable, Readable, Updatable & Deletable), most of the JSS objects listed above are capable of supplying varying URLRequest that should fit any needs.

You'll find below the basic functions to get URLRequest:

Function	Type	HTTP Method	Example	Output
`createRequest()`	`instance`	`POST`	`building.createRequest()`	`http://jss.host/jss/objects/1`
`readAllRequest()`	`static`	`GET`	`Building.readAllRequest()`	`http://jamf.com/jss/objects`
`readRequest(identifier:)`	`static`	`GET`	`Building.readRequest(identifier: "12345")`	`http://jamf.com/jss/objects/1`
`readRequest()`	`instance`	`GET`	`building.readRequest()`	`http://jamf.com/jss/objects/1`
`updateRequest()`	`instance`	`PUT`	`building.updateRequest()`	`http://jamf.com/jss/objects/1`
`deleteRequest(identifier:)`	`static`	`DELETE`	`Building.deleteRequest(identifier: "12345")`	`http://jamf.com/jss/objects/1`
`deleteRequest()`	`instance`	`DELETE`	`building.deleteRequest()`	`http://jamf.com/jss/objects/1`

Some objects will offer variants of those requests, like MobileDevice with readRequestWithName() or deleteRequestWithSerialNumber() (with both static and instance variants).

Contributing

So, you want to help improve JamfKit? That's great! Any useful contribution is welcome!

Check CONTRIBUTING for more details on how you can contribute to JamfKit.

Code of conduct

Any contributions (issues, pull requests, comments, etc.) to JamfKit are more than welcome.

But before making any contribution, please make sure that you follow the CODE OF CONDUCT.

Otherwise, there's a great chance that your contribution will be removed / blocked / hidden.

FAQ

None for the moment.

Credits

JamfKit is owned and maintained by Ethenyl.

You can join the list by contributing to the repository.

License

JamfKit is released under the MIT license. See LICENSE for more details.