[22280] New property to select preferred key agreement algorithm (backport #5413) (backport #5442)

[mergify]

Description

DDS security specifies the possibility of selecting the key agreement algorithm used to generate the shared secret at the end of the authentication phase.

The Fast DDS documentation indicates that Elliptic Curve Diffie-Hellman (ECDH) is used, but this is only the case if a participant from other vendor starts the authentication and proposes that method.

This pull request:

1. Changes the default key agreement algorithm to the one indicated in the documentation
2. Adds a new dds.sec.auth.builtin.PKI-DH.preferred_key_agreement property that allows choosing the preferred algorithm to use.

@Mergifyio backport 3.1.x

We will backport to 3.1.x, but leaving the default value of the new property to the old behavior.
We will then backport from there into 3.0.x 2.14.x 2.10.x

Contributor Checklist

• Commit messages follow the project guidelines.
• The code follows the style guidelines of this project.
• Tests that thoroughly check the new feature have been added/Regression tests checking the bug and its fix have been added; the added tests pass locally
• N/A Any new/modified methods have been properly documented using Doxygen.
• Any new configuration API has an equivalent XML API (with the corresponding XSD extension)
• Changes are backport compatible: they do NOT break ABI nor change library core behavior.
• Changes are API compatible.
• New feature has been added to the versions.md file (if applicable).
• New feature has been documented/Current behavior is correctly described in the documentation.
  • Related documentation PR: [22280] Add documentation for preferred_key_agreement property Fast-DDS-docs#963
• Applicable backports have been included in the description.

Reviewer Checklist

• The PR has a milestone assigned.
• The title and description correctly express the PR's purpose.
• Check contributor checklist is correct.
• If this is a critical bug fix, backports to the critical-only supported branches have been requested.
• Check CI results: changes do not issue any warning.
• Check CI results: failing tests are unrelated with the changes.

---

This is an automatic backport of pull request #5413 done by [Mergify](https://mergify.com).

---

This is an automatic backport of pull request #5442 done by [Mergify](https://mergify.com).

[mergify]

Cherry-pick of 4d793f0 has failed:

On branch mergify/bp/2.14.x/pr-5442
Your branch is up to date with 'origin/2.14.x'.

You are currently cherry-picking commit 4d793f001.
  (fix conflicts and run "git cherry-pick --continue")
  (use "git cherry-pick --skip" to skip this patch)
  (use "git cherry-pick --abort" to cancel the cherry-pick operation)

Changes to be committed:
	modified:   src/cpp/security/authentication/PKIDH.cpp
	modified:   test/dds/communication/security/secure_msg_crypto_besteffort_pub_profile.xml
	modified:   test/dds/communication/security/secure_msg_submsg_crypto_besteffort_pub_profile.xml
	modified:   test/dds/communication/security/secure_msg_submsg_crypto_besteffort_sub_profile.xml
	modified:   test/dds/communication/security/secure_submsg_crypto_besteffort_pub_profile.xml
	modified:   test/dds/communication/security/secure_submsg_crypto_besteffort_sub_profile.xml
	modified:   test/dds/communication/security/simple_secure_besteffort_pub_profile.xml
	modified:   test/dds/communication/security/simple_secure_besteffort_sub_profile.xml
	modified:   test/unittest/security/authentication/AuthenticationPluginTests.hpp
	modified:   test/unittest/security/authentication/BuiltinPKIDHTests.cpp

Unmerged paths:
  (use "git add <file>..." to mark resolution)
	both modified:   test/blackbox/common/BlackboxTestsSecurity.cpp
	both modified:   versions.md

To fix up this pull request, you can check it out locally. See documentation: https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/checking-out-pull-requests-locally