fanger

fanger is an npm package for defang and refang IoC.

What are defang and refang

Defang means to change a part of IoC to make inaccessible or unclickable. (e.g. example.com => example[.]com)

Refang means to revert a defanged IoC to the original one. (e.g. example[.]com => example.com)

Installation

npm install fanger -g

Usage

As a CLI

$ echo "example.com" | defang
example[.]com

$ echo "test@example.com" | defang
test@example[.]com

$ echo "https://example.com" | defang
hxxps://example[.]com

$ echo "example[.]com" | refang
example.com

$ echo "test@example[.]com" | refang
test@example.com

$ echo "hxxps://example[.]com" | refang
https://example.com

As a library

import { defang, refang } from "fanger";

const text = "example.com";
console.log(defang(text));
// example[.]com

const defangedText = "example[.]com";
console.log(refang(defangedText));
// example.com

Supported defang/refang techniques

Defang

The following defang techniques are supported.

IPv4

1.1.1.1 => 1[.]1.1.1

The first dot of an IPv4 will be replaced with [.].

Domain

example.com => example[.]com
test.com.example.com => test[.]com.example[.]com

A dot before a label which is registered as a TLD will be replaced with [.].

HTTP scheme

http => hxxp
https => hxxps

Supported refang techniques

The following refang techniques are supported.

Techniques	Defanged	Refanged
Remove spaces	`1.1.1 . 1`	`1.1.1.1`
`[.]` => `.`	`1.1.1[.]1`	`1.1.1.1`
`(.)` => `.`	`1.1.1(.)1`	`1.1.1.1`
`{.}` => `.`	`1.1.1{.}1`	`1.1.1.1`
`\.` => `.`	`example\.com`	`example.com`
`[/]` => `/`	`http://example.com[/]path`	`http://example.com/path`
`[:]` => `:`	`http[:]//example.com`	`http://example.com`
`[://]` => `://`	`http[://]example.com`	`http://example.com`
`hxxp` => `http`	`hxxps://google.com`	`https://google.com`
`[at]` => `@`	`test[at]example.com`	`test@example.com`
`[@]` => `@`	`test[@]example.com`	`test@example.com`
`(@)` => `@`	`test(@)example.com`	`test@example.com`
`[dot]` => `.`	`test@example[dot]com`	`test@example.com`
`(dot)` => `.`	`test@example(dot)com`	`test@example.com`
`{dot}` => `.`	`test@example{dot}com`	`test@example.com`
Partial	`1.1.1[.1`	`1.1.1.1`
Any combination	`hxxps[:]//test\.example[.)com[/]path`	`https://test.example.com/path`