Notarization for macOS 10.14.5+/ru: what changed

Revision 3 to 4. Removed lines have a minus sign; added lines have a plus sign.

Old	New		Line
1	1		## Обзор
2	2
3	3		Начиная с macOS 10.14.5 (Mojave), программное обеспечение, подписанное новым сертификатом разработчика Apple, и все новые или обновленные расширения ядра должны быть нотариально заверены для запуска. Начиная с macOS 10.15 (Catalina), все программное обеспечение, созданное после 1 июня 2019 года, и код, подписанный сертификатом разработчика Apple, необходимо нотариально заверить. Нотариальное заверение не требуется для программного обеспечения, распространяемого через Apple App Store, поскольку процесс отправки в App Store уже включает эквивалентные проверки безопасности.
4	4
5	5		Нотариальное заверение разработано Apple, чтобы дать пользователям больше уверенности в том, что программное обеспечение, подписанное разработчиками Apple, было проверено Apple на наличие вредоносных компонентов. Нотариальное заверение - это не проверка приложения. Нотариальная служба Apple - это автоматизированная система, которая сканирует программное обеспечение на наличие вредоносного содержимого, проверяет наличие проблем с подписью кода и возвращает результаты. Если проблем нет, нотариальная служба генерирует удостоверение для установки программного обеспечения; нотариальная служба также публикует это удостоверение в Интернете, где его может найти Gatekeeper (прим.перев.: букв. привратник).
6	6
7	7		Когда пользователь впервые устанавливает или запускает программное обеспечение, наличие удостоверения (онлайн или прикрепленного к исполняемому файлу) сообщает Gatekeeper, что Apple нотариально заверила программное обеспечение. Затем Gatekeeper помещает описательную информацию в диалоговое окно первоначального запуска, чтобы помочь пользователю сделать осознанный выбор, запускать ли приложение.
8	8
9	9		> Note: Даже если приложение не было нотариально заверено, его все равно можно запустить, щелкнув приложение, удерживая клавишу Control, или щелкнув правой кнопкой мыши для вызова контекстного меню, выбрав «Открыть» - см. диалоговое "обходное" окно Gatekeeper в галерее [[Notarization for macOS 10.14.5+/ru\|ниже]].
10	10
11	11		Подписание кода приложения без нотариального заверения - теперь совершенно бессмысленное упражнение, если только вы не распространяете свое приложение только через App Store.
12	12
13	13		## Диалоговые окна Gatekeeper
14	14
15	15		![](/wiki-images/2/29/Macos-mojave-app-downloaded-from-internet-alert-dark.jpg)
16	16
17	17		Диалоговое окно Gatekeeper до Catalina, в котором сначала открывается нотариально не заверенное приложение (диалоговое окно Mojave macOS 10.14 )
18	18
19	19		![](/wiki-images/c/c6/Screenshot_2020-01-02_at_22.42.01.png)
20	20
21	21		Диалоговое окно Gatekeeper, в котором сначала открывается подписанное и нотариально заверенное приложение (диалоговое окно Catalina macOS 10.15.1)
22	22
23	23		![](/wiki-images/4/4a/Gatekeep_no.png)
24	24
25	25		Сначала открывается диалоговое окно Gatekeeper, в котором приложение не подписано и не заверено нотариально. (диалоговое окно Catalina macOS 10.15.1)
26	26
27	27		![](/wiki-images/2/21/Macos-catalina-alert-unsigned-override.jpg)
28	28
29	29		Диалоговое "обходное" окно Gatekeeper, доступ к которому можно получить, щелкнув приложение, удерживая клавишу Control. (диалоговое окно Catalina macOS 10.15.3)
30	30
31	31		## Требования к нотариальному заверению
32	32
33	33		Для нотариального заверения требуются инструменты командной строки Xcode от Xcode 10 или новее. Для создания нового приложения для нотариального заверения требуется macOS 10.13.6 или новее. Для прикрепления приложения требуется macOS 10.12 или новее.
34	34
35	35		Нотариальная служба Apple требует от вас:
36	36
37	37		- Включения подписывания кода для всех распространяемых вами исполняемых файлов.
38	38		- Включения возможности заверения через [[Hardened runtime for macOS\|Hardened Runtime]] для вашего приложения и целей командной строки.
39	39		- Использования приложения «Developer ID», расширения ядра или сертификата установщика для подписи кода.
40	40		- Включения безопасной метки времени в свою подпись для подписи кода (включения параметра --timestamp при запуске инструмента кодовой подписи).
41	41		- Не включать право com.apple.security.get-task-allow со значением, равным любому варианту истинного. Если в вашем программном обеспечении размещаются сторонние плагины и требуется это право для отладки плагина в контексте исполняемого файла хоста, см. [Avoid the Get-Task-Allow Entitlement](https://developer.apple.com/documentation/xcode/notarizing_macos_software_before_distribution/resolving_common_notarization_issues#3087731).
42	42		- Ссылки на SDK для macOS 10.9 или новее.
43	43
44	44		3 сентября 2019 года Apple объявила, что до января 2020 года разработчики могут нотариально заверить новые версии приложений, даже если они не были заверены через [[Hardened runtime for macOS\|hardened]] или полностью соответствуют обычным требованиям. Позднее этот срок был продлен до 3 февраля 2020 года. Вышеуказанные требования к нотариальному удостоверению теперь действуют в полной мере.
45	45
46	46		### Заявление Apple от 23 декабря 2019 г.
47	47
48	48		В июне мы объявили, что все программное обеспечение Mac, распространяемое за пределами Mac App Store, должно быть нотариально заверено Apple, чтобы оно могло работать по умолчанию на macOS Catalina. В сентябре мы временно скорректировали предварительные условия нотариального заверения, чтобы упростить этот переход и защитить пользователей macOS Catalina, которые продолжают использовать более старые версии программного обеспечения. Начиная с 3 февраля 2020 года, все представленное программное обеспечение должно соответствовать предварительным требованиям для нотариального заверения.
49	49
50	50		Если вы еще не сделали этого, загрузите программное обеспечение в нотариальную службу и просмотрите журнал разработчика на наличие предупреждений. Эти предупреждения станут ошибками с 3 февраля и должны быть исправлены, чтобы ваше программное обеспечение было нотариально заверенным. Программное обеспечение, нотариально заверенное до 3 февраля, по умолчанию будет продолжать работать на macOS Catalina.
51	51
52	52		Напоминаем, что все пакеты установщика должны быть подписаны, поскольку они могут содержать исполняемый код. Образы дисков не нужно подписывать, хотя их подписание может помочь вашим пользователям проверить их содержимое.
53	53
54	54		## Нотариальное заверение заявки
55	55
56	56		В этих инструкциях предполагается, что вы выполнили другие подготовительные шаги: [[Code Signing for macOS\|подписание кода]] приложения, реализованное в [[Hardened runtime for macOS\|усиленной среде выполнения]], [[Code Signing for macOS\|подписание кода]] установщика pkg (если он у вас есть) и т.д.
57	57
58	58		Вы не можете выгрузить пакет .app непосредственно в нотариальную службу, вам необходимо создать сжатый архив, содержащий приложение, или вы можете поместить приложения, расширения ядра и другое программное обеспечение в контейнер, например образ диска, и нотариально заверить контейнер. Нотариальная служба принимает образы дисков (формат UDIF), подписанный установщиком плоских пакетов, и ZIP-архивы. Он также обрабатывает вложенные контейнеры, например пакеты внутри образа диска.
59	59
60	60		### Шаг 1 - Создание образа диска
61	61
62	62		Создайте образ диска, открыв Терминал и выполнив следующую команду:
63	63
64	64		``` bash
65	65		hdiutil create -volname MyApp -srcfolder /path/to/folder -ov -format UDBZ MyApp.dmg
66	66		```
67	67
68	68		### Шаг 2 - Код для подписи образа диска
69	69
70	70		Код подписывает образ диска, открыв Терминал и выполнив следующую команду:
71	71
72	72		``` bash
73	73		codesign -s "Developer ID Application: Your Name (Team ID)" --timestamp MyApp.dmg
74	74		```
75	75
76	76		### Шаг 3. Создание пароля для конкретного приложения
77	77
78	78		Чтобы сгенерировать пароль для конкретного приложения, обратитесь к этой [статье службы поддержки Apple](https://support.apple.com/en-us/HT204397).
79	79
80	80		> Note: это пароль, который будет специфическим для приложения нотариального заверения (xcrun altool), а не для нотариально заверенного приложения. Поэтому вам нужно сделать это только один раз, но убедитесь, что вы скопировали сгенерированный пароль и сохранили его где-нибудь.
81	81
82	82		> Tip: Сохраните пароль в связке ключей с помощью:\
83	83		> `xcrun altool -u "<your email>" -p "<app-specific pwd>" --store-password-in-keychain-item "<name for pwd>"`\
84	84		> \
85	85		> А затем вы можете использовать `"@keychain:<name for pwd>"` вместо `"<app-specific pwd>"` в следующих командах.
86	86
87	87		### Шаг 4 - Загрузка образа диска в нотариальную службу
88	88
89	89		> Note: Когда вы нотариально заверяете образ диска контейнера, altool также нотариально заверяет приложение внутри, поэтому вы можете пропустить этап нотариального заверения самого приложения.
90	90
91	91		Загрузите файл образа диска в нотариальную службу Apple, открыв Терминал и выполнив следующую команду:
92	92
93	93		``` bash
94	94		xcrun altool --notarize-app --primary-bundle-id "<your identifier>" -u "<your email>" -p "<app-specific pwd>" -t osx -f /path/to/MyApp.dmg
95	95		```
96	96
97	97		primary-bundle-id помогает отслеживать автоматическую корреспонденцию от службы нотариального заверения. Указанное вами значение не обязательно должно совпадать с идентификатором пакета отправленного приложения или иметь какое-либо конкретное значение. Это должно иметь смысл только для вас. Служба нотариального заверения включает значение всякий раз, когда она отправляет вам электронное письмо относительно данного `altool` представления.
98	98
99	99		Если загрузка прошла успешно, вы должны получить следующий результат:
100	100
101	101		No errors uploading 'MyApp.dmg'.
102	102		RequestUUID = 3af4e56f-162b-75bc-827f-7233f92bf20c
103	103
104	104		### Шаг 5 - Проверка процесса нотариального заверения
105	105
106	106		Процесс нотариального заверения обычно занимает менее часа, поэтому вы можете время от времени проверять его ход, открывая Терминал и выполняя следующую команду:
107	107
108	108		``` bash
109	109		xcrun altool --notarization-history 0 -u "<your email>" -p "<app-specific pwd>"
110	110		```
111	111
112	112		Когда процесс нотариального заверения завершится успешно, вышеуказанная команда вернет информацию, подобную следующей:
113	113
114	114		Notarization History - page 0
115	115
116	116		Date RequestUUID Status Status Code Status Message
117	117		------------------------- ------------------------------------ ------- ----------- ----------------
118	118		2019-12-08 06:24:03 +0000 3af4e56f-162b-75bc-827f-7233f92bf20c success 0 Package Approved
119	119
120	120		Next page value: 1575786243000
121	121
122	122		Вы также должны получить электронное письмо от Apple, подобное приведенному ниже, в случае успешного нотариального заверения:
123	123
124	124		Dear <First_Name>,
125	125
126	126		Your Mac software has been notarized. You can now export this software and distribute it directly to users.(rus: Программное обеспечение вашего Mac было нотариально заверено. Теперь вы можете экспортировать это программное обеспечение и распространять его непосредственно среди пользователей.)
127	127
128	128		Bundle Identifier: com.example.MyApp.001
129	129		Request Identifier: 3af4e56f-162b-75bc-827f-7233f92bf20c
130	130
131	131		For details on exporting a notarized app, visit Xcode Help or the notarization guide.(rus: Для получения дополнительных сведений об экспорте нотариально заверенного приложения посетите справку Xcode или руководство по нотариальному заверению.)
132	132
133	133		Best Regards,
134	134		Apple Developer Relations
135	135
136	136		### Шаг 6 - Прикрепление удостоверения к образу диска
137	137
138	138		В процессе нотариального заверения создается удостоверение, которое сообщает Gatekeeper, что ваше приложение нотариально заверено. После успешного завершения нотариального заверения в следующий раз, когда любой пользователь попытается запустить ваше приложение в macOS 10.14 или более поздней версии, Gatekeeper найдет удостоверение в Интернете. Сюда входят пользователи, которые загрузили ваше приложение до нотариального заверения.
139	139
140	140		После того, как на шаге 5 будет получено сообщение о статусе «Пакет одобрен», вы также должны прикрепить удостоверение к файлу образа диска с помощью инструмента прикрепления, чтобы в будущие дистрибутивы включили билет. Это гарантирует, что Gatekeeper сможет найти удостоверение, даже если сетевое соединение недоступно.
141	141
142	142		Чтобы прикрепить удостоверение к файлу образа диска, откройте Терминал и выполните следующую команду:
143	143
144	144		``` bash
145	145		xcrun stapler staple /path/to/MyApp.dmg
146	146		```
147	147
148	148		Если команда завершится успешно, вывод должен быть похож на:
149	149
150	150		Processing: /Path/to/MyApp.dmg
151	151		Processing: /Path/to/MyApp.dmg
152	152		The staple and validate action worked!
153	153
154	154		### Шаг 7 - Подтверждение нотариального заверения образа диска
155	155
156	156		Чтобы подтвердить нотариальное заверение образа диска, откройте Терминал и выполните следующую команду:
157	157
158	158		``` bash
159	159		spctl -a -vv -t install MyApp.dmg
160	160		```
161	161
162	162		Успешная проверка процесса нотариального заверения должна привести к примерно следующему результату:
163	163
164	164		MyApp.dmg: accepted
165	165		source=Notarized Developer ID
166	166		origin=Developer ID Application: <Developer Name> (<TEAM_ID>)
167	167
168	168		### Шаг 8 - Подтвердить нотариальное заверение приложения
169	169
170	170		Чтобы подтвердить нотариальное заверение приложения, установите приложение, откройте Терминал и выполните следующую команду:
171	171
172	172		``` bash
173	173		spctl -a -vv /Applications/MyApp.app
174	174		```
175	175
176	176		Успешное подтверждение процесса нотариального заверения должна привести к примерно следующему результату:
177	177
178	178		/Applications/MyApp.app: accepted
179	179		source=Notarized Developer ID
180	180		origin=Developer ID Application: <Developer Name> (<TEAM_ID>)
181	181
182	182		Важно: протестируйте приложение, поместив его в каталог Applications. Оно по-разному обрабатывается Gatekeeper'ом, когда находится в "установленном" месте.
183	183
184	184		В качестве альтернативы, рекомендуемый Apple способ проверить нотариальное заверение приложения - открыть Терминал и выполнить следующую команду:
185	185
186	186		xcrun stapler validate MyApp.app
187	187
188	188		Успешная верификация процесса нотариального заверения должна привести к примерно следующему результату:
189	189
190	190		Processing: MyApp.app
191	191		The validate action worked!
192	192
193	193		## Нотариальное заверение инструмента командной строки
194	194
195	195		Инструменты командной строки могут быть подписаны кодом, но их нелегко нотариально заверить, потому что у них нет [[Application Bundle]] и отдельного `Info.plist` [[macOS property list files\|property list file]]. Вы можете относительно легко вставить файл `Info.plist` в исполняемый файл инструмента командной строки.
196	196
197	197		### Вставка Info.plist в исполняемый файл командной строки
198	198
199	199		Вот шаблон, который вы можете настроить для своей утилиты командной строки. Я извлек его из исполняемого файла утилиты командной строки, написанного на C и названного "simplereach", который я создал с помощью Xcode 11.3.1 в Mojave после включения "Create Info.plist Section in Binary"(Создать раздел Info.plist в двоичном формате) в параметрах "Packaging"(Упаковка) (я пропустил ненужные Xcode-related build info).
200	200
201	201		``` xml
202	202		<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
203	203		<plist version="1.0">
204	204		<dict>
205	205		<key>BuildMachineOSBuild</key>
206	206		<string>18G8022</string>
207	207		<key>CFBundleDevelopmentRegion</key>
208	208		<string>English</string>
209	209		<key>CFBundleDocumentTypes</key>
210	210		<array>
211	211		<dict>
212	212		<key>CFBundleTypeOSTypes</key>
213	213		<array>
214	214		<string>fold</string>
215	215		<string>disk</string>
216	216		<string>****</string>
217	217		</array>
218	218		</dict>
219	219		</array>
220	220		<key>CFBundleExecutable</key>
221	221		<string>simplereach</string>
222	222		<key>CFBundleIdentifier</key>
223	223		<string>com.mycompany.simplereach</string>
224	224		<key>CFBundleInfoDictionaryVersion</key>
225	225		<string>6.0</string>
226	226		<key>CFBundleName</key>
227	227		<string>simplereach</string>
228	228		<key>CFBundlePackageType</key>
229	229		<string>APPL</string>
230	230		<key>CFBundleShortVersionString</key>
231	231		<string>1.0</string>
232	232		<key>CFBundleSupportedPlatforms</key>
233	233		<array>
234	234		<string>MacOSX</string>
235	235		</array>
236	236		<key>CFBundleVersion</key>
237	237		<string>1</string>
238	238		<key>LSMinimumSystemVersion</key>
239	239		<string>10.14</string>
240	240		</dict>
241	241		</plist>
242	242		```
243	243
244	244		Вам нужно будет изменить несколько ключевых строк в приведенном выше файле. Замените свой:
245	245
246	246		- BuildMachineOSBuild строку можно получить из Терминала с помощью команды `sw_vers`. '18G8022' предназначена строго для Mojave 10.14.6.
247	247		- CFBundleDevelopmentRegion строка, если она не "английская".
248	248		- CFBundleExecutable строка с названием вашей утилиты.
249	249		- CFBundleIdentifier строка (обычно ваше доменное имя в обратном порядке, за которым следует имя утилиты; не стесняйтесь использовать что-нибудь уникальное).
250	250		- CFBundleName строка (используйте то же значение, что и для CFBundleExecutable).
251	251		- CFBundleShortVersionString строка с номером вашей версии.
252	252		- LSMinimumSystemVersion строка с минимальной версией macOS, на которой будет работать ваша утилита.
253	253
254	254		Затем вы можете вставить файл `Info.plist` в свое приложение, указав компоновщику добавить его как раздел __TEXT с именем __info_plist:
255	255
256		-	~~`fpc -k"-sectcreate __TEXT __info_plist Info.plist" my_utility.pas`~~
	256	+	```text
	257	+	fpc -k"-sectcreate __TEXT __info_plist Info.plist" my_utility.pas
	258	+	```
257	259
258	260		Чтобы проверить, успешно ли он вставлен, вы можете запустить следующую команду в Терминале:
259	261
260		-	~~`otool -X -v -s __TEXT __info_plist my_utility`~~
	262	+	```text
	263	+	otool -X -v -s __TEXT __info_plist my_utility
	264	+	```
261	265
262	266		### Подпись исполняемого файла командной строки
263	267
264	268		Теперь, когда файл `Info.plist` был вставлен в исполняемый файл, вы готовы подписать его кодом, выполнив следующие команды в Терминале:
265	269
266		-	~~`cd /path/to/my_utility`\~~
267		-	~~`mkdir bin`\~~
268		-	~~`mv my_utility bin/`\~~
269		-	~~`codesign -f --strict --timestamp --options=runtime -s "Developer ID Application: YOUR NAME (TEAM_ID)" bin/my_utility`~~
	270	+	```text
	271	+	cd /path/to/my_utility
	272	+	mkdir bin
	273	+	mv my_utility bin/
	274	+	codesign -f --strict --timestamp --options=runtime -s "Developer ID Application: YOUR NAME (TEAM_ID)" bin/my_utility
	275	+	```
270	276
271	277		Критично, чтобы вы создали каталог `bin` и переместили в него свою утилиту перед подписанием. В противном случае создастся каталог `_CodeSignature`, который не подойдет для утилиты командной строки, и процесс нотариального заверения не состоится.
272	278
273	279		Чтобы убедиться, что ваши усилия увенчались успехом, вы можете запустить следующую команду в Терминале:
274	280
275		-	~~`codesign -vv bin/my_utility`~~
	281	+	```text
	282	+	codesign -vv bin/my_utility
	283	+	```
276	284
277	285		Если подписание кода прошло успешно, результат должен быть примерно таким:
278	286
279		-	~~`my_utility: valid on disk`\~~
280		-	~~`my_utility: satisfies its Designated Requirement`~~
	287	+	```text
	288	+	my_utility: valid on disk
	289	+	my_utility: satisfies its Designated Requirement
	290	+	```
281	291
282	292		### Отправка исполняемого файла командной строки на нотариальное заверение
283	293
284	294		Поскольку вы не можете нотариально заверить пустой исполняемый файл, вам необходимо включить его в контейнер (.dmg - образ диска, .pkg - пакет установщика или файл архива ZIP). ZIP-архив является самым простым, поэтому в Терминале выполните следующую команду:
285	295
286		-	~~`zip my_utility.zip bin/my_utility`~~
	296	+	```text
	297	+	zip my_utility.zip bin/my_utility
	298	+	```
287	299
288	300		Теперь вы готовы загрузить свою утилиту командной строки на серверы Apple для нотариального заверения. В терминале выполните следующую команду:
289	301
290		-	~~`xcrun altool --notarize-app --primary-bundle-id "<your identifier>" -u "<your email>" -p "<app-specific pwd>" -t osx -f my_utility.zip`~~
	302	+	```text
	303	+	xcrun altool --notarize-app --primary-bundle-id "<your identifier>" -u "<your email>" -p "<app-specific pwd>" -t osx -f my_utility.zip
	304	+	```
291	305
292	306		Если у вас еще нет пароля для приложения, см. [[Notarization for macOS 10.14.5+/ru\|выше]], чтобы узнать, как его сгенерировать.
293	307
294	308		Primary-bundle-id помогает отслеживать автоматическую корреспонденцию от службы нотариального заверения. Указанное вами значение не обязательно должно совпадать с идентификатором пакета отправленного приложения или иметь какое-либо конкретное значение. Это должно иметь смысл только для вас. Услуга нотариального заверения включает значение всякий раз, когда она отправляет вам электронное письмо относительно данной альтернативной заявки.
295	309
296	310		Если загрузка прошла успешно, вы должны получить следующий результат:
297	311
298		-	~~`No errors uploading 'my_utility'.`\~~
299		-	~~`RequestUUID = 3af4e56f-162b-75bc-827f-7233f92bf20c`~~
	312	+	```text
	313	+	No errors uploading 'my_utility'.
	314	+	RequestUUID = 3af4e56f-162b-75bc-827f-7233f92bf20c
	315	+	```
300	316
301	317		### Проверка процесса нотариального заверения
302	318
303	319		Процесс нотариального заверения обычно занимает от 10 до 15 минут, поэтому вы можете время от времени проверять его ход, выполняя следующую команду из Терминала:
304	320
305		-	~~`xcrun altool --notarization-history 0 -u "<your email>" -p "<app-specific pwd>"`~~
	321	+	```text
	322	+	xcrun altool --notarization-history 0 -u "<your email>" -p "<app-specific pwd>"
	323	+	```
306	324
307	325		Когда процесс нотариального заверения завершится успешно, вышеуказанная команда вернет информацию, подобную следующей:
308	326
309	327		Notarization History - page 0
310	328
311	329		Date RequestUUID Status Status Code Status Message
312	330		------------------------- ------------------------------------ ------- ----------- ----------------
313	331		2021-04-22 10:55:03 +0000 3af4e56f-162b-76bc-826f-7263f92bf20c success 0 Package Approved
314	332
315	333		Next page value: 1575786243000
316	334
317	335		Вы также должны получить электронное письмо от Apple, подобное приведенному ниже, в случае успешного нотариального заверения:
318	336
319	337		Dear <First Name>,
320	338
321	339		Your Mac software has been notarized. You can now export this software and distribute it directly to users.(rus: Программное обеспечение вашего Mac было нотариально заверено. Теперь вы можете экспортировать это программное обеспечение и распространять его непосредственно среди пользователей.)
322	340
323	341		Bundle Identifier:
324	342		Request Identifier: 70dbe301-d3a7-4931-9ec3-61c5cc80573c
325	343
326	344		For details on exporting a notarized app, visit Xcode Help or the notarization guide.(rus: Для получения дополнительных сведений об экспорте нотариально заверенного приложения посетите справку Xcode или руководство по нотариальному заверению.)
327	345
328	346		Best Regards,
329	347		Apple Developer Relations
330	348
331	349		В случае неудачного нотариального заверения обратитесь за помощью к разделу [[Notarization for macOS 10.14.5+/ru\|Устранение неполадок]] ниже.
332	350
333	351		### Нотариальное заверение исполняемого файла командной строки
334	352
335	353		Чтобы проверить нотариальное заверение инструмента командной строки, откройте Терминал и выполните следующую команду:
336	354
337		-	~~`spctl -a -t open --context context:primary-signature -vv my_utility `~~
	355	+	```text
	356	+	spctl -a -t open --context context:primary-signature -vv my_utility
	357	+	```
338	358
339	359		Успешная проверка правильно нотариально заверенного исполняемого файла командной строки должна привести к выводу, подобному следующему:
340	360
341		-	~~`my_utility: accepted`\~~
342		-	~~`source=Notarized Developer ID`\~~
343		-	~~`origin=Developer ID Application: Your Name (Z9HBGNDZZ9)`~~
	361	+	```text
	362	+	my_utility: accepted
	363	+	source=Notarized Developer ID
	364	+	origin=Developer ID Application: Your Name (Z9HBGNDZZ9)
	365	+	```
344	366
345	367		## Устранение неполадок
346	368
347	369		### Процесс загрузки нотариального заверения
348	370
349	371		Если процесс загрузки нотариального заверения не проходит должным образом, вы сможете найти сжатый файл журнала во временном каталоге, который может пролить свет на то, что произошло. Вы можете просмотреть его, открыв Терминал и выполнив следующие команды (замените имя вашего файла журнала, который включает идентификатор пакета вашего приложения):
350	372
351	373		``` bash
352	374		cd ${TMPDIR}
353	375		gzcat c51ca05f-cf49-405f-be57-26873faab5f6_3073718126753816760org.sentry.myapp-20191231004646-273.itmsp6022059143057318377.log
354	376		```
355	377
356	378		который для успешной загрузки нотариального заверения должен выглядеть примерно так:
357	379
358		-	~~` [2019-12-31 19:46:46 AEDT] <main> INFO: Starting upload for packageName: org.sentry.myapp-20191231004646-273.itmsp`\~~
359		-	` [2019-12-31 19:46:46 AEDT] <main> INFO: Thread Pool Configuration: {processors=12, perCoreThreadMultiplier=1.65, coreThreads=6, maxThreads=14, minConnections=6, maxConnections=13, rateLimit=100000000000 KBs}`\
360		-	` [2019-12-31 19:46:46 AEDT] <main> INFO: Reservation CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml created for file: (metadata.xml), part count:(1), file size: (538)`\
361		-	` [2019-12-31 19:46:46 AEDT] <main> INFO: Reservation CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/MyApp_31122019.dmg created for file: (MyApp_31122019.dmg), part count:(1), file size: (1400933)`\
362		-	` [2019-12-31 19:46:46 AEDT] <RLT-002> INFO: Starting upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml) file: (metadata.xml/1) size: 538`\
363		-	` [2019-12-31 19:46:46 AEDT] <RLT-003> INFO: Starting upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/myapp_31122019.dmg) file: (MyApp_31122019.dmg/1) size: 1400933`\
364		-	~~` [2019-12-31 19:46:47 AEDT] <RLT-002> INFO: Finished part upload for: (metadata.xml/1) 2.91 KB/s in 0 seconds`\~~
365		-	~~` [2019-12-31 19:46:47 AEDT] <RLT-002> INFO: Finished upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml) file: (metadata.xml)`\~~
366		-	~~` [2019-12-31 19:46:47 AEDT] <pool-8-thread-1> INFO: Reservation committed: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml) file: (metadata.xml)`\~~
367		-	~~` [2019-12-31 19:46:49 AEDT] <RLT-003> INFO: Finished part upload for: (MyApp_31122019.dmg/1) 781.33 KB/s in 1 second`\~~
368		-	` [2019-12-31 19:46:49 AEDT] <RLT-003> INFO: Finished upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/MyApp_31122019.dmg) file: (MyApp_31122019.dmg)`\
369		-	~~` [2019-12-31 19:46:49 AEDT] <main> INFO: Waiting on reservation commit(s) to finish.`\~~
370		-	~~` [2019-12-31 19:46:49 AEDT] <pool-8-thread-1> INFO: Reservation committed: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/MyApp_31122019.dmg) file: (MyApp_31122019.dmg)`\~~
371		-	~~` [2019-12-31 19:46:49 AEDT] <pool-8-thread-1> INFO: All reservation commit(s) finished.`\~~
372		-	~~` [2019-12-31 19:46:49 AEDT] <main> INFO: 456.36 KB/s in 3 seconds`~~
	380	+	```text
	381	+	[2019-12-31 19:46:46 AEDT] <main> INFO: Starting upload for packageName: org.sentry.myapp-20191231004646-273.itmsp
	382	+	[2019-12-31 19:46:46 AEDT] <main> INFO: Thread Pool Configuration: {processors=12, perCoreThreadMultiplier=1.65, coreThreads=6, maxThreads=14, minConnections=6, maxConnections=13, rateLimit=100000000000 KBs}
	383	+	[2019-12-31 19:46:46 AEDT] <main> INFO: Reservation CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml created for file: (metadata.xml), part count:(1), file size: (538)
	384	+	[2019-12-31 19:46:46 AEDT] <main> INFO: Reservation CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/MyApp_31122019.dmg created for file: (MyApp_31122019.dmg), part count:(1), file size: (1400933)
	385	+	[2019-12-31 19:46:46 AEDT] <RLT-002> INFO: Starting upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml) file: (metadata.xml/1) size: 538
	386	+	[2019-12-31 19:46:46 AEDT] <RLT-003> INFO: Starting upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/myapp_31122019.dmg) file: (MyApp_31122019.dmg/1) size: 1400933
	387	+	[2019-12-31 19:46:47 AEDT] <RLT-002> INFO: Finished part upload for: (metadata.xml/1) 2.91 KB/s in 0 seconds
	388	+	[2019-12-31 19:46:47 AEDT] <RLT-002> INFO: Finished upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml) file: (metadata.xml)
	389	+	[2019-12-31 19:46:47 AEDT] <pool-8-thread-1> INFO: Reservation committed: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/metadata.xml) file: (metadata.xml)
	390	+	[2019-12-31 19:46:49 AEDT] <RLT-003> INFO: Finished part upload for: (MyApp_31122019.dmg/1) 781.33 KB/s in 1 second
	391	+	[2019-12-31 19:46:49 AEDT] <RLT-003> INFO: Finished upload for reservation: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/MyApp_31122019.dmg) file: (MyApp_31122019.dmg)
	392	+	[2019-12-31 19:46:49 AEDT] <main> INFO: Waiting on reservation commit(s) to finish.
	393	+	[2019-12-31 19:46:49 AEDT] <pool-8-thread-1> INFO: Reservation committed: (CPUSource113/v4/93/41/ce/9341ce96-e7bc-2577-eaac-4528c888a70d/MyApp_31122019.dmg) file: (MyApp_31122019.dmg)
	394	+	[2019-12-31 19:46:49 AEDT] <pool-8-thread-1> INFO: All reservation commit(s) finished.
	395	+	[2019-12-31 19:46:49 AEDT] <main> INFO: 456.36 KB/s in 3 seconds
	396	+	```
373	397
374	398		### Сбои в процессе нотариального заверения
375	399
376	400		Если при проверке вы обнаружите, что процесс нотариального заверения не удался. Например:
377	401
378	402		Date RequestUUID Status Status Code Status Message
379	403		------------------------- ------------------------------------ ------- ----------- ----------------
380	404		2020-02-29 13:54:08 +0000 fa2e5d79-cba0-469d-bb27-859a8f081821 invalid 2 Package Invalid
381	405
382	406		Вы можете получить URL-адрес файла журнала нотариального заверения с помощью команды:
383	407
384	408		``` bash
385	409		xcrun altool --notarization-info <RequestUUID> -u "<your email>" -p "<app-specific pwd>"
386	410		```
387	411
388	412		который должен дать информацию, подобную следующей:
389	413
390	414		No errors getting notarization info.
391	415
392	416		Date: 2020-02-29 13:54:08 +0000
393	417		Hash: 1b08ea5cdf97eb6fed9b959a549d4b325eb5e90f16538139a29a83f75609d87b
394	418		LogFileURL: https://osxapps-ssl.itunes.apple.com/itunes-assets/[...]
395	419		RequestUUID: fa2e5d79-cba0-469d-bb27-859a8f081821
396	420		Status: invalid
397	421		Status Code: 2
398	422		Status Message: Package Invalid
399	423
400	424		Затем вы можете вырезать и вставить LogFileURL в свой веб-браузер и получить файл журнала процесса нотариального заверения, который будет выглядеть примерно так:
401	425
402	426		``` json
403	427		{
404	428		"logFormatVersion": 1,
405	429		"jobId": "fa2e5d79-cba0-469d-bb27-859a8f081821",
406	430		"status": "Invalid",
407	431		"statusSummary": "Archive contains critical validation errors",
408	432		"statusCode": 4000,
409	433		"archiveFilename": "test.dmg",
410	434		"uploadDate": "2020-02-29T13:54:08Z",
411	435		"sha256": "1b08ea5cdf97eb6fed9b959a549d4b325eb5e90f16538139a29a83f75609d87b",
412	436		"ticketContents": null,
413	437		"issues": [
414	438		{
415	439		"severity": "error",
416	440		"code": null,
417	441		"path": "test.dmg/MyApp.app/Contents/MacOS/MyApp",
418	442		"message": "The executable does not have the hardened runtime enabled.",
419	443		"docUrl": null,
420	444		"architecture": "x86_64"
421	445		}
422	446		]
423	447		}
424	448		```
425	449
426	450		В приведенном выше случае сбоя это произошло из-за того, что исполняемый файл не был [[Hardened runtime for macOS\|с подписанной защитой]].
427	451
428	452		Также стоит упомянуть, что всегда стоит извлекать файл журнала нотариального заверения для проверки предупреждений, которые еще не являются ошибками, чтобы вы могли исправить их до того, как они станут ошибками, препятствующими успешному нотариальному заверению.
429	453
430	454		Вот пример протокола процесса нотариального заверения после успешного нотариального заверения:
431	455
432	456		``` json
433	457		{
434	458		"logFormatVersion": 1,
435	459		"jobId": "fa2e5d79-cba0-469d-bb27-859a8f081822",
436	460		"status": "Accepted",
437	461		"statusSummary": "Ready for distribution",
438	462		"statusCode": 0,
439	463		"archiveFilename": "test.dmg",
440	464		"uploadDate": "2020-03-01T01:50:55Z",
441	465		"sha256": "1945554c24da3bb1d587b7c9f968dcbb925b726f2f663b816301928c06593dd9",
442	466		"ticketContents": [
443	467		{
444	468		"path": "test.dmg",
445	469		"digestAlgorithm": "SHA-256",
446	470		"cdhash": "1d4d033edbecc2baf7ff8ce0fa16691be990595f"
447	471		},
448	472		{
449	473		"path": "test.dmg/MyApp.app",
450	474		"digestAlgorithm": "SHA-256",
451	475		"cdhash": "7f9d54e76f25807e2b425a09684aa8cb54dcd17f",
452	476		"arch": "x86_64"
453	477		},
454	478		{
455	479		"path": "test.dmg/MyApp.app/Contents/MacOS/MyApp",
456	480		"digestAlgorithm": "SHA-256",
457	481		"cdhash": "7f9d54e762c7907e2b425a09684aa8cb54dcd17f",
458	482		"arch": "x86_64"
459	483		},
460	484		{
461	485		"path": "test.dmg/MyApp.app/Contents/Resources/MyApp.help",
462	486		"digestAlgorithm": "SHA-256",
463	487		"cdhash": "b544a32a216578e7805ca93b968377cdd92f7ec6",
464	488		"arch": "i386"
465	489		},
466	490		{
467	491		"path": "test.dmg/MyApp.app/Contents/Resources/MyApp.help",
468	492		"digestAlgorithm": "SHA-256",
469	493		"cdhash": "b544a32a216578e7805ca93b968377cdd92f7ec6",
470	494		"arch": "x86_64"
471	495		},
472	496		{
473	497		"path": "test.dmg/MyApp.app/Contents/Resources/MyApp.help",
474	498		"digestAlgorithm": "SHA-256",
475	499		"cdhash": "b544a32a216578e7805ca93b968377cdd92f7ec6",
476	500		"arch": "x86_64h"
477	501		}
478	502		],
479	503		"issues": null
480	504		}
481	505		```
482	506
483	507		### Сбои при проверке нотариального заверения
484	508
485	509		Если процесс нотариального заверения прошел успешно, но вы получили сбой при проверке успешности нотариального заверения, вы можете использовать `Console.app` для проверки файлов журнала на предмет информации об отклонении (после попытки запустить заблокированное приложение). Имейте в виду, что вы должны открыть `Console.app` перед попыткой открыть ваше `Console.app`, иначе не все сообщения могут быть зарегистрированы. Вы должны выбрать свое устройство на левой боковой панели `Console.app` и проверить в журналах процесс XprotectService.
486	510
487	511		## См.также
488	512
489	513		- [[Apple Developer Certificates]]
490	514		- [[Code Signing for macOS]]
491	515		- [[Hardened runtime for macOS]]
492	516		- [[Signing and Notarization FAQ]]
493	517
494	518		## Внешние ссылки
495	519
496	520		- [Apple: Notarizing your app before distribution](https://developer.apple.com/documentation/security/notarizing_your_app_before_distribution)
497	521		- [Apple: Notarizing macOS Software Before Distribution](https://developer.apple.com/documentation/xcode/notarizing_macos_software_before_distribution)
498	522		- [Apple: Customizing the Notarization Workflow](https://developer.apple.com/documentation/xcode/notarizing_macos_software_before_distribution/customizing_the_notarization_workflow)
499	523		- [Apple: Common notarization issues](https://developer.apple.com/documentation/xcode/notarizing_macos_software_before_distribution/resolving_common_notarization_issues)
500	524		- [Apple: Using app-specific passwords](https://support.apple.com/en-us/HT204397)
501	525		- [Notarize FPC](https://github.com/neurolabusc/NotarizeFPC) A script to notarize a command line utility and package it in an installer .pkg file.
502	526
503	527		---
504	528		From the Free Pascal wiki, page "Notarization for macOS 10.14.5+/ru", as it stood on 2022-01-01 after a change by Zoltanleo, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).

Back to history