IDN and Punycode checks before proxy connections

Core idea

An internationalized name can display as Unicode while DNS uses an ASCII A-label. Conversion, allowed code points, and browser display policy matter; visually similar text can identify another domain.

Start IDN and Punycode checks before proxy connections with a threat model: what data needs protection, from whom, and on which link. Proxy credentials control access, TLS protects origin traffic, and an IP allowlist narrows the source network. These controls complement one another but do not make an unsafe workflow safe by themselves.

What the primary source establishes

Map Unicode display to ASCII labels, detect confusables, and verify DNS, CONNECT, and certificate identity for one name.

The primary source, RFC 5890 — IDNA Definitions, RFC 5891 — IDNA Protocol, RFC 5892 — IDNA Code Points, RFC 3492 — Punycode, Unicode UTS #46, defines the technical baseline but not every client and provider configuration. Read the normative behavior with its version and then verify your implementation. Treat anything beyond the source as a product feature that needs separate confirmation.

Controlled lab

Build cases for an owned IDN, A-label, mixed case, trailing dot, and an unregistered confusable control. Accept the intended canonical host, reject invalid input, and display both forms. Proxy and TLS evidence must refer to that same host.

Step-by-step verification

Use an owned test IDN with a known ASCII label. Round-trip Unicode and ASCII in one library, then compare URL parsing, DNS, CONNECT authority, SNI, and certificate SAN.

Use a test account and an authorized endpoint. Issue short-lived, least-privilege credentials and define revocation before the run. Verify normal access, rejection with a bad secret, and rejection from an unapproved source. Error messages must remain distinct without echoing credentials.

Inspect application logs, command history, HAR files, and support output. A connection string may leak through a URL, process arguments, terminal history, or screenshots. Rotate temporary credentials and remove sensitive test artifacts after verification.

• Obtain a known A-label
• Round-trip both forms
• Compare DNS, CONNECT, and SNI
• Reject a confusable control

Evidence to retain

Record safe input, Unicode code points, A-label, normalized URL, DNS qname, CONNECT authority, SNI, SAN, and parser version.

A security report stores the check ID, time, result, and policy, never a password, cookie, token, secret URL, or reusable browser state. Record that credentials changed rather than storing the old and new values. Evidence should prove the control without becoming another secret store.

Define report columns and time format before the run. A result without context becomes a guess: the address, cache state, and changed condition are unknown. Record controlled failures as well as successes so the check proves that it can distinguish states.

Interpreting the result

Logs and allowlists should retain canonical values beside safe display text. Never authorize a host by visual comparison or mix percent decoding with IDNA conversion.

UTS #46 compatibility processing and strict IDNA are not identical. Browser display policies evolve, and Punycode does not prove owner trust.

One successful run confirms only one client, route, and moment. Repeat while changing one variable and state the limits. When observation conflicts with documentation, rule out cache, client version, and intermediaries before creating a reproducible support case.

Worked decision process

Build an access register for IDN and Punycode checks before proxy connections with owner, purpose, expiry, allowed network, and revocation path. Shared credentials prevent selective revocation and useful audit. Issue replacement access, verify one safe request, and then revoke the old secret.

Run negative checks after successful access: old credentials, an unapproved source IP, and an invalid destination. Confirm rejection at the intended stage without echoing a secret. Inspect browser history, process output, CI logs, and support attachments for complete connection strings.

Review active access on a schedule. Match each record to an owner and task, remove orphaned entries, and give exceptions an owner and deadline. The review result is a list of retained, revoked, and time-bounded exceptions rather than a checkbox.

Common mistakes

Disabling certificate validation, sharing one team password, allowing a broad CIDR, and pasting proxy URLs into chat are recurring failures. Restore validation, create scoped credentials, narrow the source range, and verify that old access has actually been revoked.

Stop when errors rise, a source returns a limit, the task would require bypassing protection, or secrets enter logs. Save sanitized diagnostics and correct the cause first. More concurrency or another IP can hide the fault and add load without improving evidence.

Rollout and maintenance criteria

Define the decision boundary before rollout: which observation permits continuation, which requires review, and which stops the workflow. Record acceptable error ratio, maximum wait, and the owner of every exception so a temporary failure cannot silently become permanent configuration.

Review real load, cost, and quality after the first week. Schedule a small control after client, proxy-service, or network changes. Archive outdated instructions with their replacement date and reason so operators do not follow conflicting configurations.

Operational checklist

Turn the successful experiment into a short procedure covering owner, safe configuration, limits, and stop conditions. Every run needs a terminal status. After browser, library, or network changes, run a small control before the main queue.

• Assets and threat are defined
• Test access is isolated
• TLS validation remains on
• Logs were checked for leaks
• Revocation is documented
• Negative cases were tested