Dela en anpassad anslutningsapp

Slutförd

Nu när du har skapat en anpassad anslutningsapp för Skrivar-Framer-API:et vill du göra anslutningsappen tillgänglig för alla användare i din organisation. På så sätt kan de anropa API:et från sina egna Azure Logic Apps-arbetsflöden. Du vet också att många av dina kunder använder Azure Logic Apps. Om du kan publicera din nya anslutningsapp till dem kan de enkelt göra anrop till ditt API.

Dela en anslutningsapp med din organisation

Om du har skapat och använt en anpassad anslutningsapp i ett logikapparbetsflöde är anslutningsappen som standard tillgänglig för andra Azure Logic Apps-användare i din organisation. De kan lägga till anslutningsappen i arbetsflöden i logikappregioner om de uppfyller följande kriterier:

  • De delar samma Microsoft Entra-klientorganisation med dig.
  • De delar samma Azure-prenumeration med dig.

Azure Logic Apps delar automatiskt anpassade anslutningsappar, som andra användare kan se när de väljer anslutningsappar för sina arbetsflöden. Men du kanske vill informera dem om den nya anslutningsappen, dess syfte, hur du använder den och så vidare.

Dela en anslutningsapp med communityn

Om externa användare kan anropa ditt API kan du överväga att publicera din anpassade anslutningsapp till Azure-communityn. Publicering gör det mycket enklare att skapa arbetsflöden med Azure Logic Apps och komma åt dina data via API:et. Att göra din anpassade anslutningsapp mer allmänt tillgänglig hjälper också till att främja ditt API och driva communityimplementering.

Print Framer-API:et är ett bra exempel. Alla som har en prenumeration och kan skriva kod som gör REST API-anrop kan komma åt ditt API. Men om du publicerar din anpassade anslutningsapp kan personer som använder Azure Logic Apps anropa ditt API från sina arbetsflöden utan att skriva någon kod. Vissa kanske inte känner till ditt API, så om de hittar din anslutningsapp via Azure Logic Apps-anslutningsgalleriet kan de välja att prova API:et och till och med köpa en prenumeration.

Om du vill publicera anslutningsappen i Azure Logic Apps-anslutningsgalleriet måste du skicka anslutningsappen till Microsoft för certifiering. Om anslutningsappen uppfyller certifieringskriterierna publicerar Microsoft anslutningsappen så att alla Azure Logic Apps-användare kan hitta och använda den.

Certifieringskriterier

Microsoft certifierar endast anslutningsappar som uppfyller följande kriterier:

Funktion Nödvändiga eller rekommenderade Description
Programvaruägarskap som en tjänst Obligatoriskt Din organisation måste äga det API som anslutningsappen ger åtkomst till.
Autentisering Obligatoriskt Ditt API måste ha stöd för OAuth2, API Key eller grundläggande autentisering.
Support Obligatoriskt Du måste tillhandahålla ett supportkontrakt till användarna så att kunderna kan begära hjälp för tekniska problem.
Tillgänglighet Rekommenderat Garantera minst 99,9 % drifttid i ditt serviceavtal (SLA).

Checklista innan du skickar en anslutningsapp

Testa anslutningsappen helt innan du skickar den för certifiering. Kontrollera att du är säker på att det inte finns några buggar eller andra problem. I följande lista beskrivs vanliga problem att kontrollera och lösa:

  • Fel i OpenAPI-definitionen: Eliminera eventuell ogiltig JSON-kod i API-definitionsfilen. Kontrollera att API-definitionen uppfyller OpenAPI-schemat.
  • Fullständig information i definitionen: Kontrollera att varje åtgärd, indataparameter och svarsattribut i OpenAPI-specifikationen som du skickar har en sammanfattning, beskrivning och synlighetsinformation.

Skicka en anslutningsapp för certifiering

Certifieringsprocessen tar cirka två veckor, men den här tidslinjen beror på hur väl din anslutningsapp uppfyller de tidigare kriterierna. Processen körs på samma sätt som följande steg:

  1. Nominering: Besök nomineringsformuläret för att skicka in din anslutningsapp. Microsoft skickar ett partneravtal.

  2. Granska: När avtalen har signerats granskar en Microsoft-anställd anslutningsappen. Du kan behöva ange anslutnings-ID: t, OpenAPI-definitionen, en ikonfil, ett testkonto, en e-postadress för support och annan information.

  3. Publicera: Microsoft arrangerar och publicerar anslutningsappen med taggen "Förhandsversion".

  4. Support och uppdateringar: När Microsoft har publicerat anslutningsappen och användarna börjar använda den övervakar du de relaterade produktforumen för att ta reda på om kunderna har några problem. Om du behöver skicka in en ny version använder du samma nomineringsformulär. När anslutningsappen har varit tillgänglig under en tid kan du be din nomineringskontakt att ta bort taggen "Förhandsversion".

Mer information finns i Skicka din anslutningsapp för Microsoft-certifiering.

Kontrollera dina kunskaper

1.

Ditt företag har en anslutningsapp som använder en API-nyckel för autentisering och ger åtkomst till ett REST API som körs av regeringen. Är din anslutningsapp berättigad till certifiering?

2.

Ditt företag har en anslutningsapp som använder klientcertifikat för autentisering och ger åtkomst till ditt eget REST API, som har en typisk tillgänglighet på 95 %. Är din anslutningsapp berättigad till certifiering?