#!/usr/bin/env python3 """ Simple API Key Management Script for Agentic AI System. Provides easy commands to add, remove, list, and manage API keys. """ import json import sys import string from pathlib import Path from typing import Dict, Any CONFIG_FILE = Path("config/api_keys.json") def validate_api_key(key: str) -> bool: """Validate API key format.""" if not key or len(key) < 8: return False # Allow alphanumeric, hyphens, underscores allowed_chars = string.ascii_letters + string.digits + "-_" return all(c in allowed_chars for c in key) def load_config() -> Dict[str, Any]: """Load current API key configuration.""" if CONFIG_FILE.exists(): with open(CONFIG_FILE, 'r') as f: return json.load(f) else: return { "api_keys": {}, "settings": { "default_rate_limit": 100, "token_expiry_days": 365, "require_https": False } } def save_config(config: Dict[str, Any]) -> None: """Save API key configuration.""" CONFIG_FILE.parent.mkdir(parents=True, exist_ok=True) with open(CONFIG_FILE, 'w') as f: json.dump(config, f, indent=2) print(f"✅ Configuration saved to {CONFIG_FILE}") def list_keys() -> None: """List all API keys.""" config = load_config() api_keys = config.get("api_keys", {}) if not api_keys: print("❌ No API keys found") return print("🔑 Current API Keys:") print("-" * 60) for key, info in api_keys.items(): status = "✅ Enabled" if info.get("enabled", True) else "❌ Disabled" masked_key = key[:8] + "..." + key[-4:] if len(key) > 12 else key print(f"Key: {masked_key}") print(f" Name: {info.get('name', 'Unknown')}") print(f" Permissions: {', '.join(info.get('permissions', []))}") print(f" Rate Limit: {info.get('rate_limit', 100)}/hour") print(f" Status: {status}") print(f" Description: {info.get('description', 'No description')}") print() def add_key(api_key: str, name: str, permissions: list = None, rate_limit: int = 100, description: str = "") -> None: """Add a new API key.""" config = load_config() # Validate the API key if not validate_api_key(api_key): print("❌ Invalid API key format. Must be at least 8 characters and contain only letters, numbers, hyphens, and underscores.") return # Check if key already exists if api_key in config.get("api_keys", {}): print(f"❌ API key already exists: {api_key}") return # Set default permissions if permissions is None: permissions = ["read", "write"] # Add key to config config["api_keys"][api_key] = { "name": name, "permissions": permissions, "description": description, "rate_limit": rate_limit, "enabled": True } save_config(config) print("🎉 API key added successfully!") print(f"Key: {api_key}") print(f"Name: {name}") print(f"Permissions: {', '.join(permissions)}") print(f"Rate Limit: {rate_limit}/hour") def remove_key(key_pattern: str) -> None: """Remove an API key by pattern matching.""" config = load_config() api_keys = config.get("api_keys", {}) # Find matching keys matches = [key for key in api_keys.keys() if key_pattern in key] if not matches: print(f"❌ No keys found matching: {key_pattern}") return if len(matches) > 1: print(f"❌ Multiple keys match '{key_pattern}'. Be more specific:") for key in matches: masked_key = key[:8] + "..." + key[-4:] print(f" {masked_key} ({api_keys[key].get('name', 'Unknown')})") return # Remove the key key_to_remove = matches[0] removed_info = api_keys.pop(key_to_remove) config["api_keys"] = api_keys save_config(config) print(f"✅ Removed API key: {removed_info.get('name', 'Unknown')}") def disable_key(key_pattern: str) -> None: """Disable an API key.""" config = load_config() api_keys = config.get("api_keys", {}) # Find matching keys matches = [key for key in api_keys.keys() if key_pattern in key] if not matches: print(f"❌ No keys found matching: {key_pattern}") return if len(matches) > 1: print(f"❌ Multiple keys match '{key_pattern}'. Be more specific.") return # Disable the key key_to_disable = matches[0] api_keys[key_to_disable]["enabled"] = False save_config(config) print(f"✅ Disabled API key: {api_keys[key_to_disable].get('name', 'Unknown')}") def enable_key(key_pattern: str) -> None: """Enable an API key.""" config = load_config() api_keys = config.get("api_keys", {}) # Find matching keys matches = [key for key in api_keys.keys() if key_pattern in key] if not matches: print(f"❌ No keys found matching: {key_pattern}") return if len(matches) > 1: print(f"❌ Multiple keys match '{key_pattern}'. Be more specific.") return # Enable the key key_to_enable = matches[0] api_keys[key_to_enable]["enabled"] = True save_config(config) print(f"✅ Enabled API key: {api_keys[key_to_enable].get('name', 'Unknown')}") def create_default_config() -> None: """Create default configuration with demo keys.""" config = { "api_keys": { "demo-key-12345": { "name": "Demo User", "permissions": ["read", "write"], "description": "Default demo key for testing and development", "rate_limit": 100, "enabled": True }, "admin-key-67890": { "name": "Admin User", "permissions": ["read", "write", "admin"], "description": "Admin key with full system access", "rate_limit": 1000, "enabled": True } }, "settings": { "default_rate_limit": 100, "token_expiry_days": 365, "require_https": False } } save_config(config) print("✅ Created default API key configuration") def show_help() -> None: """Show help information.""" print("🔑 API Key Management for Agentic AI System") print("=" * 50) print() print("Commands:") print(" list - List all API keys") print(" add - Add new API key with default permissions") print(" add-admin - Add new admin API key") print(" remove - Remove API key (partial match)") print(" disable - Disable API key") print(" enable - Enable API key") print(" init - Create default configuration") print(" help - Show this help") print() print("Examples:") print(" python manage_api_keys.py list") print(" python manage_api_keys.py add 'prod-api-key-2024' 'Production Client'") print(" python manage_api_keys.py add-admin 'admin-key-secure-2024' 'System Admin'") print(" python manage_api_keys.py remove demo-key") print(" python manage_api_keys.py disable demo-key-12345") print() print("Notes:") print(" - API keys must be at least 8 characters") print(" - Use letters, numbers, hyphens, and underscores only") print(" - Choose secure, unique keys for production") print() print("Configuration file: config/api_keys.json") def main(): """Main function.""" if len(sys.argv) < 2: show_help() return command = sys.argv[1].lower() try: if command == "list": list_keys() elif command == "add": if len(sys.argv) < 4: print("❌ Usage: add ") return api_key = sys.argv[2] name = sys.argv[3] add_key(api_key, name) elif command == "add-admin": if len(sys.argv) < 4: print("❌ Usage: add-admin ") return api_key = sys.argv[2] name = sys.argv[3] add_key(api_key, name, permissions=["read", "write", "admin"], rate_limit=1000, description="Admin user with full access") elif command == "remove": if len(sys.argv) < 3: print("❌ Usage: remove ") return pattern = sys.argv[2] remove_key(pattern) elif command == "disable": if len(sys.argv) < 3: print("❌ Usage: disable ") return pattern = sys.argv[2] disable_key(pattern) elif command == "enable": if len(sys.argv) < 3: print("❌ Usage: enable ") return pattern = sys.argv[2] enable_key(pattern) elif command == "init": create_default_config() elif command == "help": show_help() else: print(f"❌ Unknown command: {command}") show_help() except Exception as e: print(f"❌ Error: {e}") if __name__ == "__main__": main()