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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
____ _
_ __ ___ ___ _ _|___ \ __ _ _ __ ___ _ __ ___| |_
| '_ \ / _ \/ _ \ '__|__) / _` | '_ \ / _ \| '_ \ / _ \ __|
| |_) | __/ __/ | / __/ (_| | | | | (_) | | | | __/ |_
| .__/ \___|\___|_| |_____\__,_|_| |_|\___/|_| |_|\___|\__|
|_|
SYNOPSIS:
# Interactive prompt:
peer2anonet
# Accept pipe from file:
peer2anonet < autoconfig.txt
# Accept netcat pipe:
nc -l 1337 | peer2anonet
# Send a netcat pipe:
nc 192.168.1.0 1337 < autoconfig.txt
DESCRIPTION:
peer2anonet is an autoconfiguration utility to easily establish a
peering session with BGP on anonet2.
LICENSE:
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
DEPENDS ON:
quicktun, bird, daemontools(non-deb), bash
INSTALL AND UNINSTALL:
******************************************************************
* PEER2ANONET CAN AND WILL OVERWRITE /service AND /services, TO *
* INCLUDE FILES WITHIN THOSE DIRECTORIES. PLEASE CREATE BACKUPS *
* BEFORE INSTALLING AND USING PEER2ANONET AT ANY TIME! *
******************************************************************
To install, `cd' to the extracted peer2anonet folder.
Issue the following commands as root:
make install
To uninstall peer2anonet, as root do:
make uninstall
To compile/install a .deb package, as root do:
make install-deb
USAGE:
You may execute peer2anonet and answer configuration questions
via interface or pipe a file containing the new peering
session's specifications to the executable. peer2anonet has
some security checks but it is highly recommended you check
a autoconfig file manually before using to prevent malicious
attacks. An autoconfig file should be in the following format:
Plain text file, one block of data per line, no spaces, and
without including the following '<-- comments'.
================== Not Actual Line on File ============================
anon <--your peer's alias
11.22.33.44 <--your peer's remote ip
3.5.7.9 <--your peer's anonet ip
3570 <--your peer's asn
3c6e0b8a9c15224a8228b9a98ca1531d <--your peer's public key
================== Not Actual Line on File ============================
At your discretion, you may exclude the public key from the
bottom of an autoconfig file and post installation of your new
peer service, peer2anonet will prompt for it. PLEASE NOTE:
peer2anonet will set client ports for peering as:
#REMOTE:
2<last four of your asn>.
#LOCAL:
2<last four of your peer's asn>.
If you need to change the ports, go to:
/services/$PEERNAME/run and change the values.
CHANGES:
Sat Jul 9 06:48:58 CDT 2011 - d3v1150m471c
* quicktun's "EXPORT DEBUG=1" removed on peering script.
* some variables removed, info now passed directly to files.
* peering.in removed. info passed directly to peering and
then given executable status. Corresponding makefile
was also removed.
* Public key question corrected.
* daemontools non-deb specified in README.
* trimmed off unnecessary tests.
* bash added to dependencies
* file tests with mkdir changed to `mkdir -p`... .
* peering file removed, passes directly to run file now.
Sun Jul 10 05:47:22 CDT 2011 - d3v1150m471c
* makefile changed to Makefile
* parse quicktun.keypair</dev/random directly to seckey variable.
* removed y/n questions with file tests and automatic
configuration.
* README file updated
* ported for autoconfig file pipes
* some security checks created
Sun Jul 10 07:25:42 CDT 2011 - d3v1150m471c
* security checks, whitespace removed after some data
Sun Jul 10 08:13:17 CDT 2011 - d3v1150m471c
* security checks changed to check acceptable data and exits
showing offending info for violating data detections.
* security checks more specific
Sun Jul 10 17:04:36 CDT 2011 - d3v1150m471c
* security check and key bugs patched.
Sun Jul 10 18:50:31 CDT 2011 - d3v1150m471c
* public key prompt altered to avoid complications.
Sun Jul 10 22:01:12 CDT 2011 - d3v1150m471c
* key inputs changed. peer2anonet no longer generates
key pairs so they can be manually created prior to
using peer2anonet, for expedience.
Wed Jul 13 04:17:03 CDT 2011 - d3v1150m471c
* added env variables that are configured on installation
* uses env variables for certain settings to uncomplicate the
peering process. A peer now only needs to send you pertinent
data pertaining to his/her system in order for you to
configure a new peering session, or vice versa.
Thu Jul 14 09:09:07 CDT 2011 - d3v1150m471c
* client local/remote ports simplified using peers' asn's.
see above for details.
|
