JSanitizer 3.0.0

JSanitizer

Configurable sanitizer for XML and JSON string value through extension method.

Features

• Default sanitizer to replace password value
• Sanitize with options
  • Default value replacer
  • Add property to sanitize value

Requirements

• .NET Core 3.1
• Visual Studio or VS Code

How to use:

• Go to Tools and select Manage Nuget Packages and Search for JSanitizer library
  Install-Package JSanitizer -Version 3.0.0

Extension:
.SanitizeJsonValue(configPath)
.SanitizeXmlValue(configPath)
.SanitizeJsonValue(options)
.SanitizeXmlValue(options)

How to create your custom JSON configurations.

• Create folder with name JSOptions under your project then create json file with name SanitizerOptions.json under the said folder as your default configuration and follow the object format below.

{Project.Name}/JSOptions/SanitizerOptions.json

{
  "DefaultMaskValue": "#",
  "ConfigurationValue": [
    {
      "id": 1,
      "XmlMask": {
        "MaskValue": "#",
        "IsFullMasking": false,
        "Sensitivity": [
          {
            "TargetProperties": [
              "Password",
              "password",
              "PASSWROD"
            ],
            "Positions": {
              "Left": 1,
              "Center": 1,
              "Right": 1
            }
          }
        ]
      },
      "JsonMask": {
        "MaskValue": "#",
        "IsFullMasking": false,
        "Sensitivity": [
          {
            "TargetProperties": [
              "Password",
              "password",
              "PASSWROD"
            ],
            "Positions": {
              "Left": 3,
              "Center": 3,
              "Right": 3
            }
          }
        ]
      }
    }
  ]
}

note: It will throw an exception if you use the default json or xml extension methods without providing default json configurations.

remarks: You can add more properties under Sensitivity for value masking.

1. Sanitize without options

    [HttpGet, Route("GetWithJsonConfiguration")]
    public IActionResult Get()
    {
        string configDir = $"{Directory.GetCurrentDirectory()}\\JSOptions\\SanitizerOptions.json";

        Data data = new Data()
        {
            JsonArrayResult = "[{\"password\":\"password@412\", \"data\": \"sample\" }]".SanitizeJsonValue(configDir),
            Name = "{\"name\":\"John\", \"age\":30, \"password\":\"password@123\" }".SanitizeJsonValue(configDir),
            XMLResult = _xmlValue.SanitizeXmlValue(configDir)
        };

        return Ok(data);
    }

2. Sanitize withoptions

    [HttpGet, Route("GetWithClassConfigurations")]
    public IActionResult GetWithOptions()
    {
        Data data = new Data()
        {
            XMLResult = _xmlValue.SanitizeXmlValue(new XmlMask()
            {
                MaskValue = "#",
                IsFullMasking = false,
                Sensitivity = new List<Sensitivity>()
                {
                  new Sensitivity()
                  {
                      TargetProperties = new List<string> {
                         "Password",
                         "password",
                         "PASSWROD"
                      },
                      Positions = new MaskPosition ()
                      {
                          Left = 3,
                          Center = 2,
                          Right = 2
                      }
                }
            }
            })
        };

        return Ok(data);
    }

License

Copyright (c) 2020 Joever Monceda

Linkedin: Joever Monceda
Medium: Joever Monceda
Twitter @_EthanHunt07
Facebook: Ethan Hunt