Rychlý start: Připojení Azure Functions k databázím a službám pomocí konektoru Service Connector

Začněte s konektorem Service Connector a připojte službu Azure Functions k databázím, účtům úložiště a dalším službám Azure. Service Connector zjednodušuje ověřování a konfiguraci a umožňuje připojení k prostředkům pomocí spravovaných identit nebo jiných metod ověřování.

Tento článek obsahuje podrobné pokyny pro Azure Portal i Azure CLI. Zvolte upřednostňovanou metodu pomocí karet výše.

Požadavky

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Aplikace funkcí v oblasti podporované konektorem služby Pokud ho ještě nemáte, vytvořte ho.
• Cílový prostředek pro připojení aplikace funkcí, jako je například účet Blob Storage.
• Potřebná oprávnění k vytváření a správě připojení služeb.

• Účet Azure s aktivním předplatným. Vytvořte si bezplatný účet.
• Aplikace funkcí v oblasti podporované konektorem služby Pokud ho ještě nemáte, vytvořte ho.
• Cílový prostředek pro připojení aplikace funkcí, jako je například účet Blob Storage.
• Oprávnění potřebná k vytváření a správě připojení služeb.

• Použijte prostředí Bash v Azure Cloud Shellu. Další informace najdete v tématu Začínáme s Azure Cloud Shellem.

  

• Pokud dáváte přednost místnímu spouštění referenčních příkazů rozhraní příkazového řádku, nainstalujte Azure CLI. Pokud používáte Windows nebo macOS, zvažte spuštění Azure CLI v kontejneru Docker. Další informace najdete v tématu Jak spustit Azure CLI v kontejneru Dockeru.

  • Pokud používáte místní instalaci, přihlaste se k Azure CLI pomocí příkazu az login. Pokud chcete dokončit proces ověřování, postupujte podle kroků zobrazených na terminálu. Další možnosti přihlášení najdete v tématu Ověřování v Azure pomocí Azure CLI.

  • Po zobrazení výzvy nainstalujte rozšíření Azure CLI při prvním použití. Další informace o rozšířeních najdete v tématu Použití a správa rozšíření pomocí Azure CLI.

  • Spuštěním příkazu az version zjistěte verzi a závislé knihovny, které jsou nainstalované. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgrade.

• Tento rychlý start vyžaduje verzi 2.30.0 nebo vyšší azure CLI. Pokud chcete upgradovat na nejnovější verzi, spusťte az upgradepříkaz . Pokud používáte Azure Cloud Shell, je už nainstalovaná nejnovější verze.

Nastavení prostředí

1. Pokud konektor Service Connector používáte poprvé, zaregistrujte poskytovatele prostředků konektoru služby spuštěním příkazu az provider register .

   az provider register -n Microsoft.ServiceLinker
   

   Návod

   Spuštěním příkazu az provider show -n "Microsoft.ServiceLinker" --query registrationStatemůžete zkontrolovat, jestli už je poskytovatel prostředků zaregistrovaný. Pokud je Registeredvýstup , konektor Service Connector už je zaregistrovaný.

2. Volitelně spusťte příkaz az functionapp connection list-support-types a získejte seznam podporovaných cílových služeb pro Azure Functions.

   az functionapp connection list-support-types --output table
   

Vytvoření připojení služby

Pomocí konektoru služby můžete vytvořit připojení služby mezi aplikací Azure Functions a službou Azure Blob Storage. Tento příklad ukazuje připojení ke službě Blob Storage, ale stejný proces můžete použít i pro další podporované služby Azure.

1. Na webu Azure Portal vyberte vyhledávací panel Prohledat prostředky, služby a dokumenty (G +/) v horní části, zadejte Aplikaci funkcí a vyberte Aplikaci funkcí.

   

2. Vyberte prostředek aplikace funkcí, který chcete připojit k cílovému prostředku.

3. V levém navigačním panelu vyberte Konektor služby a pak vyberte Vytvořit.

   

4. Na kartě Základy vyberte nebo zadejte následující nastavení:

   Nastavení	Příklad	Popis
   Typ služby	Storage – objekt blob	Typ cílové služby. Pokud účet Blob Storage nemáte, můžete si ho vytvořit nebo použít jiný typ služby.
   Předplatné	Moje předplatné	Předplatné cílové služby (služba, ke které se chcete připojit). Výchozí hodnota je předplatné pro tento prostředek aplikace funkcí.
   Název připojení	my_connection	Název připojení, který identifikuje propojení mezi vaší aplikací funkcí a cílovou službou. Použijte název připojení poskytovaný konektorem service connector nebo zvolte vlastní název připojení.
   Účet úložiště	my_storage_account	Cílový účet úložiště, ke kterému se chcete připojit. Cílové instance služby, ze které se mají vybírat, se liší podle vybraného typu služby.
   Typ klienta	Stejný zásobník aplikací v této aplikaci funkcí	Výchozí hodnota pochází ze zásobníku modulu runtime aplikace funkcí. Vyberte zásobník aplikace, který je v této instanci aplikace funkcí.

5. Vyberte Další: Ověřování a zvolte metodu ověřování.

   Spravovaná identita přiřazená systémem (doporučeno)

   Vyberte spravovanou identitu přiřazenou systémem , která se připojí prostřednictvím identity, která se automaticky vygeneruje v Microsoft Entra ID a je svázaná s životním cyklem instance služby. Toto je doporučená možnost ověřování.

   Spravovaná identita přiřazená uživatelem

   Vyberte uživatelsky přiřazenou spravovanou identitu k ověření prostřednictvím samostatné identity přidělené jedné nebo více instancím služby Azure. Vyberte předplatné, které obsahuje spravovanou identitu přiřazenou uživatelem, a pak vyberte identitu.

   Pokud ještě nemáte spravovanou identitu přiřazenou uživatelem, vyberte Vytvořit novou a vytvořte ji.

   Služba principal

   1. Výběrem instančního objektu použijte instanční objekt , který definuje zásady přístupu a oprávnění pro uživatele nebo aplikaci v MICROSOFT Entra ID.
   2. V seznamu vyberte instanční objekt a zadejte tajný klíč.

   Připojovací řetězec

   Výstraha

   Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Ověřovací tok popsaný v tomto postupu vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích. Tento tok byste měli použít jenom v případě, že jiné bezpečnější toky, jako jsou spravované identity, nejsou přijatelné.

   Vyberte Připojovací řetězec a vygenerujte nebo nakonfigurujte jeden nebo více párů klíč-hodnota s čistými tajnými kódy nebo tokeny.

6. Vyberte Další: Sítě a nakonfigurujte nastavení sítě. Výběrem možnosti Konfigurovat pravidla brány firewall povolte přístup k cílové službě , aby vaše aplikace funkcí mohla přistupovat k cílové službě.

7. Vyberte Další: Zkontrolujte a vytvořte a zkontrolujte zadané informace. Spuštění konečného ověření trvá několik sekund. Pak výběrem možnosti Vytvořit vytvořte připojení služby. Dokončení této operace může trvat minutu.

Spravovaná identita (doporučeno)

Spuštěním příkazu az functionapp connection create vytvořte připojení služby ke službě Blob Storage se spravovanou identitou přiřazenou systémem. Tento příkaz můžete spustit dvěma způsoby:

• Krok za krokem vygenerujte nové připojení:

  az functionapp connection create storage-blob --system-identity
  

• Vygenerujte nové připojení najednou. Zástupné symboly nahraďte vlastními informacemi: <source-subscription>, <source_resource_group>, <function-app>, <target-subscription>, <target_resource_group>a <account>.

  az functionapp connection create storage-blob \
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.Web/sites/<function-app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --system-identity
  

Návod

Pokud nemáte účet Blob Storage, spusťte az functionapp connection create storage-blob --new --system-identity ho, abyste ho vytvořili a připojili ho k aplikaci funkcí pomocí spravované identity.

Připojovací řetězec

Výstraha

Microsoft doporučuje používat nejbezpečnější dostupný tok ověřování. Ověřovací tok popsaný v tomto postupu vyžaduje velmi vysoký stupeň důvěryhodnosti v aplikaci a nese rizika, která nejsou přítomna v jiných tocích. Tento tok byste měli použít jenom v případě, že jiné bezpečnější toky, jako jsou spravované identity, nejsou přijatelné.

Spuštěním příkazu az functionapp connection create vytvořte připojení služby ke službě Blob Storage pomocí připojovacího řetězce. Tento příkaz můžete spustit dvěma způsoby:

• Krok za krokem vygenerujte nové připojení:

  az functionapp connection create storage-blob --secret
  

• Vygenerujte nové připojení najednou. Zástupné symboly nahraďte vlastními informacemi: <source-subscription>, <source_resource_group>, <function-app>, <target-subscription><target_resource_group>, , <account>, <secret-name>, a <secret>.

  az functionapp connection create storage-blob \
     --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.Web/sites/<function-app> \
     --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
     --secret name=<secret-name> secret=<secret>
  

Návod

Pokud účet Blob Storage nemáte, spusťte az functionapp connection create storage-blob --new --secret ho, abyste ho vytvořili a připojili ho k aplikaci funkcí pomocí připojovacího řetězce.

Zobrazení a ověření připojení služeb

Po vytvoření připojení služby můžete zobrazit, ověřit a spravovat všechna připojení z aplikace Azure Functions.

1. Připojení aplikace funkcí se zobrazují v nabídce služby Konektor služby . Výběrem > rozbalíte seznam a zobrazíte vlastnosti požadované vaší aplikací.

2. Vyberte Ověřit a zkontrolujte připojení. Podrobnosti o ověření připojení se zobrazí na panelu vpravo.

   

Spuštěním příkazu az functionapp connection list zobrazte seznam všech zřízených připojení vaší aplikace funkcí. Nahraďte zástupné symboly <function-app-resource-group> a <function-app-name> vlastními informacemi. Můžete také odebrat --output table možnost zobrazení dalších informací o připojeních.

az functionapp connection list --resource-group "<function-app-resource-group>" --name "<function-app-name>" --output table

Výstup také zobrazí stav zřizování připojení.

Související obsah

Teď, když jste úspěšně připojili aplikaci Azure Functions ke službě Azure Storage, prozkoumejte tyto kurzy a sestavte pokročilejší aplikace funkcí pomocí konektoru služby:

• Kurz: Funkce Pythonu se službou Azure Queue Storage jako triggerem
• Kurz: Funkce Pythonu se službou Azure Blob Storage jako vstup
• Kurz: Funkce Pythonu se službou Azure Table Storage jako výstupem