HSM Kit

Servidor MCP local-first para ferramentas de Base64, Luhn, XOR de componentes de chave e bloco PIN ISO-0 sintético.

Documentação

HSM Kit - Kit de Ferramentas Profissionais de Criptografia Online

🔐 Ferramentas profissionais de criptografia e gerenciamento de chaves, 100% no lado do cliente, seguras e confiáveis

📖 Introdução

O HSM Kit é um kit de ferramentas profissionais de criptografia online, projetado para desenvolvedores, testadores e engenheiros de segurança nas áreas financeira, de pagamentos e de segurança. Ele fornece mais de 44 ferramentas que cobrem gerenciamento de chaves HSM, segurança de pagamentos, certificados PKI e algoritmos criptográficos, tudo executado inteiramente no navegador.

Valores Principais

Segurança em Primeiro Lugar - Computação 100% no lado do cliente; chaves e dados sensíveis nunca saem do seu dispositivo
Profissional e Completo - Mais de 44 ferramentas cobrindo gerenciamento de chaves HSM, segurança de pagamentos, certificados PKI e algoritmos criptográficos
Pronto para Usar - Abra o navegador e comece a trabalhar; suporta instalação PWA e funciona em Mac/Windows/Linux/dispositivos móveis
Código Aberto - Código auditável publicamente, atendendo aos requisitos de conformidade do setor financeiro

✨ Recursos

Recurso	Descrição
🔒 Computação Local	Todas as operações criptográficas são executadas no navegador; os dados nunca são enviados
📱 Suporte PWA	Instalável na área de trabalho, funciona como um aplicativo nativo, disponível offline
🌐 Multiplataforma	Suporte para Mac/Windows/Linux/iOS/Android
🌍 Multilíngue	Inglês, chinês, japonês, coreano, alemão, francês - cobertura de 100%
🌙 Modo Escuro	Alternância de tema dia/noite para proteger seus olhos
♿ Acessível	Rótulos ARIA, navegação por teclado, pular para o conteúdo, regiões aria-live, em conformidade com WCAG 2.1 AA
⚡ Carregamento Preguiçoso	Divisão de código em nível de rota; carrega apenas a página atual
🔍 Otimizado para SEO	HTML estático pré-renderizado, marcação Schema, hreflang multilíngue
📚 Base de Conhecimento	43 artigos técnicos em inglês + 43 em chinês com entrega estática e indexável
🇨🇳 URLs de Ferramentas Localizadas	8 ferramentas de alta demanda têm URLs canônicas em chinês com hreflang recíproco
🧪 Vetores de Teste Publicados	Vetores JSON AES para download verificados por testes de regressão CryptoJS e Web Crypto
📝 Exemplos Seguros de Contexto	Exemplos com um clique preservam o modo selecionado, formato, aba e alternâncias de ativação
✅ Validação de Entrada Consistente	Estados compartilhados de comprimento e formato cinza/verde/vermelho em todas as entradas das ferramentas
⭐ Favoritos e Ferramentas Recentes	Favoritos locais mais histórico de ferramentas recentes de 90 dias, sem necessidade de conta
🔗 Descoberta de Fluxo de Trabalho	Cada ferramenta vincula às próximas ferramentas relevantes e aos seus guias de suporte
📊 Eventos Seguros de Privacidade	Eventos opcionais GA/Zaraz contêm apenas IDs de ação/ferramenta, nunca valores de formulário ou resultados
🧪 Cobertura de Testes	Mais de 100 testes Vitest mais verificações de fumaça de páginas de produção para todas as 44 ferramentas

🛠️ Módulos de Ferramentas

🔐 Ferramentas de Criptografia/Descriptografia (5)

Ferramenta	Descrição	Rota
Criptografia AES	AES-128/192/256, modos ECB/CBC/CFB/OFB/CTR	`/aes-encryption`
Criptografia DES/3DES	DES/Triple DES, múltiplas opções de preenchimento	`/des-encryption`
Criptografia RSA	Criptografar/descriptografar/assinar/verificar RSA, PKCS#1/OAEP	`/rsa-encryption`
ECC/ECDSA	Curva elíptica, secp256k1/P-256/P-384	`/ecc-encryption`
FPE Preservação de Formato	Algoritmos FF1/FF3-1, NIST SP 800-38G	`/fpe-encryption`

🔑 Ferramentas de Gerenciamento de Chaves (8)

Ferramenta	Descrição	Rota
Gerador de Chaves	Chaves aleatórias seguras AES/DES/3DES, combinação de chaves, paridade	`/keys-dea`
Gerador de Compartilhamento de Chaves	Divisão de chaves para custódia segura, cálculo de KCV	`/keyshare-generator`
Chaves Futurex	Criptografar/descriptografar/consultar chaves HSM Futurex	`/futurex-keys`
Chaves Atalla (AKB)	Criptografar/descriptografar chaves no formato AKB Atalla	`/atalla-keys`
Chaves SafeNet	Criptografar/descriptografar/consultar chaves HSM SafeNet	`/safenet-keys`
Chaves Thales	Criptografar/descriptografar/consultar chaves LMK HSM Thales	`/thales-keys`
Bloco de Chaves Thales	Codificar/decodificar bloco de chaves proprietário Thales	`/thales-key-block`
Bloco de Chaves TR-31	Codificar/decodificar bloco de chaves ANSI X9.143	`/tr31-key-block`

🔐 Ferramentas PKI (2)

Ferramenta	Descrição	Rota
Decodificador ASN.1	Decodificação de estrutura DER/BER, análise de certificados X.509	`/asn1-parser`
Certificados SSL (X509)	Análise e validação de certificados SSL/TLS	`/ssl-certificates`

💳 Ferramentas de Segurança de Pagamentos (21)

Categoria	Ferramenta	Rota
AS2805	Ferramenta de Mensagens AS2805	`/payments-as2805`
Bitmap	Bitmap ISO 8583	`/payments-bitmap`
Validação de Cartão	CVV/CVC	`/payments-card-validation-cvvs`
Validação de Cartão	AMEX CSC	`/payments-card-validation-amex-cscs`
Validação de Cartão	MasterCard CVC3	`/payments-card-validation-mastercard-cvc3`
DUKPT	DUKPT TDES (ISO 9797)	`/payments-dukpt-iso9797`
DUKPT	DUKPT AES	`/payments-dukpt-aes`
MAC	MAC ISO 9797-1	`/payments-mac-iso9797-1`
MAC	ANSI X9.9/X9.19	`/payments-mac-ansix9`
MAC	MAC AS2805	`/payments-mac-as2805`
MAC	TDES CBC-MAC	`/payments-mac-tdes-cbc-mac`
MAC	HMAC	`/payments-mac-hmac`
MAC	CMAC	`/payments-mac-cmac`
MAC	MAC de Varejo	`/payments-mac-retail`
PIN	Bloco PIN Geral	`/payments-pin-blocks-general`
PIN	Bloco PIN AES	`/payments-pin-blocks-aes`
PIN	Offset PIN	`/payments-pin-offset`
PIN	PVV PIN	`/payments-pin-pvv`
Outros	Certificados VISA	`/payments-visa-certificates`
Outros	ZKA (Banco Alemão)	`/payments-zka`

🧰 Ferramentas Gerais (9)

Ferramenta	Descrição	Rota
Calculadora de Hash	MD5/SHA/SHA-3/BLAKE2/SM3, mais de 20 algoritmos	`/hashes`
Codificação de Caracteres	Conversão ASCII/Hex/Binário/EBCDIC/ATM	`/character-encoding`
Codificação BCD	Conversão de decimal para codificação BCD	`/bcd`
Dígitos de Verificação	Luhn (MOD 10) / Amex SE (MOD 9)	`/check-digits`
Codificar/Decodificar Base64	Codificação/decodificação Base64 padrão	`/base64`
Codificar/Decodificar Base94	Codificação/decodificação Base94	`/base94`
Analisador de Mensagens	Análise ISO 8583, ATM NDC/Wincor	`/message-parser`
Chave Pública DER RSA	Codificar/decodificar chave pública RSA DER/PEM	`/rsa-der-public-key`
Gerador de UUID	Geração de UUID v1/v3/v4/v5	`/uuid`

📚 Base de Conhecimento

O HSM Kit inclui uma base de conhecimento integrada (/guides/) com 42 artigos técnicos aprofundados em inglês e chinês, cobrindo algoritmos de criptografia, segurança de pagamentos, gerenciamento de chaves HSM e muito mais. Os artigos são interligados e diretamente conectados às ferramentas correspondentes.

Recursos da Base de Conhecimento

📝 Renderização Markdown - Blocos de código, tabelas, links internos
🔗 Integração com Ferramentas - Links diretos para ferramentas e artigos relacionados
🌍 Bilíngue - Inglês e chinês, 43 artigos cada, totalmente traduzidos
📖 Sumário - Navegação TOC no lado direito com destaque de rolagem
🔍 Pesquisa - Pesquisa de texto completo nos artigos

📁 Estrutura do Projeto

hsmkit/
├── public/                     # Static assets
│   ├── favicon.svg             # Website logo
│   ├── favicon-*.png           # PWA icons (48/192/512)
│   ├── apple-touch-icon.png    # iOS icon
│   ├── sitemap.xml             # Sitemap (144 URLs with hreflang)
│   ├── robots.txt              # Crawler instructions
│   ├── _headers                # HTTP headers (Cloudflare)
│   └── _redirects              # SPA route redirects
│
├── scripts/                    # Build scripts
│   ├── generate-favicon-png.js # Favicon generation
│   ├── generate-guide-og.js    # Per-guide social image generation
│   ├── prerender-guides.js     # Static guide-page generation
│   ├── check-tool-pages.js     # Production page smoke checks
│   └── update-sitemap-lastmod.js # Guide/tool sitemap maintenance
│
├── src/
│   ├── components/             # Reusable components
│   │   ├── cipher/             # Encryption tool components
│   │   ├── common/             # Common components
│   │   │   ├── PageLayout.tsx  # Page layout + Schema.org
│   │   │   ├── ToolPage.tsx    # Tool page factory
│   │   │   ├── SEO.tsx         # SEO meta tags + prerender
│   │   │   ├── ResultCard.tsx  # Result display (aria-live)
│   │   │   ├── ErrorCard.tsx   # Error display (role="alert")
│   │   │   ├── LengthIndicator.tsx # Shared input length/format states
│   │   │   ├── ExampleButton.tsx # Context-preserving example loading
│   │   │   ├── ErrorBoundary.tsx # Error boundary
│   │   │   ├── ReloadPrompt.tsx # PWA update prompt (dark mode)
│   │   │   └── ...
│   │   ├── generic/            # General tool components
│   │   ├── keys/               # Key management components
│   │   ├── payment/            # Payment tool components
│   │   └── pki/                # PKI tool components
│   │
│   ├── hooks/                  # Custom hooks
│   │   ├── useLanguage.tsx     # Multi-language switching
│   │   ├── useTheme.tsx        # Theme switching
│   │   ├── useToolForm.ts      # Tool form hook
│   │   ├── useRecentTools.ts   # Recent tools and local favorites
│   │   └── ...
│   │
│   ├── data/                   # Tool metadata and examples
│   │   ├── examples.ts         # Non-production example values
│   │   ├── toolRelations.ts    # Related-tool workflow graph
│   │   └── toolGuidesMap.ts    # Tool-to-guide links
│   │
│   ├── locales/                # Translations (6 languages)
│   │   ├── en/                 # English
│   │   ├── zh/                 # Chinese
│   │   ├── ja/                 # Japanese
│   │   ├── ko/                 # Korean
│   │   ├── de/                 # German
│   │   └── fr/                 # French
│   │
│   ├── utils/                  # Utility functions
│   │   ├── analytics.ts        # Privacy-safe tool action events
│   │   ├── crypto.ts           # Core crypto utilities
│   │   ├── crypto.test.ts      # Crypto unit tests
│   │   ├── hex.ts              # Hex utilities
│   │   ├── hex.test.ts         # Hex unit tests
│   │   ├── logger.ts           # Production-safe logger
│   │   └── ...
│   │
│   ├── App.tsx                 # Root component + routes
│   ├── routeConfig.ts          # Route configuration
│   ├── routes.tsx              # Lazy-loaded page components
│   └── main.tsx                # Entry point
│
├── vitest.config.ts            # Test configuration
├── vite.config.ts              # Build configuration
├── tsconfig.json               # TypeScript config (strict mode)
└── package.json                # Dependencies

🚀 Início Rápido

Online

Visite https://hsmkit.com para usar todas as ferramentas diretamente.

Instalação PWA

Após visitar o site, seu navegador exibirá o prompt "Instalar HSM Kit". Clique para instalar na área de trabalho.

Desenvolvimento Local

# Clone repository
git clone https://github.com/hsm-kit/hsmkit.git
cd hsmkit

# Install dependencies
npm install

# Start development server
npm run dev
# Visit http://localhost:5173

Build para Produção

# Build (includes sitemap update + Puppeteer prerender + PWA Service Worker)
npm run build

# Preview production build
npm run preview

Quando uma versão altera a funcionalidade das páginas de ferramentas, atualize apenas as datas das 44 páginas de ferramentas sem reescrever as datas da página inicial, legais ou de guias:

node scripts/update-sitemap-lastmod.js --tools-date YYYY-MM-DD

Nota: O Chrome é necessário para o build. O script prebuild o instala automaticamente via npx puppeteer browsers install chrome.

Verificação de Tipos

# TypeScript type checking (strict mode)
npm run typecheck

# ESLint code checking
npm run lint

# ESLint auto-fix
npm run lint:fix

Testes

# Run all tests
npm test

# Smoke-test every generated tool and guide page
npm run test:pages

# Watch mode
npm run test:watch

# Test coverage
npm run test:coverage

🏗️ Pilha de Tecnologia

Tecnologia	Versão	Finalidade
React	19	Framework frontend
TypeScript	5.9	Segurança de tipos (modo estrito)
Vite (Rolldown)	7.2	Ferramenta de build
Ant Design	6	Biblioteca de componentes de UI
React Router	7	Roteamento
CryptoJS	4.2	Criptografia simétrica (AES/DES/3DES)
node-forge	1.3	RSA/ASN.1/X.509
elliptic	6.6	ECC/ECDSA
hash-wasm	4.12	Hash de alto desempenho (WASM)
react-markdown	10.x	Renderização Markdown
vite-plugin-pwa	1.3	Suporte PWA (Service Worker)
Vitest	4.x	Estrutura de testes unitários
@testing-library/react	16.x	Testes de componentes React

⚡ Desempenho

Otimização	Descrição
Carregamento Preguiçoso de Rotas	Todas as páginas usam `React.lazy()` para carregamento sob demanda
Divisão de Fornecedores	React / Ant Design / Crypto empacotados separadamente para cache
Pré-renderização SSG	Puppeteer gera HTML estático no momento do build
Reutilização de Hidratação	Usa `hydrateRoot` quando o HTML pré-renderizado existe
Cache PWA	Service Worker pré-armazena em cache mais de 210 recursos para uso offline
Cache de Longo Prazo	Ativos estáticos `max-age=31536000, immutable`

🔐 Segurança

Criptografia no Lado do Cliente - Todas as operações criptográficas são executadas no navegador usando Web Crypto API e crypto-js
Zero Transferência de Dados - Chaves e dados sensíveis nunca saem do seu dispositivo
Código Aberto - Todo o código é publicamente auditável
Pronto para Conformidade - Atende aos requisitos de segurança do setor financeiro
Proteção CSP - Content-Security-Policy previne ataques XSS
Registro em Produção - Logs de depuração silenciados em produção, apenas erros são registrados

♿ Acessibilidade

O HSM Kit segue os padrões WCAG 2.1 AA com suporte abrangente de acessibilidade:

Link Pular para o Conteúdo - Usuários de teclado podem pular rapidamente para o conteúdo principal
Rótulos ARIA - Navegação, botões e elementos de formulário têm rótulos aria adequados
Regiões aria-live - Resultados dinâmicos e erros são anunciados por leitores de tela
Navegação por Teclado - Todos os elementos interativos suportam Tab/Enter/Espaço
Gerenciamento de Foco - Indicadores de foco claros e ordem de foco lógica
HTML Semântico - Usa role="banner", role="main", role="alert" etc.

🌍 Internacionalização

O HSM Kit suporta 6 idiomas com cobertura de tradução de 100%:

Idioma	Código	Status
English	en	✅ 100%
简体中文	zh	✅ 100%
日本語	ja	✅ 100%
한국어	ko	✅ 100%
Deutsch	de	✅ 100%
Français	fr	✅ 100%

Os arquivos de tradução estão localizados em src/locales/ com carregamento preguiçoso para desempenho ideal.

🌍 Implantação

O HSM Kit pode ser implantado em qualquer serviço de hospedagem estática:

Plataforma	Arquivo de Configuração
Cloudflare Pages	`wrangler.json`, `public/_headers`, `public/_redirects`
Vercel	`vercel.json`
Netlify	`public/_redirects`

# The dist/ directory can be deployed directly after build
npm run build

Descoberta de Pesquisa

Defina BING_SITE_AUTH no ambiente de build com o valor de verificação fornecido pelo Bing Webmaster Tools.
Após o Cloudflare Pages concluir a implantação, abra o GitHub Actions → Submit URLs to IndexNow → Run workflow. Deixe a URL vazia para enviar o sitemap, ou insira uma URL alterada. O envio local permanece disponível via npm run submit:indexnow.
Recursos legíveis por IA são publicados em /llms.txt, /ai/tools.json e na URL index.md de cada guia.

🤝 Contribuindo

Sinta-se à vontade para enviar Issues e Pull Requests!

Faça um fork deste repositório
Crie um branch de recurso (git checkout -b feature/AmazingFeature)
Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
Envie para o branch (git push origin feature/AmazingFeature)
Envie um Pull Request

Adicionando Novos Artigos à Base de Conhecimento

Crie {slug}.md em src/content/guides/en/ (e zh/ para chinês)
Atualize src/data/guides/en.json e zh.json com metadados
Adicione rotas em prerender.config.ts
Adicione URL em public/sitemap.xml
Execute npm run build para verificar

📄 Licença

Licença MIT - Consulte o arquivo LICENSE

🔗 Links

⚠️ Nota: Esta ferramenta é destinada a ambientes de teste e desenvolvimento. Certifique-se de cumprir os padrões de segurança relevantes antes de usar em produção.

Feito com ❤️ pela Equipe HSM Kit