Authenticeer in Azure gehoste Rust-apps bij Azure-resources met behulp van een door de gebruiker toegewezen beheerde identiteit

De aanbevolen methode voor het verifiëren van een Azure gehoste app voor andere Azure resources is het gebruik van een beheerde identiteit. Deze benadering wordt ondersteund voor de meeste Azure services, waaronder apps die worden gehost op Azure App Service, Azure Container Apps en Azure Virtuele Machines. Ontdek meer over verschillende verificatietechnieken en benaderingen op de verificatieoverzicht pagina. In de volgende secties krijgt u meer informatie over:

  • Essentiële concepten voor beheerde identiteiten
  • Een door de gebruiker toegewezen beheerde identiteit voor uw app maken
  • Rollen toewijzen aan de door de gebruiker toegewezen beheerde identiteit
  • Authenticeren met behulp van de door de gebruiker toegewezen beheerde identiteit vanuit uw app-code

Essentiële concepten voor beheerde identiteiten

Met een beheerde identiteit kan uw app veilig verbinding maken met andere Azure-resources zonder gebruik te maken van geheime sleutels of andere toepassingsgeheimen. Intern houdt Azure de identiteit bij en met welke resources verbinding mag worden gemaakt. Azure gebruikt deze informatie om automatisch Microsoft Entra-tokens voor de app te verkrijgen, zodat deze verbinding kan maken met andere Azure-resources.

Er zijn twee typen beheerde identiteiten waarmee u rekening moet houden bij het configureren van uw gehoste app:

  • Systeemtoegewezen beheerde identiteiten worden rechtstreeks ingeschakeld op een Azure resource en zijn gekoppeld aan de levenscyclus van die resource. Wanneer de resource wordt verwijderd, verwijdert Azure de identiteit automatisch voor u. Door het systeem toegewezen identiteiten bieden een minimalistische benadering voor het gebruik van beheerde identiteiten.
  • Door gebruikers toegewezen beheerde identiteiten zijn zelfstandige Azure resources en bieden meer flexibiliteit en mogelijkheden. Ze zijn ideaal voor oplossingen met meerdere Azure-resources die dezelfde identiteit en machtigingen moeten delen. Als bijvoorbeeld meerdere virtuele machines toegang moeten hebben tot dezelfde set Azure-resources, biedt een door de gebruiker toegewezen beheerde identiteit herbruikbaar en geoptimaliseerd beheer.

Tip

Meer informatie over het selecteren en beheren van door het systeem toegewezen en door de gebruiker toegewezen beheerde identiteiten in het artikel met aanbevelingen voor aanbevolen procedures voor beheerde identiteiten.

In de volgende secties worden de stappen beschreven voor het inschakelen en gebruiken van een door de gebruiker toegewezen beheerde identiteit voor een Azure gehoste app. Als u een door het systeem toegewezen beheerde identiteit wilt gebruiken, raadpleegt u het artikel over door het systeem toegewezen beheerde identiteiten voor meer informatie.

Maak een door de gebruiker toegewezen beheerde identiteit

Door de gebruiker toegewezen beheerde identiteiten worden gemaakt als zelfstandige resources in uw Azure-abonnement met behulp van de Azure-portal of de Azure CLI. Azure CLI opdrachten kunnen worden uitgevoerd in de Azure Cloud Shell of op een werkstation waarop de Azure CLI is geïnstalleerd.

  1. Voer in de Azure-portal Beheerde identiteiten in de hoofdzoekbalk in en selecteer het overeenkomende resultaat onder de sectie Services.

  2. Selecteer op de pagina Beheerde identiteiten de optie + Maken.

    Een schermopname van de pagina voor het beheren van door de gebruiker toegewezen beheerde identiteiten.

  3. Selecteer op de pagina Door gebruiker toegewezen beheerde identiteit maken een abonnement, een resourcegroep en een regio voor de door gebruiker toegewezen beheerde identiteit, en geef vervolgens een naam op.

  4. Selecteer Beoordelen en maken om uw invoer te controleren en te valideren.

    Een schermopname van het formulier voor het maken van een door de gebruiker toegewezen beheerde identiteit.

  5. Selecteer Create om de door de gebruiker toegewezen beheerde identiteit te maken.

  6. Nadat de identiteit is gemaakt, selecteer Ga naar de resource.

  7. Op de pagina Overzicht van de nieuwe identiteit kopieert u de -client-id om later te gebruiken wanneer u de toepassingscode configureert.

De beheerde identiteit toewijzen aan uw app

Een door de gebruiker toegewezen beheerde identiteit kan worden gekoppeld aan een of meer Azure-resources. Alle resources die gebruikmaken van die identiteit krijgen de machtigingen die via de rollen van die identiteit worden verleend.

  1. Navigeer in de Azure-portal naar de resource die als host fungeert voor uw app-code, zoals een Azure App Service of Azure Container Apps exemplaar.

  2. Vouw op de pagina Overzicht van de resource de Instellingen uit en selecteer Identiteit in de navigatie.

  3. Ga op de pagina Identity naar het tabblad Gebruiker toegewezen.

  4. Selecteer + Voeg toe om het deelvenster Toevoegen van door de gebruiker toegewezen beheerde identiteit te openen.

  5. Gebruik in het paneel Gebruikerstoewijzing voor beheerde identiteit toevoegen de keuzelijst Abonnement om de zoekresultaten voor uw identiteiten te filteren. Gebruik het zoekvak Gebruiker toegewezen beheerde identiteiten om de door de gebruiker toegewezen beheerde identiteit te zoeken die u hebt ingeschakeld voor de Azure resource die als host fungeert voor uw app.

  6. Selecteer de identiteit en kies Add onder aan het deelvenster om door te gaan.

    Een schermopname die laat zien hoe u een door de gebruiker toegewezen beheerde identiteit koppelt aan een app.

Rollen toewijzen aan de beheerde identiteit

Bepaal vervolgens welke rollen uw app nodig heeft en wijs deze rollen toe aan de beheerde identiteit. U kunt aan een beheerde identiteit rollen toewijzen op de volgende niveaus:

  • Resource: De toegewezen rollen zijn alleen van toepassing op die specifieke resource.
  • Resourcegroep: De toegewezen rollen zijn van toepassing op alle resources in de resourcegroep.
  • Abonnement: De toegewezen rollen zijn van toepassing op alle resources in het abonnement.

In het volgende voorbeeld ziet u hoe u rollen toewijst binnen het bereik van de resourcegroep, omdat veel apps al hun gerelateerde Azure-resources beheren met één resourcegroep.

  1. Navigeer naar de pagina Overzicht van de resourcegroep die de app bevat met de door de gebruiker toegewezen beheerde identiteit.

  2. Selecteer IAM- (Access Control) in het linkernavigatievenster.

  3. Selecteer op de pagina Toegangsbeheer (IAM) + toevoegen in het bovenste menu en kies vervolgens Roltoewijzing toevoegen om naar de pagina Roltoewijzing toevoegen te navigeren.

    Een schermopname van het openen van de pagina voor identiteitsroltoewijzing.

  4. Op de pagina Roltoewijzing toevoegen pagina wordt een werkstroom met tabbladen met meerdere stappen weergegeven om rollen toe te wijzen aan identiteiten. Gebruik op het eerste tabblad Rol het zoekvak bovenaan om de rol te vinden die u aan de identiteit wilt toewijzen.

  5. Selecteer de rol in de resultaten en kies vervolgens Volgende om naar het tabblad Leden te gaan.

  6. Voor de optie Toegang toewijzen aan selecteer Beheerde identiteit.

  7. Voor de optie Leden kiest u + Selecteer leden om het Selecteer beheerde identiteiten deelvenster te openen.

  8. Gebruik in het deelvenster Beheerde identiteiten selecteren de dropdowns Abonnement en Beheerde identiteit om de zoekresultaten voor uw beheerde identiteiten te filteren. Gebruik het zoekvak Select om de door de gebruiker toegewezen beheerde identiteit te zoeken die u hebt ingeschakeld voor de Azure resource die als host fungeert voor uw app.

    Een schermopname van het toewijzingsproces voor een beheerde identiteit.

  9. Selecteer de identiteit en kies Selecteer onderaan het deelvenster om door te gaan.

  10. Selecteer Beoordelen en toewijzen onderaan de pagina.

  11. Selecteer op het laatste tabblad Beoordelen en toewijzen, Beoordelen en toewijzen om de werkstroom te voltooien.

Verifiëren bij Azure-services vanuit uw app

De azure_identity crate biedt verschillende aanmeldingsgegevens: implementaties van TokenCredential die ondersteuning bieden voor verschillende scenario's en Microsoft Entra verificatiestromen. Omdat beheerde identiteit niet beschikbaar is wanneer u lokaal werkt, wordt in de volgende richtlijnen uitgelegd welke aanmeldingsgegevens in elk scenario moeten worden gebruikt:

De code implementeren

Voeg de azure_identity crate toe.

Ga in een terminal naar de projectmap van de toepassing en voer het volgende uit:

cargo add azure_identity

Gespecialiseerde clients van de verschillende Azure SDK crates hebben toegang tot Azure diensten. Voor rustcode waarmee een Azure SDK-client in uw app instantiëert, moet u het volgende doen:

  1. Importeer de azure_identity crate.
  2. Maak een exemplaar van ManagedIdentityCredential met de identiteit van uw door de gebruiker toegewezen beheerde identiteit.
  3. Geef het ManagedIdentityCredential exemplaar door aan de Azure SDK clientconstructor.

De ManagedIdentityCredentialOptions struct accepteert een UserAssignedId opsomming om op te geven welke door de gebruiker toegewezen identiteit moet worden geauthenticeerd. U kunt de beheerde identiteit identificeren met behulp van de client-id, object-id (principal) of Azure resource-id.

De meest voorkomende benadering is het gebruik van de client-id van de door de gebruiker toegewezen beheerde identiteit:

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

Gebruik in productie ManagedIdentityCredential om te authenticeren met de beheerde identiteit die is toegewezen aan uw app.

Tijdens lokale ontwikkeling kunt u DeveloperToolsCredential gebruiken om zich te authenticeren met behulp van uw ontwikkelhulpprogramma's. Zie het artikel over authenticatie van lokale ontwikkeling voor meer informatie.