Merge pull request 'fix: close #3-#12 - app.py security hardening (auth, TTS whitelist, cleanup, rotation)' (#28) from fix/issue-app-security into main

Reviewed-on: https://git.home.ms/jarianc/kokorotts-server/pulls/28
This commit is contained in:
jarianc 2026-07-05 07:53:42 -05:00
commit 28ee521411

123
app.py
View File

@ -2,15 +2,35 @@ import os
import subprocess
import tempfile
import re
import logging
import glob
from pathlib import Path
from flask import Flask, request, jsonify
from werkzeug.utils import secure_filename
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
app = Flask(__name__)
# Configuration from environment variables
OUTPUT_DIR = os.environ.get("OUTPUT_DIR", "output")
TTS_COMMAND = os.environ.get("TTS_COMMAND", "kokoro-tts")
PORT = int(os.environ.get("PORT", 5012))
API_KEY = os.environ.get("TTS_API_KEY", "")
# Issue #10: Whitelist allowed TTS commands
ALLOWED_TTS_COMMANDS = {"kokoro-tts", "/usr/local/bin/kokoro-tts", "/usr/bin/kokoro-tts"}
_tts_command = os.environ.get("TTS_COMMAND", "kokoro-tts")
if _tts_command not in ALLOWED_TTS_COMMANDS:
logger.warning(
f"TTS_COMMAND '{_tts_command}' not in whitelist, using default 'kokoro-tts'"
)
TTS_COMMAND = "kokoro-tts"
else:
TTS_COMMAND = _tts_command
# Issue #12: Maximum number of output files to keep per title
MAX_OUTPUT_FILES_PER_TITLE = 5
# Ensure output directory exists
os.makedirs(OUTPUT_DIR, exist_ok=True)
@ -21,7 +41,6 @@ VOICES = ["bm_fable", "bm_lewis", "bm_george"]
def parse_speaker_text(text):
"""Parse text into speaker: complete lines pairs for full conversation"""
# Split by newlines and filter empty ones
lines = [line.strip() for line in text.strip().split("\n") if line.strip()]
speakers = {}
@ -30,26 +49,18 @@ def parse_speaker_text(text):
tracks = []
for line in lines:
# Check if this is a speaker line (format: "SpeakerName: Some text")
match = re.match(r"^(.*?): (.*)$", line)
if match:
# Handle previous speaker content
if current_speaker and speaker_content:
speakers[current_speaker] = "\n".join(speaker_content)
# Start new speaker
current_speaker = match.group(1).strip()
speaker_content = [
match.group(2).strip()
] # First part after colon as initial content
speaker_content = [match.group(2).strip()]
tracks += [(current_speaker, speaker_content[0])]
else:
# This is a continuation line for the current speaker
if current_speaker and line.strip():
speaker_content.append(line.strip())
# Save final speaker's content
if current_speaker and speaker_content:
speakers[current_speaker] = "\n".join(speaker_content)
@ -62,14 +73,12 @@ def assign_voices_to_speakers(speakers):
used_voices = set()
for speaker in speakers.keys():
# If we haven't assigned a voice yet, pick an unused one
if not speaker_voice_map.get(speaker):
available_voices = [voice for voice in VOICES if voice not in used_voices]
if available_voices:
selected_voice = available_voices[0]
else:
# If all voices are used, pick randomly (this shouldn't happen with few speakers)
selected_voice = VOICES[0] # Fallback
selected_voice = VOICES[0]
speaker_voice_map[speaker] = selected_voice
used_voices.add(selected_voice)
@ -77,26 +86,37 @@ def assign_voices_to_speakers(speakers):
return speaker_voice_map
def clean_old_outputs(title):
"""Issue #12: Remove old output files for a given title, keeping only the newest."""
pattern = os.path.join(OUTPUT_DIR, f"{title}_*.wav")
files = sorted(glob.glob(pattern), key=os.path.getmtime, reverse=True)
for old_file in files[MAX_OUTPUT_FILES_PER_TITLE:]:
try:
os.unlink(old_file)
logger.info(f"Removed old output file: {old_file}")
except OSError as e:
logger.warning(f"Failed to remove old output file {old_file}: {e}")
def generate_wav_files(speakers, speaker_voice_map, title, tracks):
"""Generate individual WAV files for each speaker"""
wav_files = []
turn = 0
for speaker, text in tracks:
# Create a unique filename for this speaker's contribution
safe_speaker = secure_filename(speaker)
filepath = os.path.join(OUTPUT_DIR, f"{title}_{turn}.wav")
turn += 1
# Create temporary input file with the text
temp_input_path = None
try:
# Issue #11: Create temporary input file with proper cleanup
with tempfile.NamedTemporaryFile(
mode="w", suffix=".txt", delete=False
) as temp_file:
temp_file.write(text)
temp_input_path = temp_file.name
try:
# Run the kokoro-tts command
cmd = [
TTS_COMMAND,
temp_input_path,
@ -106,17 +126,19 @@ def generate_wav_files(speakers, speaker_voice_map, title, tracks):
]
subprocess.run(cmd, check=True, capture_output=True)
# Clean up temporary file
os.unlink(temp_input_path)
wav_files.append(filepath)
except Exception as e:
print(f"Error generating audio for {speaker}: {e}")
logger.error(f"Error generating audio for {speaker}: {e}")
return None
finally:
# Issue #11: Always clean up temp file, using specific exception type
if temp_input_path and os.path.exists(temp_input_path):
try:
os.unlink(temp_input_path)
except:
pass
return None
except OSError as cleanup_err:
logger.warning(
f"Failed to clean up temp file {temp_input_path}: {cleanup_err}"
)
return wav_files
@ -124,47 +146,61 @@ def generate_wav_files(speakers, speaker_voice_map, title, tracks):
def merge_wav_files(wav_files, final_output_path):
"""Merge multiple WAV files into a single file using sox"""
try:
# If no files provided, return None
if not wav_files:
return None
# If only one file, copy it and return
if len(wav_files) == 1:
import shutil
shutil.copy2(wav_files[0], final_output_path)
return final_output_path
# Use sox to concatenate all WAV files
cmd = ["sox"] + wav_files + [final_output_path]
subprocess.run(cmd, check=True, capture_output=True)
# Clean up all files
# Clean up intermediate files
for wav_file in wav_files:
try:
os.unlink(wav_file)
except OSError:
pass
except OSError as e:
logger.warning(f"Failed to remove intermediate file {wav_file}: {e}")
return final_output_path
except Exception as e:
print(f"Error merging WAV files: {e}")
# Fallback to returning the last file if merger fails
logger.error(f"Error merging WAV files: {e}")
if wav_files and len(wav_files) > 0:
import shutil
try:
shutil.copy2(wav_files[-1], final_output_path)
return final_output_path
except:
pass
except OSError as fallback_err:
logger.error(
f"Fallback copy failed for {wav_files[-1]}: {fallback_err}"
)
return None
def check_api_key():
"""Issue #9: Validate API key from Authorization header."""
if not API_KEY:
return True # No key configured = skip auth (dev mode)
auth_header = request.headers.get("Authorization", "")
if not auth_header.startswith("Bearer "):
return False
provided_key = auth_header[len("Bearer "):]
return provided_key == API_KEY
@app.route("/tts", methods=["POST"])
def text_to_speech():
"""Endpoint to convert full conversation to audio podcast"""
# Issue #9: API key authentication
if not check_api_key():
return jsonify({"error": "Unauthorized. Provide valid API key."}), 401
data = request.get_json()
if not data:
@ -176,29 +212,32 @@ def text_to_speech():
if not text or not title:
return jsonify({"error": "Both 'text' and 'title' fields are required"}), 400
# Parse the text to identify speakers and their complete conversations
# Sanitize title to prevent path traversal
safe_title = secure_filename(title)
if not safe_title:
return jsonify({"error": "Invalid title format"}), 400
(speakers, tracks) = parse_speaker_text(text)
if not speakers:
return jsonify({"error": "No speaker lines found in text"}), 400
# Assign voices to speakers
speaker_voice_map = assign_voices_to_speakers(speakers)
# Generate individual WAV files for each speaker
wav_files = generate_wav_files(speakers, speaker_voice_map, title, tracks)
# Issue #12: Clean old outputs before generating new ones
clean_old_outputs(safe_title)
wav_files = generate_wav_files(speakers, speaker_voice_map, safe_title, tracks)
if not wav_files:
return jsonify({"error": "Failed to generate audio files"}), 500
# Merge all generated WAV files into a single podcast file
final_wav_path = os.path.join(OUTPUT_DIR, f"{title}.wav")
final_wav_path = os.path.join(OUTPUT_DIR, f"{safe_title}.wav")
merged_file = merge_wav_files(wav_files, final_wav_path)
if not merged_file:
return jsonify({"error": "Failed to merge audio files"}), 500
# Return the location of the complete podcast file
return jsonify(
{
"file_path": final_wav_path,