Message.SenderCertificate Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets or sets the security certificate used to authenticate messages.

Namespace:   System.Messaging
Assembly:  System.Messaging (in System.Messaging.dll)

public byte[] SenderCertificate { get; set; }

Property Value

Type: System.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.

Exception Condition

The message queue is filtered to ignore the SenderCertificate property.

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.

.NET Framework
Available since 1.1
Return to top