Mac-apps ondertekenen en notariseren in heldere taal

Kort antwoord

Ondertekenen zet je naam op de app en laat zien dat hij niet is veranderd. Notarisatie stuurt hem naar de geautomatiseerde scan van Apple. Stapling voegt het resultaat toe, zodat het offline kan worden gecontroleerd. Je doet ze in die volgorde, en je doet ze als laatste, nadat de build definitief is.

Als je je app alleen ooit vanuit Xcode hebt gedraaid, kan dit deel van het uitbrengen aanvoelen als een muur van certificaten. De ideeën zijn eenvoudig, en er zijn er maar drie. Voor alle details, met de documenten van Apple erbij, lees je wat notarisatie op een Mac is. Dit bericht is de korte versie voor makers.

De drie stappen

Ondertekenen is jouw naam op de app. Een Developer ID-certificaat van Apple zegt wie hem heeft gemaakt, en de handtekening laat zien dat er sindsdien niets is veranderd. Dat certificaat krijg je met een lidmaatschap van het Apple Developer Program, voor US$ 99 per jaar.
Notarisatie is een geautomatiseerde scan. Je uploadt de ondertekende app, de dienst van Apple zoekt naar schadelijke inhoud en ondertekeningsproblemen, en als die er geen vindt, geeft die een ticket uit. Niemand bij Apple gebruikt je app, en het is geen App Review.
Stapling voegt dat ticket aan je bestand toe, zodat een Mac het kan controleren zonder online te zijn.

Als je alleen via de Mac App Store verkoopt, sla je de laatste twee stappen over. Apple ondertekent store-apps, en de documentatie van Apple zegt dat het storeproces gelijkwaardige beveiligingscontroles heeft.

Wat je gebruikers zien als je het overslaat

Ze krijgen een waarschuwing. macOS zegt dat het de app niet kan verifiëren, en sinds macOS Sequoia komt je er met Control-klikken niet meer langs. Ze moeten naar Systeeminstellingen en “Toch openen” kiezen. Sommige mensen haken daar af, en ik kan ze niet kwalijk nemen. Wat “Apple kon niet verifiëren” betekent laat dezelfde waarschuwing van hun kant zien, wat de moeite waard is om één keer te lezen.

De volgorde die je een middag bespaart

Maak de build af. Alles wat je na het ondertekenen verandert, breekt de handtekening.
Onderteken eerst de geneste code, zoals frameworks en helpers, en daarna de app zelf. Gebruik de hardened runtime en een veilige tijdstempel, omdat notarisatie beide vereist.
Zet hem in een DMG als je zo uitbrengt, en onderteken die ook.
Dien hem in met notarytool. Apple zegt dat scannen meestal minder dan een uur duurt.
Lees het logboek, ook als alles goed ging.
Staple hem met stapler.

Controleer je eigen build

spctl -a -vv /Applications/YourApp.app
xcrun stapler validate /Applications/YourApp.app

Je wilt source=Notarized Developer ID bij de eerste, en een succesbericht bij de tweede. Plak wat je krijgt in de notarisatie-uitleg, en die zegt wat elke regel betekent, of laat je weten als er iets is wat hij niet herkent. Hij leest de tekst in je browser en stuurt niets ergens heen.

Doe daarna de test die het meeste vangt: download je eigen build via een browser op een andere Mac of gebruikersaccount, en open hem. De lanceringschecklist heeft dit en de andere stappen in de juiste volgorde.

Wat genotariseerd niet betekent

Het betekent niet dat hij goed, privé of veilig is. Het betekent dat de geautomatiseerde scan van Apple niets vond wat die kent. Wees voorzichtig om op je site niet meer te beloven. Hoe je ziet of een Mac-app veilig is legt uit wat elke controle wel en niet kan bewijzen, vanuit het oogpunt van een gebruiker.

Wat MacPip hiermee doet

MacPip vraagt om ondertekende en genotariseerde downloads. Open source-apps zijn welkom zonder dat, en hun rapport zegt dat. Een blauw vinkje betekent dat een persoon de app op de getoonde datum heeft gecontroleerd, en handtekening en notarisatie staan alleen in het rapport als we die op een gedownload exemplaar hebben bevestigd. Het is geen veiligheidsgarantie, en onze regels zeggen dat ook. Als je build klaar is, kun je hem gratis vermelden.