Azure-gehostete Rust-Apps für Azure-Ressourcen mithilfe einer vom Benutzer zugewiesenen verwalteten Identität authentifizieren

Der empfohlene Ansatz zum Authentifizieren einer von Azure gehosteten App für andere Azure-Ressourcen besteht darin, eine verwaltete Identität zu verwenden. Dieser Ansatz wird für die meisten Azure-Dienste unterstützt, einschließlich Apps, die auf Azure App Service, Azure-Container-Apps und virtuellen Azure-Computern gehostet werden. Erfahren Sie mehr über verschiedene Authentifizierungstechniken und Ansätze auf der Seite "Authentifizierungsübersicht ". In den folgenden Abschnitten erfahren Sie mehr über:

  • Grundlegende Konzepte für verwaltete Identitäten
  • So erstellen Sie eine vom Benutzer zugewiesene verwaltete Identität für Ihre App
  • Zuweisen von Rollen zur vom Benutzer zugewiesenen verwalteten Identität
  • Authentifizieren Sie sich mithilfe der vom Benutzer zugewiesenen verwalteten Identität aus Ihrem App-Code

Grundlegende Konzepte für verwaltete Identitäten

Mit einer verwalteten Identität kann Ihre App sicher eine Verbindung mit anderen Azure-Ressourcen herstellen, ohne geheime Schlüssel oder andere geheime Anwendungsschlüssel zu verwenden. Intern verfolgt Azure die Identität und zu welchen Ressourcen es eine Verbindung herstellen darf. Azure verwendet diese Informationen, um automatisch Microsoft Entra Token für die App abzurufen, damit sie eine Verbindung mit anderen Azure-Ressourcen herstellen kann.

Es gibt zwei Arten von verwalteten Identitäten, die Sie beim Konfigurieren Ihrer gehosteten App berücksichtigen sollten:

  • Vom System zugewiesene verwaltete Identitäten werden direkt auf einer Azure-Ressource aktiviert und sind an ihren Lebenszyklus gebunden. Wenn die Ressource gelöscht wird, löscht Azure die Identität automatisch für Sie. Vom System zugewiesene Identitäten bieten einen minimalistischen Ansatz für die Verwendung verwalteter Identitäten.
  • Vom Benutzer zugewiesene verwaltete Identitäten werden als eigenständige Azure Ressourcen erstellt und bieten mehr Flexibilität und Funktionen. Sie eignen sich ideal für Lösungen mit mehreren Azure-Ressourcen, die dieselbe Identität und Berechtigungen gemeinsam nutzen müssen. Wenn beispielsweise mehrere virtuelle Computer auf denselben Satz von Azure-Ressourcen zugreifen müssen, bietet eine vom Benutzer zugewiesene verwaltete Identität wiederverwendbarkeit und optimierte Verwaltung.

Tip

Erfahren Sie mehr über das Auswählen und Verwalten von vom System zugewiesenen und vom Benutzer zugewiesenen verwalteten Identitäten im Empfehlungsartikel zu bewährten Methoden für verwaltete Identitäten .

In den folgenden Abschnitten werden die Schritte zum Aktivieren und Verwenden einer vom Benutzer zugewiesenen verwalteten Identität für eine Azure gehostete App beschrieben. Wenn Sie eine vom System zugewiesene verwaltete Identität verwenden müssen, finden Sie im Artikel zu vom System zugewiesenen verwalteten Identitäten weitere Informationen.

Erstellen einer benutzerseitig zugewiesenen verwalteten Identität

Vom Benutzer zugewiesene verwaltete Identitäten werden mithilfe des Azure Portals oder der Azure CLI als eigenständige Ressourcen in Ihrem Azure-Abonnement erstellt. Azure CLI Befehle können im Azure Cloud Shell oder auf einer Arbeitsstation ausgeführt werden, auf der Azure CLI installiert ist.

  1. Geben Sie im Azure-Portal verwaltete Identitäten in die Hauptsuchleiste ein, und wählen Sie das entsprechende Ergebnis unter dem Abschnitt "Dienste " aus.

  2. Wählen Sie auf der Seite Verwaltete Identitäten die Option + Erstellen aus.

    Screenshot der Seite zum Verwalten von vom Benutzer zugewiesenen verwalteten Identitäten.

  3. Wählen Sie auf der Seite " Vom Benutzer zugewiesene verwaltete Identität erstellen " ein Abonnement, eine Ressourcengruppe und eine Region für die vom Benutzer zugewiesene verwaltete Identität aus, und geben Sie dann einen Namen an.

  4. Wählen Sie "Überprüfen + Erstellen" aus, um Ihre Eingaben zu überprüfen und zu validieren.

    Screenshot des Formulars zum Erstellen einer vom Benutzer zugewiesenen verwalteten Identität.

  5. Wählen Sie "Erstellen" aus, um die vom Benutzer zugewiesene verwaltete Identität zu erstellen.

  6. Nachdem die Identität erstellt wurde, wählen Sie "Zur Ressource wechseln" aus.

  7. Kopieren Sie auf der Seite "Übersicht" der neuen Identität den Client-ID-Wert , der später verwendet werden soll, wenn Sie den Anwendungscode konfigurieren.

Weisen Sie Ihrer App die verwaltete Identität zu

Eine vom Benutzer zugewiesene verwaltete Identität kann einer oder mehreren Azure-Ressourcen zugeordnet werden. Alle Ressourcen, die diese Identität verwenden, erhalten die Berechtigungen, die durch die Rollen der Identität vergeben werden.

  1. Navigieren Sie im Azure-Portal zu der Ressource, die Ihren App-Code hostt, z. B. eine Azure App Service- oder Azure Container Apps Instanz.

  2. Erweitern Sie auf der „Übersicht“-Seite der Ressource die „Einstellungen“ und wählen Sie dann „Identität“ aus der Navigation.

  3. Wechseln Sie auf der Seite Identität zur Registerkarte Benutzerzugewiesen.

  4. Wählen Sie + Hinzufügen aus, um den Bereich Benutzerzugeordnete verwaltete Identität hinzufügen zu öffnen.

  5. Verwenden Sie im Bereich "Vom Benutzer zugewiesene verwaltete Identität hinzufügen " das Dropdownmenü "Abonnement ", um die Suchergebnisse nach Ihren Identitäten zu filtern. Verwenden Sie das Suchfeld Benutzer zugewiesene verwaltete Identitäten, um die vom Benutzer zugewiesene verwaltete Identität zu finden, die Sie für die Azure Ressource aktiviert haben, die Ihre App hosten soll.

  6. Wählen Sie die Identität aus, und wählen Sie "Hinzufügen" am unteren Rand des Bereichs aus, um den Vorgang fortzusetzen.

    Screenshot, der zeigt, wie eine vom Benutzer zugewiesene verwaltete Identität einer App zugeordnet wird.

Zuweisen von Rollen für die verwaltete Identität

Ermitteln Sie als Nächstes, welche Rollen Ihre App benötigt, und weisen Sie diese Rollen der verwalteten Identität zu. Sie können einer verwalteten Identität rollen in den folgenden Bereichen zuweisen:

  • Ressource: Die zugewiesenen Rollen gelten nur für diese bestimmte Ressource.
  • Ressourcengruppe: Die zugewiesenen Rollen gelten für alle Ressourcen, die in der Ressourcengruppe enthalten sind.
  • Abonnement: Die zugewiesenen Rollen gelten für alle Im Abonnement enthaltenen Ressourcen.

Das folgende Beispiel zeigt, wie Rollen im Ressourcengruppenbereich zugewiesen werden, da viele Apps alle zugehörigen Azure-Ressourcen mithilfe einer einzelnen Ressourcengruppe verwalten.

  1. Navigieren Sie zur Übersichtsseite der Ressourcengruppe, die die App mit der vom Benutzer zugewiesenen verwalteten Identität enthält.

  2. Wählen Sie access control (IAM) in der linken Navigation aus.

  3. Wählen Sie auf der Seite access control (IAM)die Option +Hinzufügen im oberen Menü aus, und wählen Sie dann " Rollenzuweisung hinzufügen " aus, um zur Seite " Rollenzuweisung hinzufügen " zu navigieren.

    Screenshot, der zeigt, wie Sie auf die Seite

  4. Auf der Seite " Rollenzuweisung hinzufügen " wird ein mehrstufiger Registerkartenworkflow zum Zuweisen von Rollen zu Identitäten angezeigt. Verwenden Sie auf der ersten Registerkarte " Rolle " das Suchfeld oben, um die Rolle zu suchen, die Sie der Identität zuweisen möchten.

  5. Wählen Sie die Rolle aus den Ergebnissen aus, und wählen Sie dann "Weiter" aus, um zur Registerkarte " Mitglieder " zu wechseln.

  6. Wählen Sie für die Option "Zugriff zuweisen"die Option "Verwaltete Identität" aus.

  7. Wählen Sie für die Option Mitglieder+ Mitglieder auswählen aus, um das Panel Verwaltete Identitäten auswählen zu öffnen.

  8. Verwenden Sie im Bereich "Verwaltete Identitäten auswählen " die Dropdowns " Abonnement " und "Verwaltete Identität ", um die Suchergebnisse nach Ihren Identitäten zu filtern. Verwenden Sie das Suchfeld Select, um die vom Benutzer zugewiesene verwaltete Identität zu suchen, die Sie für die Azure Ressource aktiviert haben, die Ihre App hosten soll.

    Screenshot des Prozesses der verwalteten Identitätszuweisung.

  9. Wählen Sie die Identität aus, und wählen Sie unten im Bereich die Option "Auswählen " aus, um den Vorgang fortzusetzen.

  10. Wählen Sie "Überprüfen" und "Zuweisen " am unteren Rand der Seite aus.

  11. Wählen Sie auf der letzten Registerkarte "Überprüfen+ Zuweisen" die Option "Überprüfen" und "Zuweisen" aus, um den Workflow abzuschließen.

Authentifizieren von Azure-Diensten aus Ihrer App

Das azure_identity-Crate bietet verschiedene Anmeldeinformationen – Implementierungen von TokenCredential, die unterschiedliche Szenarien und Microsoft Entra-Authentifizierungsabläufe unterstützen. Da verwaltete Identität nicht verfügbar ist, wenn Sie lokal arbeiten, wird in den folgenden Anleitungen erläutert, welche Anmeldeinformationen in den einzelnen Szenarien verwendet werden sollen:

Implementieren des Codes

Fügen Sie das azure_identity-Crate hinzu.

Wechseln Sie in einem Terminal zum Anwendungsprojektverzeichnis, und führen Sie Folgendes aus:

cargo add azure_identity

Spezialisierte clients aus den verschiedenen Azure SDK Crates greifen auf Azure-Dienste zu. Für Rust-Code, der einen Azure SDK Client in Ihrer App instanziiert, müssen Sie:

  1. Importieren Sie das azure_identity Crate.
  2. Erstellen Sie eine Instanz ManagedIdentityCredential mit der Identität Ihrer vom Benutzer zugewiesenen verwalteten Identität.
  3. Übergeben Sie die ManagedIdentityCredential Instanz an den Azure SDK Clientkonstruktor.

Die ManagedIdentityCredentialOptions Struktur akzeptiert eine UserAssignedId Enumeration, um anzugeben, welche vom Benutzer zugewiesene Identität authentifiziert werden soll. Sie können die verwaltete Identität mithilfe der Client-ID, der Objekt-ID (des Prinzipals) oder der Azure-Ressourcen-ID identifizieren.

Der häufigste Ansatz besteht darin, die Client-ID der vom Benutzer zugewiesenen verwalteten Identität zu verwenden:

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

Verwenden Sie in der Produktion ManagedIdentityCredential um sich mit der verwalteten Identität zu authentifizieren, die Ihrer App zugewiesen ist.

Während der lokalen Entwicklung können Sie DeveloperToolsCredential verwenden, um sich mithilfe Ihrer Entwicklertools zu authentifizieren. Weitere Informationen finden Sie im Artikel zur lokalen Entwicklungsauthentifizierung .