jwt_auth_cognito 1.0.0.pre.beta.1 → 1.0.0.pre.beta.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b2b634f054c3fc1bfda6e0e63ffca5138547b23b11eff699faf23152491764a
-  data.tar.gz: df5e63158c0ac35b9530dc09ce74cf207a08897a8480c1aa5bcb1b9c177bd6e3
+  metadata.gz: 9296db47172be874a7d6204b54c3e5fc8de7f77a77a7e02f4b1d8d4b70bc9b8d
+  data.tar.gz: 55a4df3b1c9077b9803508ac925715510af9974ef79c40ed097cc0a86eb5b7a3
 SHA512:
-  metadata.gz: 034cd66eeb8c72a3446f32a74f1f73b17e78c4c24f566c2bbaacb017568d4e73faee63c9c53c4aecd658b11ee472d8912a9e87da1695a869590210b8c820b2ae
-  data.tar.gz: f00152cc1067ebda1630768f93ab7fb5053372c13e67b94ef08f6cdc5fde421e008c326c6ea454d0839b71b525dbf1daf16a94aa14fbb759ceb07dd150cd9477
+  metadata.gz: 19b0aa21809ac6d94c74e358d48d30b4246836610eff67121f41368552a6c385696952aec47a5bb8291c9141e6e0c1de398a028679f1fb05c8a3c71904d58446
+  data.tar.gz: 4cff441b707184fab34cc16f8368ae67334b8aad174f28b2c1649292a7d2b0b99ad66d60920ef9d503c95a162cd01e2ae621081e0129f38f3dc11c95f40c810c

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Improved
+
+- **Documentation Enhancement**: Added Redis configuration documentation to main usage patterns
+  - Updated README.md with complete Redis connection setup in factory method
+  - Enhanced CLAUDE.md with Redis configuration in the main usage pattern
+  - Improved clarity on how to connect Redis for token blacklisting and user data enrichment
+
 ## [0.3.0] - 2024-01-15
 
 ### Added

data/CLAUDE.md

@@ -145,6 +145,50 @@ ENV['REDIS_CA_CERT'] = "-----BEGIN CERTIFICATE-----..."
 - **Backward Compatibility**: All functionality works without client secret configuration
 - **Security Integration**: Secret hash automatically included in blacklist operations when configured
 
+## 🚀 Main Usage Pattern with Redis Connection
+
+### ✨ Complete Setup with Redis Connection
+
+```ruby
+# Create validator with Redis connection for blacklist and user data
+validator = JwtAuthCognito.create_cognito_validator(
+  region: 'us-east-1',
+  user_pool_id: 'us-east-1_ExamplePool',
+  client_id: 'your-client-id',
+  client_secret: 'your-client-secret', # Optional
+  redis_config: {
+    # Redis configuration for token blacklisting and user data enrichment
+    host: ENV['REDIS_HOST'] || 'localhost',
+    port: ENV['REDIS_PORT']&.to_i || 6379,
+    password: ENV['REDIS_PASSWORD'],
+    db: ENV['REDIS_DB']&.to_i || 0,
+
+    # TLS configuration for secure connections
+    tls: ENV['REDIS_TLS'] == 'true',
+    ca_cert_path: ENV['REDIS_CA_CERT_PATH'],
+    ca_cert_name: ENV['REDIS_CA_CERT_NAME'],
+    verify_mode: ENV['REDIS_VERIFY_MODE'] || 'peer'
+  },
+  enable_user_data_retrieval: true
+)
+
+# Initialize Redis connection and services
+validator.initialize!
+
+# 🌟 Main validation method with complete functionality
+result = validator.validate_token_enriched(token)
+
+if result[:valid]
+  puts "✅ Valid token:"
+  puts "User: #{result[:sub]}"
+  puts "Permissions: #{result[:user_permissions]}"
+  puts "Organizations: #{result[:user_organizations]}"
+  puts "Applications: #{result[:applications]}"
+else
+  puts "❌ Invalid token: #{result[:error]}"
+end
+```
+
 ## Environment Configuration
 
 The gem supports extensive environment variable configuration for deployment flexibility:
@@ -152,7 +196,7 @@ The gem supports extensive environment variable configuration for deployment fle
 ### AWS Cognito Configuration
 ```bash
 COGNITO_REGION=us-east-1
-COGNITO_USER_POOL_ID=us-east-1_AbCdEfGhI  
+COGNITO_USER_POOL_ID=us-east-1_AbCdEfGhI
 COGNITO_CLIENT_ID=your-client-id
 COGNITO_CLIENT_SECRET=your-client-secret  # Optional for enhanced security
 ```

data/README.md

@@ -162,21 +162,41 @@ end
 ### Factory Method para Configuración Simplificada (Nuevo v0.3.0)
 
 ```ruby
-# Crear validador con una línea
+# Crear validador con conexión Redis completa
 validator = JwtAuthCognito.create_cognito_validator(
   region: 'us-east-1',
   user_pool_id: 'us-east-1_ExamplePool',
   client_id: 'your-client-id',
   redis_config: {
-    host: 'localhost',
-    port: 6379,
-    tls: true
+    # Configuración básica de Redis
+    host: ENV['REDIS_HOST'] || 'localhost',
+    port: ENV['REDIS_PORT']&.to_i || 6379,
+    password: ENV['REDIS_PASSWORD'],
+    db: ENV['REDIS_DB']&.to_i || 0,
+
+    # Configuración TLS para conexiones seguras
+    tls: ENV['REDIS_TLS'] == 'true',
+    ca_cert_path: ENV['REDIS_CA_CERT_PATH'],
+    ca_cert_name: ENV['REDIS_CA_CERT_NAME']
   },
   enable_user_data_retrieval: true
 )
 
-# Usar inmediatamente
+# Inicializar conexiones (incluye Redis)
+validator.initialize!
+
+# Usar inmediatamente con validación enriquecida
 result = validator.validate_token_enriched(token)
+
+if result[:valid]
+  puts "✅ Token válido con datos enriquecidos:"
+  puts "Usuario: #{result[:sub]}"
+  puts "Permisos: #{result[:user_permissions]}"
+  puts "Organizaciones: #{result[:user_organizations]}"
+  puts "Aplicaciones: #{result[:applications]}"
+else
+  puts "❌ Token inválido: #{result[:error]}"
+end
 ```
 
 ### Manejo Mejorado de Errores (Nuevo v0.3.0)

data/lib/jwt_auth_cognito/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module JwtAuthCognito
-  VERSION = '1.0.0-beta.1'
+  VERSION = '1.0.0-beta.2'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: jwt_auth_cognito
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre.beta.1
+  version: 1.0.0.pre.beta.2
 platform: ruby
 authors:
 - The Optimal
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-15 00:00:00.000000000 Z
+date: 2025-09-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-ssm