Wywoływanie usługi Azure Functions z przepływów pracy w usłudze Azure Logic Apps
Dotyczy: Azure Logic Apps (Zużycie + Standardowa)
Aby uruchomić kod wykonujący określone zadanie w przepływie pracy aplikacji logiki, nie musisz kompilować kompletnej aplikacji ani infrastruktury. Zamiast tego możesz utworzyć i wywołać funkcję platformy Azure. Usługa Azure Functions zapewnia przetwarzanie bezserwerowe w chmurze i możliwość wykonywania następujących zadań:
- Rozszerz zachowanie przepływu pracy, uruchamiając funkcje utworzone przy użyciu Node.js lub C#.
- Wykonywanie obliczeń w przepływie pracy.
- Zastosuj zaawansowane formatowanie lub pola obliczeniowe w przepływie pracy.
W tym przewodniku z instrukcjami pokazano, jak wywołać istniejącą funkcję platformy Azure z poziomu przepływu pracy Zużycie lub Standardowy. Aby uruchomić kod bez korzystania z usługi Azure Functions, zapoznaj się z następującą dokumentacją:
- Uruchamianie fragmentów kodu w przepływach pracy
- Tworzenie i uruchamianie kodu programu .NET Framework na podstawie przepływów pracy w warstwie Standardowa
Ograniczenia
Tylko przepływy pracy Zużycie obsługują uwierzytelnianie wywołań funkcji platformy Azure przy użyciu tożsamości zarządzanej z uwierzytelnianiem firmy Microsoft Entra. Standardowe przepływy pracy nie są obecnie obsługiwane w sekcji dotyczącej sposobu włączania uwierzytelniania dla wywołań funkcji.
Usługa Azure Logic Apps nie obsługuje używania usługi Azure Functions z włączonymi miejscami wdrożenia. Chociaż ten scenariusz może czasami działać, takie zachowanie jest nieprzewidywalne i może spowodować problemy z autoryzacją, gdy przepływ pracy spróbuje wywołać funkcję platformy Azure.
Wymagania wstępne
Konto i subskrypcja platformy Azure. Jeśli nie masz subskrypcji, zarejestruj się w celu założenia bezpłatnego konta platformy Azure.
Zasób aplikacji funkcji platformy Azure, który zawiera co najmniej jedną funkcję platformy Azure.
Zasób aplikacji funkcji i zasób aplikacji logiki muszą używać tej samej subskrypcji platformy Azure.
Zasób aplikacji funkcji musi używać platformy .NET lub Node.js jako stosu środowiska uruchomieniowego.
Po dodaniu nowej funkcji do aplikacji funkcji możesz wybrać język C# lub JavaScript.
Funkcja platformy Azure, którą chcesz wywołać. Tę funkcję można utworzyć przy użyciu następujących narzędzi:
Funkcja musi używać szablonu wyzwalacza HTTP.
Szablon wyzwalacza HTTP może akceptować zawartość, która ma
application/jsontyp z przepływu pracy aplikacji logiki. Po dodaniu funkcji do przepływu pracy projektant wyświetla funkcje niestandardowe utworzone na podstawie tego szablonu w ramach subskrypcji platformy Azure.Kod funkcji musi zawierać odpowiedź i ładunek, który ma zostać zwrócony do przepływu pracy po zakończeniu działania funkcji. Obiekt
contextodwołuje się do komunikatu wysyłanego przez przepływ pracy za pośrednictwem parametru akcji usługi Azure Functions o nazwie Treść żądania w dalszej części tego przewodnika.W tym przewodniku użyto następującej przykładowej funkcji o nazwie FabrikamAzureFunction:
module.exports = function (context, data) { var input = data; // Function processing logic // Function response for later use context.res = { body: { content:"Thank you for your feedback: " + input } }; context.done(); }Aby uzyskać dostęp do
contextwłaściwości obiektu z poziomu funkcji, użyj następującej składni:context.body.<property-name>Aby na przykład odwołać się
contentdo właściwości wcontextobiekcie, użyj następującej składni:context.body.contentTen kod zawiera również zmienną
input, która przechowuje wartość z parametrudata, aby funkcja mogła wykonywać operacje na tej wartości. W funkcjach języka JavaScript zmiennadatajest również skrótem dla elementucontext.body.Uwaga
Właściwość
bodyma zastosowanie docontextobiektu i nie jest taka sama jak token Treść w danych wyjściowych akcji, które można również przekazać do funkcji.Funkcja nie może używać tras niestandardowych, chyba że zdefiniowano definicję interfejsu OpenAPI (plik Struktury Swagger).
Jeśli masz definicję interfejsu OpenAPI dla funkcji, projektant przepływu pracy zapewnia bogatsze środowisko pracy podczas pracy z parametrami funkcji. Zanim przepływ pracy będzie mógł znaleźć funkcje z definicjami interfejsu OpenAPI i uzyskiwać do nich dostęp, skonfiguruj aplikację funkcji, wykonując następujące kroki.
Przepływ pracy aplikacji logiki Zużycie lub Standardowa rozpoczynający się od dowolnego wyzwalacza.
W przykładach w tym przewodniku użyto wyzwalacza usługi Office 365 Outlook o nazwie Po nadejściu nowej wiadomości e-mail.
Aby utworzyć i wywołać funkcję platformy Azure, która wywołuje inny przepływ pracy, upewnij się, że pomocniczy przepływ pracy rozpoczyna się od wyzwalacza, który zapewnia wywoływany punkt końcowy.
Możesz na przykład uruchomić przepływ pracy za pomocą ogólnego wyzwalacza HTTP lub żądania albo użyć wyzwalacza opartego na usłudze, takiego jak kolejki platformy Azure lub usługa Event Grid. Wewnątrz funkcji wyślij żądanie HTTP POST do adresu URL wyzwalacza i dołącz ładunek, który ma zostać przetworzyny przez pomocniczy przepływ pracy. Aby uzyskać więcej informacji, zobacz Wywoływanie, wyzwalanie lub zagnieżdżanie przepływów pracy aplikacji logiki.
Wskazówki do pracy z usługą Azure Functions
Generowanie definicji interfejsu OpenAPI lub pliku struktury Swagger dla funkcji
Aby uzyskać bogatsze środowisko pracy z parametrami funkcji w projektancie przepływu pracy, wygeneruj definicję interfejsu OpenAPI lub plik struktury Swagger dla funkcji. Aby skonfigurować aplikację funkcji, aby przepływ pracy mógł znajdować i używać funkcji zawierających opisy struktury Swagger, wykonaj następujące kroki:
W witrynie Azure Portal otwórz aplikację funkcji. Upewnij się, że aplikacja funkcji jest aktywnie uruchomiona.
W aplikacji funkcji skonfiguruj współużytkowanie zasobów między źródłami (CORS), aby wszystkie źródła były dozwolone, wykonując następujące kroki:
W menu aplikacji funkcji w obszarze INTERFEJS API wybierz pozycję CORS.
W obszarze Dozwolone źródła dodaj znak wieloznaczny gwiazdki (
*), ale usuń wszystkie inne źródła z listy i wybierz pozycję Zapisz.
Uzyskiwanie dostępu do wartości właściwości wewnątrz żądań HTTP
Funkcje oparte na elementach webhook mogą akceptować żądania HTTP jako dane wejściowe i przekazywać te żądania do innych funkcji. Na przykład chociaż usługa Azure Logic Apps ma funkcje, które konwertują wartości DateTime, ta podstawowa przykładowa funkcja Języka JavaScript pokazuje, jak można uzyskać dostęp do właściwości wewnątrz obiektu żądania HTTP przekazanego do funkcji i wykonywać operacje na tej wartości właściwości. Aby uzyskać dostęp do właściwości wewnątrz obiektów, w tym przykładzie użyto operatora kropki (.):
function convertToDateString(request, response){
var data = request.body;
response = {
body: data.date.ToDateString();
}
}
Oto, co dzieje się wewnątrz tej funkcji:
Funkcja tworzy zmienną
data, a następnie przypisujebodyobiekt , który znajduje się wewnątrzrequestobiektu, do zmiennej. Funkcja używa operatora kropki (.) do odwołowania siębodydo obiektu wewnątrzrequestobiektu:var data = request.body;Funkcja może teraz uzyskać dostęp do
datewłaściwości za pośrednictwemdatazmiennej i przekonwertować wartość właściwości z typu DateTime na typ DateString , wywołującToDateString()funkcję. Funkcja zwraca również wynik za pośrednictwembodywłaściwości w odpowiedzi funkcji:body: data.date.ToDateString();
Po utworzeniu funkcji na platformie Azure wykonaj kroki dodawania funkcji platformy Azure do przepływu pracy.
Dodawanie funkcji do przepływu pracy (użycie i standardowe przepływy pracy)
Aby wywołać funkcję platformy Azure z przepływu pracy, możesz dodać tę funkcję jak dowolną inną akcję w projektancie.
W witrynie Azure Portal otwórz przepływ pracy aplikacji logiki Zużycie w projektancie.
W projektancie wykonaj następujące ogólne kroki, aby dodać akcję usługi Azure Functions o nazwie Wybierz funkcję platformy Azure.
W okienku Tworzenie Połączenie ion wykonaj następujące kroki:
Podaj nazwę Połączenie ion dla połączenia z aplikacją funkcji.
Z listy aplikacji funkcji wybierz aplikację funkcji.
Z listy funkcji wybierz funkcję, a następnie wybierz pozycję Dodaj akcję, na przykład:
W polu akcji wybranej funkcji wykonaj następujące kroki:
W polu Treść żądania podaj dane wejściowe funkcji, które muszą być sformatowane jako obiekt JavaScript Object Notation (JSON). Te dane wejściowe to ładunek obiektu kontekstu lub komunikat, który przepływ pracy wysyła do funkcji.
Aby wybrać tokeny reprezentujące dane wyjściowe z poprzednich kroków, wybierz wewnątrz pola Treść żądania, a następnie wybierz opcję otwarcia listy zawartości dynamicznej (ikona błyskawicy).
Aby utworzyć wyrażenie, wybierz wewnątrz pola Treść żądania, a następnie wybierz opcję, aby otworzyć edytor wyrażeń (ikona formuły).
Poniższy przykład określa obiekt JSON z atrybutem
contenti token reprezentujący wartość Od danych wyjściowych z wyzwalacza wiadomości e-mail jako wartość Treść żądania:
W tym miejscu obiekt kontekstu nie jest rzutowy jako ciąg, więc zawartość obiektu jest dodawana bezpośrednio do ładunku JSON. Oto kompletny przykład:
Jeśli podasz obiekt kontekstu inny niż token JSON przekazujący ciąg, obiekt JSON lub tablicę JSON, zostanie wyświetlony błąd. Można jednak rzutować obiekt kontekstu jako ciąg, ujęcie tokenu w cudzysłów ("), na przykład jeśli chcesz użyć tokenu Odebrany czas :
Aby określić inne szczegóły, takie jak metoda do użycia, nagłówki żądań, parametry zapytania lub uwierzytelnianie, otwórz listę Parametry zaawansowane i wybierz żądane parametry. W przypadku uwierzytelniania opcje różnią się w zależności od wybranej funkcji. Aby uzyskać więcej informacji, zobacz Włączanie uwierzytelniania dla funkcji.
Włączanie uwierzytelniania dla wywołań funkcji platformy Azure (tylko przepływy pracy użycia)
Przepływ pracy Zużycie może używać tożsamości zarządzanej do uwierzytelniania wywołania funkcji platformy Azure i uzyskiwania dostępu do zasobów chronionych przez identyfikator Entra firmy Microsoft. Tożsamość zarządzana może uwierzytelniać dostęp bez konieczności logowania się i podawania poświadczeń lub wpisów tajnych. Platforma Azure zarządza tą tożsamością i pomaga zabezpieczyć poświadczenia, ponieważ dzięki temu nie musisz dostarczać ani rotować wpisów tajnych. Tożsamość przypisaną przez system można skonfigurować lub ręcznie utworzoną tożsamość przypisaną przez użytkownika na poziomie zasobu aplikacji logiki. Funkcja platformy Azure wywoływana z przepływu pracy może używać tej samej tożsamości zarządzanej do uwierzytelniania.
Uwaga
Tylko przepływy pracy Zużycie obsługują uwierzytelnianie wywołania funkcji platformy Azure przy użyciu tożsamości zarządzanej i uwierzytelniania firmy Microsoft Entra. Standardowe przepływy pracy obecnie nie obejmują tej obsługi, gdy używasz akcji do wywołania funkcji platformy Azure.
Więcej informacji można znaleźć w następującej dokumentacji:
- Uwierzytelnianie dostępu za pomocą tożsamości zarządzanych
- Dodawanie uwierzytelniania do wywołań wychodzących
Aby skonfigurować aplikację funkcji i funkcję w celu korzystania z tożsamości zarządzanej aplikacji logiki Consumption, wykonaj następujące ogólne kroki:
Włącz i skonfiguruj tożsamość zarządzaną aplikacji logiki.
Skonfiguruj funkcję na potrzeby uwierzytelniania anonimowego.
Znajdź wymagane wartości do skonfigurowania uwierzytelniania firmy Microsoft Entra.
Konfigurowanie funkcji na potrzeby uwierzytelniania anonimowego (tylko przepływy pracy użycia)
Aby funkcja korzystała z tożsamości zarządzanej aplikacji logiki Zużycie, należy ustawić poziom uwierzytelniania funkcji na anonymouswartość . W przeciwnym razie przepływ pracy zgłasza błąd BadRequest .
W witrynie Azure Portal znajdź i wybierz aplikację funkcji.
W poniższych krokach użyto przykładowej aplikacji funkcji o nazwie FabrikamFunctionApp.
W menu zasobów aplikacji funkcji w obszarze Narzędzia programistyczne wybierz pozycję Narzędzia zaawansowane>Przejdź.
Po otworzie strony Kudu Plus na pasku tytułu witryny internetowej Kudu z menu Konsola debugowania wybierz pozycję CMD.
Po wyświetleniu następnej strony z listy folderów wybierz pozycję witryna>wwwroot>your-function.
W poniższych krokach użyto przykładowej funkcji o nazwie FabrikamAzureFunction.
Otwórz plik function.json do edycji.
W obiekcie bindings sprawdź, czy właściwość authLevel istnieje. Jeśli właściwość istnieje, ustaw wartość właściwości na
anonymous. W przeciwnym razie dodaj właściwość i ustaw wartość.
Gdy wszystko będzie gotowe, zapisz ustawienia. Przejdź do następnej sekcji.
Znajdź wymagane wartości do skonfigurowania uwierzytelniania entra firmy Microsoft (tylko przepływy pracy użycia)
Aby można było skonfigurować aplikację funkcji do korzystania z tożsamości zarządzanej i uwierzytelniania firmy Microsoft Entra, należy znaleźć i zapisać następujące wartości, wykonując kroki opisane w tej sekcji.
Znajdź identyfikator dzierżawy dla dzierżawy firmy Microsoft Entra.
Znajdź identyfikator obiektu dla tożsamości zarządzanej.
Znajdź identyfikator aplikacji dla aplikacji dla przedsiębiorstw skojarzonej z tożsamością zarządzaną.
Znajdowanie identyfikatora dzierżawy dla dzierżawy firmy Microsoft Entra
Uruchom polecenie programu PowerShell o nazwie Get-AzureAccount lub w witrynie Azure Portal, wykonaj następujące kroki:
W witrynie Azure Portal otwórz dzierżawę firmy Microsoft Entra.
W tym przewodniku jako przykładowej dzierżawie użyto firmy Fabrikam .
W menu dzierżawy wybierz pozycję Przegląd.
Skopiuj i zapisz identyfikator dzierżawy do późniejszego użycia, na przykład:
Znajdowanie identyfikatora obiektu dla tożsamości zarządzanej
Po włączeniu tożsamości zarządzanej dla zasobu aplikacji logiki Zużycie znajdź obiekt tożsamości zarządzanej. Użyjesz tego identyfikatora do znalezienia skojarzonej aplikacji dla przedsiębiorstw w dzierżawie entra.
W menu aplikacji logiki w obszarze Ustawienia wybierz pozycję Tożsamość, a następnie wybierz pozycję Przypisany system lub Użytkownik.
Przypisano system
Skopiuj identyfikator obiektu (podmiotu zabezpieczeń) tożsamości:
Przypisany użytkownik
Wybierz tożsamość:
Skopiuj identyfikator obiektu (podmiotu zabezpieczeń) tożsamości:
Znajdowanie identyfikatora aplikacji dla aplikacji dla przedsiębiorstw platformy Azure skojarzonej z tożsamością zarządzaną
Po włączeniu tożsamości zarządzanej w zasobie aplikacji logiki platforma Azure automatycznie tworzy skojarzą aplikację platformy Azure Enterprise o tej samej nazwie. Teraz musisz znaleźć skojarzą aplikację dla przedsiębiorstw i skopiować jej identyfikator aplikacji. Później użyjesz tego identyfikatora aplikacji, aby dodać dostawcę tożsamości dla aplikacji funkcji, tworząc rejestrację aplikacji.
W witrynie Azure Portal znajdź i otwórz dzierżawę entra.
W menu dzierżawy w obszarze Zarządzanie wybierz pozycję Aplikacje dla przedsiębiorstw.
Na stronie Wszystkie aplikacje w polu wyszukiwania wprowadź identyfikator obiektu tożsamości zarządzanej. Z wyników znajdź zgodną aplikację dla przedsiębiorstw i skopiuj identyfikator aplikacji:
Teraz użyj skopiowanego identyfikatora aplikacji, aby dodać dostawcę tożsamości do aplikacji funkcji.
Dodawanie dostawcy tożsamości dla aplikacji funkcji (tylko przepływy pracy użycia)
Teraz, gdy masz identyfikator dzierżawy i identyfikator aplikacji, możesz skonfigurować aplikację funkcji do korzystania z uwierzytelniania firmy Microsoft Entra, dodając dostawcę tożsamości i tworząc rejestrację aplikacji.
W witrynie Azure Portal otwórz aplikację funkcji.
W menu aplikacji funkcji w obszarze Ustawienia wybierz pozycję Uwierzytelnianie, a następnie wybierz pozycję Dodaj dostawcę tożsamości.
W okienku Dodawanie dostawcy tożsamości w obszarze Podstawy z listy Dostawca tożsamości wybierz pozycję Microsoft.
W obszarze Rejestracja aplikacji w polu Typ rejestracji aplikacji wybierz pozycję Podaj szczegóły istniejącej rejestracji aplikacji i wprowadź wcześniej zapisane wartości.
Właściwości Wymagania Wartość Opis Identyfikator aplikacji (klienta) Tak <identyfikator aplikacji> Unikatowy identyfikator do użycia na potrzeby tej rejestracji aplikacji. W tym przykładzie użyj identyfikatora aplikacji skopiowanego dla aplikacji dla przedsiębiorstw skojarzonej z tożsamością zarządzaną. Klucz tajny klienta Opcjonalne, ale zalecane <klucz tajny klienta> Wartość wpisu tajnego używana przez aplikację do potwierdzenia tożsamości podczas żądania tokenu. Wpis tajny klienta jest tworzony i przechowywany w konfiguracji aplikacji jako ustawienie aplikacji sticky o nazwie MICROSOFT_PROVIDER_AUTHENTICATION_SECRET. Aby zamiast tego zarządzać wpisem tajnym w usłudze Azure Key Vault, możesz zaktualizować to ustawienie później, aby użyć odwołań usługi Key Vault.
— Jeśli podasz wartość wpisu tajnego klienta, operacje logowania korzystają z przepływu hybrydowego, zwracając tokeny dostępu i odświeżania.
— Jeśli nie podasz wpisu tajnego klienta, operacje logowania korzystają z niejawnego przepływu przyznawania OAuth 2.0, zwracając tylko token identyfikatora.
Te tokeny są wysyłane przez dostawcę i przechowywane w magazynie tokenów EasyAuth.Adres URL wystawcy Nie. <authentication-endpoint-URL>/<Entra-tenant-ID>/v2.0 Ten adres URL przekierowuje użytkowników do właściwej dzierżawy firmy Microsoft Entra i pobiera odpowiednie metadane, aby określić odpowiednie klucze podpisywania tokenu i wartość oświadczenia wystawcy tokenu. W przypadku aplikacji korzystających z usługi Azure AD w wersji 1 pomiń /v2.0 z adresu URL.
W tym scenariuszu użyj następującego adresu URL:https://sts.windows.net/<Entra-tenant-ID>Dozwolone grupy odbiorców tokenów Nie. <identyfikator-URI aplikacji> Identyfikator URI aplikacji (identyfikator zasobu) dla aplikacji funkcji. W przypadku aplikacji w chmurze lub serwera, w której chcesz zezwolić na tokeny uwierzytelniania z aplikacji internetowej, dodaj identyfikator URI identyfikatora aplikacji dla aplikacji internetowej. Skonfigurowany identyfikator klienta jest zawsze niejawnie uznawany za dozwolonych odbiorców.
W tym scenariuszu wartość tohttps://management.azure.com. Później możesz użyć tego samego identyfikatora URI we właściwości Audience podczas konfigurowania akcji funkcji w przepływie pracy w celu korzystania z tożsamości zarządzanej.
Ważne: Identyfikator URI identyfikatora aplikacji (identyfikator zasobu) musi dokładnie odpowiadać wartości oczekiwanej przez identyfikator Entra firmy Microsoft, w tym wszelkich wymaganych ukośników końcowych.Na tym etapie wersja wygląda podobnie do tego przykładu:
Jeśli konfigurujesz aplikację funkcji za pomocą dostawcy tożsamości po raz pierwszy, zostanie również wyświetlona sekcja Ustawienia uwierzytelniania usługi App Service. Te opcje określają sposób, w jaki aplikacja funkcji odpowiada na nieuwierzytelnione żądania. Wybór domyślny przekierowuje wszystkie żądania, aby zalogować się za pomocą nowego dostawcy tożsamości. To zachowanie można teraz dostosować lub dostosować te ustawienia później na stronie głównej Uwierzytelnianie , wybierając pozycję Edytuj obok pozycji Ustawienia uwierzytelniania. Aby dowiedzieć się więcej na temat tych opcji, zobacz Przepływ uwierzytelniania — uwierzytelnianie i autoryzacja w usłudze aplikacja systemu Azure i usłudze Azure Functions.
W przeciwnym razie możesz kontynuować wykonywanie następnego kroku.
Aby zakończyć tworzenie rejestracji aplikacji, wybierz pozycję Dodaj.
Po zakończeniu na stronie Uwierzytelnianie zostanie wyświetlony identyfikator dostawcy tożsamości i identyfikator aplikacji rejestracji aplikacji (klienta). Aplikacja funkcji może teraz używać tej rejestracji aplikacji do uwierzytelniania.
Skopiuj identyfikator aplikacji rejestracji aplikacji (klienta), aby użyć jej później we właściwości Odbiorcy akcji usługi Azure Functions dla przepływu pracy.
Wróć do projektanta i wykonaj kroki uwierzytelniania dostępu za pomocą tożsamości zarządzanej przy użyciu wbudowanej akcji usługi Azure Functions.
