agentic_security/docs/stenography.md

Stenography Functions

The stenography module provides various text obfuscation and transformation techniques for security testing. This document explains its architecture and implementation.

Overview

The module implements:

1. Rotation ciphers (ROT13, ROT5)
2. Base64 encoding
3. Text manipulation functions
4. Randomization techniques
5. Character substitution methods

Core Functions

Rotation Ciphers

def rot13(input_text):
    """
    Applies ROT13 cipher to input text
    - Preserves case of letters
    - Leaves non-alphabetic characters unchanged
    """
    # Implementation details...

def rot5(input_text):
    """
    Applies ROT5 cipher to input text
    - Rotates digits by 5 positions
    - Leaves non-digit characters unchanged
    """
    # Implementation details...

Encoding

def base64_encode(data):
    """
    Encodes input data using Base64
    - Handles both string and bytes input
    - Returns UTF-8 encoded string
    """
    # Implementation details...

Text Manipulation

def mirror_words(text):
    """
    Reverses each word in the input text
    - Preserves word order
    - Maintains spaces between words
    """
    # Implementation details...

def scramble_words(text):
    """
    Randomly scrambles middle letters of words
    - Preserves first and last letters
    - Handles words shorter than 4 characters
    """
    # Implementation details...

Randomization

def randomize_letter_case(text):
    """
    Randomly changes case of each character
    - Independent case changes per character
    - Preserves non-letter characters
    """
    # Implementation details...

def insert_noise_characters(text, frequency=0.2):
    """
    Inserts random characters between existing ones
    - Configurable insertion frequency
    - Uses alphanumeric characters for noise
    """
    # Implementation details...

Advanced Transformations

def substitute_with_ascii(text):
    """
    Replaces characters with their ASCII codes
    - Space-separated numeric values
    - Preserves original character order
    """
    # Implementation details...

def remove_vowels(text):
    """
    Removes all vowel characters from text
    - Handles both lowercase and uppercase vowels
    - Preserves non-vowel characters
    """
    # Implementation details...

def zigzag_obfuscation(text):
    """
    Alternates character case in zigzag pattern
    - Starts with uppercase
    - Toggles case for each alphabetic character
    """
    # Implementation details...

Usage Patterns

1. Text Obfuscation:

   obfuscated = zigzag_obfuscation(
       scramble_words(
           insert_noise_characters(text)
       )
   )
   

2. Encoding:

   encoded = base64_encode(rot13(text))
   

3. Randomization:

   randomized = randomize_letter_case(
       remove_vowels(text)
   )
   

Configuration

• Noise Frequency: Configurable in insert_noise_characters()
• Scrambling: Automatic handling of word lengths
• Case Handling: Preserved in rotation ciphers

Limitations

• Primarily handles ASCII text
• Limited to implemented transformation types
• Randomization is not cryptographically secure