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

Определение

Получает или задает симметричный ключ, применяемый для шифрования сообщений, шифруемых приложением, или сообщений, отправляемых во внешние очереди.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()

Значение свойства

Byte[]

Массив байтовых значений, задающий целевой симметричный ключ, используемый для шифрования сообщения.An array of byte values that specifies the destination symmetric key used to encrypt the message. По умолчанию задан массив нулевой длины.The default is a zero-length array.

Исключения

Очередь сообщений фильтруется, чтобы не учитывать свойство DestinationSymmetricKey.The message queue is filtered to ignore the DestinationSymmetricKey property.

Комментарии

Для двух сценариев требуется использовать DestinationSymmetricKey свойство.Two scenarios require you to use the DestinationSymmetricKey property. Первый — когда приложение, а не очередь сообщений, шифрует сообщение.The first is when your application, rather than Message Queuing, encrypts a message. Второй — при отправке зашифрованного сообщения в систему очередей, отличную от очереди сообщений.The second is when you send an encrypted message to a queuing system other than Message Queuing.

Перед установкой этого свойства необходимо зашифровать симметричный ключ с помощью открытого ключа принимающего Queue Manager.Before you set this property, you must encrypt the symmetric key with the public key of the receiving queue manager. При отправке сообщения, зашифрованного приложением, диспетчер очереди приема использует симметричный ключ для расшифровки сообщения перед его отправкой в очередь назначения.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.

При отправке сообщения во внешнюю очередь сообщение сначала получается соответствующим приложением-соединителем, которое пересылает зашифрованное сообщение с присоединенным симметричным ключом к принимающему приложению.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. Затем принимающее приложение несет ответственность за расшифровку сообщения с помощью симметричного ключа.It is then the responsibility of the receiving application to decrypt the message using the symmetric key.

При задании DestinationSymmetricKey свойства необходимо также ConnectorType задать свойство.When you set the DestinationSymmetricKey property, you must also set the ConnectorType property. При отправке сообщения служба Message Queuing игнорирует это DestinationSymmetricKey свойство, ConnectorType если свойство также не задано.When the message is sent, Message Queuing ignores the DestinationSymmetricKey property if the ConnectorType property is not also set.

DestinationSymmetricKey Свойство имеет максимальный размер массива, равный 256.The DestinationSymmetricKey property has a maximum array size of 256.

Применяется к

Дополнительно