docs: @Override
      public void setPrincipal( final Principal principal ) {
          if ( !equals( principal, this.principal ) ) {
              _authenticationChanged = true;
          }
          super.setPrincipal( principal );
      }