Autenticar usuários e encaminhar solicitações para agentes em uma frota com ASP.NET Core

Os usuários chamam um agente de frota com um token de acesso para o escopo do access_agent blueprint. Cada agente da frota compartilha esse público, portanto, a validação de token prova quem é o usuário, mas não qual agente ele tem permissão para usar. O runtime roteia cada solicitação para um agente e aplica o acesso por agente por conta própria.

Prerequisites

Configurar a validação de token

A validação de token é a mesma de um único agente. Use a ID do cliente blueprint como o público-alvo esperado. Para obter detalhes de configuração e validação do cliente upstream, consulte Autenticar usuários em uma API do agente ASP.NET Core.

Para limitar quais usuários podem chamar a frota, exija uma atribuição de função de aplicativo no principal do blueprint. Essas funções de aplicativo se aplicam a todos os agentes da frota.

Controlar o acesso por agente

Decida quem pode usar cada agente e armazene essa decisão no runtime. Por exemplo, registre os usuários e grupos com os quais o proprietário de um agente compartilha com eles. Defina uma política de acesso que o runtime verifica em cada solicitação:

using System.Security.Claims;

public interface IAgentAccessPolicy
{
    Task<bool> CanUseAgentAsync(ClaimsPrincipal user, string agentId);
}

Identifique o usuário pelas declarações oid e tid. Não use o nome principal de usuário ou o email como uma chave estável.

Implemente IAgentAccessPolicy em seus registros de compartilhamento e registre-o na injeção de dependência antes de mapear o ponto de extremidade. A interface em si não controla o acesso.

Encaminhar solicitações para agentes

Coloque a ID do agente do runtime na rota. Valide o token, confirme se o agente existe e verifique a política de acesso antes de executar o agente:

using Microsoft.Identity.Web.Resource;

app.MapPost("/agents/{agentId}/messages", async (
    string agentId,
    HttpContext context,
    IAgentDirectory directory,
    IAgentAccessPolicy accessPolicy) =>
{
    context.VerifyUserHasAnyAcceptedScope("access_agent");

    if (await directory.FindAsync(agentId) is null
        || !await accessPolicy.CanUseAgentAsync(context.User, agentId))
    {
        return Results.NotFound();
    }

    // Run the agent for this request.
    return Results.Accepted();
})
.RequireAuthorization();

O ponto de extremidade retorna 404 Not Found para um agente desconhecido e para um agente que o usuário não pode usar, portanto, os chamadores não podem descobrir outros agentes na frota. Depois que essas verificações forem aprovadas, use agentId para cada solicitação de token feita durante o tratamento da solicitação.

Antes de adicionar a implementação do agente, teste com um usuário que tenha acesso a um agente, mas não a outro. A solicitação permitida atinge a resposta do espaço reservado 202 Accepted; solicitações para o outro agente e para um agente desconhecido retornam 404 Not Found. Confirme se nenhuma solicitação rejeitada executa o trabalho do agente ou solicita um token downstream. A resposta de placeholder confirma o roteamento e as verificações de acesso, não a execução do agente.

Próxima etapa

Chamar APIs como um usuário em uma frota com ASP.NET Core