Notarization
Notarization
Starting in macOS Catalina, all disk images which are code signed, are also required to be “notarized” by Apple in order to be opened by end-users. Without notarization, the user will see an error that the identity and source of the disk image cannot be verified so it cannot be opened. Disk images which are not code signed, are not required to be notarized, and are able to be opened on Catalina with the caveat of having Gatekeeper path randomization enabled for applications in the disk image.
To notarize your disk image, you must have an Apple developer account, you must be running on macOS 10.14 or later with the Xcode 10.12 or later command line tools installed. (The notarization process uses the altool
command included with Xcode.)
- In Preferences → Notarization, add an Apple ID developer account.
- Set up an App-Specific password to use with Notarization for the account. (Because Two-Factor Authentication cannot be used with notarization).
- In the Disk Image’s sidebar, turn on “Notarize with Apple”
- Select the Apple ID to use for Notarization.
- Enter an identifier for the content of disk image. (See note below)
During the build process, DMG Canvas will upload the disk image to Apple for notarization, and then wait for the Apple to finish notarizing the disk image. This process can take several minutes. Once notarization is complete, the disk image will be stapled with a ticket and is ready for distribution.
If you choose to “Stop Waiting” for notarization to finish after the upload has completed, you will need to manually check for the notarization status (an email is sent by Apple) and if notarization is successful, you will need to manually staple the ticket to the disk image:
xcrun stapler staple /path/to/diskimage.dmg
See Customizing the Notarization Workflow for more information on how notarization works.
The Primary Bundle Identifier is a required identifier that helps you keep track of automated correspondence from the notarization service. The value you give doesn’t need to match the bundle identifier of the submitted app or have any particular value. It only needs to make sense to you. The notarization service includes the value whenever it emails you regarding the given notarization submission.
An App-Specific Password is required for Notarization because Two-Factor Authentication cannot be used. See https://support.apple.com/en-us/HT204397 for how to set up a password.