docs: clarify macOS installation steps for unsigned apps

calypsonet · Dec 3, 2024 · 079f29a · 079f29a
1 parent 02fdda3
commit 079f29a
Show file tree

Hide file tree

Showing 2 changed files with 18 additions and 7 deletions.
diff --git a/content/assistance-tools/basic-card-personalizer/_index.md b/content/assistance-tools/basic-card-personalizer/_index.md
@@ -45,10 +45,16 @@ This tool requires two PC/SC readers:
    the GitHub repository is private. Please request access from [CNA](https://calypsonet.org)). Choose the installation
    file that matches your operating system:
     * **Windows:** `.msi` package
-    * **macOS:** `.dmg` package
+    * **macOS:** `.dmg` package (available in both arm64 version for Apple Silicon Macs and x64 version for Intel Macs)
     * **Linux:** `.deb` package
 2. **Windows:** double-click the `.msi` package to start the installation process.
-3. **macOS:** open the `.dmg` file and drag the application to the Applications folder.
+3. **macOS:**
+    * Open the `.dmg` file and drag the application to the Applications folder
+    * Since the application is not signed with an Apple developer certificate, you'll need to authorize it:
+        1. When first launching the app, you may see a security warning
+        2. Go to System Settings > Privacy & Security
+        3. Scroll down to find the message about the blocked application
+        4. Click "Open Anyway" to authorize the application
 4. **Linux:** use your distribution's package manager to install the `.deb` package.
 5. **Important note:** currently, the installer does not automatically create a shortcut in the Start Menu (Windows) or
    Applications menu (macOS). If you want quick access, you will need to create a shortcut manually.

diff --git a/content/assistance-tools/basic-legacysam-personalizer/_index.md b/content/assistance-tools/basic-legacysam-personalizer/_index.md
@@ -44,15 +44,20 @@ This tool requires two PC/SC contact readers:
    the [releases page](https://github.com/calypsonet/cna-tool-basic-card-perso-app/releases) to download it. (Note:
    the GitHub repository is private. Please request access from [CNA](https://calypsonet.org)). Choose the installation
    file that matches your operating system:
-    * **Windows:** `.msi` package
-    * **macOS:** `.dmg` package
-    * **Linux:** `.deb` package
+   * **Windows:** `.msi` package
+   * **macOS:** `.dmg` package (available in both arm64 version for Apple Silicon Macs and x64 version for Intel Macs)
+   * **Linux:** `.deb` package
 2. **Windows:** double-click the `.msi` package to start the installation.
-3. **macOS:** open the `.dmg` file and drag the application to the Applications folder.
+3. **macOS:**
+   * Open the `.dmg` file and drag the application to the Applications folder
+   * Since the application is not signed with an Apple developer certificate, you'll need to authorize it:
+      1. When first launching the app, you may see a security warning
+      2. Go to System Settings > Privacy & Security
+      3. Scroll down to find the message about the blocked application
+      4. Click "Open Anyway" to authorize the application
 4. **Linux:** use your distribution's package manager to install the `.deb` package.
 5. **Important note:** the installer does not automatically create a shortcut in the Start Menu (Windows) or
    Applications menu (macOS). You need to create one manually.
-
 <br>
 
 ## Launch the Tool