Skip to main content
Organizing your authorization environment from business domains to enforcement

Hierarchy Levels

  1. Category
    Business domain grouping
    • Purpose: Organize applications by function or governance needs.
    • Example: Healthcare, Financial
    • Governance: Policies inherit category-level settings
  2. Application
    Your software system
    • Purpose: Central unit for policy management
    • Structure:
      • Belongs to one Category
      • Contains multiple Environments
    • Example: Patient Portal App, Payment Service
  3. Environment
    Deployment stage
    • Purpose: Isolate access rules per deployment phase
    • Types: Dev, Test, Staging, Prod
    • Critical Link: Connects to one Policy Store
  4. Policy Store
    Authorization policies container
    Function: Stores all access policies for an environment
    Two Configuration Paths:
    • AVP Policy Store: For existing Amazon Verified Permissions setups
      • Auto-imports:
        • Entity Types (users/resources)
        • Schema structure
        • Existing policies
      • Benefits: Zero manual setup, instant governance
    • New Policy Store: For new authorization implementations
      • Manual configuration:
        • Define Entity Types
        • Create custom Schema
        • Build policies from scratch
      • Flexibility: Full control over access model design

Key Relationships

LevelParentChildDescription
CategoryTenantApplicationGroups applications by business domain
ApplicationCategoryEnvironmentRepresents a service or product
EnvironmentApplicationPolicy StoreDefines deployment stages (e.g., dev, prod)
Policy StoreEnvironmentNoneStores and enforces rules

Workflow Example: Healthcare Portal

Why This Structure Works

  1. Business Alignment: Categories map to organizational units.
  2. Environment Isolation: Separate policies for dev/test/prod.
  3. Flexible Integration: Support both new and existing AVP stores.
Use AVP Policy Stores for production environments and New Policy Stores for experimental stages to maintain stability while enabling innovation.
I