Notarization for macOS 10.14.5+/ru: what changed

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