""" Advanced Secrets Management System for Cyber-LLM Provides secure handling of API keys, credentials, and sensitive configuration """ import os import json import base64 import hashlib from typing import Dict, List, Any, Optional, Union from datetime import datetime, timedelta from pathlib import Path from cryptography.fernet import Fernet from cryptography.hazmat.primitives import hashes from cryptography.hazmat.primitives.kdf.pbkdf2 import PBKDF2HMAC import keyring import hvac # HashiCorp Vault client import boto3 from azure.keyvault.secrets import SecretClient from azure.identity import DefaultAzureCredential from google.cloud import secretmanager import yaml import logging from .logging_system import CyberLLMLogger, CyberLLMError, ErrorCategory class SecretNotFoundError(CyberLLMError): """Raised when a secret is not found""" def __init__(self, secret_name: str): super().__init__( f"Secret not found: {secret_name}", ErrorCategory.AUTHENTICATION, details={"secret_name": secret_name} ) class SecretDecryptionError(CyberLLMError): """Raised when secret decryption fails""" def __init__(self, secret_name: str): super().__init__( f"Failed to decrypt secret: {secret_name}", ErrorCategory.SECURITY, details={"secret_name": secret_name} ) class SecretProvider: """Base class for secret providers""" def __init__(self, logger: Optional[CyberLLMLogger] = None): self.logger = logger or CyberLLMLogger(name="secrets") async def get_secret(self, name: str) -> str: """Get a secret by name""" raise NotImplementedError async def set_secret(self, name: str, value: str) -> bool: """Set a secret value""" raise NotImplementedError async def delete_secret(self, name: str) -> bool: """Delete a secret""" raise NotImplementedError async def list_secrets(self) -> List[str]: """List available secrets""" raise NotImplementedError class LocalEncryptedProvider(SecretProvider): """Local encrypted file-based secret provider""" def __init__(self, secrets_file: str = "secrets/encrypted_secrets.json", password: Optional[str] = None, logger: Optional[CyberLLMLogger] = None): super().__init__(logger) self.secrets_file = Path(secrets_file) self.secrets_file.parent.mkdir(parents=True, exist_ok=True) # Generate or load encryption key self.password = password or os.getenv("CYBERLLM_SECRETS_PASSWORD") if not self.password: raise ValueError("Secrets password must be provided via parameter or CYBERLLM_SECRETS_PASSWORD env var") self.cipher_suite = self._get_cipher_suite() # Load existing secrets self.secrets = self._load_secrets() def _get_cipher_suite(self) -> Fernet: """Generate cipher suite from password""" password_bytes = self.password.encode() salt = b'cyberllm_secrets_salt' # In production, use random salt per secret kdf = PBKDF2HMAC( algorithm=hashes.SHA256(), length=32, salt=salt, iterations=100000, ) key = base64.urlsafe_b64encode(kdf.derive(password_bytes)) return Fernet(key) def _load_secrets(self) -> Dict[str, str]: """Load secrets from encrypted file""" if not self.secrets_file.exists(): return {} try: with open(self.secrets_file, 'rb') as f: encrypted_data = f.read() if not encrypted_data: return {} decrypted_data = self.cipher_suite.decrypt(encrypted_data) return json.loads(decrypted_data.decode()) except Exception as e: self.logger.error("Failed to load secrets", error=str(e)) return {} def _save_secrets(self) -> bool: """Save secrets to encrypted file""" try: data = json.dumps(self.secrets).encode() encrypted_data = self.cipher_suite.encrypt(data) with open(self.secrets_file, 'wb') as f: f.write(encrypted_data) # Set restrictive permissions os.chmod(self.secrets_file, 0o600) return True except Exception as e: self.logger.error("Failed to save secrets", error=str(e)) return False async def get_secret(self, name: str) -> str: """Get a secret by name""" if name not in self.secrets: raise SecretNotFoundError(name) self.logger.audit("Secret accessed", secret_name=name) return self.secrets[name] async def set_secret(self, name: str, value: str) -> bool: """Set a secret value""" self.secrets[name] = value success = self._save_secrets() if success: self.logger.audit("Secret updated", secret_name=name) else: self.logger.error("Failed to save secret", secret_name=name) return success async def delete_secret(self, name: str) -> bool: """Delete a secret""" if name in self.secrets: del self.secrets[name] success = self._save_secrets() if success: self.logger.audit("Secret deleted", secret_name=name) return success return False async def list_secrets(self) -> List[str]: """List available secrets""" return list(self.secrets.keys()) class VaultProvider(SecretProvider): """HashiCorp Vault secret provider""" def __init__(self, vault_url: str = "http://localhost:8200", vault_token: Optional[str] = None, mount_point: str = "kv", logger: Optional[CyberLLMLogger] = None): super().__init__(logger) self.vault_url = vault_url self.mount_point = mount_point # Initialize Vault client self.client = hvac.Client(url=vault_url) # Authenticate token = vault_token or os.getenv("VAULT_TOKEN") if token: self.client.token = token else: # Try other auth methods (AWS IAM, Kubernetes, etc.) self._authenticate() def _authenticate(self): """Authenticate with Vault using available methods""" # Try AWS IAM authentication if os.getenv("AWS_ROLE"): try: self.client.auth.aws.iam_login( role=os.getenv("AWS_ROLE"), mount_point="aws" ) self.logger.info("Authenticated with Vault using AWS IAM") return except Exception as e: self.logger.warning("AWS IAM auth failed", error=str(e)) # Try Kubernetes authentication if os.path.exists("/var/run/secrets/kubernetes.io/serviceaccount/token"): try: with open("/var/run/secrets/kubernetes.io/serviceaccount/token", "r") as f: jwt = f.read() self.client.auth.kubernetes.login( role=os.getenv("VAULT_K8S_ROLE", "cyberllm"), jwt=jwt, mount_point="kubernetes" ) self.logger.info("Authenticated with Vault using Kubernetes") return except Exception as e: self.logger.warning("Kubernetes auth failed", error=str(e)) raise CyberLLMError("Failed to authenticate with Vault", ErrorCategory.AUTHENTICATION) async def get_secret(self, name: str) -> str: """Get a secret from Vault""" try: response = self.client.secrets.kv.v2.read_secret_version( path=name, mount_point=self.mount_point ) secret_data = response['data']['data'] # If secret has a 'value' key, return that, otherwise return the first value if 'value' in secret_data: value = secret_data['value'] else: value = next(iter(secret_data.values())) self.logger.audit("Secret accessed from Vault", secret_name=name) return value except hvac.exceptions.InvalidPath: raise SecretNotFoundError(name) except Exception as e: self.logger.error("Failed to get secret from Vault", secret_name=name, error=str(e)) raise CyberLLMError(f"Vault error: {str(e)}", ErrorCategory.SYSTEM) async def set_secret(self, name: str, value: str) -> bool: """Set a secret in Vault""" try: self.client.secrets.kv.v2.create_or_update_secret( path=name, secret={'value': value}, mount_point=self.mount_point ) self.logger.audit("Secret updated in Vault", secret_name=name) return True except Exception as e: self.logger.error("Failed to set secret in Vault", secret_name=name, error=str(e)) return False async def delete_secret(self, name: str) -> bool: """Delete a secret from Vault""" try: self.client.secrets.kv.v2.delete_metadata_and_all_versions( path=name, mount_point=self.mount_point ) self.logger.audit("Secret deleted from Vault", secret_name=name) return True except Exception as e: self.logger.error("Failed to delete secret from Vault", secret_name=name, error=str(e)) return False async def list_secrets(self) -> List[str]: """List secrets in Vault""" try: response = self.client.secrets.kv.v2.list_secrets( path="", mount_point=self.mount_point ) return response['data']['keys'] except Exception as e: self.logger.error("Failed to list secrets from Vault", error=str(e)) return [] class AWSSecretsProvider(SecretProvider): """AWS Secrets Manager provider""" def __init__(self, region_name: str = "us-east-1", logger: Optional[CyberLLMLogger] = None): super().__init__(logger) self.client = boto3.client('secretsmanager', region_name=region_name) async def get_secret(self, name: str) -> str: """Get secret from AWS Secrets Manager""" try: response = self.client.get_secret_value(SecretId=name) self.logger.audit("Secret accessed from AWS", secret_name=name) return response['SecretString'] except self.client.exceptions.ResourceNotFoundException: raise SecretNotFoundError(name) except Exception as e: self.logger.error("Failed to get secret from AWS", secret_name=name, error=str(e)) raise CyberLLMError(f"AWS error: {str(e)}", ErrorCategory.SYSTEM) async def set_secret(self, name: str, value: str) -> bool: """Set secret in AWS Secrets Manager""" try: try: # Try to update existing secret self.client.update_secret(SecretId=name, SecretString=value) except self.client.exceptions.ResourceNotFoundException: # Create new secret self.client.create_secret(Name=name, SecretString=value) self.logger.audit("Secret updated in AWS", secret_name=name) return True except Exception as e: self.logger.error("Failed to set secret in AWS", secret_name=name, error=str(e)) return False async def delete_secret(self, name: str) -> bool: """Delete secret from AWS Secrets Manager""" try: self.client.delete_secret( SecretId=name, ForceDeleteWithoutRecovery=True ) self.logger.audit("Secret deleted from AWS", secret_name=name) return True except Exception as e: self.logger.error("Failed to delete secret from AWS", secret_name=name, error=str(e)) return False async def list_secrets(self) -> List[str]: """List secrets in AWS Secrets Manager""" try: paginator = self.client.get_paginator('list_secrets') secrets = [] for page in paginator.paginate(): for secret in page['SecretList']: secrets.append(secret['Name']) return secrets except Exception as e: self.logger.error("Failed to list secrets from AWS", error=str(e)) return [] class SecretsManager: """Central secrets manager with fallback providers""" def __init__(self, providers: Optional[List[SecretProvider]] = None, cache_ttl: int = 300, # 5 minutes logger: Optional[CyberLLMLogger] = None): self.logger = logger or CyberLLMLogger(name="secrets_manager") self.providers = providers or [] self.cache_ttl = cache_ttl self.cache = {} # Auto-configure providers based on environment if not self.providers: self._auto_configure_providers() def _auto_configure_providers(self): """Auto-configure providers based on available credentials/environment""" # Try Vault if available if os.getenv("VAULT_ADDR") or os.getenv("VAULT_TOKEN"): try: vault_provider = VaultProvider( vault_url=os.getenv("VAULT_ADDR", "http://localhost:8200"), logger=self.logger ) self.providers.append(vault_provider) self.logger.info("Added Vault provider") except Exception as e: self.logger.warning("Failed to configure Vault provider", error=str(e)) # Try AWS if credentials available try: boto3.Session().get_credentials() aws_provider = AWSSecretsProvider(logger=self.logger) self.providers.append(aws_provider) self.logger.info("Added AWS Secrets Manager provider") except Exception as e: self.logger.warning("Failed to configure AWS provider", error=str(e)) # Always add local encrypted provider as fallback if os.getenv("CYBERLLM_SECRETS_PASSWORD"): try: local_provider = LocalEncryptedProvider(logger=self.logger) self.providers.append(local_provider) self.logger.info("Added local encrypted provider") except Exception as e: self.logger.warning("Failed to configure local provider", error=str(e)) def _is_cache_valid(self, name: str) -> bool: """Check if cached secret is still valid""" if name not in self.cache: return False cache_entry = self.cache[name] return datetime.now() < cache_entry['expires'] async def get_secret(self, name: str, use_cache: bool = True) -> str: """Get secret from providers with caching""" # Check cache first if use_cache and self._is_cache_valid(name): self.logger.debug("Secret retrieved from cache", secret_name=name) return self.cache[name]['value'] # Try each provider for i, provider in enumerate(self.providers): try: value = await provider.get_secret(name) # Cache the result if use_cache: self.cache[name] = { 'value': value, 'expires': datetime.now() + timedelta(seconds=self.cache_ttl), 'provider': type(provider).__name__ } self.logger.info(f"Secret retrieved from provider {i+1}/{len(self.providers)}", secret_name=name, provider=type(provider).__name__) return value except SecretNotFoundError: continue # Try next provider except Exception as e: self.logger.warning(f"Provider {type(provider).__name__} failed", secret_name=name, error=str(e)) continue # No provider found the secret raise SecretNotFoundError(name) async def set_secret(self, name: str, value: str) -> bool: """Set secret in the first available provider""" # Clear cache if name in self.cache: del self.cache[name] for provider in self.providers: try: success = await provider.set_secret(name, value) if success: self.logger.info("Secret set successfully", secret_name=name, provider=type(provider).__name__) return True except Exception as e: self.logger.warning(f"Provider {type(provider).__name__} failed to set secret", secret_name=name, error=str(e)) continue return False def get_api_credentials(self) -> Dict[str, str]: """Get common API credentials""" import asyncio credentials = {} common_secrets = [ "metasploit_api_key", "cobalt_strike_license", "shodan_api_key", "virustotal_api_key", "openai_api_key", "anthropic_api_key", "github_token", "slack_webhook_url", "discord_webhook_url" ] for secret in common_secrets: try: value = asyncio.run(self.get_secret(secret)) credentials[secret] = value except SecretNotFoundError: self.logger.debug(f"Optional secret not found: {secret}") except Exception as e: self.logger.warning(f"Failed to get {secret}", error=str(e)) return credentials # Global instance _secrets_manager = None def get_secrets_manager() -> SecretsManager: """Get global secrets manager instance""" global _secrets_manager if _secrets_manager is None: _secrets_manager = SecretsManager() return _secrets_manager # Convenience functions async def get_secret(name: str) -> str: """Get a secret using the global manager""" return await get_secrets_manager().get_secret(name) async def set_secret(name: str, value: str) -> bool: """Set a secret using the global manager""" return await get_secrets_manager().set_secret(name, value) def get_api_credentials() -> Dict[str, str]: """Get API credentials using the global manager""" return get_secrets_manager().get_api_credentials() # Example usage if __name__ == "__main__": import asyncio async def test_secrets(): # Initialize secrets manager manager = SecretsManager() # Set a test secret await manager.set_secret("test_api_key", "super_secret_value_123") # Retrieve the secret value = await manager.get_secret("test_api_key") print(f"Retrieved secret: {value}") # Get API credentials credentials = manager.get_api_credentials() print(f"Available credentials: {list(credentials.keys())}") asyncio.run(test_secrets())