meshcore-packet-capture/auth_token.py

#!/usr/bin/env python3
"""
MeshCore Auth Token Generator
Generates JWT-style authentication tokens for MQTT authentication
"""
import json
import base64
import hashlib
import hmac
import time
import subprocess
import sys
import shutil
import platform

def base64url_encode(data: bytes) -> str:
    """Base64url encode without padding"""
    return base64.urlsafe_b64encode(data).rstrip(b'=').decode('utf-8')

def _find_meshcore_decoder():
    """
    Find the meshcore-decoder executable with proper platform handling.
    
    Returns:
        str: Path to meshcore-decoder executable, or None if not found
    """
    # Try to find meshcore-decoder in PATH
    decoder_path = shutil.which('meshcore-decoder')
    if decoder_path:
        return decoder_path
    
    # On Windows, also try with .cmd extension
    if platform.system().lower() == 'windows':
        decoder_path = shutil.which('meshcore-decoder.cmd')
        if decoder_path:
            return decoder_path
        
        # Try with .exe extension
        decoder_path = shutil.which('meshcore-decoder.exe')
        if decoder_path:
            return decoder_path
    
    return None

def create_auth_token(public_key_hex: str, private_key_hex: str, expiry_seconds: int = 86400, **claims) -> str:
    """
    Create a JWT-style auth token for MeshCore MQTT authentication
    
    Requires the meshcore-decoder CLI tool to be installed and available in PATH.
    
    Args:
        public_key_hex: 32-byte public key in hex format
        private_key_hex: 64-byte private key in hex format (MeshCore format)
        expiry_seconds: Token expiry time in seconds (default 24 hours)
        **claims: Additional JWT claims (e.g., audience="mqtt.example.com", sub="device-123")
    
    Returns:
        JWT-style token string
    
    Raises:
        FileNotFoundError: If meshcore-decoder is not found in PATH
        Exception: If token generation fails
    """
    # Find the meshcore-decoder executable with proper platform handling
    decoder_cmd = _find_meshcore_decoder()
    if not decoder_cmd:
        raise FileNotFoundError(
            "meshcore-decoder not found in PATH. "
            "Please install meshcore-decoder to generate JWTs for sign-in. "
            "The meshcore-decoder tool is required for JWT token generation."
        )
    
    try:
        cmd = [decoder_cmd, 'auth-token', public_key_hex, private_key_hex, '-e', str(expiry_seconds)]
        
        if claims:
            claims_json = json.dumps(claims)
            cmd.extend(['-c', claims_json])
        
        result = subprocess.run(
            cmd,
            capture_output=True,
            text=True,
            timeout=10
        )
        
        if result.returncode != 0:
            raise Exception(
                f"meshcore-decoder error (exit code {result.returncode}): {result.stderr}. "
                "Please ensure meshcore-decoder is properly installed and configured."
            )
        
        token = result.stdout.strip()
        if not token or token.count('.') != 2:
            raise Exception(f"Invalid token format: {token}")
        
        return token
        
    except subprocess.TimeoutExpired:
        raise Exception(
            "Token generation timed out. "
            "Please ensure meshcore-decoder is working correctly."
        )
    except Exception as e:
        raise Exception(
            f"Failed to generate auth token: {str(e)}. "
            "Please ensure meshcore-decoder is installed and available in PATH."
        )


def read_private_key_file(filepath: str) -> str:
    """Read private key from file (64-byte hex format)"""
    try:
        with open(filepath, 'r') as f:
            key = f.read().strip()
            key = ''.join(key.split())
            if len(key) != 128:  # 64 bytes = 128 hex chars
                raise ValueError(f"Invalid private key length: {len(key)} (expected 128)")
            int(key, 16)
            return key
    except FileNotFoundError:
        raise Exception(f"Private key file not found: {filepath}")
    except ValueError as e:
        raise Exception(f"Invalid private key format: {str(e)}")


if __name__ == "__main__":
    # Test/CLI usage
    if len(sys.argv) < 3:
        print("Usage: python auth_token.py <public_key_hex> <private_key_hex_or_file>")
        sys.exit(1)
    
    public_key = sys.argv[1]
    private_key_input = sys.argv[2]
    
    if len(private_key_input) < 128:
        try:
            private_key = read_private_key_file(private_key_input)
            print(f"Loaded private key from: {private_key_input}")
        except Exception as e:
            print(f"Error: {e}")
            sys.exit(1)
    else:
        private_key = private_key_input
    
    try:
        token = create_auth_token(public_key, private_key)
        print(f"Generated token: {token}")
    except Exception as e:
        print(f"Error: {e}")
        sys.exit(1)