Udostępnij przez

Niezależny proces certyfikacji wydawcy

Proces certyfikacji łączników opisany w niniejszym artykule dotyczy niezależnych wydawców. Jeśli użytkownik jest właścicielem podstawowej usługi łącznika, przejdź do Procesu certyfikacji zweryfikowanego wydawcy.

Notatka

Wszystkie łączniki są gotowe do użycia. Ten artykuł zawiera informacje o certyfikowaniu łączników niestandardowych dla usług Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps i Microsoft Copilot Studio. Przed rozpoczęciem kroków opisanych w tym artykule przeczytaj Uzyskaj certyfikowany łącznik.

Gdy firma Microsoft certyfikuje łącznik dla programu programu Independent Publisher i publikuje łącznik, nazwa użytkownika pojawia się w produkcie jako oficjalny wydawca, a na łączniku pojawia się ogólna ikona. Przygotowanie i przesłanie łącznika do certyfikacji jest proste. Przed przesłaniem plików łącznika do usługi Microsoft przejrzyj i wykonaj wszystkie kroki opisane w tym artykule.

Wymagania wstępne

Grupa Łączników Niezależnego Wydawcy umożliwia każdemu, kto ma zweryfikowane poświadczenia, opublikować łącznik na oficjalnej liście łączników firmy Microsoft. Jeśli chcesz współtworzyć grupę, przejrzyj zasoby grupy i podejmij wymagane działania:

  • Zapoznaj się z Power Platform repozytorium GitHub łączników. Repozytorium zawiera foldery, które obsługują niezależnych wydawców.
  • Przejrzyj materiały szkoleniowe dla łączników niezależnych wydawców
  • Przeczytaj, zrozum i zaakceptuj treść manifestu grupy łączników wydawców niezależnych.
  • Uzyskiwanie zweryfikowanych poświadczeń. Za każdym razem, gdy wysyłasz pull request do łączników niezależnych wydawców Power Platform Connectors, musisz przedstawić zweryfikowane poświadczenia. Jeśli nie masz zweryfikowanych poświadczeń, ważne jest, aby wykonać kroki opisane w artykule Uzyskiwanie zweryfikowanych poświadczeń , aby rozpocząć proces uzyskiwania poświadczeń skonfigurowanych w aplikacji Microsoft Authenticator, aby móc łatwo się z nimi zalogować przy każdym przesłaniu żądania ściągnięcia.

Krok 1: Sprawdź, czy łącznik nie jest już stworzony

Przed rozpoczęciem tworzenia łącznika sprawdź, czy łącznik nie został jeszcze stworzony. Aby to sprawdzić, możesz wyszukać łącznik w następujących miejscach:

Skorzystaj z tej tabeli, aby zobaczyć, co możesz zrobić z łącznikiem na podstawie jego stanu:

Jeśli proponowany łącznik: Opcja:
Już dostępne dla Copilot Studio i Power Platform. Nie można utworzyć łącznika.
Już istnieje jako łącznik niezależnego wydawcy. Do łącznika można dodać więcej funkcji.
Jest obecnie żądaniem i propozycją ściągania. Można skontaktować się z niezależnym wydawcą w celu wspólnej pracy na łącznikiem.
Jest żądaniem ściągania i nie jest propozycją. Poczekaj, aż łącznik zostanie certyfikowany i wdrożony. Następnie dodaj aktualizację do tego łącznika.

Krok 2: Udostępnij propozycję łącznika z Microsoft

Po sprawdzeniu, czy łącznik nie znajduje się na platformie, udostępnij propozycję łącznika w repozytorium GitHub grupy łączników niezależnych wydawców. Udostępnienie propozycji pomaga uniknąć powielania działań i może pomóc w znalezieniu współpracowników.

Aby udostępnić ofertę, należy przesłać żądanie ściągania do repozytorium GitHub z następującymi kryteriami:

  • Nadaj żądaniu ściągnięcia tytuł: Propozycja - Nazwa Łącznika. Na przykład Proposal - HubSpotCRM.
  • Zatwierdź plik intro.md z tyloma szczegółami, ile możesz podać. Jeśli nie możesz znaleźć osoby, która znajduje się w tym celu, dołącz wiadomość e-mail z kontaktem.
  • Udostępnij zweryfikowane poświadczenia. Jeśli nie masz jeszcze skonfigurowanych poświadczeń zweryfikowanych i gotowych do udostępnienia, otrzymasz automatycznie wygenerowany link do formularza w celu wypełnienia i przesłania. Zespół ds. łączników skontaktuje się za pośrednictwem poczty e-mail z informacjami, które pozwolą na rozpoczęcie procesu jednorazowej konfiguracji zweryfikowanych poświadczeń.

Notatka

To samo pull request jest używane, gdy jesteś gotowy do przesłania wszystkich plików do certyfikacji w kroku 4.

Krok 3: Utwórz łącznik

Utwórz łącznik. Rozpoczęcie pracy: Tworzenie łącznika niestandardowego od podstaw. Przed przesłaniem łącznika do niezależnej weryfikacji i wdrożenia przez wydawcę należy postępować zgodnie z najlepszymi praktykami dotyczącymi przygotowania łącznika:

Zapoznaj się ze wszystkimi krokami opisanymi w artykule Przygotowywanie plików łącznika do certyfikacji.

Krok 4: Przesyłanie artefaktów łącznika

Gdy wszystko będzie gotowe do przesłania artefaktów łącznika do walidacji przez Microsoft, certyfikacji i wdrożenia, pamiętaj, aby:

  • Prześlij artefakty łącznika na żądanie pull utworzone w kroku 2.
  • Wypełnij listę kontrolną w szablonie żądań ściągnięcia.
  • Usuń Proposal - z tytułu żądania żądania ściągnięcia.

Krok 5. Weryfikacja OneVet

Aby zachować zaufanie i bezpieczeństwo w całej społeczności Power Platform, wszyscy wydawcy przesyłający prośby o połączenie w usłudze GitHub muszą zweryfikować tożsamość i autentyczność. Wykonaj następujące kroki, aby uzyskać zweryfikowane poświadczenia.

Krok 6. Przechodzenie przez proces weryfikacji i certyfikacji łącznika

Po zweryfikowaniu tożsamości przez firmę Microsoft wykonaj następujące kroki:

  • Rozwidlij repozytorium microsoft/PowerPlatformConnector.

  • Utwórz pull request zawierający wszystkie pliki, które były wcześniej potrzebne, a następnie dodaj plik package.zip do pull requestu.

  • Spakuj pliki łącznika, korzystając z artykułu Przygotowywanie łączników agenta i platformy Power Platform do certyfikacji.

  • Zweryfikuj pakiet pod kątem struktury przed przesłaniem pakietu w celu certyfikacji do Centrum partnerskiego — uruchom narzędzie sprawdzania poprawności pakietów.

  • Zespół ds. certyfikacji dodaje komentarz do pull requestu o nazwie certify-connector, aby rozpocząć proces certyfikacji.

  • Jeśli pakiet jest prawidłowy, certyfikacja zostaje zatwierdzona, a w PR zostanie wyświetlony komunikat o powodzeniu z informacją, że proces wdrażania zostanie wkrótce rozpoczęty.

  • Nie można zmienić nazwy folderu łącznika w repozytorium GitHub po dodaniu. Jeśli jako wydawca chcesz zmienić nazwę pliku, musisz skontaktować się z zespołem ds. certyfikacji.

  • Zespół ds. certyfikacji ukończy przegląd kodu i inicjuje wdrożenia łącznika. Po zakończeniu procesu wdrażania pull request zostanie zaktualizowany i scalony przez zespół certyfikacji.

  • Jeśli występują jakiekolwiek błędy związane z przesłaniem, które należy rozwiązać, zobaczysz szczegóły błędu pojawiące się w komentarzach zapytania o ściągnięcie (PR). Po wprowadzeniu aktualizacji i ponownym złożeniu pull requestu proces certyfikacji uruchamia się ponownie. Możesz utworzyć nowy Pull Request, ale najlepiej jest pracować z tym samym Pull Requestem.

  • Aktualizacje muszą zostać przesłane przez tego samego wydawcę, który przesłał poprzednią wersję. Jeśli aktualizacje są odbierane od innego wydawcy, żądania ściągnięcia są odrzucane.

  • Jeśli jesteś oryginalnym wydawcą i utracisz dostęp do konta, musisz ręcznie skontaktować się z zespołem certyfikacji w celu weryfikacji i poprosić o odblokowanie.

Notatka

Łączniki OAuth nie są obecnie obsługiwane dla niezależnych wydawców.

Krok 6: Poczekaj na wdrożenie łącznika

Ważne

Wdrożenie łącznika zajmuje przeciętnie 15 dni roboczych. Czas jest wymagany niezależnie od rozmiaru lub złożoności łącznika, niezależnie od tego, czy jest nowy, czy aktualizacja. Aby zapewnić integralność, wszystkie łączniki poddawane są tym samym zadaniom weryfikacyjnym w celu sprawdzenia funkcjonalności i treści, które są wykonywane przy każdym wdrożeniu.

  • Harmonogramy wdrażania: harmonogramy wdrażania łączników dotyczące rozpoczęcia produkcyjnego w piątek rano, PST/PDT. Poinformuj osobę kontaktową w firmie Microsoft co najmniej 24 godziny przed rozpoczęciem wdrażania produkcyjnego, aby łącznik został uwzględniony w następnym zaplanowanym wdrożeniu.

  • Wdrożenie w regionie: Firma Microsoft powiadomi cię pocztą elektroniczną o nazwach regionów, w których wdrożono łącznik, ponieważ wdrażanie w regionach odbywa się etapami. Jeśli wystąpi opóźnienie lub zawieszenie wdrożenia, otrzymasz powiadomienie e-mail. Aby dowiedzieć się więcej, przejdź do Wdrażąnie regionalne.

Postępuj zgodnie z najlepszymi praktykami dotyczącymi przesyłania

Aby przesłać łącznik zgodnie z najlepszymi praktykami:

  • Prześlij tylko jeden konektor na żądanie pull, aby ułatwić proces weryfikacji.
  • Dodaj wiadomość e-mail skojarzona z kontem usługi GitHub do sekcji poczty e-mail pomocy technicznej. W takim przypadku konieczne jest skontaktowanie się z tobą.
  • Należy pamiętać o wypełnieniu parametru zasad ochrony prywatności zasadami ochrony prywatności dla usługi końcowej.
  • Napisz szczegółowe opisy operacji, aby użytkownicy mogli zrozumieć Twoją operację.
  • Jeśli łącznik korzysta z protokołu OAuth, upewnij się, że podajesz szczegółowe instrukcje tworzenia aplikacji w pliku readme.md. Jeśli tego nie zrobisz, certyfikacja zostanie opóźniona. Przykład dokumentacji, która ma być dołączyć, przejdź do przykładu Readme.md.
  • Upewnij się, że dodajesz schematy odpowiedzi do swoich działań, chyba że schemat odpowiedzi jest dynamiczny. Pomaga to łącznikowi w zwiększeniu użycia.
  • Przejrzyj Listę kontrolną przed przesłaniem.

Firma Microsoft gwarantuje

Firma Microsoft zobowiązuje się do zagwarantowania poniżej wymienionych:

  • Jeśli będzie dostępna aktualizacja łącznika, ponownie uruchomimy narzędzie do zmiany powodującej niezgodność i wszystkie inne narzędzia sprawdzania poprawności.
  • Brak aktualizacji łącznika gwarantuje, że działa, chyba że wystąpi zmiana lub aktualizacja interfejsu API bądź problem z platformą.
  • W przypadku wystąpienia jakichkolwiek problemów związanych z platformą lub bezpieczeństwem firma Microsoft bada je w miarę ich pojawiania się i wycofuje uszkodzone łączniki niezależnych wydawców.

Następny krok

Przenoszenie łącznika z wersji zapoznawczej do wersji ogólnie dostępnej (GA)

  • Last updated on