/** * @file nacm.c * @author Radek Krejci * @author Michal Vasko * @brief libyang extension plugin - NACM (RFC 6536) * * Copyright (c) 2019 - 2022 CESNET, z.s.p.o. * * This source code is licensed under BSD 3-Clause License (the "License"). * You may not use this file except in compliance with the License. * You may obtain a copy of the License at * * https://opensource.org/licenses/BSD-3-Clause */ #include #include #include #include "compat.h" #include "libyang.h" #include "plugins_exts.h" struct nacm_dfs_arg { struct lysc_ext_instance *ext; struct lysc_node *parent; }; /** * @brief DFS callback implementation for inheriting the NACM extension. */ static LY_ERR nacm_inherit_clb(struct lysc_node *node, void *data, ly_bool *dfs_continue) { LY_ERR ret; struct nacm_dfs_arg *arg = data; struct lysc_ext_instance *inherited; LY_ARRAY_COUNT_TYPE u; /* ignore the parent from which we inherit and input/output nodes */ if ((node != arg->parent) && !(node->nodetype & (LYS_INPUT | LYS_OUTPUT))) { /* check that the node does not have its own NACM extension instance */ LY_ARRAY_FOR(node->exts, u) { if (node->exts[u].def == arg->ext->def) { /* the child already have its own NACM flag, so skip the subtree */ *dfs_continue = 1; return LY_SUCCESS; } } /* duplicate this one to inherit it to the child */ LY_ARRAY_NEW_GOTO(node->module->ctx, node->exts, inherited, ret, emem); inherited->def = arg->ext->def; inherited->parent = node; inherited->parent_stmt = lyplg_ext_nodetype2stmt(node->nodetype); if (arg->ext->argument) { if ((ret = lydict_insert(node->module->ctx, arg->ext->argument, 0, &inherited->argument))) { return ret; } } /* copy the pointer to the static variables */ inherited->compiled = arg->ext->compiled; } return LY_SUCCESS; emem: lyplg_ext_compile_log(NULL, arg->ext, LY_LLERR, LY_EMEM, "Memory allocation failed (%s()).", __func__); return ret; } /** * @brief Parse NACM extension instances. * * Implementation of ::lyplg_ext_parse_clb callback set as lyext_plugin::parse. */ static LY_ERR nacm_parse(struct lysp_ctx *pctx, struct lysp_ext_instance *ext) { struct lysp_node *parent = NULL; LY_ARRAY_COUNT_TYPE u; /* check that the extension is instantiated at an allowed place - data node */ if (!(ext->parent_stmt & LY_STMT_NODE_MASK)) { lyplg_ext_parse_log(pctx, ext, LY_LLWRN, 0, "Extension %s is allowed only in a data nodes, but it is placed in " "\"%s\" statement.", ext->name, lyplg_ext_stmt2str(ext->parent_stmt)); return LY_ENOT; } parent = ext->parent; if (!(parent->nodetype & (LYS_CONTAINER | LYS_LEAF | LYS_LEAFLIST | LYS_LIST | LYS_CHOICE | LYS_ANYDATA | LYS_CASE | LYS_RPC | LYS_ACTION | LYS_NOTIF)) || (!strcmp(strchr(ext->name, ':') + 1, "default-deny-write") && (parent->nodetype & (LYS_RPC | LYS_ACTION | LYS_NOTIF)))) { /* note LYS_AUGMENT and LYS_USES is not in the list since they are not present in the compiled tree. Instead, libyang * passes all their extensions to their children nodes */ lyplg_ext_parse_log(pctx, ext, LY_LLWRN, 0, "Extension %s is not allowed in %s statement.", ext->name, lys_nodetype2str(parent->nodetype)); return LY_ENOT; } /* check for duplication */ LY_ARRAY_FOR(parent->exts, u) { if ((&parent->exts[u] != ext) && parent->exts[u].record && (parent->exts[u].record->plugin.id == ext->record->plugin.id)) { /* duplication of a NACM extension on a single node * We check for all NACM plugins since we want to catch even the situation that there is default-deny-all * AND default-deny-write */ if (parent->exts[u].name == ext->name) { lyplg_ext_parse_log(pctx, ext, LY_LLERR, LY_EVALID, "Extension %s is instantiated multiple times.", ext->name); } else { lyplg_ext_parse_log(pctx, ext, LY_LLERR, LY_EVALID, "Extension nacm:default-deny-write is mixed with nacm:default-deny-all."); } return LY_EVALID; } } return LY_SUCCESS; } /** * @brief Compile NACM extension instances. * * Implementation of ::lyplg_ext_compile_clb callback set as lyext_plugin::compile. */ static LY_ERR nacm_compile(struct lysc_ctx *UNUSED(cctx), const struct lysp_ext_instance *UNUSED(extp), struct lysc_ext_instance *ext) { struct nacm_dfs_arg dfs_arg; static const uint8_t nacm_deny_all = 1; static const uint8_t nacm_deny_write = 2; /* store the NACM flag */ if (!strcmp(ext->def->name, "default-deny-write")) { ext->compiled = (void *)&nacm_deny_write; } else if (!strcmp(ext->def->name, "default-deny-all")) { ext->compiled = (void *)&nacm_deny_all; } else { return LY_EINT; } /* inherit the extension instance to all the children nodes */ dfs_arg.ext = ext; dfs_arg.parent = ext->parent; return lysc_tree_dfs_full(ext->parent, nacm_inherit_clb, &dfs_arg); } /** * @brief Plugin descriptions for the NACM's default-deny-write and default-deny-all extensions * * Note that external plugins are supposed to use: * * LYPLG_EXTENSIONS = { */ const struct lyplg_ext_record plugins_nacm[] = { { .module = "ietf-netconf-acm", .revision = "2012-02-22", .name = "default-deny-write", .plugin.id = "ly2 NACM v1", .plugin.parse = nacm_parse, .plugin.compile = nacm_compile, .plugin.printer_info = NULL, .plugin.printer_ctree = NULL, .plugin.printer_ptree = NULL, .plugin.node = NULL, .plugin.snode = NULL, .plugin.validate = NULL, .plugin.pfree = NULL, .plugin.cfree = NULL }, { .module = "ietf-netconf-acm", .revision = "2018-02-14", .name = "default-deny-write", .plugin.id = "ly2 NACM v1", .plugin.parse = nacm_parse, .plugin.compile = nacm_compile, .plugin.printer_info = NULL, .plugin.printer_ctree = NULL, .plugin.printer_ptree = NULL, .plugin.node = NULL, .plugin.snode = NULL, .plugin.validate = NULL, .plugin.pfree = NULL, .plugin.cfree = NULL }, { .module = "ietf-netconf-acm", .revision = "2012-02-22", .name = "default-deny-all", .plugin.id = "ly2 NACM v1", .plugin.parse = nacm_parse, .plugin.compile = nacm_compile, .plugin.printer_info = NULL, .plugin.printer_ctree = NULL, .plugin.printer_ptree = NULL, .plugin.node = NULL, .plugin.snode = NULL, .plugin.validate = NULL, .plugin.pfree = NULL, .plugin.cfree = NULL }, { .module = "ietf-netconf-acm", .revision = "2018-02-14", .name = "default-deny-all", .plugin.id = "ly2 NACM v1", .plugin.parse = nacm_parse, .plugin.compile = nacm_compile, .plugin.printer_info = NULL, .plugin.printer_ctree = NULL, .plugin.printer_ptree = NULL, .plugin.node = NULL, .plugin.snode = NULL, .plugin.validate = NULL, .plugin.pfree = NULL, .plugin.cfree = NULL }, {0} /* terminating zeroed item */ };