1 | =head1 NAME |
1 | =head1 NAME |
2 | |
2 | |
3 | AnyEvent::Porttracker - Porttracker/PortIQ API client interface. |
3 | AnyEvent::Porttracker - Porttracker API client interface. |
4 | |
4 | |
5 | =head1 SYNOPSIS |
5 | =head1 SYNOPSIS |
6 | |
6 | |
7 | use AnyEvent::Porttracker; |
7 | use AnyEvent::Porttracker; |
8 | |
8 | |
… | |
… | |
67 | other things) scans switches and routers in a network and gives a coherent |
67 | other things) scans switches and routers in a network and gives a coherent |
68 | view of which end devices are connected to which switch ports on which |
68 | view of which end devices are connected to which switch ports on which |
69 | switches and routers. It also offers a JSON-based client API, for which |
69 | switches and routers. It also offers a JSON-based client API, for which |
70 | this module is an implementation. |
70 | this module is an implementation. |
71 | |
71 | |
72 | In addition to Porttracker, the PortIQ product is also supported, as it |
|
|
73 | uses the same protocol. |
|
|
74 | |
|
|
75 | If you do not have access to either a Porttracker or PortIQ box then this |
72 | If you do not have access to a Porttracker box then this module will be of |
76 | module will be of little value to you. |
73 | little value to you. |
77 | |
74 | |
78 | This module is an L<AnyEvent> user, you need to make sure that you use and |
75 | This module is an L<AnyEvent> user, you need to make sure that you use and |
79 | run a supported event loop. |
76 | run a supported event loop. |
80 | |
77 | |
81 | To quickly understand how this module works you should read how to |
78 | To quickly understand how this module works you should read how to |
… | |
… | |
155 | |
152 | |
156 | Enables or disables TLS (default: disables). When enabled, then the |
153 | Enables or disables TLS (default: disables). When enabled, then the |
157 | connection will try to handshake a TLS connection before logging in. If |
154 | connection will try to handshake a TLS connection before logging in. If |
158 | unsuccessful a fatal error will be raised. |
155 | unsuccessful a fatal error will be raised. |
159 | |
156 | |
160 | Since most Porttracker/PortIQ boxes will not have a sensible/verifiable |
157 | Since most Porttracker boxes will not have a sensible/verifiable |
161 | certificate, no attempt at verifying it will be done (which means |
158 | certificate, no attempt at verifying it will be done (which means |
162 | man-in-the-middle-attacks will be trivial). If you want some form of |
159 | man-in-the-middle-attacks will be trivial). If you want some form of |
163 | verification you need to provide your own C<tls_ctx> object with C<< |
160 | verification you need to provide your own C<tls_ctx> object with C<< |
164 | verify => 1, verify_peername => [1, 1, 1] >> or whatever verification mode |
161 | verify => 1, verify_peername => [1, 1, 1] >> or whatever verification mode |
165 | you wish to use. |
162 | you wish to use. |
… | |
… | |
586 | |
583 | |
587 | =back |
584 | =back |
588 | |
585 | |
589 | =head1 SEE ALSO |
586 | =head1 SEE ALSO |
590 | |
587 | |
591 | L<AnyEvent>, L<http://www.porttracker.com/>, L<http://www.infoblox.com/en/products/portiq.html>. |
588 | L<AnyEvent>, L<http://www.porttracker.com/>. |
592 | |
589 | |
593 | =head1 AUTHOR |
590 | =head1 AUTHOR |
594 | |
591 | |
595 | Marc Lehmann <marc@nethype.de> |
592 | Marc Lehmann <marc@nethype.de> |
596 | |
593 | |