Ihren Konnektor für die Microsoft-Zertifizierung einreichen

  • Artikel

Dieses Thema beschreibt, wie Sie:

  1. Veröffentlichen Sie Ihren Connector im Open-Source-Repository.

  2. Senden Sie die Commit-Informationen für die Zertifizierung in ISV Studio. (Dieser Schritt gilt nicht für unabhängige Herausgeber.)

Allgemein gilt, dass wir Open-Source als Teil unseres Zertifizierungsprogramms voraussetzen. Fragen Sie Ihren Microsoft-Ansprechpartner, wenn Sie Bedenken haben.

Open-Source des Connectors

Dieser Abschnitt gilt für verifizierte Herausgeber einschließlich unabhängige Herausgeber.

Wichtig

Sie müssen den Connector als Open Source öffnen, bevor er dem Zertifizierungsportal hinzugefügt wird, um Inkonsistenzen zu vermeiden. Wenn Sie zum ersten Mal auf GitHub mitwirken, nehmen Sie an der Power Platform Samples - First Time Contributor Sitzung teil.

  1. Öffnen Sie einen Pull-Request im Open-Source-Repository.

  2. Ein Microsoft-Zertifizierungstechniker wird innerhalb ein bis zwei Wochen nach Ihrer ersten Anfrage Feedback geben. Wenn das Feedback eine Aktualisierung des Connectors erfordert, müssen Sie eine Aktualisierung an die Pull-Anforderung senden. Planen Sie dafür ein bis zwei zusätzliche Wochen ein.

    Der Connector bleibt weiterhin in Ihrem Besitz, und Sie können sämtliche Änderungen an Ihrem Connector akzeptieren oder ablehnen.

  3. Microsoft wird die Pull-Anforderung genehmigen und zusammenführen. Sobald die Pull-Anforderung Ihres Connectors zusammengeführt wurde, können Sie Ihre Connector-Artefakte an ISV Studio senden. Gehen Sie zu An ISV Studio senden für Anweisungen.

Vorteile des Open-Sourcing Ihres Connectors

Das Open-Sourcing Ihres Konnektors hat mehrere Vorteile, u. a:

  • Möglichkeit zum einfachen Hinzufügen von Funktionen zu einem ehemals vorgefertigten, unveränderbaren Konnektor

  • Nutzung von Beiträgen aus der Entwicklercommunity für Erweiterungen und Wartung des Konnektors.

  • Schaffung einer Plattform, über die Benutzer Featureanfragen und entsprechende Beiträge einreichen können

  • Umfangreichere Nachverfolgung von Konnektoränderungen.

  • Ermöglichung der Zusammenarbeit mehrerer Entwickler

Folgende Punkte zu unserem Programm sind wichtig:

  • Es werden lediglich Ihre Konnektordateien als Open Source bereitgestellt, nicht aber Ihre API. Diese Daten sind für Benutzer bereits über die öffentlichen APIs von Microsoft Power Platform zugänglich.

  • Ihre Konnektorartefakte werden in unserem GitHub-Repository gespeichert und sind öffentlich zugänglich. Sie können unsere bestehenden Open-Source-Konnektoren dort einsehen.

  • In dem Repository werden keinerlei personenbezogene Daten und kein geistiges Eigentum gespeichert.

  • Microsoft nimmt Sie in die CODEOWNERS-Datei für den Connector in GitHub auf; alle Änderungen an Ihrem Connector werden von Ihnen verwaltet.

Upload aus lokalen Dateien

Wenn Sie eine Ausnahme vom Open-Sourcing erhalten haben, müssen Sie Ihren Konnektor senden, indem Sie Ihre lokalen Konnektor-Dateien hochladen:

  1. Formatieren Sie die Dateien Ihres benutzerdefinierten Konnektors für die Übermittlung an Microsoft als ZIP-Archiv.

  2. Übermitteln Sie nur Archive, die erfolgreich überprüft wurden und alle drei Artefaktdateien enthalten:

    • apiDefinition.swagger.json
    • apiProperties.json
    • Das Konnektorensymbol

    Wichtig

    Vergewissern Sie sich unter macOS, dass das ZIP-Archiv nur die drei Konnektorartefaktdateien enthält. MacOS nimmt standardmäßig andere Ordner und Dateien ins ZIP-Archiv auf.

An ISV Studio senden

Dieser Abschnitt gilt für verifizierte Herausgeber ohne unabhängige Herausgeber.

Sobald die Pull-Anforderung Ihres Connectors zusammengeführt wurde, können Sie Ihre Connector-Artefakte an die Registerkarte Connector-Zertifizierung in ISV Studio senden.

Wenn Ihre Übermittlung erfolgreich war, können Sie innerhalb ein bis zwei Wochen mit einer Antwort von einem Zertifizierungstechniker rechnen. Wenn es Probleme mit der Übermittlung gibt, müssen Sie die Übermittlung basierend auf dem Feedback aktualisieren. Der Zertifizierungstechniker benötigt ein bis zwei zusätzliche Wochen, um zu antworten.

Wenn Sie eine Ausnahme vom Open-Sourcing erhalten haben, senden Sie Ihren Konnektor erst dann, wenn Ihr Microsoft-Kontakt Sie dazu aufgefordert hat. Vergewissern Sie sich, dass Sie alle Schritte in Zertifizierungsprozess befolgt und Ihre Artefakte vor dem Senden validiert haben.

Die Zur Überprüfung einreichen-Schaltfläche ist verfügbar, wenn alle Felder gültige Eingaben enthalten.

  1. Stellen Sie sicher, dass Sie eine Einreichung mit einer aktiven E-Mail-Adresse erstellen.

  2. Auf der Registerkarte Konnektorzertifizierung in ISV Studio werden Sie aufgefordert, Ihre Dateien wie folgt zu senden:

    • Als Eingabe der GitHub-Commit-Informationen von Ihrem Open-Source-Konnektor.

      Hinweis

      Stellen Sie sicher, dass Sie die aktuelle Commit-ID des PR Ihres Konnektors angeben.

    • Hochladen des Zip-Archivs, das Sie im vorherigen Schritt erstellt haben.

  3. Geben Sie die folgenden Informationen in ISV Studio ein:

    • Konnektor-Testinformationen und Anmeldeinformationen:

      • Geben Sie so viele Details wie möglich an, um einen reibungslosen Test zu gewährleisten. Stellen Sie sicher, dass Sie gültige Testinformationen bereitstellen.

      Screenshot der Übermittlungsdetails des Konnektors

      Wichtig

      Wenn Ihr Konnektor vom Typ OAuth ist, stellen Sie sicher, dass Sie eine gültige Client ID und Client secret angeben. Diese Informationen können nach der Übermittlung nicht mehr geändert werden. Sobald es empfangen wurde, wird es in Azure Key Vault gespeichert.

      Wenn Sie dies ändern möchten, verbinden Sie sich mit Ihrem Microsoft-Kontakt.

      • Sollte Ihr Konnektor „OAuth“ als Authentifizierungstyp verwenden, fügen Sie Ihrer App die in die Whitelist aufgenommenen zugelassenen Umleitungs-URLs hinzu.

        https://global.consent.azure-apim.net/redirect
        https://global-test.consent.azure-apim.net/redirect

      • Vermeiden Sie, ein Konto bereitzustellen, das die mehrstufige Authentifizierung (MFA) verwendet, oder stellen Sie Schritte für das Zertifizierungsteam bereit, um ordnungsgemäß auf das MFA-geschützte Konto zuzugreifen.

    • Eine Support-E-Mail für Microsoft zur Kontaktaufnahme bei Problemen.

  4. Setzen Sie sich mit Ihrem Microsoft-Kontakt in Verbindung, wenn Sie Schwierigkeiten haben, Ihre Konnektor-Artefakte zu senden.

  5. Nachdem Sie Ihre Artefakte gesendet haben, fügen Sie separat eine intro.md in den Bereich Aktivitätssteuerung oder Funktionsdokumentation ein. Diese intro.md wird in die öffentlich zugängliche Dokumentation Ihres Konnektors aufgenommen. Dies ist getrennt von der readme.md, die Sie während des Open-Sourcing-Schrittes gesendet haben.

    Fügen Sie keine Informationen über die Aktionen oder Auslöser Ihres Konnektors in intro.md ein, da diese Informationen während der Zertifizierung automatisch für Sie generiert werden.

  6. (Erforderlich) Verwenden Sie den folgenden Markdown als Beispiel für eine Vorlage für eine intro.md-Datei:

Provide a detailed description here, distinct from your connector's description, of the value that the connector offers users and a high-level overview of functionality that the connector supports. This description should be no more than one paragraph of eight sentences.

## <a name="prerequisites"></a>Prerequisites

Provide information about any prerequisites that are required to use this connector. For example, an account on your website or a paid service plan. 

## <a name="how-to-get-credentials"></a>How to get credentials

Provide detailed information about how a user can get credentials to use the connector. Where possible, this should be step-by-step instructions with links pointing to relevant parts of your website.

If your connector doesn't require authentication, this section can be removed.

## <a name="get-started-with-your-connector"></a>Get started with your connector

Provide users with a step-by-step process for getting started with your connector. This is where you should highlight common use cases, such as your expected popular triggers and actions, and how they can help in automation scenarios. Include images where possible.

## <a name="known-issues-and-limitations"></a>Known issues and limitations

If your connector has any known issues and limitations, include a detailed description of them here. This information should be as robust as possible so users have plenty of information should they run into problems. If any workarounds are known, include them here.

## <a name="common-errors-and-remedies"></a>Common errors and remedies

Highlight any errors that might commonly occur when using the connector (such as HTTP status code errors), and what the user should do to resolve the error.

## <a name="faq"></a>FAQ

Provide a breakdown of frequently asked questions and their respective answers here. This can cover FAQs about interacting with the underlying service or about the connector itself.

Nachdem Sie Ihren Konnektor und intro.md übermittelt haben, können Sie sich auf das Testen Ihres Konnektors vorbereiten. Siehe Testen Sie Ihren Konnektor bei der Zertifizierung für Anweisungen.

Einreichung von Updates vor der Zertifizierung

Dieser Abschnitt gilt für verifizierte Herausgeber ohne unabhängige Herausgeber.

In folgenden Situationen sollten Sie nur einen Connector aktualisieren, der gerade zertifiziert wird, aber noch nicht zertifiziert ist:

  • Wenn Microsoft Änderungen angefordert hat.

  • Wenn Sie ein kritisches Problem gefunden haben, das vor der Zertifizierung behoben werden muss.

Wichtig

Alle Aktualisierungen während des Zertifizierungsprozesses setzen den Prozess zurück. Nachdem Sie ein Update eingereicht haben, senden Sie bitte einen Pull-Request mit den aktualisierten Artefakten in unserem Open-Source Repository.

So senden Sie ein Update:

  1. Gehen Sie zur Registerkarte Konnektorzertifizierung von ISV Studio und wählen Sie Ihre vorhandene Übermittlung aus.

  2. Wählen Sie in dem Fensterbereich, der sich rechts öffnet, Ihre neueste Version aus.

    Liste der eingereichten Konnektoren

  3. In der unteren linken Ecke der Ansicht Konnektorübermittlungen wählen Sie Ein Update senden aus.

  4. In der Aufforderung Bearbeiten bestätigen wählen Sie Bestätigen aus. Dadurch wird der Zertifizierungsprozess zurückgesetzt.

  5. Entfernen Sie Ihr vorhandenes Connector-Archiv, indem Sie Entfernen auswählen. Führen Sie einen der folgenden Schritte aus:

    • Verwenden Sie die GitHub-Integration, um die aktualisierten Artefakte aus dem Open-Source-Repository zu erfassen
    • Laden Sie das aktualisierte Zip-Archiv hoch

    Entfernen Sie das vorhandene Zip-Archiv

  6. Füllen Sie die Felder des Einreichungsformulars aus. Stellen Sie sicher, dass Sie die richtigen Informationen bereitstellen —einschließlich der Tests —für Ihr letztes Update.

  7. In der unteren linken Ecke der Ansicht Konnektorübermittlung wählen Sie Zur Überprüfung senden aus. Sie sehen die stehende Bestätigung im folgenden Bild dargestellt, und Microsoft beginnt mit dem Überprüfungsprozess.

    Bestätigung der erhaltenen Übermittlung

Wichtig

Wählen Sie nicht erneut Ein Update senden, nachdem Sie Schritt 7 abgeschlossen haben. Dadurch wird der Fortschritt erneut zurückgesetzt.

Wenn Sie ein Update für Ihren bereits zertifizierten Konnektor senden möchten, siehe Aktualisieren Ihres zertifizierten Konnektors.

Nächster Schritt

Zu zertifizierenden Connector testen

Feedback senden

Wir freuen uns sehr über Feedback zu Problemen mit unserer Connector-Plattform oder neuen Feature-Ideen. Wenn Sie Feedback geben möchten, gehen Sie zu Probleme melden oder Hilfe zu Connectors und wählen Sie einen Feedbacktyp aus.