# Generated by the protocol buffer compiler.  DO NOT EDIT!
# sources: sigstore_bundle.proto
# plugin: python-betterproto
# This file has been @generated

from dataclasses import dataclass
from typing import List

import betterproto

from .....io import intoto as ____io_intoto__
from ...common import v1 as __common_v1__
from ...rekor import v1 as __rekor_v1__


@dataclass(eq=False, repr=False)
class TimestampVerificationData(betterproto.Message):
    """
    Various timestamped counter signatures over the artifacts signature.
     Currently only RFC3161 signatures are provided. More formats may be added
     in the future.
    """

    rfc3161_timestamps: List["__common_v1__.Rfc3161SignedTimestamp"] = (
        betterproto.message_field(1)
    )
    """
    A list of RFC3161 signed timestamps provided by the user.
     This can be used when the entry has not been stored on a
     transparency log, or in conjunction for a stronger trust model.
     Clients MUST verify the hashed message in the message imprint
     against the signature in the bundle.
    """


@dataclass(eq=False, repr=False)
class VerificationMaterial(betterproto.Message):
    """
    VerificationMaterial captures details on the materials used to verify
     signatures. This message may be embedded in a DSSE envelope as a signature
     extension. Specifically, the `ext` field of the extension will expect this
     message when the signature extension is for Sigstore. This is identified by
     the `kind` field in the extension, which must be set to
     application/vnd.dev.sigstore.verificationmaterial;version=0.1 for Sigstore.
     When used as a DSSE extension, if the `public_key` field is used to indicate
     the key identifier, it MUST match the `keyid` field of the signature the
     extension is attached to.
    """

    public_key: "__common_v1__.PublicKeyIdentifier" = betterproto.message_field(
        1, group="content"
    )
    x509_certificate_chain: "__common_v1__.X509CertificateChain" = (
        betterproto.message_field(2, group="content")
    )
    certificate: "__common_v1__.X509Certificate" = betterproto.message_field(
        5, group="content"
    )
    tlog_entries: List["__rekor_v1__.TransparencyLogEntry"] = betterproto.message_field(
        3
    )
    """
    An inclusion proof and an optional signed timestamp from the log.
     Client verification libraries MAY provide an option to support v0.1
     bundles for backwards compatibility, which may contain an inclusion
     promise and not an inclusion proof. In this case, the client MUST
     validate the promise.
     Verifiers SHOULD NOT allow v0.1 bundles if they're used in an
     ecosystem which never produced them.
    """

    timestamp_verification_data: "TimestampVerificationData" = (
        betterproto.message_field(4)
    )
    """
    Timestamp may also come from
     tlog_entries.inclusion_promise.signed_entry_timestamp.
    """


@dataclass(eq=False, repr=False)
class Bundle(betterproto.Message):
    media_type: str = betterproto.string_field(1)
    """
    MUST be application/vnd.dev.sigstore.bundle.v0.3+json when
     when encoded as JSON.
     Clients must to be able to accept media type using the previously
     defined formats:
     * application/vnd.dev.sigstore.bundle+json;version=0.1
     * application/vnd.dev.sigstore.bundle+json;version=0.2
     * application/vnd.dev.sigstore.bundle+json;version=0.3
    """

    verification_material: "VerificationMaterial" = betterproto.message_field(2)
    """
    When a signer is identified by a X.509 certificate, a verifier MUST
     verify that the signature was computed at the time the certificate
     was valid as described in the Sigstore client spec: "Verification
     using a Bundle".
     <https://docs.google.com/document/d/1kbhK2qyPPk8SLavHzYSDM8-Ueul9_oxIMVFuWMWKz0E/edit#heading=h.x8bduppe89ln>
     If the verification material contains a public key identifier
     (key hint) and the `content` is a DSSE envelope, the key hints
     MUST be exactly the same in the verification material and in the
     DSSE envelope.
    """

    message_signature: "__common_v1__.MessageSignature" = betterproto.message_field(
        3, group="content"
    )
    dsse_envelope: "____io_intoto__.Envelope" = betterproto.message_field(
        4, group="content"
    )
    """
    A DSSE envelope can contain arbitrary payloads.
     Verifiers must verify that the payload type is a
     supported and expected type. This is part of the DSSE
     protocol which is defined here:
     <https://github.com/secure-systems-lab/dsse/blob/master/protocol.md>
     DSSE envelopes in a bundle MUST have exactly one signture.
     This is a limitation from the DSSE spec, as it can contain
     multiple signatures. There are two primary reasons:
     1. It simplfies the verification logic and policy
     2. The bundle (currently) can only contain a single
        instance of the required verification materials
     During verification a client MUST reject an envelope if
     the number of signatures is not equal to one.
    """
