Passer au contenu principal

Comment déployer vos applications macOS avec Appaloosa

Ajoutez un .pkg à Appaloosa, ou générez un .pkg signé à partir d'un .app ou d'un script.

Écrit par Jeremy Bodokh

Appaloosa installe automatiquement vos applications sur vos Mac enrôlés. Le format attendu est le .pkg, signé. Selon ce que fournit l'éditeur de l'application, vous êtes dans l'un des trois cas ci-dessous.

Votre cas

Ce que vous avez à faire

L'éditeur fournit un .pkg

Rien : ajoutez le fichier tel quel à Appaloosa

L'éditeur fournit un .app (souvent dans un .dmg ou un .zip)

Générer un .pkg signé à partir du .app

Vous voulez exécuter un script

Placer le script dans un .pkg signé

L'application est déjà au format .pkg

Ces applications sont distribuables en l'état. Ajoutez le fichier à Appaloosa, renseignez les informations de l'application puis déployez-la.

Ne signez pas à nouveau un .pkg fourni par un éditeur : votre signature remplacerait la sienne.

L'application est au format .app

Vous devez générer votre propre .pkg et le signer avec un certificat Developer ID Installer de votre compte Apple Developer.

Avant de commencer

  • Un Mac avec les outils en ligne de commande d'Apple (xcode-select --install).

  • Un certificat Developer ID Installer installé dans votre trousseau. Suivez le guide Apple pour le créer. Il nécessite une adhésion à l'Apple Developer Program, et seul le titulaire du compte (Account Holder) peut le créer.

Attention au type de certificat : un certificat Developer ID Application signe des applications, pas des .pkg. Il vous faut bien le certificat Developer ID Installer.

1. Récupérez le nom de votre certificat

security find-identity -v | grep "Developer ID Installer"

La commande affiche le nom complet à utiliser, par exemple Developer ID Installer: Votre Société (ABCDE12345).

2. Préparez le fichier .app

Si l'application est livrée dans un .dmg, ouvrez-le et copiez le .app dans un dossier de travail. Si elle est livrée dans un .zip, décompressez-le.

Une application téléchargée depuis un navigateur porte un marqueur de quarantaine. Retirez-le avant de générer le .pkg, sinon il est embarqué dans le paquet :

xattr -dr com.apple.quarantine ~/Downloads/TextMate.app

Ne modifiez rien d'autre dans le .app : sa signature d'origine doit rester intacte.

3. Générez le .pkg signé

productbuild --component ~/Downloads/TextMate.app /Applications \  --sign "Developer ID Installer: Votre Société (ABCDE12345)" \  ~/Downloads/TextMate.pkg

  • /Applications, après le chemin du .app, est le dossier d'installation sur les Mac de vos utilisateurs. En l'indiquant, vous n'avez pas besoin de déplacer d'abord l'application dans votre propre dossier /Applications.

  • --sign reprend le nom exact obtenu à l'étape 1. macOS peut vous demander d'autoriser l'accès au trousseau lors de la première signature.

4. Vérifiez le .pkg

pkgutil --check-signature ~/Downloads/TextMate.pkg

Le résultat doit indiquer signed by a developer certificate issued by Apple for distribution, suivi du nom de votre certificat. Vous pouvez alors ajouter le .pkg à Appaloosa.

En cas de problème

Message

Cause probable

Could not find appropriate signing identity

Le nom passé à --sign ne correspond pas à un certificat Developer ID Installer de votre trousseau. Relancez la commande de l'étape 1 et copiez le nom complet.

La commande de l'étape 1 n'affiche rien

Le certificat ou sa clé privée n'est pas dans le trousseau de ce Mac. Installez-le depuis le Mac qui a servi à le créer, ou créez-en un nouveau.

pkgutil indique no signature

Le .pkg a été généré sans l'option --sign. Relancez l'étape 3.

Exécuter un script avec un .pkg

Vous pouvez exécuter un script sur vos Mac en le plaçant dans un .pkg signé, par exemple pour installer un outil ou appliquer un réglage.

  1. Créez un dossier scripts contenant votre script, nommé exactement postinstall, sans extension. Il doit commencer par #!/bin/bash (ou #!/bin/zsh) et être exécutable :

    chmod +x scripts/postinstall
  2. Générez le paquet, puis signez-le :

    pkgbuild --nopayload --scripts scripts \  --identifier com.votresociete.monscript --version 1.0 \  monscript-composant.pkgproductbuild --package monscript-composant.pkg \  --sign "Developer ID Installer: Votre Société (ABCDE12345)" \  monscript.pkg
  3. Vérifiez monscript.pkg avec pkgutil --check-signature, puis ajoutez-le à Appaloosa.

Le script s'exécute avec les droits administrateur (root), sans session utilisateur. Testez-le d'abord sur un Mac de test, et terminez-le par exit 0 : tout autre code de sortie fait échouer l'installation.

Avez-vous trouvé la réponse à votre question ?