Процесс сертификации независимых издателей

Процесс сертификации соединителей, описанный в этой статье, предназначен для независимых издателей. Если вы являетесь владельцем базовой службы для вашего соединителя, перейдите к Процесс сертификации проверенного издателя.

Заметка

Все соединители готовы к работе с агентом. В этой статье содержатся сведения о сертификации пользовательских соединителей для Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps и Microsoft Copilot Studio. Перед выполнением шагов в этой статье, ознакомьтесь со статьей Сертификация соединителя.

Когда Microsoft сертифицирует ваш соединитель для программы независимых издателей и публикует ваш соединитель, ваше имя появляется в продукте в качестве официального издателя, а на вашем соединителе появляется общий значок. Подготовить и отправить соединитель на сертификацию несложно. Прежде чем отправлять файлы соединителя в Microsoft, просмотрите и выполните все действия, описанные в этой статье.

Предварительные требования

Группа соединителей независимого издателя позволяет любому пользователю с проверенными учетными данными публиковать соединитель в официальном списке соединителей Майкрософт. Если вы хотите внести свой вклад в группу, просмотрите ресурсы группы и выполните все необходимые действия:

Шаг 1: Убедитесь, что соединитель еще не собран

Прежде чем приступить к созданию соединителя, убедитесь, что он еще не создан. Чтобы проверить это, вы можете поискать соединитель в следующих местах:

Используйте эту таблицу, чтобы узнать, что можно делать с соединителем в зависимости от его состояния:

Если предлагаемый вами соединитель: Вариант:
Уже существует для Copilot Studio и Power Platform. Вы не можете построить соединитель.
Уже существует как соединитель независимого издателя. Вы можете добавить дополнительные функции к соединителю.
В настоящее время является запросом на вытягивание и предложением. Вы можете связаться с независимым издателем для совместной работы над соединителем.
В настоящее время является запросом на вытягивание и не является предложением. Подождите, пока соединитель не будет сертифицирован и развернут. Затем добавьте обновление к этому соединителю.

Шаг 2: Поделитесь предложением соединителя с Microsoft

Убедившись, что соединителя нет на платформе, опубликуйте предложение соединителя в репозитории GitHub группы соединителей независимых издателей. Если вы поделитесь своим предложением, это поможет избежать дублирования усилий и найти соавторов.

Чтобы поделиться своим предложением, отправьте запрос на вытягивание в репозиторий GitHub, который удовлетворяет следующим критериям:

  • Заголовок pull request: Пропозиция - имя коннектора. Например: Proposal - HubSpotCRM.
  • Зафиксируйте файл intro.md с как можно большим количеством сведений. Если вы готовы найти соавтора, укажите свой контактный адрес электронной почты.
  • Предоставление общего доступа к проверенным учетным данным. Если у вас еще нет проверенных учетных данных, готовых к совместному использованию, вы получите автоматическую ссылку на форму для заполнения и отправки. Команда разработчиков коннекторов свяжется с вами по электронной почте, чтобы предоставить информацию для начала единовременного процесса настройки ваших проверенных учетных данных.

Заметка

Вы используете тот же запрос на вытягивание, когда готовы отправить все файлы на сертификацию на шаге 4.

Шаг 3. Разработайте соединитель

Разработайте свой соединитель. Для начала работы см. раздел Создание пользовательского соединителя с нуля. Прежде чем отправить соединитель на проверку и развертывание независимым издателем, следуйте рекомендациям по подготовке соединителя.

Ознакомьтесь со всеми шагами, описанными в статье Подготовка файлов соединителей для сертификации.

Шаг 4. Отправка артефактов соединителя

Когда вы будете готовы отправить артефакты соединителя на проверку, сертификацию и развертывание Microsoft, убедитесь, что:

  • Отправьте артефакты соединителя в запрос на вытягивание, созданный на шаге 2.
  • Заполните контрольный список в шаблоне запроса на вытягивание.
  • Удалите Proposal - из заголовка запроса на вытягивание.

Шаг 5. Проверка OneVet

Для поддержания доверия и безопасности в сообществе Power Platform все издатели, отправляющие PR GitHub, должны проверить подлинность и идентификацию. Чтобы получить проверенные учетные данные, выполните следующие действия.

Шаг 6. Проверка соединителя и процесс сертификации

После проверки удостоверения корпорацией Майкрософт выполните следующие действия.

  • Сделайте форк репозитория Microsoft/PowerPlatformConnector.

  • Создайте запрос на вытягивание (PR), содержащий все необходимые ранее файлы, а затем добавьте файл package.zip в PR.

  • Упаковайте файлы соединителей, ссылаясь на соединители Prepare Agent и Power Platform для сертификации.

  • Проверьте пакет для структуры перед отправкой пакета для сертификации в Центр партнеров — запустите средство проверки пакета.

  • Команда сертификации добавляет комментарий к PR с именем certify-connector для запуска процесса сертификации.

  • Если пакет действителен, сертификация проходит успешно, и сообщение об успешном выполнении появится в PR, указывая, что процесс развертывания скоро начнется.

  • Имя папки соединителя в репозитории GitHub нельзя изменить после добавления. Если вы, как издатель, хотите изменить имя файла, необходимо обратиться к группе сертификации.

  • Команда сертификации завершает проверку кода и инициирует развертывание соединителя. После завершения процесса развертывания PR обновляется и объединяется командой сертификации.

  • Если есть ошибки при отправке, которые необходимо устранить, вы увидите сведения об ошибке, указанные в комментариях PR. После внесения обновлений и повторной отправки PR снова запускается процесс сертификации. Вы можете создать свежий PR, но в идеале лучше всего работать с тем же PR.

  • Обновления должны быть отправлены тем же издателем, который подал предыдущую версию. Если обновления получены от другого издателя, пулл-реквесты (PR) отклоняются.

  • Если вы являетесь исходным издателем, и вы потеряли доступ к учетной записи, необходимо вручную обратиться к группе сертификации для проверки и запросить разблокировку.

Заметка

Соединители OAuth на данный момент неподдерживаются для независимых издателей.

Шаг 6. Ожидайте развертывания соединителя

Внимание!

В среднем на развертывание соединителя уходит 15 рабочих дней. Это время необходимо независимо от размера или сложности вашего соединителя, будь он новый или обновленный. В целях защиты целостности все соединители подвергаются тем же задачам проверки для проверки функциональности и содержимого, которые выполняются при каждом развертывании.

  • Графики развертывания: графики развертывания соединителей для производства начинаются в пятницу утром по тихоокеанскому времени. Заранее сообщите своему контактному лицу в Microsoft как минимум за 24 часа, когда вы будете готовы к производственному развертыванию, чтобы ваш соединитель был включен в следующее запланированное развертывание.

  • Развертывание в регионе: Microsoft уведомляет вас по электронной почте с указанием названий регионов, в которых развертывается соединитель, поскольку развертывание в регионах выполняется поэтапно. В случае задержки или зависания развертывания вы получите уведомление по электронной почте. Дополнительные сведения см. в разделе Развертывание в регионе.

Следуйте рекомендациям по отправке

Следуйте передовым методам для успешной отправки соединителя:

  • Отправьте только один соединитель на пулл-реквест, чтобы обеспечить гладкий процесс валидации.
  • Добавьте сообщение электронной почты, связанное с учетной записью GitHub, в раздел электронной почты поддержки. Это на случай, если нам понадобится с вами связаться.
  • Укажите в параметре политики конфиденциальности политику конфиденциальности для конечной службы.
  • Составьте подробное описание операции, чтобы пользователи могли понять вашу операцию.
  • Если ваш соединитель использует OAuth, предоставьте подробные инструкции по созданию приложения в вашем readme.md. Если вы этого не сделаете, сертификация будет отложена. Чтобы получить пример документации, которую нужно включить, см. пример Readme.md.
  • Добавьте схемы ответа к своим действиям, если схема ответа не является динамической. Это поможет соединителю чаще использоваться.
  • Проверьте Контрольный список перед отправкой.

Гарантии Microsoft

Microsoft обязуется соблюдать следующие гарантии:

  • Если есть обновление соединителя, мы снова запустим инструмент критических изменений и все другие инструменты проверки.​
  • Если для соединителя нет обновлений, мы гарантируем, что он работает, за исключением случаев изменения или обновления API или проблем с платформой.​
  • При наличии каких-либо проблем платформы и безопасности, Microsoft изучит их по мере возникновения и откажется от сломанных соединителей независимых издателей.​

Следующий шаг

Перемещение соединителя из предварительной версии в общедоступную (GA)

  • Last updated on