Notarization for macOS 10.14.5+/ru: what changed

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