#!/usr/bin/env python3 #!/usr/bin/env python3 # -*- coding: utf-8 -*- #*************************************************************************** # _ _ ____ _ # Project ___| | | | _ \| | # / __| | | | |_) | | # | (__| |_| | _ <| |___ # \___|\___/|_| \_\_____| # # Copyright (C) Daniel Stenberg, , et al. # # This software is licensed as described in the file COPYING, which # you should have received as part of this distribution. The terms # are also available at https://curl.se/docs/copyright.html. # # You may opt to use, copy, modify, merge, publish, distribute and/or sell # copies of the Software, and permit persons to whom the Software is # furnished to do so, under the terms of the COPYING file. # # This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY # KIND, either express or implied. # # SPDX-License-Identifier: curl # ########################################################################### # import inspect import logging import os import subprocess from datetime import timedelta, datetime from json import JSONEncoder import time from typing import List, Union, Optional from .curl import CurlClient, ExecResult from .env import Env log = logging.getLogger(__name__) class Httpd: MODULES = [ 'log_config', 'logio', 'unixd', 'version', 'watchdog', 'authn_core', 'authn_file', 'authz_user', 'authz_core', 'authz_host', 'auth_basic', 'auth_digest', 'alias', 'env', 'filter', 'headers', 'mime', 'setenvif', 'socache_shmcb', 'rewrite', 'http2', 'ssl', 'proxy', 'proxy_http', 'proxy_connect', 'brotli', 'mpm_event', ] COMMON_MODULES_DIRS = [ '/usr/lib/apache2/modules', # debian '/usr/libexec/apache2/', # macos ] MOD_CURLTEST = None def __init__(self, env: Env, proxy_auth: bool = False): self.env = env self._cmd = env.apachectl self._apache_dir = os.path.join(env.gen_dir, 'apache') self._run_dir = os.path.join(self._apache_dir, 'run') self._lock_dir = os.path.join(self._apache_dir, 'locks') self._docs_dir = os.path.join(self._apache_dir, 'docs') self._conf_dir = os.path.join(self._apache_dir, 'conf') self._conf_file = os.path.join(self._conf_dir, 'test.conf') self._logs_dir = os.path.join(self._apache_dir, 'logs') self._error_log = os.path.join(self._logs_dir, 'error_log') self._tmp_dir = os.path.join(self._apache_dir, 'tmp') self._basic_passwords = os.path.join(self._conf_dir, 'basic.passwords') self._digest_passwords = os.path.join(self._conf_dir, 'digest.passwords') self._mods_dir = None self._auth_digest = True self._proxy_auth_basic = proxy_auth self._extra_configs = {} assert env.apxs p = subprocess.run(args=[env.apxs, '-q', 'libexecdir'], capture_output=True, text=True) if p.returncode != 0: raise Exception(f'{env.apxs} failed to query libexecdir: {p}') self._mods_dir = p.stdout.strip() if self._mods_dir is None: raise Exception(f'apache modules dir cannot be found') if not os.path.exists(self._mods_dir): raise Exception(f'apache modules dir does not exist: {self._mods_dir}') self._process = None self._rmf(self._error_log) self._init_curltest() @property def docs_dir(self): return self._docs_dir def clear_logs(self): self._rmf(self._error_log) def exists(self): return os.path.exists(self._cmd) def set_extra_config(self, domain: str, lines: Optional[Union[str, List[str]]]): if lines is None: self._extra_configs.pop(domain, None) else: self._extra_configs[domain] = lines def clear_extra_configs(self): self._extra_configs = {} def set_proxy_auth(self, active: bool): self._proxy_auth_basic = active def _run(self, args, intext=''): env = {} for key, val in os.environ.items(): env[key] = val env['APACHE_RUN_DIR'] = self._run_dir env['APACHE_RUN_USER'] = os.environ['USER'] env['APACHE_LOCK_DIR'] = self._lock_dir env['APACHE_CONFDIR'] = self._apache_dir p = subprocess.run(args, stderr=subprocess.PIPE, stdout=subprocess.PIPE, cwd=self.env.gen_dir, input=intext.encode() if intext else None, env=env) start = datetime.now() return ExecResult(args=args, exit_code=p.returncode, stdout=p.stdout.decode().splitlines(), stderr=p.stderr.decode().splitlines(), duration=datetime.now() - start) def _apachectl(self, cmd: str): args = [self.env.apachectl, "-d", self._apache_dir, "-f", self._conf_file, "-k", cmd] return self._run(args=args) def start(self): if self._process: self.stop() self._write_config() with open(self._error_log, 'a') as fd: fd.write('start of server\n') with open(os.path.join(self._apache_dir, 'xxx'), 'a') as fd: fd.write('start of server\n') r = self._apachectl('start') if r.exit_code != 0: log.error(f'failed to start httpd: {r}') return False return self.wait_live(timeout=timedelta(seconds=5)) def stop(self): r = self._apachectl('stop') if r.exit_code == 0: return self.wait_dead(timeout=timedelta(seconds=5)) log.fatal(f'stopping httpd failed: {r}') return r.exit_code == 0 def restart(self): self.stop() return self.start() def reload(self): self._write_config() r = self._apachectl("graceful") if r.exit_code != 0: log.error(f'failed to reload httpd: {r}') return self.wait_live(timeout=timedelta(seconds=5)) def wait_dead(self, timeout: timedelta): curl = CurlClient(env=self.env, run_dir=self._tmp_dir) try_until = datetime.now() + timeout while datetime.now() < try_until: r = curl.http_get(url=f'http://{self.env.domain1}:{self.env.http_port}/') if r.exit_code != 0: return True time.sleep(.1) log.debug(f"Server still responding after {timeout}") return False def wait_live(self, timeout: timedelta): curl = CurlClient(env=self.env, run_dir=self._tmp_dir, timeout=timeout.total_seconds()) try_until = datetime.now() + timeout while datetime.now() < try_until: r = curl.http_get(url=f'http://{self.env.domain1}:{self.env.http_port}/') if r.exit_code == 0: return True time.sleep(.1) log.debug(f"Server still not responding after {timeout}") return False def _rmf(self, path): if os.path.exists(path): return os.remove(path) def _mkpath(self, path): if not os.path.exists(path): return os.makedirs(path) def _write_config(self): domain1 = self.env.domain1 domain1brotli = self.env.domain1brotli creds1 = self.env.get_credentials(domain1) domain2 = self.env.domain2 creds2 = self.env.get_credentials(domain2) proxy_domain = self.env.proxy_domain proxy_creds = self.env.get_credentials(proxy_domain) self._mkpath(self._conf_dir) self._mkpath(self._logs_dir) self._mkpath(self._tmp_dir) self._mkpath(os.path.join(self._docs_dir, 'two')) with open(os.path.join(self._docs_dir, 'data.json'), 'w') as fd: data = { 'server': f'{domain1}', } fd.write(JSONEncoder().encode(data)) with open(os.path.join(self._docs_dir, 'two/data.json'), 'w') as fd: data = { 'server': f'{domain2}', } fd.write(JSONEncoder().encode(data)) if self._proxy_auth_basic: with open(self._basic_passwords, 'w') as fd: fd.write('proxy:$apr1$FQfeInbs$WQZbODJlVg60j0ogEIlTW/\n') if self._auth_digest: with open(self._digest_passwords, 'w') as fd: fd.write('test:restricted area:57123e269fd73d71ae0656594e938e2f\n') self._mkpath(os.path.join(self.docs_dir, 'restricted/digest')) with open(os.path.join(self.docs_dir, 'restricted/digest/data.json'), 'w') as fd: fd.write('{"area":"digest"}\n') with open(self._conf_file, 'w') as fd: for m in self.MODULES: if os.path.exists(os.path.join(self._mods_dir, f'mod_{m}.so')): fd.write(f'LoadModule {m}_module "{self._mods_dir}/mod_{m}.so"\n') if Httpd.MOD_CURLTEST is not None: fd.write(f'LoadModule curltest_module \"{Httpd.MOD_CURLTEST}\"\n') conf = [ # base server config f'ServerRoot "{self._apache_dir}"', f'DefaultRuntimeDir logs', f'PidFile httpd.pid', f'ErrorLog {self._error_log}', f'LogLevel {self._get_log_level()}', f'StartServers 4', f'ReadBufferSize 16000', f'H2MinWorkers 16', f'H2MaxWorkers 256', f'H2Direct on', f'Listen {self.env.http_port}', f'Listen {self.env.https_port}', f'Listen {self.env.proxy_port}', f'Listen {self.env.proxys_port}', f'TypesConfig "{self._conf_dir}/mime.types', f'SSLSessionCache "shmcb:ssl_gcache_data(32000)"', f'SSLHonorCipherOrder on', ] if 'base' in self._extra_configs: conf.extend(self._extra_configs['base']) conf.extend([ # plain http host for domain1 f'', f' ServerName {domain1}', f' ServerAlias localhost', f' DocumentRoot "{self._docs_dir}"', f' Protocols h2c http/1.1', ]) conf.extend(self._curltest_conf(domain1)) conf.extend([ f'', f'', ]) conf.extend([ # https host for domain1, h1 + h2 f'', f' ServerName {domain1}', f' ServerAlias localhost', f' Protocols h2 http/1.1', f' SSLEngine on', f' SSLCertificateFile {creds1.cert_file}', f' SSLCertificateKeyFile {creds1.pkey_file}', f' DocumentRoot "{self._docs_dir}"', ]) conf.extend(self._curltest_conf(domain1)) if domain1 in self._extra_configs: conf.extend(self._extra_configs[domain1]) conf.extend([ f'', f'', ]) # Alternate to domain1 with BROTLI compression conf.extend([ # https host for domain1, h1 + h2 f'', f' ServerName {domain1brotli}', f' Protocols h2 http/1.1', f' SSLEngine on', f' SSLCertificateFile {creds1.cert_file}', f' SSLCertificateKeyFile {creds1.pkey_file}', f' DocumentRoot "{self._docs_dir}"', f' SetOutputFilter BROTLI_COMPRESS', ]) conf.extend(self._curltest_conf(domain1)) if domain1 in self._extra_configs: conf.extend(self._extra_configs[domain1]) conf.extend([ f'', f'', ]) conf.extend([ # plain http host for domain2 f'', f' ServerName {domain2}', f' ServerAlias localhost', f' DocumentRoot "{self._docs_dir}"', f' Protocols h2c http/1.1', ]) conf.extend(self._curltest_conf(domain2)) conf.extend([ f'', f'', ]) conf.extend([ # https host for domain2, no h2 f'', f' ServerName {domain2}', f' Protocols http/1.1', f' SSLEngine on', f' SSLCertificateFile {creds2.cert_file}', f' SSLCertificateKeyFile {creds2.pkey_file}', f' DocumentRoot "{self._docs_dir}/two"', ]) conf.extend(self._curltest_conf(domain2)) if domain2 in self._extra_configs: conf.extend(self._extra_configs[domain2]) conf.extend([ f'', f'', ]) conf.extend([ # http forward proxy f'', f' ServerName {proxy_domain}', f' Protocols h2c http/1.1', f' ProxyRequests On', f' H2ProxyRequests On', f' ProxyVia On', f' AllowCONNECT {self.env.http_port} {self.env.https_port}', ]) conf.extend(self._get_proxy_conf()) conf.extend([ f'', f'', ]) conf.extend([ # https forward proxy f'', f' ServerName {proxy_domain}', f' Protocols h2 http/1.1', f' SSLEngine on', f' SSLCertificateFile {proxy_creds.cert_file}', f' SSLCertificateKeyFile {proxy_creds.pkey_file}', f' ProxyRequests On', f' H2ProxyRequests On', f' ProxyVia On', f' AllowCONNECT {self.env.http_port} {self.env.https_port}', ]) conf.extend(self._get_proxy_conf()) conf.extend([ f'', f'', ]) fd.write("\n".join(conf)) with open(os.path.join(self._conf_dir, 'mime.types'), 'w') as fd: fd.write("\n".join([ 'text/html html', 'application/json json', '' ])) def _get_proxy_conf(self): if self._proxy_auth_basic: return [ f' ', f' AuthType Basic', f' AuthName "Restricted Proxy"', f' AuthBasicProvider file', f' AuthUserFile "{self._basic_passwords}"', f' Require user proxy', f' ', ] else: return [ f' ', f' Require ip 127.0.0.1', f' ', ] def _get_log_level(self): if self.env.verbose > 3: return 'trace2' if self.env.verbose > 2: return 'trace1' if self.env.verbose > 1: return 'debug' return 'info' def _curltest_conf(self, servername) -> List[str]: lines = [] if Httpd.MOD_CURLTEST is not None: lines.extend([ f' Redirect 302 /data.json.302 /data.json', f' Redirect 301 /curltest/echo301 /curltest/echo', f' Redirect 302 /curltest/echo302 /curltest/echo', f' Redirect 303 /curltest/echo303 /curltest/echo', f' Redirect 307 /curltest/echo307 /curltest/echo', f' ', f' SSLOptions StdEnvVars', f' SetHandler curltest-sslinfo', f' ', f' ', f' SetHandler curltest-echo', f' ', f' ', f' SetHandler curltest-put', f' ', f' ', f' SetHandler curltest-tweak', f' ', f' Redirect 302 /tweak /curltest/tweak', f' ', f' SetHandler curltest-1_1-required', f' ', f' ', f' SetHandler curltest-tweak', f' SetEnv force-response-1.0 1', f' ', f' SetEnvIf Request_URI "/shutdown_unclean" ssl-unclean=1', ]) if self._auth_digest: lines.extend([ f' ', f' AuthType Digest', f' AuthName "restricted area"', f' AuthDigestDomain "https://{servername}"', f' AuthBasicProvider file', f' AuthUserFile "{self._digest_passwords}"', f' Require valid-user', f' ', ]) return lines def _init_curltest(self): if Httpd.MOD_CURLTEST is not None: return local_dir = os.path.dirname(inspect.getfile(Httpd)) p = subprocess.run([self.env.apxs, '-c', 'mod_curltest.c'], capture_output=True, cwd=os.path.join(local_dir, 'mod_curltest')) rv = p.returncode if rv != 0: log.error(f"compiling mod_curltest failed: {p.stderr}") raise Exception(f"compiling mod_curltest failed: {p.stderr}") Httpd.MOD_CURLTEST = os.path.join( local_dir, 'mod_curltest/.libs/mod_curltest.so')