ieee802-dot1ae-pry

This YANG module augments the configuration and operational state data for interfaces for the MAC Privacy project: Std 802.1AE;...

  • Version: 2022-06-17

    ieee802-dot1ae-pry@2022-06-17


    
      module ieee802-dot1ae-pry {
    
        yang-version 1.1;
    
        namespace
          "urn:ieee:std:802.1AE:yang:ieee802-dot1ae-pry";
    
        prefix pry;
    
        import ietf-interfaces {
          prefix if;
        }
        import ietf-yang-types {
          prefix yang;
        }
        import ieee802-dot1q-types {
          prefix dot1q-types;
        }
        import ieee802-types {
          prefix ieee;
        }
        import iana-if-type {
          prefix ianaift;
        }
    
        organization "IEEE 802.1 Working Group";
    
        contact
          "WG-URL: http:ieee802.org/1/
         WG-EMail: stds-802-1-l@ieee.org
    
         Contact: IEEE 802.1 Working Group Chair
         Postal: C/O IEEE 802.1 Working Group
               IEEE Standards Association
               445 Hoes Lane
               Piscataway, NJ 08855
               USA
    
         E-mail: stds-802-1-chairs@ieee.org";
    
        description
          "This YANG module augments the configuration and operational state
         data for interfaces for the MAC Privacy project: Std 802.1AE; see
         that standard and its amendments for full legal notices.
    
         A MAC Privacy protection Entity (PrY) is a protocol shim in an
         interface stack that encapsulates user data frames in MAC Privacy
         protection Data Units (MPPDUs). Once those MPPDUs are
         confidentiality protected by MACsec, the ability of potential
         adversaries to draw conclusions from the source and destination
         MAC addresses, sizes, and transmission timing and frequency of
         user data frames is reduced or eliminated.
    
         Each PrY in a system and its managed objects augments its upper
         interface (Private Port), which provides a privacy protected
         service to its user, typically a Bridge Port (IEEE Std 802.1Q) or
         an end station protocol stack. Object names can be conveniently
         pronounced by rendering Pry as Privacy.";
    
        revision "2022-06-17" {
          description
            "The following reference statement identifies each referenced IEEE
           Standard as updated by applicable amendments.";
          reference
            "IEEE Std 802.1AE Media Access Control (MAC) Security: 
            IEEE Stds 802.1AE-2018, 802.1AE-2018-Cor1-2020, 802.1AEdk-2022. 
            IEEE Std 802.1X Port-Based Network Access Control: 
            IEEE Std 802.1X-2020.
            IEEE Std 802.1Q Bridges and Bridged Networks:
            IEEE Std 802.Q-2022";
    
        }
    
    
        feature macsec-priv {
          description "Feature MAC Privacy.";
        }
    
        identity priority-map-identity {
          description
            "Base identity for assigning a priority to a Privacy type.";
        }
    
        identity channel-identity {
          description
            "Base identity for privacy channel.";
        }
    
        identity express-channel {
          base channel-identity;priority-map-identity;
          description
            "This is the express privacy channel frame designation.";
          reference
            "20.13.4 of IEEE Std 802.1AE";
    
        }
    
        identity preemptable-channel {
          base channel-identity;priority-map-identity;
          description
            "This is the preemptable privacy channel designation.";
          reference
            "20.13.4 of IEEE Std 802.1AE";
    
        }
    
        identity frame-identity {
          description
            "Base identity for privacy frame.";
        }
    
        identity privacy-frame {
          base frame-identity;priority-map-identity;
          description
            "This is a privacy frame designation.";
          reference
            "3 of IEEE Std 802.1AE";
    
        }
    
        identity none-identity {
          description
            "Base identity for privacy frame.";
        }
    
        identity none {
          base none-identity;priority-map-identity;
          description
            "This is no privacy encapsulation. Frames mapped to this
           identity are forwarded directly without MAC privacy
           encapsulation.";
          reference
            "17 of IEEE Std 802.1AE";
    
        }
    
        notification pry-max-peers-exceeded {
          description
            "A max-peers-exceeded notification is sent when the value
           of if-num-peers exceeds if-max-peers. This is triggered
           only on the transition to the exceeded state and reset
           when the if-num peers is less than or equal to
           if-num-peers.";
          leaf pry-interface {
            type leafref {
              path "/if:interfaces/if:interface/if:name";
            }
            description
              "Contains the interface name containing the PrY that has
             exceeded the number of peers.";
          }
        }  // notification pry-max-peers-exceeded
      }  // module ieee802-dot1ae-pry
    

© 2023 YumaWorks, Inc. All rights reserved.