summaryrefslogtreecommitdiffstats
path: root/shodan/README.md
blob: 496c9d1f5a33ff370babe60409bae60497c61e08 (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
[shodan]
========

Create a Shodan container that's ready to roll.

Requirements
------------

This work has been developed and tested on Fedora with podman/buildah Fedora (latest) was chosen as it meets all required dependencies.

Prerequisites
-------------

The following steps are required ONCE (on the machine the container runs) prior to building and running the container:

- export SHODANAPIKEY=(insert api key id used for upload here)
- podman secret create --env shodanapikey SHODANAPIKEY

Instructions for use
--------------------

Building:

```
cd shodan
buildah bud -t shodan . && podman image prune -f
```
Running:

```
podman run -it --secret source=shodanapikey,type=env --rm shodan
```

Another tool that comes with it is icon.py to murmur hash a website's favourite icon.

License
-------

GPLv3

Author Information
------------------

Timo Trinks, ttrinks@fedoraproject.org

Acknowledgements
------------------

N/A