MacOS Gatekeeper Debugging Tips

│ {{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

{{#if:{{PROTECTIONEXPIRY:edit|{{{Link|}}}}} |'''[[:{{{Link}}}|{{{Caption}}}]]''' │ }}

This article applies to macOS only.

See also: Multiplatform Programming Guide

Notarising your application is necessary to pass Gatekeeper, but it is not sufficient. Gatekeeper has its own array of checks.

To determine why Gatekeeper is not executing your application is quite tricky. In most cases where Gatekeeper denies execution, there is some evidence in the system log. It is not always easy to spot. Some key terms to look for are:

Gatekeeper caches its assessments, and if you ‘hit’ that cache then you may not see anything interesting in the log (because the code that logs the interesting entries is not run). Try testing in a VM:

If you need to run it again, restore from the snapshot first.

With regards to collecting logs, you can use the sysdiagnose command line utility (see its man page) for that but it is generally faster to run log collect (see the man page for log) and then export the log to analyse offline on your real Mac.

In many cases, critical log entries have private info redacted. You can disable that system-wide using a configuration profile. See the discussion of Enable-Private-Data property in SystemLogging. IMPORTANT This is on the VM. You really don’t want to do it on any Mac you care about.