Skip to content

bernardo1024/Sanwaf-Sample

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

69 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Sanwaf Framework Overview

Sanwaf is a declarative data validation framework that secures your UI & Server without writing any code

  • Sanwaf-UI is a Sanitation Web Application Firewall that runs on the Browser

     - Uses a declarative mechanism to add validation to HTML pages
     - Add validation to a UI elements by including custom Sanwaf-UI Attributes
     - Fully configurable look and feel
     - No custom code is required to perform validation on web pages
    
  • Sanwaf-Server is a Sanitation Web Application Firewall that runs on the Server

    - Sanwaf-Server secures parameters, cookies, headers and endpoints prior to entering your application code
    - Sanwaf-Server is configured with an XML file
    - Can be used independently of Sanwaf-UI
    - No custom code is required to perform validation on the server
    
  • Sanwaf-UI-2-Server Utility converts the Sanwaf-UI declarative validation into the server XML format

     - Provides for effortless Sanwaf-Server configuration using Sanwaf-UI attributes
     - Converts the Sanwaf-UI declarative Attributes into a Sanwaf-Server consumable form
     - Automate Sanwaf-Server configuration using this utility
    
  • Sanwaf-Sample project is a sample implementation of Sanwaf-UI and Sanwaf Server

     - End-2-end sample of using Sanwaf-UI & Sanwaf-Server
     - Dynamically configure and test Sanwaf-UI 
     - Dynamically disable Browser Validation and run against Server (uses embedded Jetty)
    

Sanwaf Sample Application

  1. Build the application

     mvn clean package
    
  2. Run the sample application, in the SanwafSample project:

     mvn jetty:run
    
  3. Open a browser and navigate to http://127.0.0.1:8080

     http://127.0.0.1:8080
    
  4. if you update sanwaf attributes on the html sample pages, you will need re-generate the sanwaf configuration file by running the sanwaf-ui-2-server mvn command (exec:exec), then restart jetty (jetty:run):

     mvn exec:exec
     mvn jetty:run
    

if you experience any exception relating to the sanwaf-server dependency, see the readme.md in the Sanwaf-Server project for instructions on cloning and installing the jar to your local maven repo

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published