Appelez Azure services à partir de votre agent à l’aide de .NET Kit de développement logiciel (SDK) Azure

Lisez les données d’objet blob avec l’identité de l’agent, sans accès délégué de l’utilisateur connecté. Les services Azure autorisent l’ID de l’agent via le contrôle d’accès en fonction du rôle Azure (Azure RBAC).

Dans cet article, vous adaptez l'acquisition de jetons d'un agent ASP.NET Core aux clients Kit de développement logiciel (SDK) Azure. Attribuez le rôle minimal à l’étendue de ressource la plus étroite.

Prerequisites

  • Informations d’identification de blueprint et services ASP.NET Core, y compris l’acquisition de jetons. Réutilisez la configuration du certificat local lors de l’exécution sur une station de travail. Cet exemple ne nécessite pas le rôle d’application de l’API personnalisée ni l’octroi de consentement.
  • Un compte de stockage existant et un conteneur d’objets agent-data blob. Remplacez <storage-account> dans l’exemple par le nom du compte.
  • Une Azure attribution de rôle de plan de données pour l'ID d'objet de l'identité de l'agent sur ce conteneur ou compte, et non pour le blueprint ou ses informations d'identification d'identité managée.

Installez le package d'intégration et Stockage Blob SDK à partir du répertoire du projet d'agent :

dotnet add package Microsoft.Identity.Web.Azure
dotnet add package Azure.Storage.Blobs

Configurer les informations d’identification de jeton

Enregistrez MicrosoftIdentityTokenCredential dans l’injection de dépendances :

Ajoutez l’inscription suivante avant builder.Build() , Program.cspuis fusionnez la using directive avec celles situées en haut du fichier.

using Microsoft.Identity.Web;

builder.Services.AddMicrosoftIdentityAzureTokenCredential();

Les informations d’identification utilisent la configuration Microsoft.Identity.Web établie dans le parcours parent. Utilisez des informations d’identification fédérées d’identité gérée dans des environnements hébergés.

Avertissement

Les secrets client ne doivent pas être utilisés comme informations d’identification client dans des environnements de production pour les blueprints d’identité de l’agent en raison des risques de sécurité. Utilisez plutôt des méthodes d’authentification plus sécurisées telles que les informations d’identification d’identité fédérée (FIC) avec des identités managées ou des certificats clients. Ces méthodes offrent une sécurité renforcée en éliminant la nécessité de stocker des secrets sensibles directement dans la configuration de votre application.

Appeler Stockage Blob Azure en tant qu’agent

Injectez MicrosoftIdentityTokenCredential et demandez un jeton d’application uniquement avec l’ID client partagé configuré dans le parcours parent :

Voici un composant de service, et non pas une application complète Program.cs. Placez la classe dans AgentStorageService.cs, inscrivez-la auprès de ListBlobsAsync() avant builder.Services.AddScoped<AgentStorageService>(), et appelez builder.Build() à partir d’une opération d’application autorisée. Conservez la stratégie du AgentUser parcours parent sur n’importe quel point de terminaison qui déclenche cette opération en mode application uniquement.

using Azure.Storage.Blobs;
using Microsoft.Identity.Web;

public sealed class AgentStorageService
{
    private readonly MicrosoftIdentityTokenCredential _credential;

    public AgentStorageService(MicrosoftIdentityTokenCredential credential)
    {
        _credential = credential;
    }

    public async Task<IReadOnlyList<string>> ListBlobsAsync()
    {
        _credential.Options.RequestAppToken = true;

        var serviceClient = new BlobServiceClient(
            new Uri("https://<storage-account>.blob.core.windows.net"),
            _credential);
        var container = serviceClient.GetBlobContainerClient("agent-data");
        var names = new List<string>();

        await foreach (var blob in container.GetBlobsAsync())
        {
            names.Add(blob.Name);
        }

        return names;
    }
}

RequestAppToken = true sélectionne un accès autonome, de l’application uniquement. Pour un appel Azure délégué par l’utilisateur, utilisez Appeler un service Azure en tant qu’utilisateur.

L’ID de l’agent a besoin d’un rôle de plan de données approprié, tel que le lecteur de données Blob du stockage. Un rôle de plan de gestion tel que Reader n’accorde pas l’accès aux données d’objet blob.

Utilisez les mêmes informations d’identification avec d’autres clients Kit de développement logiciel (SDK) Azure, y compris les clients Azure Key Vault. Remplacez le point de terminaison et le rôle par les valeurs requises par le service cible.

Pour un conteneur contenant des blobs de test, ListBlobsAsync() doit renvoyer leurs noms ; un conteneur vide renvoie une liste vide. Un compte de stockage 403 nécessite de vérifier séparément le rôle de plan de données de l’agent et la ressource cible de l’acquisition réussie du jeton. N’accordez pas de rôle de plan de gestion pour corriger l’absence d’accès aux données Blob.

Étape suivante

Authentification des utilisateurs auprès de l’API de l’agent