Autentisera Azure-värdbaserade Rust-appar till Azure-resurser med hjälp av en användartilldelad hanterad identitet

Den rekommenderade metoden för att autentisera en Azure värdbaserad app till andra Azure resurser är att använda en hanterad identitet. Den här metoden stöds för de flesta Azure tjänster, inklusive appar som finns på Azure App Service, Azure Container Apps och Azure Virtual Machines. Upptäck mer om olika autentiseringstekniker och metoder på -autentiseringsöversikten sidan. I följande avsnitt lär du dig mer om:

  • Grundläggande begrepp för hanterad identitet
  • Så här skapar du en användartilldelad hanterad identitet för din app
  • Så här tilldelar du roller till den användartilldelade hanterade identiteten
  • Autentisera med hjälp av den användartilldelade hanterade identiteten från din appkod

Grundläggande begrepp för hanterad identitet

Med en hanterad identitet kan din app på ett säkert sätt ansluta till andra Azure-resurser utan att använda hemliga nycklar eller andra programhemligheter. Internt spårar Azure identiteten och vilka resurser den tillåts ansluta till. Azure använder den här informationen för att automatiskt hämta Microsoft Entra-token för appen så att den kan ansluta till andra Azure-resurser.

Det finns två typer av hanterade identiteter att tänka på när du konfigurerar din värdbaserade app:

  • Systemtilldelade hanterade identiteter aktiveras direkt på en Azure resurs och är knutna till dess livscykel. När resursen tas bort tar Azure automatiskt bort identiteten åt dig. Systemtilldelade identiteter ger en minimalistisk metod för att använda hanterade identiteter.
  • Användartilldelade hanterade identiteter skapas som fristående Azure resurser och ger större flexibilitet och funktioner. De är idealiska för lösningar som omfattar flera Azure-resurser som behöver dela samma identitet och behörigheter. Om till exempel flera virtuella datorer behöver komma åt samma uppsättning Azure-resurser, ger en användartilldelad hanterad identitet återanvändning och optimerad hantering.

Tip

Läs mer om hur du väljer och hanterar systemtilldelade och användartilldelade hanterade identiteter i artikeln Rekommenderade metoder för hanterad identitet .

I följande avsnitt beskrivs stegen för att aktivera och använda en användartilldelad hanterad identitet för en Azure värdbaserad app. Mer information finns i artikeln om systemtilldelade hanterade identiteter om du behöver använda en systemtilldelad hanterad identitet.

Skapa en användartilldelad hanterad identitet

Användartilldelade hanterade identiteter skapas som fristående resurser i din Azure-prenumeration med hjälp av Azure-portalen eller Azure CLI. Azure CLI-kommandon kan köras i Azure Cloud Shell eller på en arbetsstation med Azure CLI installerat.

  1. I Azure-portalen anger du Hanterade identiteter i huvudsökfältet och väljer matchande resultat under avsnittet Services.

  2. På sidan Hanterade identiteter väljer du + Skapa.

    En skärmbild som visar sidan för att hantera användartilldelade hanterade identiteter.

  3. På sidan Skapa användartilldelad hanterad identitet väljer du en prenumeration, resursgrupp och region för den användartilldelade hanterade identiteten och anger sedan ett namn.

  4. Välj Granska + skapa för att granska och verifiera dina indata.

    En skärmbild som visar formuläret för att skapa en användartilldelad hanterad identitet.

  5. Välj Skapa för att skapa den användartilldelade hanterade identiteten.

  6. När identiteten har skapats väljer du Gå till resurs.

  7. På den nya identitetens översiktssida kopierar du värdet klient-ID som ska användas för senare när du konfigurerar programkoden.

Tilldela den hanterade identiteten till din app

En användartilldelad hanterad identitet kan associeras med en eller flera Azure-resurser. Alla resurser som använder den identiteten får de behörigheter som tillämpas via identitetens roller.

  1. I Azure-portalen går du till resursen som är värd för din appkod, till exempel en Azure App Service eller Azure Container Apps instans.

  2. På resursens översiktssida expanderar du Inställningar och väljer Identitet från navigeringen.

  3. På sidan Identitet växlar du till fliken Användartilldelad .

  4. Välj + Lägg till för att öppna panelen Lägg till användartilldelad hanterad identitet.

  5. I panelen Lägg till användartilldelad hanterad identitet använder du listrutan Prenumeration för att filtrera sökresultaten för dina identiteter. Använd sökrutan Användare tilldelade hanterade identiteter för att hitta den användartilldelade hanterade identiteten som du har aktiverat för den Azure resurs som är värd för din app.

  6. Välj identiteten och välj Lägg till längst ned i panelen för att fortsätta.

    En skärmbild som visar hur du associerar en användartilldelad hanterad identitet med en app.

Tilldela roller till den hanterade identiteten

Bestäm sedan vilka roller din app behöver och tilldela dessa roller till den hanterade identiteten. Du kan tilldela roller till en hanterad identitet i följande omfång:

  • Resurs: De tilldelade rollerna gäller endast för den specifika resursen.
  • Resursgrupp: De tilldelade rollerna gäller för alla resurser i resursgruppen.
  • Abonnemang: De tilldelade rollerna gäller för alla resurser som ingår i abonnemanget.

I följande exempel visas hur du tilldelar roller i resursgruppens omfång, eftersom många appar hanterar alla sina relaterade Azure-resurser med hjälp av en enda resursgrupp.

  1. Gå till sidan Översikt i resursgruppen som innehåller appen med den användartilldelade hanterade identiteten.

  2. Välj åtkomstkontroll (IAM) i det vänstra navigeringsfältet.

  3. På sidan Åtkomstkontroll (IAM) väljer du + Lägg till på den översta menyn och väljer sedan Lägg till rolltilldelning för att gå till sidan Lägg till rolltilldelning.

    En skärmbild som visar hur du kommer åt sidan för identitetsrolltilldelning.

  4. Sidan Lägg till rolltilldelning visar ett flikarat arbetsflöde i flera steg för att tilldela roller till identiteter. På den första fliken Roll använder du sökrutan längst upp för att hitta den roll som du vill tilldela identiteten.

  5. Välj rollen i resultatet och välj sedan Nästa för att flytta till fliken Medlemmar.

  6. För alternativet Tilldela åtkomst till väljer du Hanterad identitet.

  7. För alternativet Medlemmar väljer du + Välj medlemmar för att öppna panelen Välj hanterade identiteter.

  8. I panelen Välj hanterade identiteter använder du listrutorna Prenumeration och Hanterad identitet för att filtrera sökresultaten efter dina identiteter. Använd sökrutan Select för att hitta den användartilldelade hanterade identiteten som du har aktiverat för den Azure resurs som är värd för din app.

    En skärmbild som visar processen för tilldelning av hanterad identitet.

  9. Välj identiteten och välj Välj längst ned i panelen för att fortsätta.

  10. Välj Granska + tilldela längst ned på sidan.

  11. På den sista fliken Granska + tilldela väljer du Granska + tilldela för att slutföra arbetsflödet.

Autentisera dig mot Azure-tjänster från din app

azure_identity-cratet innehåller olika autentiseringsuppgifter – implementeringar av TokenCredential som stöder olika scenarier och Microsoft Entra-autentiseringsflöden. Eftersom den hanterade identiteten inte är tillgänglig när du kör lokalt förklarar följande vägledning vilka autentiseringsuppgifter som ska användas i varje scenario:

Implementera koden

Lägg till azure_identity-crate.

I en terminal går du till programprojektkatalogen och kör:

cargo add azure_identity

Specialiserade klienter från de olika Azure SDKs crates har åtkomst till Azure-tjänster. För all Rust-kod som instansierar en Azure SDKs-klient i din app måste du:

  1. Importera azure_identity crate.
  2. Skapa en instans av ManagedIdentityCredential med identiteten för din användartilldelade hanterade identitet.
  3. Skicka ManagedIdentityCredential-instansen till Azure SDKs-klientkonstruktorn.

Struct ManagedIdentityCredentialOptions accepterar en UserAssignedId uppräkning för att ange vilken användartilldelad identitet som ska autentiseras. Du kan identifiera den hanterade identiteten med hjälp av dess klient-ID, objekt-ID (principal-ID) eller Azure resurs-ID.

Den vanligaste metoden är att använda klient-ID för den användartilldelade hanterade identiteten:

use azure_identity::{ManagedIdentityCredential, ManagedIdentityCredentialOptions, UserAssignedId};
use azure_security_keyvault_secrets::SecretClient;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Create a user-assigned managed identity credential
    let options = ManagedIdentityCredentialOptions {
        user_assigned_id: Some(UserAssignedId::ClientId(String::from("abcd1234-..."))),
        ..Default::default()
    };
    let credential = ManagedIdentityCredential::new(Some(options))?;

    // Create a client for the specified Key Vault
    let client = SecretClient::new(
        "https://<your-key-vault-name>.vault.azure.net/",
        credential.clone(),
        None,
    )?;

    // Use the client to interact with Azure Key Vault
    // let secret = client.get("secret-name", None).await?;

    Ok(())
}

Important

I produktion använder du ManagedIdentityCredential för att autentisera med den hanterade identitet som tilldelats din app.

Under den lokala utvecklingen kan du använda DeveloperToolsCredential för att autentisera med hjälp av dina utvecklarverktyg. Mer information finns i artikeln om autentisering för lokal utveckling .