Skip to content

Commit 7efe164

Browse files
authored
Describe Ad-hoc signing on MacOS (#3289)
1 parent c6c82d4 commit 7efe164

File tree

1 file changed

+21
-2
lines changed

1 file changed

+21
-2
lines changed

src/content/docs/distribute/Sign/macos.mdx

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ With the certificate installed in your Mac computer keychain, you can configure
5252

5353
The name of the certificate's keychain entry represents the `signing identity`, which can also be found by executing:
5454

55-
```
55+
```sh
5656
security find-identity -v -p codesigning
5757
```
5858

@@ -79,7 +79,7 @@ and configure the `APPLE_CERTIFICATE` and `APPLE_CERTIFICATE_PASSWORD` environme
7979
3. Select the path to save the certificate's `.p12` file and define a password for the exported certificate.
8080
4. Convert the `.p12` file to base64 running the following script on the terminal:
8181

82-
```
82+
```sh
8383
openssl base64 -in /path/to/certificate.p12 -out certificate-base64.txt
8484
```
8585

@@ -182,3 +182,22 @@ Notarization is required when using a _Developer ID Application_ certificate.
182182
[creating a certificate signing request]: https://developer.apple.com/help/account/create-certificates/create-a-certificate-signing-request
183183
[Certificates, IDs & Profiles page]: https://developer.apple.com/account/resources/certificates/list
184184
[app-specific password]: https://support.apple.com/en-ca/HT204397
185+
186+
## Ad-Hoc Signing
187+
188+
If you do not wish to provide an Apple-authenticated identity, but still wish to sign your application, you can configure an _ad-hoc_ signature.
189+
190+
This is useful on ARM (Apple Silicon) devices, where code-signing is required for all apps from the Internet.
191+
192+
:::caution
193+
Ad-hoc code signing does not prevent MacOS from requiring users to
194+
[whitelist the installation in their Privacy & Security settings](https://support.apple.com/guide/mac-help/open-a-mac-app-from-an-unknown-developer-mh40616/mac).
195+
:::
196+
197+
To configure an ad-hoc signature, provide the pseudo-identity `-` to Tauri, e.g.
198+
199+
```json
200+
"signingIdentity": "-"
201+
```
202+
203+
For details on configuring Tauri's signing identity, see [above](#configuring-tauri).

0 commit comments

Comments
 (0)