<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE rfc [
  <!ENTITY nbsp    "&#160;">
  <!ENTITY zwsp   "&#8203;">
  <!ENTITY nbhy   "&#8209;">
  <!ENTITY wj     "&#8288;">
]>
<?xml-stylesheet type="text/xsl" href="rfc2629.xslt" ?>
<!-- generated by https://github.com/cabo/kramdown-rfc version 1.7.29 (Ruby 3.3.8) -->
<rfc xmlns:xi="http://www.w3.org/2001/XInclude" ipr="trust200902" docName="draft-ietf-netmod-immutable-flag-04" category="std" consensus="true" submissionType="IETF" updates="8040, 8526" tocInclude="true" sortRefs="true" symRefs="true" version="3">
  <!-- xml2rfc v2v3 conversion 3.28.1 -->
  <front>
    <title abbrev="immutable flag">YANG Metadata Annotation for Immutable Flag</title>
    <seriesInfo name="Internet-Draft" value="draft-ietf-netmod-immutable-flag-04"/>
    <author fullname="Qiufang Ma" role="editor">
      <organization>Huawei</organization>
      <address>
        <postal>
          <street>101 Software Avenue, Yuhua District</street>
          <city>Nanjing, Jiangsu</city>
          <code>210012</code>
          <country>China</country>
        </postal>
        <email>maqiufang1@huawei.com</email>
      </address>
    </author>
    <author fullname="Qin Wu">
      <organization>Huawei</organization>
      <address>
        <postal>
          <street>101 Software Avenue, Yuhua District</street>
          <city>Nanjing, Jiangsu</city>
          <code>210012</code>
          <country>China</country>
        </postal>
        <email>bill.wu@huawei.com</email>
      </address>
    </author>
    <author fullname="Balazs Lengyel" role="editor">
      <organization>Ericsson</organization>
      <address>
        <email>balazs.lengyel@ericsson.com</email>
      </address>
    </author>
    <author fullname="Hongwei Li">
      <organization>HPE</organization>
      <address>
        <email>flycoolman@gmail.com</email>
      </address>
    </author>
    <date year="2025" month="May" day="15"/>
    <area>Operations and Management</area>
    <workgroup>netmod</workgroup>
    <keyword>immutable flag</keyword>
    <keyword>system configuration</keyword>
    <abstract>
      <?line 75?>

<t>This document defines a way to formally document an existing behavior,
   implemented by servers in production, on the immutability of some
   system-provided nodes, using a YANG metadata annotation called
   "immutable" to flag which nodes are immutable.</t>
      <t>Clients may use "immutable" annotations provided by the server, to
   know beforehand why certain otherwise valid configuration requests
   will cause the server to return an error.</t>
      <t>The immutable flag is descriptive, documenting an existing behavior, not
   proscriptive, dictating server behaviors.</t>
      <t>This document updates RFC 8040 and RFC 8526.</t>
    </abstract>
    <note removeInRFC="true">
      <name>Discussion Venues</name>
      <t>Discussion of this document takes place on the
    Network Modeling Working Group mailing list (netmod@ietf.org),
    which is archived at <eref target="https://mailarchive.ietf.org/arch/browse/netmod/"/>.</t>
      <t>Source for this draft and an issue tracker can be found at
    <eref target="https://github.com/netmod-wg/immutable-flag"/>.</t>
    </note>
  </front>
  <middle>
    <?line 91?>

<section anchor="introduction">
      <name>Introduction</name>
      <t>This document defines a YANG metadata annotation <xref target="RFC7952"/> to formally document
   an existing model handling behavior that has been used by
   multiple standard organizations and vendors.  It is the aim to create
   one single standard solution for documenting non-modifiable system
   data declared as configuration, instead of the multiple existing
   vendor and organization specific solutions.</t>
      <t>YANG <xref target="RFC7950"/> is a data modeling language used to model both state
   and configuration data, based on the "config" statement.  However,
   there exists some system configuration data that cannot be modified
   by the client (it is immutable), but still needs to be declared as
   "config true" to:</t>
      <ul spacing="normal">
        <li>
          <t>allow configuration of data nodes under immutable lists or containers;</t>
        </li>
        <li>
          <t>place "when", "must" and "leafref" constraints between configuration
   and immutable nodes;</t>
        </li>
        <li>
          <t>ensure the existence of specific list entries that are provided and
   needed by the system, while additional list entries can be created,
   modified or deleted.</t>
        </li>
      </ul>
      <t>If the server always rejects a client's attempt to override some
   system-provided data because it internally thinks immutable, it should document
   it towards the clients in a machine-readable way rather than writing as
   plain text in the "description" statement.</t>
      <t>This document defines a way to formally document the existing behavior,
   implemented by servers in production, on the immutability of some
   system-provided nodes, using a YANG metadata annotation <xref target="RFC7952"/>
   called "immutable" to flag which nodes are immutable. This document does not
   regulate server behaviors. That said, it is expected that a server will return
   an error with an error-tag containing "invalid-value" when immutability
   is attempted to be violated.</t>
      <t>This document does not apply to the server not having any immutable
   system configuration.  While in some cases immutability may be
   needed, it also has disadvantages, therefore it <bcp14>SHOULD</bcp14> be avoided
   wherever possible.</t>
      <t>The following is a list of already implemented and potential use
   cases:</t>
      <ul spacing="normal">
        <li>
          <t>UC1  Modeling of server capabilities</t>
        </li>
        <li>
          <t>UC2  Hardware based auto-configuration</t>
        </li>
        <li>
          <t>UC3  Predefined administrator roles</t>
        </li>
        <li>
          <t>UC4  Declaring immutable system configuration from the perspective of a logical network element (LNE)</t>
        </li>
      </ul>
      <t><xref target="use-cases"/> describes the use cases in detail.</t>
      <section anchor="updates-to-rfc-8040">
        <name>Updates to RFC 8040</name>
        <t>This document updates Sections <xref target="RFC8040" section="4.8" sectionFormat="bare"/> and <xref target="RFC8040" section="9.1.1" sectionFormat="bare"/> of <xref target="RFC8040"/> to add an
  additional input parameter named "with-immutability", as specified in <xref target="RESTCONF-ext"/>.</t>
      </section>
      <section anchor="updates-to-rfc-8526">
        <name>Updates to RFC 8526</name>
        <t>This document updates <xref section="3.1.1" sectionFormat="of" target="RFC8526"/> to add an additional input parameter
   named "with-immutability" for the &lt;get-data&gt; operation, as specified in <xref target="NETCONF-ext"/>.</t>
      </section>
      <section anchor="editorial-note-to-be-removed-by-rfc-editor">
        <name>Editorial Note (To be removed by RFC Editor)</name>
        <t>Note to the RFC Editor: This section is to be removed prior to publication.</t>
        <t>This document contains placeholder values that need to be replaced with finalized
  values at the time of publication.  This note summarizes all of the
  substitutions that are needed.  No other RFC Editor instructions are specified
  elsewhere in this document.</t>
        <t>Please apply the following replacements:</t>
        <ul spacing="normal">
          <li>
            <t>XXXX --&gt; the assigned RFC number for this draft</t>
          </li>
          <li>
            <t>YYYY --&gt; the assigned RFC number for <xref target="I-D.ietf-netmod-system-config"/></t>
          </li>
          <li>
            <t>2025-05-15 --&gt; the actual date of the publication of this document</t>
          </li>
        </ul>
      </section>
    </section>
    <section anchor="conventions-and-definitions">
      <name>Conventions and Definitions</name>
      <t>The key words "<bcp14>MUST</bcp14>", "<bcp14>MUST NOT</bcp14>", "<bcp14>REQUIRED</bcp14>", "<bcp14>SHALL</bcp14>", "<bcp14>SHALL
NOT</bcp14>", "<bcp14>SHOULD</bcp14>", "<bcp14>SHOULD NOT</bcp14>", "<bcp14>RECOMMENDED</bcp14>", "<bcp14>NOT RECOMMENDED</bcp14>",
"<bcp14>MAY</bcp14>", and "<bcp14>OPTIONAL</bcp14>" in this document are to be interpreted as
described in BCP 14 <xref target="RFC2119"/> <xref target="RFC8174"/> when, and only when, they
appear in all capitals, as shown here.</t>
      <?line -18?>

<t>The document uses the following definition in <xref target="RFC6241"/>:</t>
      <ul spacing="normal">
        <li>
          <t>configuration data</t>
        </li>
      </ul>
      <t>The document uses the following definition in <xref target="RFC7950"/>:</t>
      <ul spacing="normal">
        <li>
          <t>data node</t>
        </li>
        <li>
          <t>leaf</t>
        </li>
        <li>
          <t>leaf-list</t>
        </li>
        <li>
          <t>container</t>
        </li>
        <li>
          <t>list</t>
        </li>
        <li>
          <t>anydata</t>
        </li>
        <li>
          <t>anyxml</t>
        </li>
        <li>
          <t>interior node</t>
        </li>
        <li>
          <t>data tree</t>
        </li>
      </ul>
      <t>The document uses the following definition in <xref target="RFC8341"/>:</t>
      <ul spacing="normal">
        <li>
          <t>access operation</t>
        </li>
      </ul>
      <t>The document uses the following definition in <xref target="I-D.ietf-netmod-system-config"/>:</t>
      <ul spacing="normal">
        <li>
          <t>system configuration</t>
        </li>
      </ul>
      <t>This document defines the following term:</t>
      <dl>
        <dt>immutable flag:</dt>
        <dd>
          <t>A read-only state value the server provides to describe
   immutability of the configuration, which is conveyed via a YANG metadata annotation
   called "immutable" with a boolean value.</t>
        </dd>
      </dl>
    </section>
    <section anchor="applicability">
      <name>Applicability</name>
      <t>While immutable flag applies to all configuration nodes, its value "true"
   can only be used for system configuration.</t>
      <t>The immutable flag is only visible in read-only datastores (i.e., &lt;system&gt;
   <xref target="I-D.ietf-netmod-system-config"/>, &lt;intended&gt;, and &lt;operational&gt;)
   when a "with-immutability" parameter is carried (<xref target="with-immutability"/>),
   however this only serves as descriptive information about the
   instance node itself, but has no effect on the handling of the read-only
   datastore. If the immutable flag is requested to be returned for an invalid
   datastore, then the server <bcp14>MUST</bcp14> return an &lt;rpc-error&gt; element with an &lt;error-tag&gt;
   value of "invalid-value".</t>
      <t>An instance has the same immutability if it appears in different datastores,
   the immutability of configuration data is also protocol and
   user independent. The immutability of any configuration data, and the value
   of any immutable configured data node, <bcp14>MUST</bcp14> only change via software
   upgrade, hardware resources change, or license change.</t>
    </section>
    <section anchor="immutable-metadata-annotation">
      <name>"Immutable" Metadata Annotation</name>
      <section anchor="immutable-def">
        <name>Definition</name>
        <t>The immutable flag which is defined as the metadata annotation takes a boolean
   value, and it is returned as requested by the client using a "with-immutability"
   parameter (<xref target="with-immutability"/>). If the "immutable" metadata annotation for
   a configuration node is not specified, the default "immutable" value is the
   same as the value of its parent node in the data tree (<xref target="interior"/>).
   The immutable metadata annotation value for a top-level instance
   node is "false" if not specified.</t>
        <t>A node that is annotated as immutable cannot be changed via configuring
   a different value in read-write configuration datastores (e.g., &lt;running&gt;),
   nor is there any way to delete the node from the combined configuration (as described in <xref target="I-D.ietf-netmod-system-config"/>). The node <bcp14>MAY</bcp14> be explicitly configured by a client in &lt;running&gt; with the
   same value and that configuration in &lt;running&gt; may subsequently be removed,
   but neither of these edits will change the configuration in &lt;intended&gt; (if implemented) on the device.</t>
        <t>Note that "immutable" metadata annotations are used to annotate data node
   instances.  A list may have multiple instances in the data tree,
   servers may annotate some of the instances as immutable, while others as
   mutable.</t>
        <t>Servers <bcp14>MUST</bcp14> ignore any immutable annotations sent from the client.</t>
      </section>
      <section anchor="with-immutability">
        <name>"with-immutability" Parameter</name>
        <t>This section specifies the NETCONF <xref target="RFC6241"/> <xref target="RFC8526"/> and RESTCONF <xref target="RFC8040"/>
   protocol extensions to support the "with-immutability" parameter.
   The "immutable" metadata annotations are not returned in a response unless
   explicitly requested by the client using this parameter.</t>
        <section anchor="NETCONF-ext">
          <name>NETCONF Extensions to Support "with-immutability"</name>
          <t>This doument updates <xref target="RFC8526"/> to augment the &lt;get-data&gt;
   operation with an additional parameter named "with-immutability".
   If present, this parameter requests that the server includes
   the "immutable" metadata annotations in its response.</t>
          <t><xref target="tree"/> provides the tree structure <xref target="RFC8340"/> of augmentations to NETCONF
   operations, as defined in the "ietf-immutable-annotation" module (<xref target="module"/>).</t>
          <figure anchor="tree">
            <name>Augmentations to NETCONF Operations</name>
            <artwork><![CDATA[
module: ietf-immutable-annotation
  augment /ncds:get-data/ncds:input:
    +---w with-immutability?   empty
]]></artwork>
          </figure>
        </section>
        <section anchor="RESTCONF-ext">
          <name>RESTCONF Extensions to Support "with-immutability"</name>
          <t>This document extends Sections <xref target="RFC8040" section="4.8" sectionFormat="bare"/> and <xref target="RFC8040" section="9.1.1" sectionFormat="bare"/> of <xref target="RFC8040"/> to add a query
   parameter named "with-immutability" to the GET operation. If present, this parameter
   requests that the server includes the "immutable" metadata annotations in its
   response. This parameter is only allowed with no values carried. If it has
   any unexpected value, then a "404 Bad Request" status-line is returned.</t>
          <t>To enable a RESTCONF client to discover if the "with-immutability" query parameter
   is supported by the server, the following capability URI is defined:</t>
          <artwork><![CDATA[
    urn:ietf:params:restconf:capability:with-immutability:1.0
]]></artwork>
        </section>
      </section>
    </section>
    <section anchor="use-of-immutable-flag-for-different-statements">
      <name>Use of Immutable Flag for Different Statements</name>
      <t>This section defines what the immutable flag means to the client for
   each instance of YANG data node statement.</t>
      <section anchor="the-leaf-statement">
        <name>The "leaf" Statement</name>
        <t>When a leaf node instance is immutable, it cannot be configured with a
   different value in read-write configuration datastores (e.g., &lt;running&gt;) or
   removed from &lt;intended&gt; (if implemented). Though it can be created/deleted
   in read-write configuration datastores (see Sections <xref format="counter" target="immutable-def"/> and <xref format="counter" target="system-interact"/>).</t>
      </section>
      <section anchor="the-leaf-list-statement">
        <name>The "leaf-list" Statement</name>
        <t>When a leaf-list entry is immutable, it cannot be configured with a
  different value in read-write configuration datastore (e.g., &lt;running&gt;) or
  removed from &lt;intended&gt; (if implemented). Though it can be created/deleted
  in read-write configuration datastores (see Sections <xref format="counter" target="immutable-def"/> and <xref format="counter" target="system-interact"/>).</t>
        <t>The immutable annotation attached to the individual leaf-list entry
   provides immutability with respect to the entry itself. As per the restrictions in <xref target="RFC7952"/>,
   annotations cannot be attached to an entire leaf-list instance and only
   to individual leaf-list entries, which implies a leaf-list as a whole
   can only inherit immutability from a parent node (e.g., container).</t>
        <t>If a leaf-list as a whole is immutable, any leaf-list entries cannot be added,
   modified, or reordered (if it is ordered-by user).</t>
        <t>Refer to <xref target="imm-leaf-list"/> for an example of immutability of leaf-lists.</t>
      </section>
      <section anchor="the-container-statement">
        <name>The "container" Statement</name>
        <t>When a container node instance is immutable, it cannot be removed from &lt;intended&gt; (if implemented).
   Though it can be created/deleted in read-write configuration datastores
   (see Sections <xref format="counter" target="immutable-def"/> and <xref format="counter" target="system-interact"/>).</t>
        <t>Descendant nodes of the container recursively inherit the immutability of the container, unless
   the immutability is overridden by an "immutable" annotation on a descendant node.</t>
        <t>By default, as with all interior nodes, immutability is recursively
   applied to descendants (<xref target="interior"/>).</t>
      </section>
      <section anchor="the-list-statement">
        <name>The "list" Statement</name>
        <t>When a list entry is immutable, it cannot be removed from &lt;intended&gt; (if implemented).
  Though it can be created/deleted in read-write configuration datastores
  (see Sections <xref format="counter" target="immutable-def"/> and <xref format="counter" target="system-interact"/>).</t>
        <t>Descendant nodes of the list entry recursively inherit the immutability of the list entry, unless
  the immutability is overridden by an "immutable" annotation on a descendant node.</t>
        <t>By default, as with all interior nodes, immutability is recursively
   applied to descendants (<xref target="interior"/>).</t>
        <t>The immutable annotation attached to the individual list entry provides
   immutability with respect to the entry itself. As per the restrictions in <xref target="RFC7952"/>,
   annotations cannot be attached to an entire list instance and only
   to individual list entries, which implies a list as a whole
   can only inherit immutability from a parent node (e.g., container).</t>
        <t>If a list as a whole is immutable, any list entries cannot be added, removed, or reordered (if it is ordered-by user).
   Each list entry inherits the immutability of the list by default, unless the immutability is
   overridden by an "immutable" annotation on a list entry.</t>
        <t>Refer to <xref target="imm-list"/> for an example of immutability of lists.</t>
      </section>
      <section anchor="the-anydata-statement">
        <name>The "anydata" Statement</name>
        <t>When an "anydata" node instance is immutable, it cannot be removed from &lt;intended&gt; (if implemented).
   Though it can be created/deleted in read-write configuration datastores
   (see Sections <xref format="counter" target="immutable-def"/> and <xref format="counter" target="system-interact"/>).</t>
        <t>Additionally, as with all interior nodes, immutability is recursively applied to
   descendants (<xref target="interior"/>).</t>
      </section>
      <section anchor="the-anyxml-statement">
        <name>The "anyxml" Statement</name>
        <t>When an "anyxml" node instance is immutable, it cannot be removed from &lt;intended&gt; (if implemented).
   Though it can be created/deleted in read-write configuration datastores
   (see Sections <xref format="counter" target="immutable-def"/> and <xref format="counter" target="system-interact"/>).</t>
        <t>Additionally, as with all interior nodes, immutability is recursively applied to
   descendants (<xref target="interior"/>).</t>
      </section>
    </section>
    <section anchor="interior">
      <name>Immutability of Interior Nodes</name>
      <t>Immutability is a conceptual operational state value that is
   recursively applied to descendants, which may reset the immutability
   state as needed, thereby affecting their descendants.  There is no limit
   to the number of times the immutability state may change in a data tree.</t>
      <t>If the "immutable" metadata annotation for returned child node is omitted,
   it has the same immutability as its parent node. The immutability of top
   hierarchy of returned nodes is false by default. Servers may suppress the
   annotation if it is inherited from its parent node or uses the default value
   as the top-level node, but are not precluded from returning the annotation
   on every single element.</t>
      <t>Refer to <xref target="inherit"/> for an example of how immutability is recursively
   inherited or explicitly reset by descendants.</t>
    </section>
    <section anchor="system-interact">
      <name>System Configuration Datastore Interactions</name>
      <t>Immutable configuration can only be created, updated and deleted by the server,
   and it is present in &lt;system&gt;, if implemented. That said, the existence of
   immutable configuration is independent of whether &lt;system&gt; is implemented or
   not. Not all system configuration data is immutable. Immutable configuration
   does not appear in &lt;running&gt; unless it is explicitly configured.</t>
      <t>As specified in <xref target="immutable-def"/>, a client <bcp14>MAY</bcp14> create/delete immutable nodes
   with same values as defined by server in read-write configuration datastore (e.g.,
   &lt;candidate&gt;, &lt;running&gt;), which merely mean making immutable nodes
   visible/invisible in the datastore.</t>
    </section>
    <section anchor="nacm-interactions">
      <name>NACM Interactions</name>
      <t>The server rejects an operation request due to immutability when it
   tries to perform the operation on the request data.  It happens after
   any access control processing, if the Network Configuration Access
   Control Model (NACM) <xref target="RFC8341"/> is implemented on a server.  For
   example, if an operation requests to override an immutable
   configuration data, but the server checks the user is not authorized
   to perform the requested access operation on the request data, the
   request is rejected with an "access-denied" error.</t>
    </section>
    <section anchor="module">
      <name>YANG Module</name>
      <t>This module imports definitions from <xref target="RFC6241"/> and <xref target="RFC8526"/>.</t>
      <sourcecode markers="true" name="ietf-immutable-annotation@2025-05-15.yang"><![CDATA[
module ietf-immutable-annotation {
  yang-version 1.1;
  namespace "urn:ietf:params:xml:ns:yang:ietf-immutable-annotation";
  prefix imma;

  import ietf-yang-metadata {
    prefix md;
  }
  import ietf-netconf-nmda {
    prefix ncds;
    reference
      "RFC 8526: NETCONF Extensions to Support the Network
       Management Datastore Architecture";
  }
  import ietf-system-datastore {
    prefix sysds;
    reference
      "RFC YYYY: System-defined Configuration";
  }
  import ietf-datastores {
    prefix ds;
    reference
      "RFC 8342: Network Management Datastore Architecture
                 (NMDA)";
  }

  organization
    "IETF Network Modeling (NETMOD) Working Group";

  contact
    "WG Web: <https://datatracker.ietf.org/wg/netmod/>
     WG List: <mailto:netmod@ietf.org>
     Author: Qiufang Ma
             <mailto:maqiufang1@huawei.com>
     Author: Qin Wu
             <mailto:bill.wu@huawei.com>
     Author: Balazs Lengyel
             <mailto:balazs.lengyel@ericsson.com>
     Author: Hongwei Li
             <mailto:flycoolman@gmail.com>";

  description
    "This module defines a metadata annotation called 'immutable'
     to allow the server to formally document existing behavior on
     the mutability of some system configuration. Clients may use
     'immutable' metadata annotation provided by the server to know
     beforehand why certain otherwise valid configuration requests
     will cause the server to return an error.

     Copyright (c) 2025 IETF Trust and the persons identified
     as authors of the code. All rights reserved.

     Redistribution and use in source and binary forms, with
     or without modification, is permitted pursuant to, and
     subject to the license terms contained in, the Revised
     BSD License set forth in Section 4.c of the IETF Trust's
     Legal Provisions Relating to IETF Documents
     (https://trustee.ietf.org/license-info).

     This version of this YANG module is part of RFC HHHH
     (https://www.rfc-editor.org/info/rfcHHHH); see the RFC
     itself for full legal notices.

     The key words 'MUST', 'MUST NOT', 'REQUIRED', 'SHALL',
     'SHALL NOT', 'SHOULD', 'SHOULD NOT', 'RECOMMENDED',
     'NOT RECOMMENDED', 'MAY', and 'OPTIONAL' in this document
     are to be interpreted as described in BCP 14 (RFC 2119)
     (RFC 8174) when, and only when, they appear in all
     capitals, as shown here.";

  revision 2025-05-15 {
    description
      "Initial revision.";
    // RFC Ed.: replace XXXX and remove this comment
    reference
      "RFC XXXX: YANG Metadata Annotation for Immutable Flag";
  }

  md:annotation immutable {
    type boolean;
    description
      "The 'immutable' metadata annotation indicates the 
       immutability of an instantiated data node. It takes as a
       value 'true' or 'false'. An immutable node cannot be changed 
       via configuring a different value in read-write configuration 
       datastores (e.g., <running>), though it can be created/deleted
       in read-write configuration datastores. If not specified for 
       a given configuration data node, the immutability is the
       same as the value of its parent node in the data tree. The
       default value of 'immutable' annotation for a top-level 
       instance node is false if not specified.";
  }

  augment "/ncds:get-data/ncds:input" {
    description
      "Allows the server to include 'immutable' metadata
       annotations in its response to get-data operation.";
    leaf with-immutability {
      when "derived-from-or-self(../ncds:datastore,'sysds:system') "
      +"or derived-from-or-self(../ncds:datastore,'ds:intended') "
      +"or derived-from-or-self(../ncds:datastore,'ds:operational')";
      type empty;
      description
        "If this parameter is present, the server returns the
         'immutable' annotation for configuration that it
         internally thinks immutable.";
    }
  }
}
]]></sourcecode>
    </section>
    <section anchor="security-considerations">
      <name>Security Considerations</name>
      <t>This section is modeled after the template described in <xref section="3.7" sectionFormat="of" target="I-D.ietf-netmod-rfc8407bis"/>.</t>
      <t>The "ietf-immutable-annotation" YANG module defines a data model that is
   designed to be accessed via YANG-based management protocols, such
   as NETCONF <xref target="RFC6241"/> or RESTCONF <xref target="RFC8040"/>. These protocols have to
   use a secure transport layer (e.g., SSH <xref target="RFC4252"/>, TLS <xref target="RFC8446"/>, and
   QUIC <xref target="RFC9000"/>) and have to use mutual authentication.</t>
      <t>The Network Configuration Access Control Model (NACM) <xref target="RFC8341"/>
   provides the means to restrict access for particular NETCONF or
   RESTCONF users to a preconfigured subset of all available NETCONF or
   RESTCONF protocol operations and content.</t>
      <t>The YANG module specified in this document defines a metadata annotation,
   it also extends the RPC operations of the NETCONF protocol in <xref target="RFC6241"/>
   and <xref target="RFC8526"/>.</t>
      <t>The immutable metadata annotation exposes the immutability of configuration data,
   which may provide hints for attackers to find vulnerabilities in the network,
   e.g., to leverage the immutability of some configuration to better craft an attack.
   Since immutable annotations are attached to the instances of configuration data nodes,
   it is only accessible to clients that have the permissions to read the annotated configuration nodes.</t>
      <t>The security considerations for the NETCONF protocol operations (see
   <xref section="9" sectionFormat="of" target="RFC6241"/> and <xref section="6" sectionFormat="of" target="RFC8526"/>) also apply to
   the operations extended in this document.</t>
    </section>
    <section anchor="iana-considerations">
      <name>IANA Considerations</name>
      <section anchor="the-ietf-xml-registry">
        <name>The "IETF XML" Registry</name>
        <t>This document registers one XML namespace URN in the 'IETF XML registry',
   following the format defined in <xref target="RFC3688"/>.</t>
        <artwork><![CDATA[
        URI: urn:ietf:params:xml:ns:yang:ietf-immutable-annotation
        Registrant Contact: The IESG.
        XML: N/A, the requested URIs are XML namespaces.
]]></artwork>
      </section>
      <section anchor="the-yang-module-names-registry">
        <name>The "YANG Module Names" Registry</name>
        <t>This document registers one module name in the 'YANG Module Names'
registry, defined in <xref target="RFC6020"/>.</t>
        <artwork><![CDATA[
        name: ietf-immutable-annotation
        prefix: imma
        namespace: urn:ietf:params:xml:ns:yang:ietf-immutable-annotation
        RFC: XXXX
]]></artwork>
      </section>
      <section anchor="restconf-capability-urn-registry">
        <name>RESTCONF Capability URN Registry</name>
        <t>This document defines the following capability identifier URNs in the
"RESTCONF Capability URNs" registry defined in <xref target="RFC8040"/>:</t>
        <artwork><![CDATA[
Index
Capability Identifier
---------------------

:with-immutability
urn:ietf:params:restconf:capability:with-immutability:1.0
]]></artwork>
      </section>
    </section>
  </middle>
  <back>
    <references anchor="sec-combined-references">
      <name>References</name>
      <references anchor="sec-normative-references">
        <name>Normative References</name>
        <reference anchor="RFC7952">
          <front>
            <title>Defining and Using Metadata with YANG</title>
            <author fullname="L. Lhotka" initials="L." surname="Lhotka"/>
            <date month="August" year="2016"/>
            <abstract>
              <t>This document defines a YANG extension that allows for defining metadata annotations in YANG modules. The document also specifies XML and JSON encoding of annotations and other rules for annotating instances of YANG data nodes.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7952"/>
          <seriesInfo name="DOI" value="10.17487/RFC7952"/>
        </reference>
        <reference anchor="RFC7950">
          <front>
            <title>The YANG 1.1 Data Modeling Language</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <date month="August" year="2016"/>
            <abstract>
              <t>YANG is a data modeling language used to model configuration data, state data, Remote Procedure Calls, and notifications for network management protocols. This document describes the syntax and semantics of version 1.1 of the YANG language. YANG version 1.1 is a maintenance release of the YANG language, addressing ambiguities and defects in the original specification. There are a small number of backward incompatibilities from YANG version 1. This document also specifies the YANG mappings to the Network Configuration Protocol (NETCONF).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="7950"/>
          <seriesInfo name="DOI" value="10.17487/RFC7950"/>
        </reference>
        <reference anchor="RFC8040">
          <front>
            <title>RESTCONF Protocol</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <date month="January" year="2017"/>
            <abstract>
              <t>This document describes an HTTP-based protocol that provides a programmatic interface for accessing data defined in YANG, using the datastore concepts defined in the Network Configuration Protocol (NETCONF).</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8040"/>
          <seriesInfo name="DOI" value="10.17487/RFC8040"/>
        </reference>
        <reference anchor="RFC8526">
          <front>
            <title>NETCONF Extensions to Support the Network Management Datastore Architecture</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." surname="Schoenwaelder"/>
            <author fullname="P. Shafer" initials="P." surname="Shafer"/>
            <author fullname="K. Watsen" initials="K." surname="Watsen"/>
            <author fullname="R. Wilton" initials="R." surname="Wilton"/>
            <date month="March" year="2019"/>
            <abstract>
              <t>This document extends the Network Configuration Protocol (NETCONF) defined in RFC 6241 in order to support the Network Management Datastore Architecture (NMDA) defined in RFC 8342.</t>
              <t>This document updates RFCs 6241 and 7950. The update to RFC 6241 adds new and operations and augments existing,, and operations. The update to RFC 7950 requires the usage of the YANG library (described in RFC 8525) by NETCONF servers implementing the NMDA.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8526"/>
          <seriesInfo name="DOI" value="10.17487/RFC8526"/>
        </reference>
        <reference anchor="I-D.ietf-netmod-system-config">
          <front>
            <title>System-defined Configuration</title>
            <author fullname="Qiufang Ma" initials="Q." surname="Ma">
              <organization>Huawei</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <author fullname="Chong Feng" initials="C." surname="Feng">
         </author>
            <date day="12" month="February" year="2025"/>
            <abstract>
              <t>   The Network Management Datastore Architecture (NMDA) in RFC 8342
   defines several configuration datastores holding configuration.  The
   contents of these configuration datastores are controlled by clients.
   This document introduces the concept of system configuration
   datastore holding configuration controlled by the system on which a
   server is running.  The system configuration can be referenced (e.g.,
   leafref) by configuration explicitly created by clients.

   This document updates RFC 8342.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-netmod-system-config-12"/>
        </reference>
        <reference anchor="RFC2119">
          <front>
            <title>Key words for use in RFCs to Indicate Requirement Levels</title>
            <author fullname="S. Bradner" initials="S." surname="Bradner"/>
            <date month="March" year="1997"/>
            <abstract>
              <t>In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="2119"/>
          <seriesInfo name="DOI" value="10.17487/RFC2119"/>
        </reference>
        <reference anchor="RFC8174">
          <front>
            <title>Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words</title>
            <author fullname="B. Leiba" initials="B." surname="Leiba"/>
            <date month="May" year="2017"/>
            <abstract>
              <t>RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="14"/>
          <seriesInfo name="RFC" value="8174"/>
          <seriesInfo name="DOI" value="10.17487/RFC8174"/>
        </reference>
        <reference anchor="RFC6241">
          <front>
            <title>Network Configuration Protocol (NETCONF)</title>
            <author fullname="R. Enns" initials="R." role="editor" surname="Enns"/>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <author fullname="J. Schoenwaelder" initials="J." role="editor" surname="Schoenwaelder"/>
            <author fullname="A. Bierman" initials="A." role="editor" surname="Bierman"/>
            <date month="June" year="2011"/>
            <abstract>
              <t>The Network Configuration Protocol (NETCONF) defined in this document provides mechanisms to install, manipulate, and delete the configuration of network devices. It uses an Extensible Markup Language (XML)-based data encoding for the configuration data as well as the protocol messages. The NETCONF protocol operations are realized as remote procedure calls (RPCs). This document obsoletes RFC 4741. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6241"/>
          <seriesInfo name="DOI" value="10.17487/RFC6241"/>
        </reference>
        <reference anchor="RFC8341">
          <front>
            <title>Network Configuration Access Control Model</title>
            <author fullname="A. Bierman" initials="A." surname="Bierman"/>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>The standardization of network configuration interfaces for use with the Network Configuration Protocol (NETCONF) or the RESTCONF protocol requires a structured and secure operating environment that promotes human usability and multi-vendor interoperability. There is a need for standard mechanisms to restrict NETCONF or RESTCONF protocol access for particular users to a preconfigured subset of all available NETCONF or RESTCONF protocol operations and content. This document defines such an access control model.</t>
              <t>This document obsoletes RFC 6536.</t>
            </abstract>
          </front>
          <seriesInfo name="STD" value="91"/>
          <seriesInfo name="RFC" value="8341"/>
          <seriesInfo name="DOI" value="10.17487/RFC8341"/>
        </reference>
        <reference anchor="RFC3688">
          <front>
            <title>The IETF XML Registry</title>
            <author fullname="M. Mealling" initials="M." surname="Mealling"/>
            <date month="January" year="2004"/>
            <abstract>
              <t>This document describes an IANA maintained registry for IETF standards which use Extensible Markup Language (XML) related items such as Namespaces, Document Type Declarations (DTDs), Schemas, and Resource Description Framework (RDF) Schemas.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="81"/>
          <seriesInfo name="RFC" value="3688"/>
          <seriesInfo name="DOI" value="10.17487/RFC3688"/>
        </reference>
        <reference anchor="RFC6020">
          <front>
            <title>YANG - A Data Modeling Language for the Network Configuration Protocol (NETCONF)</title>
            <author fullname="M. Bjorklund" initials="M." role="editor" surname="Bjorklund"/>
            <date month="October" year="2010"/>
            <abstract>
              <t>YANG is a data modeling language used to model configuration and state data manipulated by the Network Configuration Protocol (NETCONF), NETCONF remote procedure calls, and NETCONF notifications. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="6020"/>
          <seriesInfo name="DOI" value="10.17487/RFC6020"/>
        </reference>
      </references>
      <references anchor="sec-informative-references">
        <name>Informative References</name>
        <reference anchor="TR-531" target="https://wiki.opennetworking.org/download/attachments/376340494/Draft_TR-531_UML-YANG_Mapping_Gdls_v1.1.03.docx?version=5&amp;modificationDate=1675432243513&amp;api=v2">
          <front>
            <title>UML to YANG Mapping Guidelines</title>
            <author>
              <organization>ONF</organization>
            </author>
            <date year="2023" month="February"/>
          </front>
        </reference>
        <reference anchor="TS28.623" target="https://www.3gpp.org/ftp/Specs/archive/28_series/28.623/28623-i02.zip">
          <front>
            <title>Telecommunication management; Generic Network Resource Model (NRM) Integration Reference Point (IRP); Solution Set (SS) definitions</title>
            <author>
              <organization>3GPP</organization>
            </author>
            <date/>
          </front>
        </reference>
        <reference anchor="TS32.156" target="https://www.3gpp.org/ftp/Specs/archive/32_series/32.156/32156-h10.zip">
          <front>
            <title>Telecommunication management; Fixed Mobile Convergence (FMC) Model repertoire</title>
            <author>
              <organization>3GPP</organization>
            </author>
            <date/>
          </front>
        </reference>
        <reference anchor="RFC8340">
          <front>
            <title>YANG Tree Diagrams</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <author fullname="L. Berger" initials="L." role="editor" surname="Berger"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document captures the current syntax used in YANG module tree diagrams. The purpose of this document is to provide a single location for this definition. This syntax may be updated from time to time based on the evolution of the YANG language.</t>
            </abstract>
          </front>
          <seriesInfo name="BCP" value="215"/>
          <seriesInfo name="RFC" value="8340"/>
          <seriesInfo name="DOI" value="10.17487/RFC8340"/>
        </reference>
        <reference anchor="I-D.ietf-netmod-rfc8407bis">
          <front>
            <title>Guidelines for Authors and Reviewers of Documents Containing YANG Data Models</title>
            <author fullname="Andy Bierman" initials="A." surname="Bierman">
              <organization>YumaWorks</organization>
            </author>
            <author fullname="Mohamed Boucadair" initials="M." surname="Boucadair">
              <organization>Orange</organization>
            </author>
            <author fullname="Qin Wu" initials="Q." surname="Wu">
              <organization>Huawei</organization>
            </author>
            <date day="5" month="May" year="2025"/>
            <abstract>
              <t>   This memo provides guidelines for authors and reviewers of
   specifications containing YANG modules, including IANA-maintained
   modules.  Recommendations and procedures are defined, which are
   intended to increase interoperability and usability of Network
   Configuration Protocol (NETCONF) and RESTCONF Protocol
   implementations that utilize YANG modules.  This document obsoletes
   RFC 8407.

   Also, this document updates RFC 8126 by providing additional
   guidelines for writing the IANA considerations for RFCs that specify
   IANA-maintained modules.

              </t>
            </abstract>
          </front>
          <seriesInfo name="Internet-Draft" value="draft-ietf-netmod-rfc8407bis-25"/>
        </reference>
        <reference anchor="RFC4252">
          <front>
            <title>The Secure Shell (SSH) Authentication Protocol</title>
            <author fullname="T. Ylonen" initials="T." surname="Ylonen"/>
            <author fullname="C. Lonvick" initials="C." role="editor" surname="Lonvick"/>
            <date month="January" year="2006"/>
            <abstract>
              <t>The Secure Shell Protocol (SSH) is a protocol for secure remote login and other secure network services over an insecure network. This document describes the SSH authentication protocol framework and public key, password, and host-based client authentication methods. Additional authentication methods are described in separate documents. The SSH authentication protocol runs on top of the SSH transport layer protocol and provides a single authenticated tunnel for the SSH connection protocol. [STANDARDS-TRACK]</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="4252"/>
          <seriesInfo name="DOI" value="10.17487/RFC4252"/>
        </reference>
        <reference anchor="RFC8446">
          <front>
            <title>The Transport Layer Security (TLS) Protocol Version 1.3</title>
            <author fullname="E. Rescorla" initials="E." surname="Rescorla"/>
            <date month="August" year="2018"/>
            <abstract>
              <t>This document specifies version 1.3 of the Transport Layer Security (TLS) protocol. TLS allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery.</t>
              <t>This document updates RFCs 5705 and 6066, and obsoletes RFCs 5077, 5246, and 6961. This document also specifies new requirements for TLS 1.2 implementations.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8446"/>
          <seriesInfo name="DOI" value="10.17487/RFC8446"/>
        </reference>
        <reference anchor="RFC9000">
          <front>
            <title>QUIC: A UDP-Based Multiplexed and Secure Transport</title>
            <author fullname="J. Iyengar" initials="J." role="editor" surname="Iyengar"/>
            <author fullname="M. Thomson" initials="M." role="editor" surname="Thomson"/>
            <date month="May" year="2021"/>
            <abstract>
              <t>This document defines the core of the QUIC transport protocol. QUIC provides applications with flow-controlled streams for structured communication, low-latency connection establishment, and network path migration. QUIC includes security measures that ensure confidentiality, integrity, and availability in a range of deployment circumstances. Accompanying documents describe the integration of TLS for key negotiation, loss detection, and an exemplary congestion control algorithm.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="9000"/>
          <seriesInfo name="DOI" value="10.17487/RFC9000"/>
        </reference>
        <reference anchor="RFC8343">
          <front>
            <title>A YANG Data Model for Interface Management</title>
            <author fullname="M. Bjorklund" initials="M." surname="Bjorklund"/>
            <date month="March" year="2018"/>
            <abstract>
              <t>This document defines a YANG data model for the management of network interfaces. It is expected that interface-type-specific data models augment the generic interfaces data model defined in this document. The data model includes definitions for configuration and system state (status information and counters for the collection of statistics).</t>
              <t>The YANG data model in this document conforms to the Network Management Datastore Architecture (NMDA) defined in RFC 8342.</t>
              <t>This document obsoletes RFC 7223.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8343"/>
          <seriesInfo name="DOI" value="10.17487/RFC8343"/>
        </reference>
        <reference anchor="RFC8530">
          <front>
            <title>YANG Model for Logical Network Elements</title>
            <author fullname="L. Berger" initials="L." surname="Berger"/>
            <author fullname="C. Hopps" initials="C." surname="Hopps"/>
            <author fullname="A. Lindem" initials="A." surname="Lindem"/>
            <author fullname="D. Bogdanovic" initials="D." surname="Bogdanovic"/>
            <author fullname="X. Liu" initials="X." surname="Liu"/>
            <date month="March" year="2019"/>
            <abstract>
              <t>This document defines a logical network element (LNE) YANG module that is compliant with the Network Management Datastore Architecture (NMDA). This module can be used to manage the logical resource partitioning that may be present on a network device. Examples of common industry terms for logical resource partitioning are logical systems or logical routers. The YANG model in this document conforms with NMDA as defined in RFC 8342.</t>
            </abstract>
          </front>
          <seriesInfo name="RFC" value="8530"/>
          <seriesInfo name="DOI" value="10.17487/RFC8530"/>
        </reference>
      </references>
    </references>
    <?line 621?>

<section anchor="use-cases">
      <name>Detailed Use Cases</name>
      <section anchor="uc1-modeling-of-server-capabilities">
        <name>UC1 - Modeling of server capabilities</name>
        <t>System capabilities might be represented as immutable configuration.
   Configurable data nodes might need constraints specified as
   "when", "must" or "path" statements to ensure that configuration is set
   according to the system's capabilities. For example,</t>
        <ul spacing="normal">
          <li>
            <t>A timer can support the values 1,5,8 seconds. This is defined in the
   leaf-list 'supported-timer-values'.</t>
          </li>
          <li>
            <t>When the configurable 'interface-timer' leaf is set, it should be ensured
   that one of the supported values is used.  The natural solution would be to
   make the 'interface-timer' a leaf-ref pointing at the 'supported-timer-values'.</t>
          </li>
        </ul>
        <t>However, this is not possible as 'supported-timer-values' must be
   read-only thus config=false while 'interface-timer' must be writable
   thus config=true.  According to the rules of YANG it is not allowed
   to put a constraint between config true and false data nodes.</t>
        <t>The solution is that the supported-timer-values data node in the YANG
   Model shall be defined as "config true" and shall also be marked with
   the "immutable" annotation making it unchangeable. After this the
   'interface-timer' shall be defined as a leaf-ref pointing at the
   'supported-timer-values'.</t>
      </section>
      <section anchor="uc2-hardware-based-auto-configuration-interface-example">
        <name>UC2 - Hardware based auto-configuration - Interface Example</name>
        <t><xref target="RFC8343"/> defines a YANG data model for the management of network
   interfaces.  When a system-controlled interface is physically present,
   the system creates an interface entry with valid name and type
   values in &lt;system&gt; (if exists, see <xref target="I-D.ietf-netmod-system-config"/>).</t>
        <t>The system-generated type value is dependent on and represents the hardware
   present, and as a consequence cannot be changed by the client.  If a
   client tries to set the type of an interface to a value that can
   never be used by the system, the request will be rejected by the
   server.  The data is modeled as "config true" and thus should be annotated
   as immutable.</t>
        <t>Seemingly an alternative would be to model the list and these leaves
   as "config false", but that does not work because:</t>
        <ul spacing="normal">
          <li>
            <t>The list cannot be marked as "config false", because it needs to contain
  configurable child nodes, e.g., ip-address or enabled;</t>
          </li>
          <li>
            <t>The key leaf (name) cannot be marked as "config false" as the list
  itself is config true;</t>
          </li>
          <li>
            <t>The type cannot be marked "config false", because we <bcp14>MAY</bcp14> need to
  reference the type to make different configuration nodes
  conditionally available.</t>
          </li>
        </ul>
      </section>
      <section anchor="uc3-predefined-administrator-roles">
        <name>UC3 - Predefined Administrator Roles</name>
        <t>User and group management is fundamental for setting up access
   control rules (see <xref section="2.5" sectionFormat="of" target="RFC8341"/>).</t>
        <t>A device may provide a predefined user account (e.g., a system
   administrator that is always available and has full privileges) for
   initial system set up and management of other users/groups.  It is
   possible that a new user/group can be defined granted particular privileges,
   but the predefined administrator account and its granted access are immutable.</t>
      </section>
      <section anchor="uc4-declaring-immutable-system-configuration-from-the-perspective-of-a-logical-network-element-lne">
        <name>UC4 - Declaring immutable system configuration from the perspective of a logical network element (LNE)</name>
        <t>A logical network element (LNE), as described in <xref target="RFC8530"/>, is an independently managed virtual
   network device made up of resources allocated to it from its host or
   parent network device.  The host device may allocate some
   resources to an LNE, which from an LNE's perspective is provided by
   the system and may not be modifiable.</t>
        <t>For example, a host may allocate an interface to an LNE with a valid
   MTU value as its management interface, so that the allocated
   interface should then be accessible as the LNE-specific instance of
   the interface model.  The assigned MTU value is system-created and
   immutable from the context of the LNE.</t>
      </section>
    </section>
    <section anchor="example-of-servers-immutable-behavior">
      <name>Example of Server's Immutable Behavior</name>
      <t>This section provides some examples to illustrate the server's behavior with
  immutable flag. The following fictional module is used throughout this section:</t>
      <artwork><![CDATA[
module example-user-group {
  yang-version 1.1;
  namespace "urn:example:user-group";
  prefix "ex-urp";

  import iana-crypt-hash {
    prefix ianach;
  }

  container user-groups {
    list user-group {
      key "name";
      leaf name {
        type string;
      }
      leaf description {
        type string;
      }      
      leaf access-right {
        type enumeration {
          enum admin;
          enum power;          
          enum normal;
          enum guest;
        }
      }
      list user {
        key "user-name";
        leaf user-name {
          type string;
        }
        leaf password {
          type ianach:crypt-hash;
        }
        leaf full-name {
          type string;
        }
      }
      leaf-list tag {
        type string;
        ordered-by user;
      }
    }
  }
}
]]></artwork>
      <t><xref target="example"/> shows an example of "user-groups" configuration in &lt;system&gt; a
server might return. XML snippets are used only for illustration purposes.</t>
      <figure anchor="example">
        <name>An Example of System-defined 'user-groups' Configuration</name>
        <artwork><![CDATA[
=============== NOTE: '\' line wrapping per RFC 8792 ================

<user-groups xmlns="urn:example:user-group"
  xmlns:imma="urn:ietf:params:xml:ns:yang:ietf-immutable-annotation"
  imma:immutable="false">
  <user-group imma:immutable="true">
    <name>administrator</name>
    <description imma:immutable="false">administrator group</\
                                                         description>
    <access-right>admin</access-right>
    <user>
      <user-name>Andy</user-name>
      <password>$0$423423423</password>
    </user>
    <user imma:immutable="false">
      <user-name>Bob</user-name>
      <password>$1$/h1234q$abcdef1234567890abcdef</password>
    </user>    
    <tag>system</tag>
    <tag>non-editable</tag>
  </user-group>
  <user-group imma:immutable="false">
    <name>power-users</name>
    <description>Power user group</description>
    <access-right>power</access-right>
    <user>
      <user-name>Cindy</user-name>
      <password>$1$/h4567q$abcdef2345678901abcdef</password>
    </user>
    <tag>system</tag>
    <tag>editable</tag>
  </user-group>
</user-groups>
]]></artwork>
      </figure>
      <section anchor="inherit">
        <name>The Inheritance of Immutability</name>
        <t>In the example in <xref target="example"/>, there are two "user-group" list entries inside "user-groups"
container node. The "immutable" metadata attribute for "user-groups" container
instance is "false", which is also its default value as the top-level element,
and thus can be omitted. The "administrator" list entry is immutable
with the immutability of its descendant nodes "description" and "user" list entry of "Bob" being explicitly toggled.
Other descendant nodes inside "administrator" list entry inherit the immutability of the list entry thus are also immutable.</t>
        <t>The "immutable" metadata attribute
for "power-users" list entry is "false", which is also the same
value as its parent node (i.e., the "user-groups" container), and thus can be omitted.
Other descendant nodes inside "power-users" user-group inherit the immutability of the list entry thus are also mutable.</t>
      </section>
      <section anchor="imm-list">
        <name>Immutability of the list</name>
        <t>In the example in <xref target="example"/>, the "user-group" list as a whole inherits immutability from the
 container "user-groups", which is mutable. One of the list entry named "administrator" is immutable,
 and the other entry named "power-user" is mutable. The client is able to copy the entire "user-groups"
 container in &lt;running&gt;, add new user-group entries, modify the values of descendant nodes of "power-users" list entry,
 but the values of descendant nodes of "administrator" list entry cannot be overridden with different values expect
 for the "description" and "Bob" user list entry nodes, which is explicitly reset to be mutable. The client
 may also subsequently delete any copied "user-group" entries or the entire
 "user-groups" container, but this will not prevent the
 configuration as shown in <xref target="example"/> being present in &lt;intended&gt; (if implemented).</t>
        <t>The "user" list inside the "administrator" user-group list entry as a whole inherits immutability from the
 list entry, which is immutable. Thus the client cannot add new user entries inside "administrator" user-group.
 As one of the user entry named "Andy" is immutable through inheritance,
 and the other "Bob" user entry is explicitly set to be mutable. The client cannot
 modify the "password" parameter, or add a "full-name" value for user "Andy".
 but is allowed to update (e.g., modify the "password" value, or add a "full-name" value)
 the list entry for user "Bob". The client may copy or subsequently delete any of the two list entries in &lt;running&gt;,
 but there is no way to delete the nodes from &lt;intended&gt; (if implemented).</t>
      </section>
      <section anchor="imm-leaf-list">
        <name>Immutability of the leaf-list</name>
        <t>In the example in <xref target="example"/>, the user-ordered "tag" leaf-list node inside the "administrator" user-group entry as a whole inherits immutability from the list entry, which is immutable. Thus the client cannot add, modify, or reorder
entries, the client may copy or subsequently delete any of the two leaf-list entries in &lt;running&gt;,
but there is no way to delete the nodes from &lt;intended&gt;.</t>
        <t>The leaf-list node instance inside the "power-users" user-group entry as a whole inherits
immutability from the list entry, which is mutable. Thus the client can add or reorder
entries, the client may copy or subsequently delete any of the two leaf-list entries in &lt;running&gt;,
but there is no way to delete the nodes from &lt;intended&gt;.</t>
      </section>
    </section>
    <section anchor="implementations">
      <name>Existing Implementations</name>
      <t>Note to the RFC Editor: Please remove this section prior to publication.</t>
      <t>There are already a number of full or partial implementations of
   immutability:</t>
      <ul spacing="normal">
        <li>
          <t>3GPP TS 32.156 <xref target="TS32.156"/> and 28.623 <xref target="TS28.623"/>: Requirements
   and a partial solution</t>
        </li>
        <li>
          <t>ITU-T using ONF TR-531 <xref target="TR-531"/> concept on information model level but
   no YANG representation.</t>
        </li>
        <li>
          <t>Ericsson: requirements and solution</t>
        </li>
        <li>
          <t>YumaPro: requirements and solution</t>
        </li>
        <li>
          <t>Nokia: partial requirements and solution</t>
        </li>
        <li>
          <t>Huawei: partial requirements and solution</t>
        </li>
        <li>
          <t>Cisco using the concept at least in some YANG modules</t>
        </li>
        <li>
          <t>Junos OS provides a hidden and immutable configuration group
   called junos-defaults</t>
        </li>
      </ul>
    </section>
    <section numbered="false" anchor="acknowledgments">
      <name>Acknowledgments</name>
      <t>Thanks to Kent Watsen, Jan Lindblad, Jason Sterne, Robert Wilton, Andy Bierman,
   Juergen Schoenwaelder, Reshad Rahman, Anthony Somerset, Lou Berger, Joe Clarke,
   and Scott Mansfield for reviewing, and providing important inputs to this document.</t>
    </section>
  </back>
  <!-- ##markdown-source:
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

-->

</rfc>
