Message.SenderCertificate Property

Definition

Gets or sets the security certificate used to authenticate messages.

public:
 property cli::array <System::Byte> ^ SenderCertificate { cli::array <System::Byte> ^ get(); void set(cli::array <System::Byte> ^ value); };
[System.Messaging.MessagingDescription("MsgSenderCertificate")]
public byte[] SenderCertificate { get; set; }
[<System.Messaging.MessagingDescription("MsgSenderCertificate")>]
member this.SenderCertificate : byte[] with get, set
Public Property SenderCertificate As Byte()

Property Value

Byte[]

An array of byte values that represents a security certificate, which Message Queuing uses to verify the sender of the message. The default is a zero-length array.

Attributes

Exceptions

The message queue is filtered to ignore the SenderCertificate property.

Remarks

The receiving application uses the SenderCertificate property when the message includes an external security certificate.

Message Queuing can authenticate a message using either an internal or external security certificate. Message Queuing provides internal certificates, which are used to verify message integrity. A certification authority provides an external certificate, which you can access through the SenderCertificate property of the message. In addition to allowing Message Queuing to authenticate the message, an external certificate allows the receiving application to further verify the sender. An internal certificate has no usable value to a receiving application.

An external certificate must be registered with the directory service of the Message Queuing system. An external certificate contains information about the certification authority, the certificate user, the validity period of the certificate, the public key of the certificate user, and the certification authority's signature.

Applies to

See also