WebScripts 0.1.1

This package implements a web server to run scripts or executables from the command line and display the result in a web interface.

WebScripts

Description

This package implements a web server to run scripts or executables from the command line and display the result in a web interface.

Requirements

This package require:

• python3
• python3 Standard Library

Optional on Windows:

• pywin32 (to centralize logs in Event Viewer)

Installation

pip install WebScripts

Basic Usages

Command line

WebScripts
python3 -m WebScripts

WebScripts --help
WebScripts -h # Print help message and command line options

WebScripts --interface "192.168.1.2" --port 80
WebScripts -i "192.168.1.2" -p 80 # Change interface and port

# /!\ do not use the --debug option on the production environment
WebScripts --debug
WebScripts -d # Print informations about server configuration in errors pages (404 and 500)

# /!\ do not use the --security option on the production environment
WebScripts --security
WebScripts -s # Do not use HTTP security headers (for debugging)

WebScripts --accept-unauthenticated-user --accept-unknow-user
# Accept unauthenticated user

Python script

import WebScripts
WebScripts.main()

from WebScripts import Configuration, Server, main
from wsgiref import simple_server

config = Configuration()
config.add_conf(
    interface="", 
    port=8000, 
    scripts_path = [
        "./scripts/account",
        "./scripts/passwords"
    ],
    json_scripts_config = [
        "./config/scripts/*.json"
    ],
    ini_scripts_config = [
        "./config/scripts/*.ini"
    ],
    documentations_path = [
        "./doc/*.html"
    ],
    js_path = [
        "./static/js/*.js"
    ],
    statics_path = [
        "./static/html/*.html",
        "./static/css/*.css",
        "./static/images/*.jpg",
        "./static/pdf/*.pdf"
    ],
)
config.set_defaults()
config.check_required()
config.get_unexpecteds()
config.build_types()

server = Server(config)
httpd = simple_server.make_server(server.interface, server.port, server.app)
httpd.serve_forever()

Default Configurations

On Linux the default configurations may not work, replace all script launchers with python3 (default is python).

Documentation

Wiki

• Installation
• Usages
• Server Configuration
• Script Configuration
• Argument Configuration
• Logs
• Authentication
• Default Database
• Security Considerations
• API
• Custom WEB Interface
• Modules (Custom responses and code)
• Security checks and tests (pentest tools)

Examples

• Deployment (using virtual environment and NGINX as proxy HTTPS)
• Add a bash script (for authentication)
• Add a module
• Make a custom API client

PyDoc

• Index
• WebScripts
• Pages
• commons
• utils
• Errors
• Default Database Manager

Links

• Pypi
• Github

License

Licensed under the GPL, version 3.