Message.DestinationSymmetricKey Propiedad

Definición

Obtiene o establece la clave simétrica utilizada para cifrar los mensajes cifrados por la aplicación o los enviados a colas externas.Gets or sets the symmetric key used to encrypt application-encrypted messages or messages sent to foreign queues.

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

Valor de propiedad

Byte[]

Matriz de bytes que especifica la clave simétrica de destino utilizada para cifrar el mensaje.An array of byte values that specifies the destination symmetric key used to encrypt the message. El valor predeterminado es una matriz de longitud cero.The default is a zero-length array.

Atributos

Excepciones

La cola de mensajes se filtra para omitir la propiedad DestinationSymmetricKey.The message queue is filtered to ignore the DestinationSymmetricKey property.

Comentarios

Dos escenarios requieren que se use la DestinationSymmetricKey propiedad.Two scenarios require you to use the DestinationSymmetricKey property. La primera es cuando la aplicación, en lugar de Message Queue Server, cifra un mensaje.The first is when your application, rather than Message Queuing, encrypts a message. La segunda es cuando se envía un mensaje cifrado a un sistema de cola que no sea Message Queue Server.The second is when you send an encrypted message to a queuing system other than Message Queuing.

Antes de establecer esta propiedad, debe cifrar la clave simétrica con la clave pública del administrador de cola receptora.Before you set this property, you must encrypt the symmetric key with the public key of the receiving queue manager. Cuando envía un mensaje cifrado de la aplicación, el administrador de cola receptor usa la clave simétrica para descifrar el mensaje antes de enviarlo a su cola de destino.When you send an application-encrypted message, the receiving queue manager uses the symmetric key to decrypt the message before sending it to its destination queue.

Si envía un mensaje a una cola externa, el mensaje lo recibe primero la aplicación de conector adecuada, que reenvía el mensaje cifrado con la clave simétrica asociada a la aplicación receptora.If you send a message to a foreign queue, the message is first received by the appropriate connector application, which forwards the encrypted message with the attached symmetric key to the receiving application. Después, es responsabilidad de la aplicación receptora descifrar el mensaje mediante la clave simétrica.It is then the responsibility of the receiving application to decrypt the message using the symmetric key.

Al establecer la DestinationSymmetricKey propiedad, también debe establecer la ConnectorType propiedad.When you set the DestinationSymmetricKey property, you must also set the ConnectorType property. Cuando se envía el mensaje, Message Queue Server omite la DestinationSymmetricKey propiedad si la ConnectorType propiedad no está establecida también.When the message is sent, Message Queuing ignores the DestinationSymmetricKey property if the ConnectorType property is not also set.

La DestinationSymmetricKey propiedad tiene un tamaño máximo de matriz de 256.The DestinationSymmetricKey property has a maximum array size of 256.

Se aplica a

Consulte también