From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-9.0 required=3.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 4FC6AC04AB4 for ; Fri, 17 May 2019 11:09:43 +0000 (UTC) Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.kernel.org (Postfix) with ESMTP id 2E7A820879 for ; Fri, 17 May 2019 11:09:43 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1728654AbfEQLJm (ORCPT ); Fri, 17 May 2019 07:09:42 -0400 Received: from orbyte.nwl.cc ([151.80.46.58]:55700 "EHLO orbyte.nwl.cc" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1727689AbfEQLJm (ORCPT ); Fri, 17 May 2019 07:09:42 -0400 Received: from localhost ([::1]:40558 helo=tatos) by orbyte.nwl.cc with esmtp (Exim 4.91) (envelope-from ) id 1hRak8-000846-OY; Fri, 17 May 2019 13:09:40 +0200 From: Phil Sutter To: Pablo Neira Ayuso Cc: Eric Garver , netfilter-devel@vger.kernel.org Subject: [nft PATCH 1/2] py: Implement JSON validation in nftables module Date: Fri, 17 May 2019 13:09:30 +0200 Message-Id: <20190517110931.14068-2-phil@nwl.cc> X-Mailer: git-send-email 2.21.0 In-Reply-To: <20190517110931.14068-1-phil@nwl.cc> References: <20190517110931.14068-1-phil@nwl.cc> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: netfilter-devel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: netfilter-devel@vger.kernel.org Using jsonschema it is possible to validate any JSON input to make sure it formally conforms with libnftables JSON API requirements. Implement a simple validator class for use within a new Nftables class method 'json_validate' and ship a minimal schema definition along with the package. Signed-off-by: Phil Sutter --- py/Makefile.am | 2 +- py/nftables.py | 30 ++++++++++++++++++++++++++++++ py/schema.json | 17 +++++++++++++++++ py/setup.py | 1 + 4 files changed, 49 insertions(+), 1 deletion(-) create mode 100644 py/schema.json diff --git a/py/Makefile.am b/py/Makefile.am index 0963535d068dc..9fce7c9e54c38 100644 --- a/py/Makefile.am +++ b/py/Makefile.am @@ -1,4 +1,4 @@ -EXTRA_DIST = setup.py __init__.py nftables.py +EXTRA_DIST = setup.py __init__.py nftables.py schema.json if HAVE_PYTHON diff --git a/py/nftables.py b/py/nftables.py index 33cd2dfd736d4..db0f502b2951f 100644 --- a/py/nftables.py +++ b/py/nftables.py @@ -17,9 +17,24 @@ import json from ctypes import * import sys +import os NFTABLES_VERSION = "0.1" +class SchemaValidator: + """Libnftables JSON validator using jsonschema""" + + def __init__(self): + schema_path = os.path.join(os.path.dirname(__file__), "schema.json") + schema_file = file(schema_path) + self.schema = json.load(schema_file) + schema_file.close() + import jsonschema + self.jsonschema = jsonschema + + def validate(self, json): + self.jsonschema.validate(instance=json, schema=self.schema) + class Nftables: """A class representing libnftables interface""" @@ -46,6 +61,8 @@ class Nftables: "numeric_symbol": (1 << 9), } + validator = None + def __init__(self, sofile="libnftables.so"): """Instantiate a new Nftables class object. @@ -382,3 +399,16 @@ class Nftables: if len(output): output = json.loads(output) return (rc, output, error) + + def json_validate(self, json_root): + """Validate JSON object against libnftables schema. + + Accepts a hash object as input. + + Returns True if JSON is valid, raises an exception otherwise. + """ + if not self.validator: + self.validator = SchemaValidator() + + self.validator.validate(json_root) + return True diff --git a/py/schema.json b/py/schema.json new file mode 100644 index 0000000000000..6cb731a228bf4 --- /dev/null +++ b/py/schema.json @@ -0,0 +1,17 @@ +{ + "$schema": "http://json-schema.org/schema#", + "id": "http://netfilter.org/nftables/ruleset-schema.json", + "description": "libnftables JSON API schema", + + "type": "object", + "properties": { + "nftables": { + "type": "array", + "minitems": 0, + "items": { + "type": "object" + } + } + }, + "required": [ "nftables" ] +} diff --git a/py/setup.py b/py/setup.py index ef143c42a21b0..72fc8fd98b269 100755 --- a/py/setup.py +++ b/py/setup.py @@ -11,6 +11,7 @@ setup(name='nftables', packages=['nftables'], provides=['nftables'], package_dir={'nftables':'.'}, + package_data={'nftables':['schema.json']}, classifiers=[ 'Development Status :: 4 - Beta', 'Environment :: Console', -- 2.21.0