aidputils.agents.tools.http.audit_logger

Audit Logger for HTTP Tool.

Provides structured audit logging with: - Request ID tracking (opc_request_id) - Timestamp logging (start, end, elapsed_ms) - Request/response metadata logging - Credential masking for sensitive headers

aidputils.agents.tools.http.audit_logger.generate_request_id() → str

Generate a unique request ID for tracking.

Returns:

UUID string for request tracking

aidputils.agents.tools.http.audit_logger.is_sensitive_header(header_name: str) → bool

Check if a header name is sensitive and should be masked.

Parameters:

header_name – The header name to check

Returns:

True if the header is sensitive

aidputils.agents.tools.http.audit_logger.mask_headers(headers: Dict[str, str]) → Dict[str, str]

Mask sensitive headers for logging.

Parameters:

headers – Original headers dict

Returns:

New headers dict with sensitive values masked

aidputils.agents.tools.http.audit_logger.mask_url_credentials(url: str) → str

Mask any credentials embedded in a URL.

Parameters:

url – URL that may contain embedded credentials

Returns:

URL with credentials masked

class aidputils.agents.tools.http.audit_logger.AuditContext(method: str, url: str, headers: Dict[str, str] | None = None)

Bases: object

Context manager for audit logging of HTTP requests.

set_response(status_code: int)

Set the response status code for logging.

property elapsed_ms: float | None

Get elapsed time in milliseconds (primary timing unit).

property elapsed_seconds: float | None

Get elapsed time in seconds (derived from milliseconds).

to_dict() → Dict[str, Any]

Convert audit context to dictionary for structured logging.

Returns:

Dict with all audit fields