Leverage SMJobBless functionality with just one function call:
let message = "Example App needs your permission to do thingamajig."
let icon = Bundle.main.url(forResource: "bless", withExtension: "png")
try LaunchdManager.authorizeAndBless(message: message, icon: icon)
Both the message and icon parameters are optional. Defaults will be provided by macOS if they are not specified.
Overview
Beyond making it easy to bless an executable, Blessed provides a complete Swift implementation of the non-deprecated portions of macOS's Authorization Services and Service Management frameworks. At a high level this framework exposes three closely related capabilities:
- Requesting a user grant permission for one or more rights via macOS's Security Server
- Defining custom rights in the Policy Database
- Using
launchdto install executables which will run with root privileges
For completeness the Service Management capability to enable and disable login items via launchd is also included; see LaunchdManager.enableLoginItem(forBundleIdentifier:) and LaunchdManager.disableLoginItem(forBundleIdentifier:).
Authorization
In some more advanced circumstances you may to want directly interact with macOS's Security Server via the Authorization class.
If you only need to check if a user can perform an operation, use checkRights(_:environment:options:) without needing to create an Authorization instance.
Otherwise you'll typically want to initialize an instance via init() and then subsequently request rights with requestRights(_:environment:options:) or requestRightsAsync(_:environment:options:callback:).
Defining Custom Rights
macOS's authorization system is built around the concept of rights. The Policy Database contains definitions for all of the rights on the system and your application can add its own.
If an application defines its own rights it can then use these to self-restrict functionality. For details on why you might want to do see, consider reading Apple's Technical Note TN2095: Authorization for Everyone although keep in mind the code samples shown are not applicable if you are using this Swift implementation.
To define a custom right:
let myCustomRight = AuthorizationRight(name: "com.example.MyApp.special-action")
let description = "MyApp would like to perform a special action."
let rules: Set<AuthorizationRightRule> = [CannedAuthorizationRightRules.authenticateAsAdmin]
try myCustomRight.createOrUpdateDefinition(rules: rules, descriptionKey: description)
The above example creates a right called "com.example.MyApp.special-action" which requires that the user authenticate as an admin. How exactly the user does so is up to macOS; your application does not concern itself with this. (At the time of this documentation being written this means the user needing to type in a password, but in the future Apple could for example update their implementation of the authenticateAsAdmin rule to use Touch ID.) When the user is asked to authenticate they will see the message "MyApp would like to perform a special action."
There are several optional parameters not used in this example, see the documentation for details.
If you need to create a rule which is not solely composed of already existing rules, you must create an authorization plug-in, which is not covered by this framework. See Using Authorization Plug-ins for more information.
Sandboxing
Most of this framework is not available to sandboxed apps because of privilege escalation.
The exceptions to this are:
- reading or existence checking a right definition in the Policy Database
- enabling or disabling a login item
If you need to determine at run time if your app is sandboxed, this framework exposes an extension on NSApplication:
let sandboxed = try NSApplication.shared.isSandboxed()
0 Jan 21, 2022
55 Dec 14, 2022
479 Nov 22, 2022
24 Apr 22, 2022
3 Jul 29, 2021
0 Dec 23, 2021
63 Jan 29, 2022
407 Nov 19, 2022
4 Sep 18, 2022
1 Apr 21, 2022
5.8k Dec 14, 2022
48 Feb 2, 2022
628 Oct 17, 2022
1.6k Dec 21, 2022
5 Sep 22, 2022
5 Oct 19, 2022
142 Jan 4, 2023
6 Dec 1, 2022
19 Dec 18, 2022