Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Служба подписи артефактов от Microsoft — это полностью управляемая комплексная служба подписания сертификатов. В этом кратком руководстве вы создадите следующие три ресурса "Подписывание артефактов", чтобы начать использование подписи артефактов:
- Учетная запись для подписи артефактов
- Проверка удостоверения
- Профиль сертификата
Вы можете использовать портал Azure или расширение Azure CLI для создания и управления большинством ресурсов подписывания артефактов. (Вы можете выполнить проверку подлинности only на портале Azure. Невозможно выполнить проверку удостоверения с помощью Azure CLI.) В этом кратком руководстве показано, как это сделать.
Предпосылки
Замечание
В настоящее время для сертификатов Public Trust подписание артефактов доступно организациям в США, Канаде, Европейском Союзе и Соединённом Королевстве, а также отдельным разработчикам в США и Канаде. Это ограничение неприменимо к сертификатам частного доверия.
Чтобы завершить это краткое начальное руководство, вам требуется:
Идентификатор клиента Microsoft Entra.
Дополнительные сведения см. в разделе Создайте арендатора Microsoft Entra.
Подписка Azure.
Если у вас еще нет подписки, посмотрите Создание подписки Azure до начала работы.
Регистрация поставщика ресурсов подписывания артефактов
Прежде чем использовать подписывание артефактов, необходимо зарегистрировать поставщика ресурса для подписывания артефактов.
Поставщик ресурсов — это служба, которая предоставляет Azure ресурсы. Используйте портал Azure или Azure CLI для регистрации провайдера ресурсов подписи артефактов Microsoft.CodeSigning.
- портал Azure
- Azure CLI
- Azure PowerShell
Чтобы зарегистрировать поставщика ресурсов подписывания артефактов с помощью портала Azure:
Войдите на портал Azure.
В поле поиска или в разделе "Все службы" выберите "Подписки".
Выберите подписку, в которой вы хотите создать ресурсы для подписывания артефактов.
В меню ресурсов в разделе "Параметры" выберите "Поставщики ресурсов".
В списке поставщиков ресурсов выберите Microsoft. CodeSigning.
По умолчанию состояние поставщика ресурсов — NotRegistered.
Выберите многоточие и нажмите кнопку "Зарегистрировать".
Состояние поставщика ресурсов изменяется на "Зарегистрирован".
Создание учетной записи для подписания артефактов
Учетная запись для подписания артефактов — это логический контейнер, содержащий ресурсы для проверки удостоверения и профиля сертификата. Проверка подлинности доступна на уровне идентификатора подписки и может использоваться для всех учетных записей для подписывания артефактов в рамках этой подписки.
Регионы Azure, поддерживающие подписывание артефактов
Ресурсы подписывания артефактов можно создавать только в регионах Azure, где в настоящее время доступна служба. В следующей таблице перечислены регионы Azure, которые в настоящее время имеют поддержку ресурсов подписывания артефактов.
| Регион | Поля класса региона | Значение URI конечной точки |
|---|---|---|
| Бразилия (Юг) | Южная Бразилия | https://brs.codesigning.azure.net |
| Central US | Центральная часть США | https://cus.codesigning.azure.net |
| East US | Восточный регион США (EastUS) | https://eus.codesigning.azure.net |
| Japan East | ЯпонияВосток | https://jpe.codesigning.azure.net |
| Korea Central | КореяCentral | https://krc.codesigning.azure.net |
| северо-центральная часть США | NorthCentralUS | https://ncus.codesigning.azure.net |
| North Europe | NorthEurope | https://neu.codesigning.azure.net |
| Центральная Польша | ПольшаCentral | https://plc.codesigning.azure.net |
| Южно-Центральная часть США | SouthCentralUS | https://scus.codesigning.azure.net |
| Switzerland North | Север Швейцарии | https://swn.codesigning.azure.net |
| центрально-западная часть США | WestCentralUS | https://wcus.codesigning.azure.net |
| West Europe | WestEurope | https://weu.codesigning.azure.net |
| West US | ВестЮС | https://wus.codesigning.azure.net |
| Западная часть США 2 | ВестУС2 | https://wus2.codesigning.azure.net |
| Западная часть США 3 | WestUS3 | https://wus3.codesigning.azure.net |
Ограничения именования для учетных записей подписывания артефактов
Имена учетных записей подписывания артефактов имеют некоторые ограничения.
Имя учетной записи для подписания артефакта должно:
- Содержит от 3 до 24 буквенно-цифровых символов.
- Быть глобально уникальным.
- Начните с буквы.
- Заканчивается буквой или цифрой.
- Не содержит последовательные дефисы.
Имя учетной записи артефакта для подписания:
- Не учитывает регистр (ABC совпадает с abc).
- Отклонено Azure Resource Manager, если начинается с "one".
- портал Azure
- Azure CLI
- Azure PowerShell
Чтобы создать учетную запись для подписания артефакта через портал Azure:
Войдите на портал Azure.
Найдите и выберите «Учетные записи для подписывания артефактов».
На панели "Учетные записи подписывания артефактов" выберите "Создать".
Для Subscription выберите подписку Azure.
Для группы ресурсов выберите "Создать", а затем введите имя группы ресурсов.
В поле "Имя учетной записи" введите уникальное имя учетной записи.
Дополнительные сведения см. в разделе "Ограничения именования" для учетных записей подписывания артефактов.
Для Region выберите регион Azure, поддерживающий подпись артефактов.
Для ценообразования выберите ценовую категорию.
Нажмите кнопку Просмотреть и создать.
После успешного создания учетной записи подписи артефакта выберите Перейти к ресурсу.
Создание запроса на проверку удостоверений
Вы можете выполнить собственную проверку удостоверений, заполнив форму запроса сведениями, которые должны быть включены в сертификат. Проверку удостоверений можно выполнить только на портале Azure. Невозможно выполнить проверку удостоверений с помощью Azure CLI.
Замечание
Невозможно создать запрос на проверку личности, если вам не назначена соответствующая роль. Если кнопка Новая идентификация на панели меню в портале Azure отображается приглушенной, убедитесь, что вам назначена роль проверяющего удостоверения для подписи артефактов, чтобы продолжить проверку удостоверения.
- Проверка идентификационных данных — организация
- Проверка подлинности личности — индивидуальный разработчик
Чтобы создать запрос на подтверждение личности для организации или DBA, выполните следующие действия.
На портале Azure перейдите к вашей новой учетной записи подписи артефактов.
Убедитесь, что вам назначена роль проверяющего удостоверения подписи артефактов.
Сведения об управлении доступом с помощью управления доступом на основе ролей (RBAC) см. в руководстве: Назначение ролей в подписи артефактов.
В области обзора учетной записи подписывания артефактов или в меню ресурсов в разделе Объекты, выберите проверка подлинности.
Выберите Новую личность, а затем выберите Публичный или Частный.
- Проверка подлинности общественного удостоверения применяется только к этим типам профилей сертификатов: Public Trust, Public Trust Test, VBS Enclave.
- Проверка частного удостоверения применяется только к следующим типам профилей сертификатов: Private Trust, Private Trust CI Policy.
В новой проверке удостоверений укажите следующие сведения:
Fields Сведения Название организации Для проверки публичной идентичности укажите юридическое лицо, которому выдан сертификат. Для проверки частного удостоверения значение по умолчанию используется для имени клиента Microsoft Entra. (Только тип частного удостоверения) Организационное подразделение Введите соответствующие сведения. URL-адрес веб-сайта Введите веб-сайт, принадлежащий юридическому лицу. Основной адрес электронной почты Введите адрес электронной почты, связанный с юридическим бизнес-объектом, проходящим проверку. В рамках процесса проверки личности на этот адрес электронной почты отправляется ссылка для подтверждения, которая истекает через семь дней. Убедитесь, что адрес электронной почты может получать сообщения электронной почты (со ссылками) из внешних адресов электронной почты. Это адрес электронной почты, на который отправляются ссылки для завершения проверки проверенных учетных данных и проверки электронной почты. Вторичная электронная почта Этот адрес электронной почты должен отличаться от основного адреса электронной почты (списки рассылки принимаются). Для организаций домен должен соответствовать адресу электронной почты, указанному в основной адрес электронной почты. Убедитесь, что адрес электронной почты может получать сообщения электронной почты от внешних адресов электронной почты с ссылками. Бизнес-идентификатор Введите идентификатор бизнеса для юридической организации. Идентификатор продавца Применяется только к Microsoft Store клиентам. Найдите идентификатор продавца на портале Центра партнеров. Улица, город, страна/ регион, штат/провинция, почтовый индекс Введите адрес юридического лица. Имя Введите имя человека, представляющего организацию, которая будет выполнять проверку отдельных удостоверений. Используйте точное имя, как оно отображается в документе идентификации, выданном правительством, для процесса проверки идентификации. Фамилия Введите фамилию человека, представляющего организацию. Этот человек выполняет проверку личности. Используйте точное имя, как оно отображается в документе идентификации, выданном правительством, для процесса проверки идентификации. Выберите предварительный просмотр субъекта сертификата , чтобы просмотреть сведения, отображаемые в сертификате.
Выберите кнопку Создать.
При успешном создании запроса состояние запроса проверки удостоверений изменяется на "Выполняется".
Когда состояние изменится на "Обязательное действие", следуйте инструкциям, начиная с шага 9 на вкладке "Проверка удостоверений - Отдельный разработчик" выше.
Ссылка для проверки идентификации также отправляется по электронной почте на основной адрес электронной почты.
После успешной проверки личности состояние изменится на "Выполняется, а процесс проверки продолжается.
Если требуются дополнительные документы, отправляется сообщение электронной почты, а состояние запроса изменяется на "Обязательное действие".
По завершении процесса проверки удостоверений состояние запроса изменяется, а сообщение электронной почты отправляется с обновленным состоянием запроса:
- Завершено , если процесс выполнен успешно.
- Сбой , если процесс не выполнен успешно.
Важные сведения для проверки публичной идентичности
| Требования | Сведения |
|---|---|
| Введение в должность | Для более быстрого процесса адаптации убедитесь, что актуальны общедоступные записи юридического лица, которое проходит валидацию. |
| Точность | Убедитесь, что вы предоставляете правильную информацию для проверки личности на общедоступных основаниях. Если необходимо внести изменения после его создания, необходимо выполнить новый запрос проверки удостоверения. Это изменение влияет на связанные сертификаты, используемые для подписи. |
| Сбой проверки электронной почты | Если проверка электронной почты завершается ошибкой, необходимо инициировать новый запрос проверки удостоверения. |
| Состояние проверки удостоверения | При обновлении состояния проверки удостоверений вы получите уведомление по электронной почте. Вы также можете проверить состояние на портале Azure в любое время. |
| Время обработки | Обработка запроса на проверку удостоверений занимает от 1 до 20 рабочих дней (возможно, дольше, если вам потребуется запросить дополнительную документацию). |
| Дополнительная документация | Если нам нужна дополнительная документация для обработки запроса на проверку удостоверений, вы получите уведомление по электронной почте. Документы можно отправить на портале Azure. Для отправки документации есть три попытки. Электронная почта запроса документации содержит сведения о требованиях к размеру файла. Убедитесь, что все предоставленные документы являются наиболее актуальными. — Все отправленные документы должны быть выданы в течение предыдущих 12 месяцев и где дата окончания срока действия — это не менее двух месяцев. — Если невозможно предоставить дополнительную документацию, обновите сведения об учетной записи, чтобы они соответствовали любым юридическим документам, уже предоставленным или официальным сведениям о регистрации компании. — При предоставлении официального бизнес-документа, например формы регистрации бизнеса, устава компании или уставных документов, которые перечисляют название компании и адрес, как они предоставляются во время создания запроса на проверку подлинности. — Убедитесь, что регистрация домена или счет за регистрацию или продление, в котором указаны название организации и имя контакта, а также все домены, которые включены или упомянуты в запросе. |
Создание профиля сертификата
Ресурс профиля сертификата — это логический контейнер сертификатов, выданных для подписывания.
Ограничения именования для профилей сертификатов
Имена профилей сертификатов имеют некоторые ограничения.
Имя профиля сертификата должно:
- Содержит от 5 до 100 буквенно-цифровых символов.
- Начните с буквы, закончите буквой или цифрой и не содержите последовательные дефисы.
- Будьте уникальными в учетной записи.
Название профиля сертификата:
- В том же регионе Azure, что и учетная запись, по умолчанию наследование.
- Не учитывает регистр (ABC совпадает с abc).
- портал Azure
- Azure CLI
- Azure PowerShell
Чтобы создать профиль сертификата на портале Azure, выполните следующие действия.
На портале Azure перейдите к вашей новой учетной записи подписи артефактов.
В области Обзор учетной записи подписывания артефактов или в меню ресурсов в разделе Объекты выберите Профили сертификатов.
На панели команд выберите "Создать " и выберите тип профиля сертификата.
В разделе "Создание профиля сертификата" укажите следующие сведения:
a. В поле "Имя профиля сертификата" введите уникальное имя.
Дополнительные сведения см. в разделе "Ограничения именования" для профилей сертификатов.
Значение типа сертификата автоматически заполняется на основе выбранного типа профиля сертификата.
б. Для проверенного CN и O выберите проверку подлинности, которая должна отображаться в сертификате.
Если адрес улицы должен отображаться в сертификате, установите флажок "Включить уличный адрес ".
Если почтовый индекс должен отображаться на сертификате, установите флажок "Включить почтовый индекс ".
Значения остальных полей автоматически заполняются на основе выбранного значения для проверенного CN и O.
Созданный предварительный просмотр субъекта сертификата показывает, как будет выглядеть сертификат, который будет выдан.
Нажмите кнопку "Создать".
Очистите ресурсы
- портал Azure
- Azure CLI
- Azure PowerShell
Чтобы с помощью портала Azure удалить ресурсы подписывания объектов:
Удаление профиля сертификата
- На портале Azure войдите в учетную запись подписывания артефактов.
- В области Обзор учетной записи подписывания артефактов или в меню ресурсов в разделе Объекты выберите Профили сертификатов.
- В профилях сертификатов выберите профиль сертификата, который требуется удалить.
- В панели команд выберите Удалить.
Замечание
Это действие останавливает любую подпись, связанную с профилем сертификата.
Удаление учетной записи подписывания артефактов
- Войдите на портал Azure.
- В поле поиска введите, а затем выберите учетные записи для подписи артефактов.
- В учетной записи подписывания артефактов выберите учетную запись подписывания артефактов, которую вы хотите удалить.
- В панели команд выберите Удалить.
Замечание
Это действие удаляет все профили сертификатов, связанные с этой учетной записью. Все процессы подписывания, связанные с профилями сертификатов, останавливаются.
Связанный контент
В этом кратком руководстве вы создали учетную запись для подписания артефактов, запрос на проверку идентификации и профиль сертификата. Дополнительные сведения о подписывание артефактов и начале пути подписания см. в следующих статьях:
- Узнайте больше об интеграции подписывания.
- Узнайте больше о моделях доверия, поддерживаемых функцией подписывания артефактов.
- Дополнительные сведения об управлении сертификатами.
- Нужна помощь в настройке:
- Обратитесь через службу поддержки Azure через портал Azure.
- Разместите ваш вопрос на Stack Overflow или Microsoft Q&A, используйте тег: artifact-signing.
- Проблемы проверки удостоверений можно устранить только с помощью Stack Overflow или Microsoft Q&A.