Skip to main content

EAF IAM Client SDK

The EAF IAM Client SDK provides seamless integration with the ACCI IAM service for authentication, authorization, and tenant management.

🚀 Quick Start​

Installation​

dependencies {
    implementation("com.axians.eaf:eaf-iam-client-sdk:${eafVersion}")
}

Basic Configuration​

eaf:
  iam:
    base-url: 'https://iam.acci.com'
    client-id: 'my-service'
    client-secret: '${IAM_CLIENT_SECRET}'

🔑 Key Features​

Authentication​

  • JWT token validation
  • Service-to-service authentication
  • Token refresh management

Authorization​

  • Role-based access control (RBAC)
  • Permission checking
  • Resource-based authorization

Multi-tenancy​

  • Tenant context management
  • Tenant-aware operations
  • Cross-tenant security

🏗️ Architecture​

The IAM Client SDK follows hexagonal architecture principles with clean separation between domain logic and infrastructure concerns.

graph TB
    A[IAM Client] --> B[Authentication Service]
    A --> C[Authorization Service]
    A --> D[Tenant Service]

    B --> E[Token Validator]
    C --> F[Permission Checker]
    D --> G[Tenant Context]

    E --> H[JWT Handler]
    F --> I[Role Manager]
    G --> J[Tenant Store]

📚 Documentation Sections​

Getting Started​

Complete setup guide with configuration and basic usage examples.

API Reference​

Comprehensive API documentation for all public classes and methods.

Configuration​

Detailed configuration options and environment-specific settings.

Usage Patterns​

Common usage patterns and best practices for authentication and authorization.

Troubleshooting​

Common issues and solutions for IAM integration.

🔗 Related Documentation​

The EAF IAM Client SDK provides enterprise-grade authentication and authorization capabilities for building secure, multi-tenant applications.