Class Signature.Builder

  • All Implemented Interfaces:
    com.google.protobuf.Message.Builder, com.google.protobuf.MessageLite.Builder, com.google.protobuf.MessageLiteOrBuilder, com.google.protobuf.MessageOrBuilder, SignatureOrBuilder, Cloneable
    Enclosing class:
    Signature

    public static final class Signature.Builder
    extends com.google.protobuf.GeneratedMessageV3.Builder<Signature.Builder>
    implements SignatureOrBuilder
     Verifiers (e.g. Kritis implementations) MUST verify signatures
     with respect to the trust anchors defined in policy (e.g. a Kritis policy).
     Typically this means that the verifier has been configured with a map from
     `public_key_id` to public key material (and any required parameters, e.g.
     signing algorithm).
     In particular, verification implementations MUST NOT treat the signature
     `public_key_id` as anything more than a key lookup hint. The `public_key_id`
     DOES NOT validate or authenticate a public key; it only provides a mechanism
     for quickly selecting a public key ALREADY CONFIGURED on the verifier through
     a trusted channel. Verification implementations MUST reject signatures in any
     of the following circumstances:
       * The `public_key_id` is not recognized by the verifier.
       * The public key that `public_key_id` refers to does not verify the
         signature with respect to the payload.
     The `signature` contents SHOULD NOT be "attached" (where the payload is
     included with the serialized `signature` bytes). Verifiers MUST ignore any
     "attached" payload and only verify signatures with respect to explicitly
     provided payload (e.g. a `payload` field on the proto message that holds
     this Signature, or the canonical serialization of the proto message that
     holds this signature).
     
    Protobuf type grafeas.v1beta1.Signature
    • Method Detail

      • 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<Signature.Builder>
      • clear

        public Signature.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<Signature.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<Signature.Builder>
      • getDefaultInstanceForType

        public Signature getDefaultInstanceForType()
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageLiteOrBuilder
        Specified by:
        getDefaultInstanceForType in interface com.google.protobuf.MessageOrBuilder
      • build

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

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

        public Signature.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<Signature.Builder>
      • setField

        public Signature.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<Signature.Builder>
      • clearField

        public Signature.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<Signature.Builder>
      • clearOneof

        public Signature.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<Signature.Builder>
      • setRepeatedField

        public Signature.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<Signature.Builder>
      • addRepeatedField

        public Signature.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<Signature.Builder>
      • mergeFrom

        public Signature.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<Signature.Builder>
      • isInitialized

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

        public Signature.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<Signature.Builder>
        Throws:
        IOException
      • getSignature

        public com.google.protobuf.ByteString getSignature()
         The content of the signature, an opaque bytestring.
         The payload that this signature verifies MUST be unambiguously provided
         with the Signature during verification. A wrapper message might provide
         the payload explicitly. Alternatively, a message might have a canonical
         serialization that can always be unambiguously computed to derive the
         payload.
         
        bytes signature = 1;
        Specified by:
        getSignature in interface SignatureOrBuilder
        Returns:
        The signature.
      • setSignature

        public Signature.Builder setSignature​(com.google.protobuf.ByteString value)
         The content of the signature, an opaque bytestring.
         The payload that this signature verifies MUST be unambiguously provided
         with the Signature during verification. A wrapper message might provide
         the payload explicitly. Alternatively, a message might have a canonical
         serialization that can always be unambiguously computed to derive the
         payload.
         
        bytes signature = 1;
        Parameters:
        value - The signature to set.
        Returns:
        This builder for chaining.
      • clearSignature

        public Signature.Builder clearSignature()
         The content of the signature, an opaque bytestring.
         The payload that this signature verifies MUST be unambiguously provided
         with the Signature during verification. A wrapper message might provide
         the payload explicitly. Alternatively, a message might have a canonical
         serialization that can always be unambiguously computed to derive the
         payload.
         
        bytes signature = 1;
        Returns:
        This builder for chaining.
      • getPublicKeyId

        public String getPublicKeyId()
         The identifier for the public key that verifies this signature.
           * The `public_key_id` is required.
           * The `public_key_id` MUST be an RFC3986 conformant URI.
           * When possible, the `public_key_id` SHOULD be an immutable reference,
             such as a cryptographic digest.
         Examples of valid `public_key_id`s:
         OpenPGP V4 public key fingerprint:
           * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
         See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
         details on this scheme.
         RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
         serialization):
           * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
           * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
         
        string public_key_id = 2;
        Specified by:
        getPublicKeyId in interface SignatureOrBuilder
        Returns:
        The publicKeyId.
      • getPublicKeyIdBytes

        public com.google.protobuf.ByteString getPublicKeyIdBytes()
         The identifier for the public key that verifies this signature.
           * The `public_key_id` is required.
           * The `public_key_id` MUST be an RFC3986 conformant URI.
           * When possible, the `public_key_id` SHOULD be an immutable reference,
             such as a cryptographic digest.
         Examples of valid `public_key_id`s:
         OpenPGP V4 public key fingerprint:
           * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
         See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
         details on this scheme.
         RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
         serialization):
           * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
           * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
         
        string public_key_id = 2;
        Specified by:
        getPublicKeyIdBytes in interface SignatureOrBuilder
        Returns:
        The bytes for publicKeyId.
      • setPublicKeyId

        public Signature.Builder setPublicKeyId​(String value)
         The identifier for the public key that verifies this signature.
           * The `public_key_id` is required.
           * The `public_key_id` MUST be an RFC3986 conformant URI.
           * When possible, the `public_key_id` SHOULD be an immutable reference,
             such as a cryptographic digest.
         Examples of valid `public_key_id`s:
         OpenPGP V4 public key fingerprint:
           * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
         See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
         details on this scheme.
         RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
         serialization):
           * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
           * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
         
        string public_key_id = 2;
        Parameters:
        value - The publicKeyId to set.
        Returns:
        This builder for chaining.
      • clearPublicKeyId

        public Signature.Builder clearPublicKeyId()
         The identifier for the public key that verifies this signature.
           * The `public_key_id` is required.
           * The `public_key_id` MUST be an RFC3986 conformant URI.
           * When possible, the `public_key_id` SHOULD be an immutable reference,
             such as a cryptographic digest.
         Examples of valid `public_key_id`s:
         OpenPGP V4 public key fingerprint:
           * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
         See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
         details on this scheme.
         RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
         serialization):
           * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
           * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
         
        string public_key_id = 2;
        Returns:
        This builder for chaining.
      • setPublicKeyIdBytes

        public Signature.Builder setPublicKeyIdBytes​(com.google.protobuf.ByteString value)
         The identifier for the public key that verifies this signature.
           * The `public_key_id` is required.
           * The `public_key_id` MUST be an RFC3986 conformant URI.
           * When possible, the `public_key_id` SHOULD be an immutable reference,
             such as a cryptographic digest.
         Examples of valid `public_key_id`s:
         OpenPGP V4 public key fingerprint:
           * "openpgp4fpr:74FAF3B861BDA0870C7B6DEF607E48D2A663AEEA"
         See https://www.iana.org/assignments/uri-schemes/prov/openpgp4fpr for more
         details on this scheme.
         RFC6920 digest-named SubjectPublicKeyInfo (digest of the DER
         serialization):
           * "ni:///sha-256;cD9o9Cq6LG3jD0iKXqEi_vdjJGecm_iXkbqVoScViaU"
           * "nih:///sha-256;703f68f42aba2c6de30f488a5ea122fef76324679c9bf89791ba95a1271589a5"
         
        string public_key_id = 2;
        Parameters:
        value - The bytes for publicKeyId to set.
        Returns:
        This builder for chaining.
      • setUnknownFields

        public final Signature.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<Signature.Builder>
      • mergeUnknownFields

        public final Signature.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<Signature.Builder>