Class CryptMessage

windows/crypto/cryptmsg.py:7–133

Represent a PKCS #7 message (see `Low-level Message Functions `_)

import windows.crypto

class CryptMessage(gdef.HCRYPTMSG):
    """Represent a PKCS #7 message
    (see `Low-level Message Functions <https://msdn.microsoft.com/en-us/library/windows/desktop/aa380252(v=vs.85).aspx#low_level_message_functions>`_)
    """
    MSG_PARAM_KNOW_TYPES = {gdef.CMSG_SIGNER_INFO_PARAM: gdef.CMSG_SIGNER_INFO,
                            gdef.CMSG_SIGNER_COUNT_PARAM: gdef.DWORD,
                            gdef.CMSG_CERT_COUNT_PARAM: gdef.DWORD,
                            gdef.CMSG_ENVELOPE_ALGORITHM_PARAM: gdef.CRYPT_ALGORITHM_IDENTIFIER,
                            gdef.CMSG_RECIPIENT_COUNT_PARAM: gdef.DWORD,
                            gdef.CMSG_RECIPIENT_INFO_PARAM: gdef.CERT_INFO,
                            }


    def get_param(self, param_type, index=0, raw=False):
        data_size = gdef.DWORD()
        # https://msdn.microsoft.com/en-us/library/windows/desktop/aa380227(v=vs.85).aspx
        winproxy.CryptMsgGetParam(self, param_type, index, None, data_size)
        buffer = ctypes.c_buffer(data_size.value)
        winproxy.CryptMsgGetParam(self, param_type, index, buffer, data_size)
        if raw:
            return (buffer, data_size)

        if param_type in self.MSG_PARAM_KNOW_TYPES:
            buffer = self.MSG_PARAM_KNOW_TYPES[param_type].from_buffer(buffer)
        if isinstance(buffer, gdef.DWORD): # DWORD -> return the Python int
            return buffer.value
        return buffer

    # Certificate accessors

    @property
    def nb_cert(self):
        """The number of certificate embded in the :class:`CryptObject`

        :type: :class:`int`
        """
        return self.get_param(gdef.CMSG_CERT_COUNT_PARAM)

    def get_raw_cert(self, index=0):
        return self.get_param(gdef.CMSG_CERT_PARAM, index)

    def get_cert(self, index=0):
        """Return embded :class:`Certificate` number ``index``.

        .. note::

            Not all embded certificate are directly used to sign the :class:`CryptObject`.
        """
        return windows.crypto.Certificate.from_buffer(self.get_raw_cert(index))

    @property
    def certs(self):
        """The list of :class:`Certificate` embded in the message"""
        return [self.get_cert(i) for i in range(self.nb_cert)]

    # Signers accessors

    @property