PassForge - CLI de Gerador de Senhas Tudo-em-Um

Um gerador de senhas CLI criptograficamente seguro, pronto para produção, com 17 modos de geração, transparência de entropia e opções abrangentes de personalização.

Funcionalidades

17 Modos de Geração

Gerador	Comando	Descrição
Aleatório	random, r	Senhas aleatórias criptograficamente seguras
Frase-senha	phrase, p	Frases-senha baseadas em palavras (lista EFF)
Leetspeak	leet, l	Frases-senha com substituição de caracteres (A→4, E→3, etc.)
PIN	pin	PINs numéricos de comprimento configurável
Pronunciável	pronounce, pr	Senhas fáceis de falar baseadas em sílabas
UUID	uuid, u	UUIDs RFC 4122/9562 (v1, v4, v7) e Curto (Base58)
Base64	base64, b64	Segredos codificados em base64 seguros para URL
Segredo JWT	jwt	Segredos de alta entropia para assinatura JWT (HS256/384/512)
Chave WiFi	wifi	Chaves compatíveis com WPA2/WPA3 (8-63 caracteres)
Chave de Licença	license	Chaves de licença de software (formato AXB, ex.: 5x5)
Códigos de Recuperação	recovery	Códigos de backup 2FA (numéricos ou baseados em palavras)
Código/Segredo OTP	otp	Códigos TOTP/HOTP e segredos com URI otpauth
Padrão	pattern	Senhas baseadas em grade visual
Frase Temática	phrase (personalizado)	Frases-senha de listas de palavras temáticas (animais, sci-fi, etc.)
Fonético OTAN	phonetic, ph	Converter texto/senhas para alfabeto OTAN (Alfa-Bravo)
Analisar	analyze, check	Analisar a força de uma senha existente
Histórico	history	Ver histórico de geração de senhas (padrão: 10 entradas)

• Perfis Predefinidos: Geração com um clique para casos de uso comuns (Forte, Memorável, Dev, etc.)
• Menu Interativo: Menu completo para geração guiada
• Lançadores de Plataforma: Scripts dedicados .bat e .sh com menus interativos
• Segurança Criptográfica: Usa o módulo secrets do Python para CSPRNG
• Transparência de Entropia: Cálculo de entropia em tempo real e análise de força
• Análise zxcvbn: Verificação de força de senha baseada em padrões (ataques de dicionário, sequências)
• Área de Transferência Segura: Limpeza automática da área de transferência após tempo configurável
• Códigos OTP ao Vivo: Gera códigos TOTP atuais de 6/8 dígitos junto com o segredo
• Códigos QR para OTP: Códigos QR digitalizáveis para aplicativos autenticadores
• Saída Colorida: Distinção visual entre tipos de caracteres
• Exportação JSON: Saída legível por máquina para scripts
• Modo Balanceado: Garante distribuição legível (60% Letras, 20% Dígitos, 20% Símbolos)
• Guia do Gerador: Documentação abrangente para todos os 14 tipos de geradores.
• Histórico Criptografado (Cofre): Criptografa automaticamente as senhas salvas usando AES-128 (Fernet).
• Armazenamento Seguro em Cofre: Cofre dedicado gerencia chaves criptográficas via .env (recomendado) ou .vault.key legado com permissões restritas 0600
• Arquitetura de Zero Vazamento: 🛡️ Código-fonte e logs são bloqueados do acesso do navegador no modo PWA; entradas sensíveis são mascaradas no modo CLI para análise de entropia.
• Exportações Editadas: Exportação de histórico com foco em segurança, com ocultação automática de senhas por padrão
• Interface de Indentação Zero: Saída limpa e profissional alinhada à esquerda para todos os modos
• Leetspeak Inteligente: Substituição probabilística para senhas mais naturais e legíveis
• Validação Robusta: Prompts interativos com valores padrão e tratamento recursivo de erros
• Frontend PWA Defensivo: 🛡️ Verificações de segurança integradas para ativos CDN para evitar falhas na inicialização.
• Modificadores Globais: Modos --easy-read e --easy-say
• Modo Paranóico: Coleta manual opcional de entropia via variação de tempo do teclado para máxima segurança.

Instalação

# Clone o repositório
git clone https://github.com/krishnakanthb13/password_generator.git
cd password_generator

# Instale as dependências (colorama, cryptography, pyperclip, etc.)
pip install -r requirements.txt

Início Rápido

# Gere uma senha aleatória de 20 caracteres
python main.py random -l 20

# Gere uma frase-senha de 4 palavras
python main.py phrase -w 4 --capitalize

# Gere uma frase-senha leetspeak
python main.py leet -w 3 -s _

# Gere com análise de entropia
python main.py --show-entropy random -l 16

# Inicie o modo interativo
python main.py --interactive

# Use um perfil predefinido (Forte)
python main.py --preset strong --show-entropy

Exemplos de Uso

Senhas Aleatórias

# Senha básica de 16 caracteres
python main.py random

# 24 caracteres, apenas letras
python main.py random -l 24 --no-symbols --no-digits

# Fácil de ler (sem 0/O, 1/l/I)
python main.py --easy-read random -l 20

# Com requisitos mínimos
python main.py random -l 16 --min-upper 2 --min-digits 2 --min-symbols 1

# Modo balanceado (principalmente letras, menos símbolos)
python main.py random -l 24 --balanced

Frases-senha

# Frase-senha padrão de 4 palavras
python main.py phrase -w 4

# Capitalizado com separador sublinhado
python main.py phrase -w 5 -s _ --capitalize

# Caixa alternada (Alta Entropia)
python main.py phrase -w 4 -s . --alternate
# Saída: aPpLe.bAnAnA.cHeRrY.dAtE

# Maiúsculas com separador hífen (Alta Entropia)
python main.py phrase -w 4 -s . --uppercase
# Saída: APPLE-BANANA-CHERRY-DATE

# Versão leetspeak (Substituição inteligente de 50%)
python main.py leet -w 4 -s -
# Saída: 4PPl3.8@N@[email protected]

# Frase-senha temática (usando 'animals.txt')
python main.py phrase -w 4 --capitalize --wordlist data/wordlists/animals.txt
# Saída: Tiger-Falcon-Shark-Wolf

Chaves de Software (A x B)

# 5 segmentos de 5 caracteres
python main.py license --segments 5 --segment-length 5

# 4 segmentos de 8 caracteres
python main.py license --segments 4 --segment-length 8

Tokens de Desenvolvedor

# Segredo JWT para HS256
python main.py jwt --bits 256

# Chave API Base64
python main.py base64 -b 32 --url-safe

# Token UUID (v4 Aleatório)
python main.py uuid --upper

# UUID v7 (Baseado em tempo, ordenável)
python main.py uuid --ver 7
# Ou atalho
python main.py uuid --v7

# UUID Curto (Codificado Base58, ~22 caracteres)
python main.py uuid --short

# Gere um UUID v7 usando o atalho
python main.py u --v7

# Gere 10 UUIDs v4 curtos
python main.py uuid --v4 --short -n 10

# Conversão Fonética OTAN
python main.py phonetic --text "PassForge"
# Saída: Papa-Alpha-Sierra-Sierra-Foxtrot-Oscar-Romeo-Golf-Echo

Segurança e Registro

# Analise uma senha existente
python main.py analyze "p@ssword123"

# Registre no histórico
python main.py --log random -l 16

# Veja as últimas 10 entradas do histórico (padrão)
python main.py history

# Veja todas as entradas do histórico (descriptografadas em tempo real)
python main.py history --all

# Veja o histórico com senhas ocultadas
python main.py history --redact

# Exporte o histórico (Ocultado por padrão)
python main.py history --export backup.json

# Exporte o histórico (Texto simples - requer cuidado)
python main.py history --export secrets.csv --no-redact