ooni/probe-legacyA versão legada em Python do OONI Probe.
⚠️⚠️⚠️⚠️: este repositório contém o código fonte da implementação legada do ooniprobe. Por favor, confira em vez disso:
https://github.com/ooni/probe, o meta-repositório onde você deve abrir issues e solicitações de funcionalidades;
https://github.com/ooni/probe-cli, que contém a nova implementação do ooniprobe como um cliente de linha de comando escrito em Go;
https://github.com/ooni/probe-desktop, que contém a aplicação desktop ooniprobe, escrita em JavaScript e Electron.
Obrigado pelo seu interesse no OONI!
O restante deste arquivo contém o README.rst original para a implementação legada:
.. image:: https://travis-ci.org/TheTorProject/ooni-probe.png?branch=master :target: https://travis-ci.org/TheTorProject/ooni-probe
.. image:: https://coveralls.io/repos/TheTorProject/ooni-probe/badge.png :target: https://coveralls.io/r/TheTorProject/ooni-probe
.. image:: https://slack.openobservatory.org/badge.svg :target: https://slack.openobservatory.org/badge.svg
.. image:: https://ooni.torproject.org/images/ooni-header-mascot.png :target: https:://ooni.torproject.org/
OONI, o Observatório Aberto de Interferência de Rede, é uma rede global de observação cujo objetivo é coletar dados de alta qualidade usando metodologias abertas, utilizando Software Livre e de Código Aberto (FL/OSS) para compartilhar observações e dados sobre os vários tipos, métodos e quantidades de adulteração de rede no mundo.
"A Net interpreta censura como dano e contorna-o."
- John Gilmore; revista TIME (6 de dezembro de 1993)
ooniprobe é o primeiro programa que os usuários executam para testar sua rede e coletar dados para o projeto OONI. Você está interessado em testar sua rede em busca de sinais de vigilância e censura? Deseja coletar dados para compartilhar com outros, para que você e outros possam entender melhor sua rede? Se sim, leia este documento e esperamos que ooniprobe o ajude a reunir dados de rede que auxiliarão em seus esforços!
Executar ooniprobe é uma atividade potencialmente arriscada. Isso depende muito da jurisdição em que você se encontra e de qual teste está executando. É tecnicamente possível que uma pessoa observando sua conexão com a internet saiba que você está executando o ooniprobe. Isso significa que, se a execução de testes de medição de rede for considerada ilegal em seu país, você poderá ser identificado.
Além disso, ooniprobe não toma precauções para proteger a máquina alvo da instalação de análises forenses. Se o fato de você ter instalado ou usado o ooniprobe for uma responsabilidade para você, esteja ciente desse risco.
A versão mais recente do ooniprobe para versões Debian e Ubuntu pode ser encontrada no repositório de pacotes deb.torproject.org.
No Debian stable (jessie)::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org jessie main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
No Debian testing::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org testing main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
No Debian unstable::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org unstable main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
No Ubuntu 16.10 (yakkety), 16.04 (xenial) ou 14.04 (trusty)::
curl https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --import
gpg --export A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89 | sudo apt-key add -
echo 'deb http://deb.torproject.org/torproject.org $RELEASE main' | sudo tee /etc/apt/sources.list.d/ooniprobe.list
sudo apt-get update
sudo apt-get install ooniprobe deb.torproject.org-keyring
Nota: Você precisará substituir $RELEASE por yakkety, xenial ou
trusty. Isso não acontecerá automaticamente. Você também precisará garantir
que o repositório universe esteja ativado. O repositório universe
está ativado por padrão em uma instalação padrão do Ubuntu, mas pode não estar em
instalações mínimas ou não padrão.
Você pode instalar o ooniprobe no macOS se tiver o homebrew instalado (http://brew.sh/) com::
brew install ooniprobe
Certifique-se de ter instalado as seguintes dependências:
Dependências opcionais:
Em sistemas baseados em Debian, isso geralmente pode ser feito executando::
sudo apt-get install -y build-essential libdumbnet-dev libpcap-dev libgeoip-dev libffi-dev python-dev python-pip tor libssl-dev obfs4proxy
Então você deve conseguir instalar o ooniprobe executando::
sudo pip install ooniprobe
ou instalar o ooniprobe como usuário::
pip install ooniprobe
Teste de rede é um conjunto de medições para avaliar que tipo de censura de internet está ocorrendo.
Decks são coleções de nettests do ooniprobe com algumas entradas associadas.
Coletor é um serviço usado para reportar os resultados das medições.
Auxiliar de teste é um serviço usado por uma sonda para realizar com sucesso suas medições.
Bouncer é um serviço usado para descobrir os endereços dos auxiliares de teste e coletores.
Após instalar com sucesso o ooniprobe, você deve conseguir acessar a interface web na sua máquina host em http://localhost:8842/ após executar:: ooniprobe -w ou iniciar o daemon.
Agora você deve ver o assistente de configuração da interface web, onde poderá ler os riscos envolvidos na execução do ooniprobe. Após responder corretamente ao questionário, você pode ativar ou desativar os testes do ooniprobe, definir como se conectar ao coletor de medições e, finalmente, configurar suas configurações de privacidade.
Por padrão, o ooniprobe não incluirá informações pessoais de identificação nos resultados do teste, nem criará um arquivo pcap. Esse comportamento pode ser personalizado.
A partir da versão 2.0.0 do ooniprobe, não há necessidade de cronjobs, pois o ooniprobe-agent é responsável pelo agendamento de tarefas.
Você pode garantir que o ooniprobe-agent esteja sempre em execução instalando e ativando
a unidade systemd ooniprobe.service::
wget https://raw.githubusercontent.com/TheTorProject/ooni-probe/master/scripts/systemd/ooniprobe.service --directory-prefix=/etc/systemd/system
systemctl enable ooniprobe
systemctl start ooniprobe
Você deve ver uma saída semelhante se o serviço ooniprobe (systemd) estiver
ativo e carregado executando systemctl status ooniprobe::
● ooniprobe.service - ooniprobe.service, ferramenta de detecção de interferência de rede
Loaded: loaded (/etc/systemd/system/ooniprobe.service; enabled)
Active: active (running) since Thu 2016-10-20 09:17:42 UTC; 16s ago
Process: 311 ExecStart=/usr/local/bin/ooniprobe-agent start (code=exited, status=0/SUCCESS)
Main PID: 390 (ooniprobe-agent)
CGroup: /system.slice/ooniprobe.service
└─390 /usr/bin/python /usr/local/bin/ooniprobe-agent start
Se sua distribuição suporta capacidades, você pode evitar a necessidade de executar OONI como root::
setcap cap_net_admin,cap_net_raw+eip /caminho/para/o/python/do/seu/virtualenv
Você pode reportar bugs e problemas que encontrar com o ooni-probe no rastreador de issues do Projeto Tor, registrando-os sob o componente "Ooni": https://trac.torproject.org/projects/tor/newticket?component=Ooni.
Você pode registrar uma conta ou usar a conta de grupo "cypherpunks" com a senha "writecode".
Você pode baixar o código do ooniprobe do seguinte repositório git::
git clone https://github.com/TheTorProject/ooni-probe.git
Você deve então enviar patches para revisão como pull requests para este repositório github:
https://github.com/TheTorProject/ooni-probe
Leia este artigo para aprender como criar um pull request no github (https://help.github.com/articles/creating-a-pull-request).
Se você preferir não usar o github (ou não tiver uma conta), também pode enviar patches como anexos em tickets.
Certifique-se de formatar o patch (dado que você está trabalhando em um branch de funcionalidade diferente do master) com::
git format-patch master --stdout > my_first_ooniprobe.patch
Em sistemas baseados em Debian, um ambiente de desenvolvimento pode ser configurado da seguinte forma: (pré-requisitos incluem pacotes essenciais de construção, python-dev e tor; para tor, veja https://www.torproject.org/docs/debian.html.en)::
sudo apt-get install python-pip python-virtualenv virtualenv
sudo apt-get install libgeoip-dev libffi-dev libdumbnet-dev libssl-dev libpcap-dev
git clone https://github.com/TheTorProject/ooni-probe
cd ooni-probe
virtualenv venv
virtualenv venv criará uma pasta no diretório atual que conterá
os arquivos executáveis do Python e uma cópia da biblioteca pip que você pode
usar para instalar outros pacotes. Para começar a usar o ambiente virtual, ele precisa
ser ativado::
source venv/bin/activate
pip install -r requirements.txt
pip install -r requirements-dev.txt
python setup.py install
Então, você pode verificar se a instalação foi bem-sucedida com::
ooniprobe -s
Isso explicará os riscos de executar o ooniprobe e garantirá que você os tenha entendido; em seguida, mostrará os testes disponíveis.
Para executar o agente ooniprobe, digite::
ooniprobe-agent run
Para executar os testes de unidade do ooniprobe, digite::
coverage run $(which trial) ooni