summaryrefslogtreecommitdiff
path: root/README.md
blob: e360e35d3f0056880966974a230afe4e0ed45294 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
# mod_ip

Apache module to report IP address to web clients as a JSON response

## Description

This module reports the IP the user came from, as a JSONP response.
GET requests required; CGI style arguments are permitted.

| argument           | description                                             |
|--------------------|---------------------------------------------------------|
| `callback=[name]`  | to call a function name of your choosing                |
| `size=[number]`    | to pad the http data portion of the response.  (Does not attempt to offset header response) |
| `asn=1`            | peform ISP ASN and name lookups                         |
| `testip=IPADDRESS` | to override the IP address, force it to look up another |

If the callback is "?", it will output to the screen (calling it "callback"),
using plain text.  Any other name, will output a JSON script instead,
using the callback name specified.

Example:

`http://test-ipv6.com/ip/?callback=hello&testip=2001:470:1:18::2&asn=1`

Returns:

`hello({"ip":"2001:470:1:18::2","type":"ipv6","subtype":"","via":"","asn":"6939","asn_name":"HURRICANE - Hurricane Electric, Inc.","asnlist":"6939","padding":""})`

# Installation

```Bash
./configure
make
sudo make install   
```

# Activation 

Something like this should be in your web server config; it should have been
placed there automatically with `make install`.  The apache build system
would have taken care of that for you.  Some platforms, however, do not (such
as ubuntu), so you'll need to double check.

```ApacheConfig
LoadModule mod_ip_module      libexec/apache22/mod_ip.so
```

# Configuration

Even on platforms were activation was automatic, configuration was not.
You'll need to explicitly enable mod_ip for the paths you want it in.

 * If you're installing falling-sky, go back to the install instructions.
 * If you're installing mod_ip for another project, do something like this:



```ApacheConfig
    <VirtualHost test-ipv6.com>
    ..

    # Set /ip/  to use mod_ip
    <LocationMatch ^/ip/?$>
     SetHandler mod_ip
    </locationMatch>

    # You may optionally include the output of ./scan-sixxs.pl here
    ..
    </VirtualHost>
````