Repository navigation
v1.2.0
Overview
Tanuki v1.2.0 expands the tool into a proactive, dual-use observability and Non-Human Identity (NHI) validation platform.
Key Additions
1. Pre-Flight Diagnostic Health Check (tanuki doctor)
- Runs in under 5 milliseconds with zero network packet emission.
- Verifies keytab permissions (
0600vs world-readable0644), realm uppercase consistency in/etc/krb5.conf, SSSD daemon socket status, and credential cache ticket lifetimes across file caches and Linux kernel keyrings (KEYRING:persistent:). - Supports human terminal output and structured
--jsonschema.
2. Dual-Use SOC Detection Telemetry
- Pairs tactical actions with defender detection rules: Auditd watch rules (
-w /etc/krb5.keytab -p r -k keytab_read), Windows Security Event IDs (4768, 4769, 4771), and Sigma/Falco signatures. - Terminal output displays
[BLUE TELEMETRY]alongside[TACTICAL CMD].
3. Non-Human Identity Token Exchange Validator (RFC 8693)
- Validates cloud workload JWT claims (Kubernetes ServiceAccount, AWS IAM Roles Anywhere, SPIFFE SVIDs) undergoing RFC 8693 OAuth 2.0 token exchange to Active Directory Kerberos tickets.
- Flags insecure wildcard audiences (
aud: "*") and non-ephemeral expiration lifetimes without external network dependencies.
4. Architecture & Documentation
- Native GitHub Mermaid architecture flowchart (
flowchart TD) and subsystem directory map. - Distroless/slim multi-stage Dockerfile and automated GitHub Actions workflow for container publishing to GitHub Container Registry (GHCR).
5. Empirical Verification
- 310 automated tests passing with 100% success rate across unit tests, pairwise matrices, and Tier 5 adversarial binary fuzzing.
Assets Attached
tanuki-1.2.0-py3-none-any.whl: Standard Python wheel.tanuki-1.2.0.tar.gz: Source distribution.
Installation
# Standard Python package
pip install tanuki-1.2.0-py3-none-any.whl
# Or install from source
pip install .
# 1-line installer (POSIX)
curl -sSL https://raw.githubusercontent.com/Mafifrizi/tanuki/main/install.sh | bash
# 1-line installer (Windows)
irm https://raw.githubusercontent.com/Mafifrizi/tanuki/main/install.ps1 | iexLineage & Pioneer Attributions
- Tim Brown (
@timb-machine): Linikatz pioneer. - Dietrich Gebert (
@dietrichayala): Ponytail methodology pioneer.