Package io.envoyproxy.envoy.config.rbac.v3

Class Principal.Builder

java.lang.Object
com.google.protobuf.AbstractMessageLite.Builder
com.google.protobuf.AbstractMessage.Builder<BuilderT>
com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>
io.envoyproxy.envoy.config.rbac.v3.Principal.Builder
All Implemented Interfaces:
com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, PrincipalOrBuilder, Cloneable
Enclosing class:
Principal
public static final class Principal.Builder extends com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder> implements PrincipalOrBuilder
 Principal defines an identity or a group of identities for a downstream
 subject.
 [#next-free-field: 15]
Protobuf type envoy.config.rbac.v3.Principal

  • Method Details

    • getDescriptor

      public static final com.google.protobuf.Descriptors.Descriptor getDescriptor()

    • internalGetFieldAccessorTable

      protected com.google.protobuf.GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
      Specified by:
      internalGetFieldAccessorTable in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • clear

      public Principal.Builder clear()
      Specified by:
      clear in interface com.google.protobuf.Message.Builder
      Specified by:
      clear in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clear in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • getDescriptorForType

      public com.google.protobuf.Descriptors.Descriptor getDescriptorForType()
      Specified by:
      getDescriptorForType in interface com.google.protobuf.Message.Builder
      Specified by:
      getDescriptorForType in interface com.google.protobuf.MessageOrBuilder
      Overrides:
      getDescriptorForType in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • getDefaultInstanceForType

      public Principal getDefaultInstanceForType()
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
      Specified by:
      getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder

    • build

      public Principal build()
      Specified by:
      build in interface com.google.protobuf.Message.Builder
      Specified by:
      build in interface com.google.protobuf.MessageLite.Builder

    • buildPartial

      public Principal buildPartial()
      Specified by:
      buildPartial in interface com.google.protobuf.Message.Builder
      Specified by:
      buildPartial in interface com.google.protobuf.MessageLite.Builder

    • clone

      public Principal.Builder clone()
      Specified by:
      clone in interface com.google.protobuf.Message.Builder
      Specified by:
      clone in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      clone in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • setField

      public Principal.Builder setField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      setField in interface com.google.protobuf.Message.Builder
      Overrides:
      setField in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • clearField

      public Principal.Builder clearField(com.google.protobuf.Descriptors.FieldDescriptor field)
      Specified by:
      clearField in interface com.google.protobuf.Message.Builder
      Overrides:
      clearField in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • clearOneof

      public Principal.Builder clearOneof(com.google.protobuf.Descriptors.OneofDescriptor oneof)
      Specified by:
      clearOneof in interface com.google.protobuf.Message.Builder
      Overrides:
      clearOneof in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • setRepeatedField

      public Principal.Builder setRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, int index, Object value)
      Specified by:
      setRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      setRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • addRepeatedField

      public Principal.Builder addRepeatedField(com.google.protobuf.Descriptors.FieldDescriptor field, Object value)
      Specified by:
      addRepeatedField in interface com.google.protobuf.Message.Builder
      Overrides:
      addRepeatedField in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • mergeFrom

      public Principal.Builder mergeFrom(com.google.protobuf.Message other)
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<Principal.Builder>

    • mergeFrom

      public Principal.Builder mergeFrom(Principal other)

    • isInitialized

      public final boolean isInitialized()
      Specified by:
      isInitialized in interface com.google.protobuf.MessageLiteOrBuilder
      Overrides:
      isInitialized in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • mergeFrom

      public Principal.Builder mergeFrom(com.google.protobuf.CodedInputStream input, com.google.protobuf.ExtensionRegistryLite extensionRegistry) throws IOException
      Specified by:
      mergeFrom in interface com.google.protobuf.Message.Builder
      Specified by:
      mergeFrom in interface com.google.protobuf.MessageLite.Builder
      Overrides:
      mergeFrom in class com.google.protobuf.AbstractMessage.Builder<Principal.Builder>
      Throws:
      IOException

    • getIdentifierCase

      public Principal.IdentifierCase getIdentifierCase()
      Specified by:
      getIdentifierCase in interface PrincipalOrBuilder

    • clearIdentifier

      public Principal.Builder clearIdentifier()

    • hasAndIds

      public boolean hasAndIds()
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;
      Specified by:
      hasAndIds in interface PrincipalOrBuilder
      Returns:
      Whether the andIds field is set.

    • getAndIds

      public Principal.Set getAndIds()
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;
      Specified by:
      getAndIds in interface PrincipalOrBuilder
      Returns:
      The andIds.

    • setAndIds

      public Principal.Builder setAndIds(Principal.Set value)
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;

    • setAndIds

      public Principal.Builder setAndIds(Principal.Set.Builder builderForValue)
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;

    • mergeAndIds

      public Principal.Builder mergeAndIds(Principal.Set value)
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;

    • clearAndIds

      public Principal.Builder clearAndIds()
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;

    • getAndIdsBuilder

      public Principal.Set.Builder getAndIdsBuilder()
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;

    • getAndIdsOrBuilder

      public Principal.SetOrBuilder getAndIdsOrBuilder()
       A set of identifiers that all must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set and_ids = 1;
      Specified by:
      getAndIdsOrBuilder in interface PrincipalOrBuilder

    • hasOrIds

      public boolean hasOrIds()
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;
      Specified by:
      hasOrIds in interface PrincipalOrBuilder
      Returns:
      Whether the orIds field is set.

    • getOrIds

      public Principal.Set getOrIds()
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;
      Specified by:
      getOrIds in interface PrincipalOrBuilder
      Returns:
      The orIds.

    • setOrIds

      public Principal.Builder setOrIds(Principal.Set value)
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;

    • setOrIds

      public Principal.Builder setOrIds(Principal.Set.Builder builderForValue)
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;

    • mergeOrIds

      public Principal.Builder mergeOrIds(Principal.Set value)
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;

    • clearOrIds

      public Principal.Builder clearOrIds()
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;

    • getOrIdsBuilder

      public Principal.Set.Builder getOrIdsBuilder()
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;

    • getOrIdsOrBuilder

      public Principal.SetOrBuilder getOrIdsOrBuilder()
       A set of identifiers at least one must match in order to define the downstream.
      .envoy.config.rbac.v3.Principal.Set or_ids = 2;
      Specified by:
      getOrIdsOrBuilder in interface PrincipalOrBuilder

    • hasAny

      public boolean hasAny()
       When any is set, it matches any downstream.
      bool any = 3 [(.validate.rules) = { ... }
      Specified by:
      hasAny in interface PrincipalOrBuilder
      Returns:
      Whether the any field is set.

    • getAny

      public boolean getAny()
       When any is set, it matches any downstream.
      bool any = 3 [(.validate.rules) = { ... }
      Specified by:
      getAny in interface PrincipalOrBuilder
      Returns:
      The any.

    • setAny

      public Principal.Builder setAny(boolean value)
       When any is set, it matches any downstream.
      bool any = 3 [(.validate.rules) = { ... }
      Parameters:
      value - The any to set.
      Returns:
      This builder for chaining.

    • clearAny

      public Principal.Builder clearAny()
       When any is set, it matches any downstream.
      bool any = 3 [(.validate.rules) = { ... }
      Returns:
      This builder for chaining.

    • hasAuthenticated

      public boolean hasAuthenticated()
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;
      Specified by:
      hasAuthenticated in interface PrincipalOrBuilder
      Returns:
      Whether the authenticated field is set.

    • getAuthenticated

      public Principal.Authenticated getAuthenticated()
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;
      Specified by:
      getAuthenticated in interface PrincipalOrBuilder
      Returns:
      The authenticated.

    • setAuthenticated

      public Principal.Builder setAuthenticated(Principal.Authenticated value)
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;

    • setAuthenticated

      public Principal.Builder setAuthenticated(Principal.Authenticated.Builder builderForValue)
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;

    • mergeAuthenticated

      public Principal.Builder mergeAuthenticated(Principal.Authenticated value)
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;

    • clearAuthenticated

      public Principal.Builder clearAuthenticated()
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;

    • getAuthenticatedBuilder

      public Principal.Authenticated.Builder getAuthenticatedBuilder()
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;

    • getAuthenticatedOrBuilder

      public Principal.AuthenticatedOrBuilder getAuthenticatedOrBuilder()
       Authenticated attributes that identify the downstream.
 It is recommended to NOT use this field, but instead use
 :ref:`MTlsAuthenticated <envoy_v3_api_msg_extensions.rbac.principals.mtls_authenticated.v3.Config>`,
 configured via :ref:`custom <envoy_v3_api_field_config.rbac.v3.Principal.custom>`,
 which should be used for most use cases due to its improved security.
      .envoy.config.rbac.v3.Principal.Authenticated authenticated = 4;
      Specified by:
      getAuthenticatedOrBuilder in interface PrincipalOrBuilder

    • hasSourceIp

      @Deprecated public boolean hasSourceIp()
      Deprecated.
      envoy.config.rbac.v3.Principal.source_ip is deprecated. See envoy/config/rbac/v3/rbac.proto;l=386
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];
      Specified by:
      hasSourceIp in interface PrincipalOrBuilder
      Returns:
      Whether the sourceIp field is set.

    • getSourceIp

      @Deprecated public CidrRange getSourceIp()
      Deprecated.
      envoy.config.rbac.v3.Principal.source_ip is deprecated. See envoy/config/rbac/v3/rbac.proto;l=386
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];
      Specified by:
      getSourceIp in interface PrincipalOrBuilder
      Returns:
      The sourceIp.

    • setSourceIp

      @Deprecated public Principal.Builder setSourceIp(CidrRange value)
      Deprecated.
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • setSourceIp

      @Deprecated public Principal.Builder setSourceIp(CidrRange.Builder builderForValue)
      Deprecated.
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • mergeSourceIp

      @Deprecated public Principal.Builder mergeSourceIp(CidrRange value)
      Deprecated.
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • clearSourceIp

      @Deprecated public Principal.Builder clearSourceIp()
      Deprecated.
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • getSourceIpBuilder

      @Deprecated public CidrRange.Builder getSourceIpBuilder()
      Deprecated.
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • getSourceIpOrBuilder

      @Deprecated public CidrRangeOrBuilder getSourceIpOrBuilder()
      Deprecated.
       A CIDR block that describes the downstream IP.
 This address will honor proxy protocol, but will not honor XFF.

 This field is deprecated; either use :ref:`remote_ip
 <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` for the same
 behavior, or use
 :ref:`direct_remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`.
      .envoy.config.core.v3.CidrRange source_ip = 5 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];
      Specified by:
      getSourceIpOrBuilder in interface PrincipalOrBuilder

    • hasDirectRemoteIp

      public boolean hasDirectRemoteIp()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;
      Specified by:
      hasDirectRemoteIp in interface PrincipalOrBuilder
      Returns:
      Whether the directRemoteIp field is set.

    • getDirectRemoteIp

      public CidrRange getDirectRemoteIp()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;
      Specified by:
      getDirectRemoteIp in interface PrincipalOrBuilder
      Returns:
      The directRemoteIp.

    • setDirectRemoteIp

      public Principal.Builder setDirectRemoteIp(CidrRange value)
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;

    • setDirectRemoteIp

      public Principal.Builder setDirectRemoteIp(CidrRange.Builder builderForValue)
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;

    • mergeDirectRemoteIp

      public Principal.Builder mergeDirectRemoteIp(CidrRange value)
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;

    • clearDirectRemoteIp

      public Principal.Builder clearDirectRemoteIp()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;

    • getDirectRemoteIpBuilder

      public CidrRange.Builder getDirectRemoteIpBuilder()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;

    • getDirectRemoteIpOrBuilder

      public CidrRangeOrBuilder getDirectRemoteIpOrBuilder()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This is always the physical peer even if the
   :ref:`remote_ip <envoy_v3_api_field_config.rbac.v3.Principal.remote_ip>` is inferred from the
   x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange direct_remote_ip = 10;
      Specified by:
      getDirectRemoteIpOrBuilder in interface PrincipalOrBuilder

    • hasRemoteIp

      public boolean hasRemoteIp()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;
      Specified by:
      hasRemoteIp in interface PrincipalOrBuilder
      Returns:
      Whether the remoteIp field is set.

    • getRemoteIp

      public CidrRange getRemoteIp()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;
      Specified by:
      getRemoteIp in interface PrincipalOrBuilder
      Returns:
      The remoteIp.

    • setRemoteIp

      public Principal.Builder setRemoteIp(CidrRange value)
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;

    • setRemoteIp

      public Principal.Builder setRemoteIp(CidrRange.Builder builderForValue)
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;

    • mergeRemoteIp

      public Principal.Builder mergeRemoteIp(CidrRange value)
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;

    • clearRemoteIp

      public Principal.Builder clearRemoteIp()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;

    • getRemoteIpBuilder

      public CidrRange.Builder getRemoteIpBuilder()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;

    • getRemoteIpOrBuilder

      public CidrRangeOrBuilder getRemoteIpOrBuilder()
       A CIDR block that describes the downstream remote/origin address.

 .. note::

   This may not be the physical peer and could be different from the :ref:`direct_remote_ip
   <envoy_v3_api_field_config.rbac.v3.Principal.direct_remote_ip>`. E.g, if the remote ip is inferred from
   the x-forwarder-for header, the proxy protocol, etc.
      .envoy.config.core.v3.CidrRange remote_ip = 11;
      Specified by:
      getRemoteIpOrBuilder in interface PrincipalOrBuilder

    • hasHeader

      public boolean hasHeader()
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;
      Specified by:
      hasHeader in interface PrincipalOrBuilder
      Returns:
      Whether the header field is set.

    • getHeader

      public HeaderMatcher getHeader()
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;
      Specified by:
      getHeader in interface PrincipalOrBuilder
      Returns:
      The header.

    • setHeader

      public Principal.Builder setHeader(HeaderMatcher value)
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;

    • setHeader

      public Principal.Builder setHeader(HeaderMatcher.Builder builderForValue)
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;

    • mergeHeader

      public Principal.Builder mergeHeader(HeaderMatcher value)
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;

    • clearHeader

      public Principal.Builder clearHeader()
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;

    • getHeaderBuilder

      public HeaderMatcher.Builder getHeaderBuilder()
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;

    • getHeaderOrBuilder

      public HeaderMatcherOrBuilder getHeaderOrBuilder()
       A header (or pseudo-header such as ``:path`` or ``:method``) on the incoming HTTP request. Only available
 for HTTP request.

 .. note::

   The pseudo-header ``:path`` includes the query and fragment string. Use the ``url_path`` field if you
   want to match the URL path without the query and fragment string.
      .envoy.config.route.v3.HeaderMatcher header = 6;
      Specified by:
      getHeaderOrBuilder in interface PrincipalOrBuilder

    • hasUrlPath

      public boolean hasUrlPath()
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;
      Specified by:
      hasUrlPath in interface PrincipalOrBuilder
      Returns:
      Whether the urlPath field is set.

    • getUrlPath

      public PathMatcher getUrlPath()
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;
      Specified by:
      getUrlPath in interface PrincipalOrBuilder
      Returns:
      The urlPath.

    • setUrlPath

      public Principal.Builder setUrlPath(PathMatcher value)
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;

    • setUrlPath

      public Principal.Builder setUrlPath(PathMatcher.Builder builderForValue)
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;

    • mergeUrlPath

      public Principal.Builder mergeUrlPath(PathMatcher value)
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;

    • clearUrlPath

      public Principal.Builder clearUrlPath()
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;

    • getUrlPathBuilder

      public PathMatcher.Builder getUrlPathBuilder()
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;

    • getUrlPathOrBuilder

      public PathMatcherOrBuilder getUrlPathOrBuilder()
       A URL path on the incoming HTTP request. Only available for HTTP.
      .envoy.type.matcher.v3.PathMatcher url_path = 9;
      Specified by:
      getUrlPathOrBuilder in interface PrincipalOrBuilder

    • hasMetadata

      @Deprecated public boolean hasMetadata()
      Deprecated.
      envoy.config.rbac.v3.Principal.metadata is deprecated. See envoy/config/rbac/v3/rbac.proto;l=424
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];
      Specified by:
      hasMetadata in interface PrincipalOrBuilder
      Returns:
      Whether the metadata field is set.

    • getMetadata

      @Deprecated public MetadataMatcher getMetadata()
      Deprecated.
      envoy.config.rbac.v3.Principal.metadata is deprecated. See envoy/config/rbac/v3/rbac.proto;l=424
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];
      Specified by:
      getMetadata in interface PrincipalOrBuilder
      Returns:
      The metadata.

    • setMetadata

      @Deprecated public Principal.Builder setMetadata(MetadataMatcher value)
      Deprecated.
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • setMetadata

      @Deprecated public Principal.Builder setMetadata(MetadataMatcher.Builder builderForValue)
      Deprecated.
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • mergeMetadata

      @Deprecated public Principal.Builder mergeMetadata(MetadataMatcher value)
      Deprecated.
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • clearMetadata

      @Deprecated public Principal.Builder clearMetadata()
      Deprecated.
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • getMetadataBuilder

      @Deprecated public MetadataMatcher.Builder getMetadataBuilder()
      Deprecated.
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];

    • getMetadataOrBuilder

      @Deprecated public MetadataMatcherOrBuilder getMetadataOrBuilder()
      Deprecated.
       Metadata that describes additional information about the principal. This field is deprecated; please use
 :ref:`sourced_metadata<envoy_v3_api_field_config.rbac.v3.Principal.sourced_metadata>` instead.
      .envoy.type.matcher.v3.MetadataMatcher metadata = 7 [deprecated = true, (.envoy.annotations.deprecated_at_minor_version) = "3.0"];
      Specified by:
      getMetadataOrBuilder in interface PrincipalOrBuilder

    • hasFilterState

      public boolean hasFilterState()
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;
      Specified by:
      hasFilterState in interface PrincipalOrBuilder
      Returns:
      Whether the filterState field is set.

    • getFilterState

      public FilterStateMatcher getFilterState()
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;
      Specified by:
      getFilterState in interface PrincipalOrBuilder
      Returns:
      The filterState.

    • setFilterState

      public Principal.Builder setFilterState(FilterStateMatcher value)
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;

    • setFilterState

      public Principal.Builder setFilterState(FilterStateMatcher.Builder builderForValue)
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;

    • mergeFilterState

      public Principal.Builder mergeFilterState(FilterStateMatcher value)
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;

    • clearFilterState

      public Principal.Builder clearFilterState()
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;

    • getFilterStateBuilder

      public FilterStateMatcher.Builder getFilterStateBuilder()
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;

    • getFilterStateOrBuilder

      public FilterStateMatcherOrBuilder getFilterStateOrBuilder()
       Identifies the principal using a filter state object.
      .envoy.type.matcher.v3.FilterStateMatcher filter_state = 12;
      Specified by:
      getFilterStateOrBuilder in interface PrincipalOrBuilder

    • hasNotId

      public boolean hasNotId()
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;
      Specified by:
      hasNotId in interface PrincipalOrBuilder
      Returns:
      Whether the notId field is set.

    • getNotId

      public Principal getNotId()
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;
      Specified by:
      getNotId in interface PrincipalOrBuilder
      Returns:
      The notId.

    • setNotId

      public Principal.Builder setNotId(Principal value)
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;

    • setNotId

      public Principal.Builder setNotId(Principal.Builder builderForValue)
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;

    • mergeNotId

      public Principal.Builder mergeNotId(Principal value)
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;

    • clearNotId

      public Principal.Builder clearNotId()
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;

    • getNotIdBuilder

      public Principal.Builder getNotIdBuilder()
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;

    • getNotIdOrBuilder

      public PrincipalOrBuilder getNotIdOrBuilder()
       Negates matching the provided principal. For instance, if the value of
 ``not_id`` would match, this principal would not match. Conversely, if the
 value of ``not_id`` would not match, this principal would match.
      .envoy.config.rbac.v3.Principal not_id = 8;
      Specified by:
      getNotIdOrBuilder in interface PrincipalOrBuilder

    • hasSourcedMetadata

      public boolean hasSourcedMetadata()
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;
      Specified by:
      hasSourcedMetadata in interface PrincipalOrBuilder
      Returns:
      Whether the sourcedMetadata field is set.

    • getSourcedMetadata

      public SourcedMetadata getSourcedMetadata()
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;
      Specified by:
      getSourcedMetadata in interface PrincipalOrBuilder
      Returns:
      The sourcedMetadata.

    • setSourcedMetadata

      public Principal.Builder setSourcedMetadata(SourcedMetadata value)
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;

    • setSourcedMetadata

      public Principal.Builder setSourcedMetadata(SourcedMetadata.Builder builderForValue)
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;

    • mergeSourcedMetadata

      public Principal.Builder mergeSourcedMetadata(SourcedMetadata value)
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;

    • clearSourcedMetadata

      public Principal.Builder clearSourcedMetadata()
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;

    • getSourcedMetadataBuilder

      public SourcedMetadata.Builder getSourcedMetadataBuilder()
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;

    • getSourcedMetadataOrBuilder

      public SourcedMetadataOrBuilder getSourcedMetadataOrBuilder()
       Matches against metadata from either dynamic state or route configuration. Preferred over the
 ``metadata`` field as it provides more flexibility in metadata source selection.
      .envoy.config.rbac.v3.SourcedMetadata sourced_metadata = 13;
      Specified by:
      getSourcedMetadataOrBuilder in interface PrincipalOrBuilder

    • hasCustom

      public boolean hasCustom()
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;
      Specified by:
      hasCustom in interface PrincipalOrBuilder
      Returns:
      Whether the custom field is set.

    • getCustom

      public TypedExtensionConfig getCustom()
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;
      Specified by:
      getCustom in interface PrincipalOrBuilder
      Returns:
      The custom.

    • setCustom

      public Principal.Builder setCustom(TypedExtensionConfig value)
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;

    • setCustom

      public Principal.Builder setCustom(TypedExtensionConfig.Builder builderForValue)
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;

    • mergeCustom

      public Principal.Builder mergeCustom(TypedExtensionConfig value)
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;

    • clearCustom

      public Principal.Builder clearCustom()
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;

    • getCustomBuilder

      public TypedExtensionConfig.Builder getCustomBuilder()
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;

    • getCustomOrBuilder

      public TypedExtensionConfigOrBuilder getCustomOrBuilder()
       Extension for configuring custom principals for RBAC.
 [#extension-category: envoy.rbac.principals]
      .envoy.config.core.v3.TypedExtensionConfig custom = 14;
      Specified by:
      getCustomOrBuilder in interface PrincipalOrBuilder

    • setUnknownFields

      public final Principal.Builder setUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      setUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      setUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>

    • mergeUnknownFields

      public final Principal.Builder mergeUnknownFields(com.google.protobuf.UnknownFieldSet unknownFields)
      Specified by:
      mergeUnknownFields in interface com.google.protobuf.Message.Builder
      Overrides:
      mergeUnknownFields in class com.google.protobuf.GeneratedMessageV3.Builder<Principal.Builder>