本文概述的連接器認證流程適用於獨立發行者。 如果您擁有連接器的基本服務,請移至已驗證的發行者認證程式。
注意
所有連接器都已做好代理準備。 本文提供有關認證 Azure Logic Apps、Microsoft Power Automate、Microsoft Power Apps 和 Microsoft Copilot Studio 的自訂連接器的資訊。 在按照本文中的步驟操作之前,請先閱讀取得連接器認證。
當 Microsoft 為獨立發行者計畫認證您的連接器並發佈您的連接器時,您的名稱將作為官方發行者出現在產品中,並且連接器上會出現一個通用圖示。 準備和提交連接器進行認證非常簡單。 在將連接器檔案提交給 Microsoft 之前,請先查看並完成本文中的所有步驟。
必要條件
獨立發行者連接器群組可讓具有已驗證認證的任何人將連接器發佈至 Microsoft 連接器的正式清單。 如果您想為該群組做出貢獻,請查看該群組的資源並採取任何必要的行動:
- 熟悉 Power Platform Connectors GitHub 存放庫。 此存放庫包含專門支援獨立發行者的資料夾。
- 審查獨立發行者連接器的學習內容
- 閱讀、理解並同意獨立發行者連接器群組宣言的內容。
- 取得已驗證的認證。 每當您向 Power Platform 連接器獨立發行者連接器提交提取要求時,您都需要提供已驗證的認證。 如果您沒有已驗證的認證,請務必遵循取得 已驗證認證 一文中所述的步驟,以開始在 Microsoft Authenticator 應用程式中設定認證的程式,以便每次提交 PR 時都能輕鬆地使用認證登入。
步驟 1:驗證連接器是否尚未建置
在開始建置連接器之前,請先驗證該連接器是否尚未建置。 要檢查,您可以在以下位置搜尋連接器:
- 文件中的 Microsoft Copilot Studio、Microsoft Power Platform 和 Azure Logic Apps 連接器清單。
- GitHub 存放庫中的 Power Platform Connectors 獨立發行者連接器的提取請求清單。
使用此表來查看根據連接器的狀態您可以對其執行哪些操作:
| 如果您建議的連接器: | 選項: |
|---|---|
| Copilot Studio 和 Power Platform 已經存在。 | 您將無法組建連接器。 |
| 已作為獨立發行者連接器存在。 | 您可以在連接器中新增更多功能。 |
| 目前是提取要求和提案。 | 您可以連絡獨立發行者,以在連接器上與他們進行共同作業。 |
| 是提取要求和不是提案。 | 等到連接器獲得認證並部署。 然後,將更新新增至該連接器。 |
步驟 2:與 Microsoft 共用連接器提案
在您檢查連接器不在平台上後,請在獨立發行者連接器群組的 GitHub 存放庫中分享您的連接器提案。 分享您的提案有助於避免重複努力並幫助您找到合作者。
若要分享您的提案,請在 GitHub 存放庫中提交符合以下條件的提取請求:
- 將提取要求命名為 [提案 - 連接器名稱]。 例如:
Proposal - HubSpotCRM。 - 提交一個 intro.md 檔案,其中包含您所能提供的盡可能多的詳細資訊。 如果您願意尋找共同作業者,請附上您的連絡電子郵件。
- 分享您經過驗證的憑證。 如果您尚未設定並準備好分享已驗證的憑證,您將收到一個自動產生的表單連結,供您填寫和提交。 連接器團隊將透過電子郵件與您聯繫,並提供資訊,以開始設定已驗證認證的一次性過程。
注意
當您準備好在 步驟 4 中提交所有檔案進行認證時,您會使用相同的提取要求。
步驟 3:建置連接器
建立您的連接器。 若要開始,請參閱從頭開始建立自訂連接器。 在提交連接器進行獨立發佈商驗證和部署之前,請遵循連接器準備最佳做法:
查看準備用於認證的連接器檔案文章中的所有步驟。
步驟 4:提交連接器成品
當您準備好提交連接器專案以供 Microsoft 驗證、認證和部署時,請務必:
- 將連接器成品提交至您在步驟 2 中建立的提取要求。
- 填寫提取請求範本中的檢查清單。
- 從您的提取請求標題中移除
Proposal -。
第 5 步:OneVet 驗證
為了維護整個 Power Platform 社群的信任和安全,所有提交 GitHub PR 的發行者都需要驗證身分識別和真實性。 請按照以下步驟獲取 已驗證的憑據。
步驟 6:完成連接器驗證和認證程序
Microsoft 驗證您的身分之後,請遵循下列步驟:
分支 microsoft/PowerPlatformConnector 存放庫。
建立包含先前需要的所有檔案的提取要求 (PR),然後將 package.zip 檔案新增至 PR。
參考 準備代理程式和 Power Platform 連接器進行認證,打包您的連接器檔案。
先驗證套件的結構,再將套件提交至合作夥伴中心認證 - 執行套件驗證工具工具。
認證小組會在 PR 上新增名為 certify-connector 的註解,以啟動認證過程。
如果套件有效,認證會傳遞,而且 PR 中會出現成功訊息,指出部署程式即將開始。
一旦新增,就無法變更 GitHub 存放庫中連接器的資料夾名稱。 身為發布者,如果您想要變更檔案名稱,則需要聯絡認證團隊。
認證小組會完成程式碼檢閱,並起始連接器的部署。 部署程式完成後,認證小組會更新並合併 PR。
如果提交有任何需要解決的錯誤,您會在 PR 批注中看到填入錯誤詳細數據。 進行更新並重新提交 PR 之後,認證程式會重新開始。 您可以建立新的 PR,但理想情況下,最好使用相同的 PR。
更新必須由提交舊版的相同發行者提交。 如果從不同的發行者收到更新,則會拒絕提取要求 (PR)。
如果您是原始發布者,且無法存取帳戶,則必須手動聯絡認證團隊進行驗證,並要求解除封鎖。
注意
目前,獨立發行者不支援 OAuth 連接器。
步驟 6:等待連接器部署
重要
平均來說,部署連接器需要 15 個工作日。 無論連接器的大小或複雜程度如何,無論是新的還是更新的,都需要這段時間。 為了保護完整性,所有連接器都必須經過相同的驗證任務,以測試每次部署中遵循的功能和內容。
部署時間表:生產的連接器部署時間表從太平洋標準時間/太平洋夏令時間星期五早上開始。 當您準備好進行生產部署時,請至少提前 24 小時通知您的 Microsoft 連絡人,以便您的連接器包含在下一次規劃的部署中。
區域部署:Microsoft 會透過電子郵件通知您部署連接器的區域名稱,因為區域部署是分步驟進行的。 如果部署延遲或凍結,您會收到電子郵件通知。 若要了解詳細資訊,請移至區域部署。
遵循提交最佳做法
遵循成功提交連接器的最佳做法:
- 當您提交 Pull Request 時,請僅提交一個連接器,以確保驗證過程順利進行。
- 將與您的 GitHub 帳戶相關聯的電子郵件新增至支援電子郵件區段。 以防我們需要與您連絡。
- 在隱私權原則參數中填寫終端服務的隱私權原則。
- 寫出詳細的作業描述,以便使用者能理解您的作業。
- 如果您的連接器使用 OAuth,請在 readme.md 中提供有關如何建立應用程式的詳細步驟。 如果不這樣做,認證將會被延遲。 有關要包含的文件的範例,請參閱 Readme.md 範例。
- 除非回應模式是動態的,否則請為您的操作新增回應模式。 這有助於您的連接器獲得更多的用途。
- 檢閱提交前的檢查清單。
Microsoft 保證
Microsoft 承諾滿足以下保證:
- 如果連接器有更新,我們會再次執行中斷性變更工具和所有其他驗證工具。
- 如果連接器沒有更新,我們會保證它可以正常運作,除非有 API 變更或更新,或平台問題。
- 如果出現任何平台或安全性問題,Microsoft 會在問題發生時進行調查,並淘汰有問題的獨立發行者連接器。