c/ooni-probe-cli
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
8f7e3803eb
ooni-probe-cli/internal/engine/netx
History
Simone Basso 8f7e3803eb
feat(netxlite): implement DNSTransport wrapping (#776) 
Acknowledge that transports MAY be used in isolation (i.e., outside
of a Resolver) and add support for wrapping.

Ensure that every factory that creates an unwrapped type is named
accordingly to hopefully ensure there are no surprises.

Implement DNSTransport wrapping and use a technique similar to the
one used by Dialer to customize the DNSTransport while constructing
more complex data types (e.g., a specific resolver).

Ensure that the stdlib resolver's own "getaddrinfo" transport (1)
is wrapped and (2) could be extended during construction.

This work is part of my ongoing effort to bring to this repository
websteps-illustrated changes relative to netxlite.

Ref issue: https://github.com/ooni/probe/issues/2096
2022-06-01 11:10:08 +02:00
..
dialer refactor(netxlite): better integration with tracex (#774) 2022-06-01 08:31:20 +02:00
httptransport refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
resolver feat(netxlite): implement DNSTransport wrapping (#776) 2022-06-01 11:10:08 +02:00
tlsdialer refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
tracex refactor(netxlite): better integration with tracex (#774) 2022-06-01 08:31:20 +02:00
fake_test.go cleanup: remove unnecessary legacy interfaces (#656) 2022-01-07 18:33:37 +01:00
integration_test.go refactor(netx): merge archival, trace, and the savers (#772) 2022-05-31 21:53:01 +02:00
netx_internal_test.go chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00
netx_test.go refactor(netxlite): introduce the getaddrinfo transport (#775) 2022-06-01 09:59:44 +02:00
netx.go feat(netxlite): implement DNSTransport wrapping (#776) 2022-06-01 11:10:08 +02:00
README.md chore: merge probe-engine into probe-cli (#201) 2021-02-02 12:05:47 +01:00

README.md

Package github.com/ooni/probe-engine/netx

OONI extensions to the net and net/http packages. This code is used by ooni/probe-engine as a low level library to collect network, DNS, and HTTP events occurring during OONI measurements.

This library contains replacements for commonly used standard library interfaces that facilitate seamless network measurements. By using such replacements, as opposed to standard library interfaces, we can:

  • save the timing of HTTP events (e.g. received response headers)
  • save the timing and result of every Connect, Read, Write, Close operation
  • save the timing and result of the TLS handshake (including certificates)

By default, this library uses the system resolver. In addition, it is possible to configure alternative DNS transports and remote servers. We support DNS over UDP, DNS over TCP, DNS over TLS (DoT), and DNS over HTTPS (DoH). When using an alternative transport, we are also able to intercept and save DNS messages, as well as any other interaction with the remote server (e.g., the result of the TLS handshake for DoT and DoH).

This package is a fork of github.com/ooni/netx.