Message.DestinationSymmetricKey Message.DestinationSymmetricKey Message.DestinationSymmetricKey Message.DestinationSymmetricKey Property

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; }
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.

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 su 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 puesta en cola que no sean de 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 receptor.Before you set this property, you must encrypt the symmetric key with the public key of the receiving queue manager. Cuando se envía un mensaje cifrado a la aplicación, el Administrador de la cola receptora utiliza 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 se recibe por primera vez por la aplicación del conector adecuado, que reenvía el mensaje cifrado con la clave simétrica adjunta 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. A continuación, es responsabilidad de la aplicación receptora para 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 el DestinationSymmetricKey propiedad, también debe establecer el 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 el ConnectorType propiedad no se establece también.When the message is sent, Message Queuing ignores the DestinationSymmetricKey property if the ConnectorType property is not also set.

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

Se aplica a

Consulte también: