Ověřování Python aplikací pro Azure služeb během místního vývoje pomocí vývojářských účtů

Během místního vývoje se aplikace musí ověřit v Azure, aby používaly různé služby Azure. Místní ověřování pomocí jednoho z těchto přístupů:

Použijte vývojářský účet s jedním z vývojářských nástrojů podporovaných knihovnou identit Azure.
Ke správě přihlašovacích údajů použijte zprostředkovatele .
Použijte service principal.

Tento článek vysvětluje, jak se ověřit pomocí vývojářského účtu pomocí nástrojů podporovaných knihovnou identit Azure. V následujících částech se dozvíte:

Jak používat skupiny Microsoft Entra k efektivní správě oprávnění pro více vývojářských účtů
Jak přiřadit role vývojářským účtům pro vymezení oprávnění.
Jak se přihlásit k podporovaným lokálním vývojovým nástrojům
Jak ověřit pomocí vývojářského účtu ve vašem aplikačním kódu.

Podporované vývojářské nástroje pro ověřování

Aby se aplikace při místním vývoji ověřila v Azure pomocí přihlašovacích údajů pro Azure vývojáře, musí se vývojář přihlásit k Azure z některého z následujících vývojářských nástrojů:

Azure CLI (příkazový řádek nástroje Azure)
Azure Developer CLI
Azure PowerShell
Visual Studio Code

Knihovna identit Azure dokáže zjistit, že vývojář je přihlášený z některého z těchto nástrojů. Knihovna pak může prostřednictvím nástroje získat přístupový token Microsoft Entra, aby se aplikace vůči Azure ověřila jako přihlášený uživatel.

Tento přístup zjednodušuje proces ověřování tím, že využívá stávající účty Azure vývojáře. Účet vývojáře ale pravděpodobně má více oprávnění, než vyžaduje aplikace, což znamená, že překračuje oprávnění, která aplikace běží v produkčním prostředí. Jako alternativu můžete vytvořit instanční objekty aplikace, které se použijí při místním vývoji, které můžete nastavit tak, aby měly přístup potřebný jenom pro aplikaci.

Vytvoření skupiny Microsoft Entra pro místní vývoj

Vytvořte skupinu Microsoft Entra, která zapouzdří role (oprávnění), jež aplikace potřebuje pro místní vývoj, spíše než přiřazovat role jednotlivým služebním hlavním objektům. Tento přístup nabízí následující výhody:

Každý vývojář má stejné role přiřazené na úrovni skupiny.
Pokud je pro aplikaci potřeba nová role, stačí ji přidat jenom do skupiny aplikace.
Pokud se nový vývojář připojí k týmu, vytvoří se nový instanční objekt aplikace pro vývojáře a přidá se do skupiny, aby vývojář získal správná oprávnění pro práci s aplikací.

Azure Portal
Azure CLI

V Azure portálu přejděte na stránku přehledu Microsoft Entra ID.
V nabídce vlevo vyberte Všechny skupiny .
Na stránce Skupiny vyberte Nová skupina.
Na stránce Nová skupina vyplňte následující pole formuláře:
- Typ skupiny: Vyberte zabezpečení.
- Název skupiny: Zadejte název skupiny, která obsahuje odkaz na název aplikace nebo prostředí.
- Popis skupiny: Zadejte popis, který vysvětluje účel skupiny.
Vyberte odkaz Žádné členy vybrané v části Členové a přidejte do skupiny členy.
V rozbalovacím panelu, který se otevře, vyhledejte aplikační objekt služby, který jste vytvořili dříve, a vyberte ho z filtrovaných výsledků. Výběrem tlačítka Vybrat v dolní části panelu potvrďte výběr.
Výběrem možnosti Vytvořit v dolní části stránky Nová skupina vytvořte skupinu a vraťte se na stránku Všechny skupiny . Pokud novou skupinu nevidíte, chvíli počkejte a aktualizujte stránku.

Pomocí příkazu az ad group create vytvořte skupiny v Microsoft Entra ID.
```
az ad group create \
    --display-name <group-name> \
    --mail-nickname <group-mail-nickname> \
    --description <group-description>
```
Parametry --display-name a --mail-nickname jsou povinné. Název dané skupiny by měl být založený na názvu a prostředí aplikace, aby bylo možné určit účel skupiny.
Pokud chcete do skupiny přidat členy, potřebujete ID objektu hlavní služby aplikace, které se liší od ID aplikace. Pomocí příkazu az ad sp list zobrazte seznam dostupných servisních entit.
```
az ad sp list \
    --filter "startswith(displayName, '<group-name>')" \
    --query "[].{objectId:id, displayName:displayName}"
```
Parametr --filter přijímá filtry ve stylu OData a lze ho použít k filtrování seznamu, jak je znázorněno. Parametr --query omezuje výstup pouze na sloupce, které zajímají.

Pomocí příkazu az ad group member add přidejte členy do skupiny:

az ad group member add \
    --group <group-name> \
    --member-id <object-id>

Přiřazení rolí ke skupině

Dále určete, jaké role (oprávnění) vaše aplikace potřebuje k jakým prostředkům, a přiřaďte tyto role skupině Microsoft Entra, kterou jste vytvořili. Skupinám lze přiřadit roli v rámci prostředku, skupiny prostředků nebo předplatného. Tento příklad ukazuje, jak přiřadit role v oboru skupiny prostředků, protože většina aplikací seskupuje všechny prostředky Azure do jedné skupiny prostředků.

Azure Portal
Azure CLI

Na webu Azure Portal přejděte na stránku Přehled skupiny prostředků, která obsahuje vaši aplikaci.
V levém navigačním panelu vyberte řízení přístupu (IAM).
Na stránce Řízení přístupu (IAM) vyberte + Přidat a pak v rozevírací nabídce zvolte Přidat přiřazení role . Stránka Přidat přiřazení role poskytuje několik záložek pro konfiguraci a přiřazení rolí.
Na kartě Role vyhledejte roli, kterou chcete přiřadit, pomocí vyhledávacího pole. Vyberte roli a pak zvolte Další.
Na kartě Členové :
- V části Přiřadit přístup k hodnotě vyberte Uživatel, skupina nebo instanční objekt .
- Pro hodnotu Členové zvolte + Vybrat členy , aby se otevřel informační panel Vybrat členy .
- Vyhledejte skupinu Microsoft Entra, kterou jste vytvořili dříve, a vyberte ji z filtrovaných výsledků. Výběrem možnosti Vybrat vyberte skupinu a zavřete informační panel.
- V dolní části karty Členové vyberte Zkontrolovat a přiřadit.
Na kartě Revize a Přiřazení vyberte Revize a Přiřazení v dolní části stránky.

Pomocí příkazu az role definition list získejte názvy rolí, které lze přiřadit skupině Microsoft Entra nebo služebnímu principálu:
```
az role definition list \
    --query "sort_by([].{roleName:roleName, description:description}, &roleName)" \
    --output table
```
Pomocí příkazu az role assignment create přiřaďte roli skupině Microsoft Entra, kterou jste vytvořili:
```
az role assignment create \
    --assignee "<group-object-Id>" \
    --role "<role-name>" \
    --resource-group "<resource-group-name>"
```
Informace o přiřazování oprávnění na úrovni prostředku nebo předplatného pomocí Azure CLI najdete v tématu Přiřazení rolí Azure pomocí Azure CLI.

Pokud chcete provést ověření pomocí účtu Azure, zvolte jednu z následujících metod:

Vývojáři, kteří používají Visual Studio Code, se můžou ověřit pomocí svého vývojářského účtu přímo prostřednictvím editoru prostřednictvím zprostředkovatele. Aplikace, které používají DefaultAzureCredential nebo VisualStudioCodeCredential , pak můžou tento účet použít k ověřování žádostí o aplikace prostřednictvím bezproblémového jednotného přihlašování.

V editoru Visual Studio Code přejděte na panel Rozšíření a nainstalujte rozšíření Azure Resources . Toto rozšíření umožňuje zobrazit a spravovat prostředky Azure přímo ze sady Visual Studio Code. Používá také integrovaného poskytovatele ověřování Microsoftu v editoru Visual Studio Code pro ověřování u Azure.
Otevřete paletu příkazů v editoru Visual Studio Code a vyhledejte a vyberte Azure: Přihlásit se.

Návod

Otevřete paletu příkazů pomocí Ctrl+Shift+P Windows/Linuxu nebo Cmd+Shift+P v macOS.
Přidejte balíček Pythonu azure-identity-broker do aplikace:
```
pip install azure-identity-broker
```

Vývojáři můžou použít Azure CLI k ověření v Microsoft Entra ID. Aplikace používající DefaultAzureCredential nebo AzureCliCredential můžou tento účet použít k ověřování žádostí o aplikace při místním spuštění.

Pokud se chcete ověřit pomocí Azure CLI, spusťte az login příkaz. V systému s výchozím webovým prohlížečem azure CLI spustí prohlížeč pro ověření uživatele.

az login

Pro systémy bez výchozího webového prohlížeče používá příkaz az login tok ověřování kódu zařízení. Uživatel může také vynutit, aby azure CLI používalo tok kódu zařízení místo spuštění prohlížeče zadáním argumentu --use-device-code.

az login --use-device-code

Vývojáři můžou k ověření v Microsoft Entra ID použít Azure Developer CLI . Aplikace, které používají DefaultAzureCredential nebo AzureDeveloperCliCredential můžou tento účet používat k ověřování žádostí o aplikace při místním spuštění.

Pokud chcete provést ověření pomocí rozhraní příkazového řádku pro vývojáře Azure, spusťte azd auth login příkaz. V systému s výchozím webovým prohlížečem spustí rozhraní příkazového řádku Azure Developer CLI prohlížeč pro ověření uživatele.

azd auth login

Pro systémy bez výchozího webového prohlížeče používá příkaz azd auth login --use-device-code tok ověřování kódu zařízení. Uživatel může také vynutit, aby rozhraní příkazového řádku Azure Developer CLI používalo tok kódu zařízení místo spuštění prohlížeče zadáním argumentu --use-device-code .

azd auth login --use-device-code

Vývojáři můžou k ověření v Microsoft Entra ID použít Azure PowerShell . Aplikace, které používají DefaultAzureCredential nebo AzurePowerShellCredential můžou tento účet používat k ověřování žádostí o aplikace při místním spuštění.

Pokud chcete provést ověření pomocí Azure PowerShell, spusťte příkaz Connect-AzAccount. V systému s výchozím webovým prohlížečem a verzí 5.0.0 nebo novějším Azure PowerShellu se spustí prohlížeč pro ověření uživatele.

Connect-AzAccount

Pro systémy bez výchozího webového prohlížeče používá příkaz Connect-AzAccount tok ověřování kódu zařízení. Uživatel může také vynutit, aby Azure PowerShell používal tok kódu zařízení místo spuštění prohlížeče zadáním argumentu UseDeviceAuthentication .

Connect-AzAccount -UseDeviceAuthentication

Ověřování ve službách Azure z vaší aplikace

Knihovna Identit Azure poskytuje implementace TokenCredential, které podporují různé scénáře a toky ověřování Microsoft Entra. Následující kroky ukazují, jak při práci s uživatelskými účty místně používat defaultAzureCredential nebo konkrétní přihlašovací údaje vývojového nástroje.

Implementace kódu

Přidejte balíček azure identity a všechny balíčky klienta služby Azure, které vaše aplikace vyžaduje:
```
pip install azure-identity azure-storage-blob
```
Poznámka:

Při použití VisualStudioCodeCredential musíte také nainstalovat balíček azure-identity-broker.
```
pip install azure-identity-broker
```
Přidejte potřebné import příkazy pro azure.identity modul a klientský modul služby Azure, který vaše aplikace vyžaduje.
Zvolte jednu z implementací přihlašovacích údajů na základě vašeho scénáře.
- Použijte přihlašovací údaje specifické pro váš vývojový nástroj: tato možnost je nejvhodnější pro scénáře s jedním člověkem nebo jedním nástrojem.
- Použijte přihlašovací údaje dostupné pro použití v jakémkoli vývojovém nástroji: tato možnost je nejvhodnější pro opensourcové projekty a různorodé týmy nástrojů.

Použití přihlašovacích údajů specifických pro váš vývojový nástroj

Předejte konstruktoru klienta služby Azure instanci, která odpovídá konkrétnímu vývojovému nástroji, například TokenCredential.

from azure.identity import AzureCliCredential
from azure.storage.blob import BlobServiceClient

credential = AzureCliCredential()

blob_service_client = BlobServiceClient(
   account_url="https://<account-name>.blob.core.windows.net",
   credential=credential)

Použití přihlašovacích údajů dostupných v jakémkoli vývojovém nástroji

Použijte instanci optimalizovanou DefaultAzureCredential pro všechny místní vývojové nástroje. Tento příklad vyžaduje proměnnou AZURE_TOKEN_CREDENTIALS prostředí nastavenou na dev. Další informace najdete v tématu Vyloučení kategorie typu přihlašovacích údajů.

Před spuštěním aplikace nastavte proměnnou prostředí:

export AZURE_TOKEN_CREDENTIALS=dev

from azure.identity import DefaultAzureCredential
from azure.storage.blob import BlobServiceClient

credential = DefaultAzureCredential(require_envvar=True)

blob_service_client = BlobServiceClient(
   account_url="https://<account-name>.blob.core.windows.net",
   credential=credential)

Návod

Pokud váš tým k ověřování v Azure používá více vývojových nástrojů, upřednostňujte DefaultAzureCredential přednost před přihlašovacími údaji specifickými pro konkrétní nástroje.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-06-19