Internet-Draft | A Standard for Safe and Reversible Shari | April 2025 |
Grimminck | Expires 11 October 2025 | [Page] |
This document defines a consistent and reversible method for sharing potentially malicious indicators of compromise (IOCs), such as URLs, IP addresses, email addresses, and domain names. It introduces a safe obfuscation format to prevent accidental execution or activation when IOCs are displayed or transmitted. These techniques aim to standardize the safe dissemination of threat intelligence data. This specification uses the URI syntax defined in RFC 3986 and follows the key word conventions from RFC 2119.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 11 October 2025.¶
Copyright (c) 2025 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
The secure sharing of malicious artifacts is vital to threat intelligence, open-source intelligence (OSINT), and incident response efforts. However, sharing raw URLs, IP addresses, and email addresses associated with malware or threat actors poses a risk of accidental activation.¶
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “NOT RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
This document defines a clear and reversible method for obfuscating and de-obfuscating IOCs to support safe sharing across various platforms, formats, and use cases. The requirements language (e.g., "MUST", "SHOULD") follows [RFC2119], and URI syntax adheres to [RFC3986].¶
Obfuscating: The process of altering an indicator so that it cannot be accidentally activated or clicked. This was previously referred to as "defanging".¶
De-obfuscating: The process of restoring an obfuscated indicator to its original, actionable form. This was previously referred to as "refanging".¶
IOC: Indicator of Compromise - data such as a URL, IP address, domain name, email address, or hash associated with malicious activity.¶
Inconsistent obfuscation practices hinder the reliable and automated exchange of threat intelligence. For example:¶
Such inconsistencies reduce the effectiveness of threat detection and response.¶
The following transformations MUST be consistently applied:¶
Using encoded characters (such as %2e for ".") SHOULD be avoided to prevent ambiguity.¶
Examples:¶
Note: Credentials in URIs (e.g., username:password) are included here for illustrative purposes only. Sharing credentials, even in obfuscated form, is strongly discouraged in operational contexts.¶
Note: IPv6 addresses enclosed in square brackets MUST retain their colon-based syntax (e.g., "::") and brackets. These characters are essential to URI parsing and MUST NOT be altered. Obfuscation should apply only to components such as the scheme ("http") or domains, not to the IPv6 address syntax.¶
Tools designed to ingest obfuscated data SHOULD automatically reverse these transformations in a deterministic manner:¶
De-obfuscation MUST maintain the original semantics of the data to avoid misinterpretation. Examples:¶
Common scenarios include:¶
While these obfuscation techniques reduce the risk of accidental activation of malicious indicators, obfuscated data SHOULD always be handled with caution.¶
Repeated application of obfuscation without proper context or normalization MAY result in ambiguous or non-reversible transformations. Implementations SHOULD avoid multiple layers of obfuscation without canonicalization.¶
Software designed to parse threat intelligence feeds should explicitly support these obfuscation and de-obfuscation standards. Implementations SHOULD verify correct de-obfuscation through unit tests and validation scripts. Example test case:¶
Test Input: "hxxp://192[.]0[.]2[.]1" Expected Output: "http://192.0.2.1"¶
**Internationalized Domain Names (IDNs)**: Obfuscate punycode domains similarly (e.g., "xn--example[.]com").¶
**Non-Standard URI Schemes**: For schemes like "ftp", apply analogous obfuscation (e.g., "fxp://example[.]com").¶
**IPv6 Literals in URIs**: Do not alter colon characters (":") or brackets ("[", "]") in IPv6 addresses. For example, "[2001:db8::1]" MUST remain unchanged. Only scheme names or domain elements surrounding them should be obfuscated.¶
This document has no IANA actions.¶