👁 Image
Eaf.Middleware.AzureActiveDirectory 9.1.0

Eaf.Middleware.AzureActiveDirectory

Descrição Técnica

O Eaf.Middleware.AzureActiveDirectory é um módulo de autenticação Azure Active Directory do Enterprise Application Foundation (EAF). Este módulo fornece integração completa com Azure AD para autenticação externa e sincronização de usuários, permitindo que usuários autentiquem usando suas credenciais Microsoft 365.

Este módulo suporta OpenID Connect, OAuth 2.0 e sincronização automática de usuários, grupos e propriedades do Azure AD.

Relação com o EAF e ASP.NET Boilerplate

Integração com ABP

• Abp: Framework base para injeção de dependência e configuração
• Abp.Zero.Common: Funcionalidades comuns do ABP Zero

Dependências Externas

• Microsoft.Identity.Web: Biblioteca principal para autenticação Microsoft
• Microsoft.Identity.Web.MicrosoftGraph: Integração com Microsoft Graph API
• Microsoft.Graph: SDK do Microsoft Graph

Principais Componentes

AzureActiveDirectoryAuthenticationSource

Implementação de autenticação externa via Azure AD:

• Integração com OpenID Connect
• Validação de tokens JWT
• Sincronização de usuários
• Mapeamento de claims

AzureActiveDirectorySettings

Configurações de conexão Azure AD:

• Tenant ID
• Client ID
• Client Secret
• Callback URL
• Scopes e permissões

Guia de Instalação

Pré-requisitos

• .NET 10.0 SDK ou superior
• ASP.NET Boilerplate 10.4.0
• Azure AD Tenant configurado
• App Registration no Azure AD

Instalação via NuGet

dotnet add package Eaf.Middleware.AzureActiveDirectory --version 10.4.0

Instalação via Referência de Projeto

Adicione a referência ao seu arquivo .csproj:

<ProjectReference Include="..\Eaf.Middleware.AzureActiveDirectory\Eaf.Middleware.AzureActiveDirectory.csproj" />

Exemplo Básico de Uso

1. Registrando o Módulo

No seu módulo principal, herde de MiddlewareAzureActiveDirectoryModule:

[DependsOn(
 typeof(MiddlewareAzureActiveDirectoryModule),
 typeof(AbpZeroCommonModule)
)]
public class MyAuthenticationModule : AbpModule
{
 public override void Initialize()
 {
 IocManager.RegisterAssemblyByConvention(Assembly.GetExecutingAssembly());
 }
}

2. Configurando Azure AD

No appsettings.json:

{
 "AzureAd": {
 "Instance": "https://login.microsoftonline.com/",
 "TenantId": "your-tenant-id",
 "ClientId": "your-client-id",
 "CallbackPath": "/signin-oidc",
 "Domain": "your-domain.onmicrosoft.com"
 }
}

3. Configurando Microsoft Graph

{
 "AzureAd": {
 "TenantId": "your-tenant-id",
 "ClientId": "your-client-id",
 "ClientSecret": "your-client-secret",
 "GraphScopes": "User.Read Group.Read.All"
 }
}

4. Usando Autenticação Azure AD

public class AzureAdAuthenticationAppService : ApplicationService
{
 private readonly AzureActiveDirectoryAuthenticationSource _azureAdAuthSource;

 public AzureAdAuthenticationAppService(AzureActiveDirectoryAuthenticationSource azureAdAuthSource)
 {
 _azureAdAuthSource = azureAdAuthSource;
 }

 public async Task<bool> AuthenticateAsync(string token)
 {
 try
 {
 var result = await _azureAdAuthSource.AuthenticateAsync(token);
 return result != null;
 }
 catch (Exception ex)
 {
 Logger.Error(ex, "Azure AD authentication failed");
 return false;
 }
 }
}

5. Sincronizando Usuários do Azure AD

public class AzureAdSyncService : ApplicationService
{
 private readonly AzureActiveDirectoryAuthenticationSource _azureAdAuthSource;

 public AzureAdSyncService(AzureActiveDirectoryAuthenticationSource azureAdAuthSource)
 {
 _azureAdAuthSource = azureAdAuthSource;
 }

 public async Task SyncUserAsync(string objectId)
 {
 var user = await _azureAdAuthSource.CreateOrUpdateUserAsync(
 new ExternalAuthUserInfo
 {
 ProviderName = "AzureActiveDirectory",
 ProviderKey = objectId,
 Name = "user@domain.com"
 }
 );
 }
}

6. Usando Microsoft Graph API

public class AzureAdGraphService : ApplicationService
{
 private readonly GraphServiceClient _graphClient;

 public AzureAdGraphService(GraphServiceClient graphClient)
 {
 _graphClient = graphClient;
 }

 public async Task<User> GetUserAsync(string userId)
 {
 return await _graphClient.Users[userId].Request().GetAsync();
 }

 public async Task<IEnumerable<Group>> GetUserGroupsAsync(string userId)
 {
 var groups = await _graphClient.Users[userId].MemberOf.Request().GetAsync();
 return groups.OfType<Group>();
 }
}

Estrutura do Módulo

Eaf.Middleware.AzureActiveDirectory/
├── AzureActiveDirectory/ # Implementações Azure AD
│ ├── AzureActiveDirectoryAuthenticationSource.cs
│ ├── AzureActiveDirectorySettings.cs
│ └── AzureActiveDirectoryUserManager.cs
└── MiddlewareAzureActiveDirectoryModule.cs # Módulo ABP

Configurações Opcionais

Configuração de Claims Personalizados

public override void PreInitialize()
{
 Configuration.Modules.EafAzureAd().ClaimMappings = new Dictionary<string, string>
 {
 ["given_name"] = "FirstName",
 ["family_name"] = "LastName",
 ["job_title"] = "JobTitle"
 };
}

Configuração de Sincronização Automática

{
 "AzureAd": {
 "AutoSyncUsers": true,
 "SyncGroups": true,
 "SyncIntervalMinutes": 60
 }
}

Configuração de Multi-Tenant

{
 "AzureAd": {
 "IsMultiTenant": true,
 "DefaultTenantId": "default-tenant-id"
 }
}

Testes

Os testes para este módulo devem ser criados seguindo o padrão dos outros módulos do EAF.

Licença

Este projeto faz parte do Enterprise Application Foundation (EAF) e está licenciado sob os mesmos termos do projeto principal.

Suporte

Para issues e perguntas, consulte o repositório principal do EAF: https://github.com/afonsoft/EAF