Skip to content

v1.2.0

Choose a tag to compare

@Mafifrizi Mafifrizi released this 03 Oct 13:44
· 154 commits to main since this release

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 (0600 vs world-readable 0644), 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 --json schema.

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 | iex

Lineage & Pioneer Attributions

  • Tim Brown (@timb-machine): Linikatz pioneer.
  • Dietrich Gebert (@dietrichayala): Ponytail methodology pioneer.