Skip to content

Modifies Lightweight example to with PSL changes #759

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
krd-rti merged 2 commits into from
Aug 19, 2026
Merged

Modifies Lightweight example to with PSL changes #759

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
eb0b734
Modifies lightweight example to work with PSL
krd-rti Aug 17, 2026
ac451da
cosmetics
krd-rti Aug 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 23 additions & 0 deletions examples/connext_secure/lightweight/c++11/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,8 @@ which will create the lightweight subscriber.
./Lws_subscriber -lw
```

The lightweight profile uses the OpenSSL PSL.

Then, in a third window, launch the publisher.

```sh
Expand Down Expand Up @@ -68,6 +70,19 @@ Lws subscriber sleeping up to 1 sec...
Lws subscriber sleeping up to 1 sec...
```

## Notes on Lightweight Platform Support Library (PSL) configuration

The lightweight participant profiles now include explicit PSL configuration
properties for OpenSSL Cryptographic Library:

- OpenSSL profile (`lightweight_library::peer`):
- `com.rti.serv.secure.psl_library=psl_openssl3`
- `com.rti.serv.secure.psl_get_interface=PSL_OSSL_get_interface`
- `com.rti.serv.secure.psl_get_configuration=PSL_OSSL_get_default_configuration`

This mirrors the newer lightweight security initialization model where PSL abstracts
cryptography library and enables easy switch between different cryptographic libraries
with properties.

## Troubleshooting

Expand All @@ -84,3 +99,11 @@ Connext version you're using, e.g.
```sh
git checkout release/7.3.0
```

### Application does not start because of linking errors

If your application does not start because of errors related to library linking
or missing symbols, make sure your LD_LIBRARY_PATH contains `lib` directory within
Connext installation. Check if the `lib` directory contains PSL library matching
the value of `psl_library` property and make sure `psl_get_interface` and
`psl_get_configuration` match the functions provided by this library.
79 changes: 44 additions & 35 deletions examples/connext_secure/lightweight/c++11/USER_QOS_PROFILES.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -139,43 +139,52 @@ to use the software. -->
<qos_library name="lightweight_library">

<qos_profile name="peer">

<domain_participant_qos>

<transport_builtin>
<mask>UDPv4</mask>
</transport_builtin>
<domain_participant_qos>
<transport_builtin>
<mask>UDPv4</mask>
</transport_builtin>

<property>
<value>
<element>
<name>com.rti.serv.load_plugin</name>
<value>com.rti.serv.secure</value>
</element>
<element>
<name>com.rti.serv.secure.library</name>
<value>nddslightweightsecurity</value>
</element>
<element>
<name>com.rti.serv.secure.create_function</name>
<value>RTI_SecurityLightweight_PluginSuite_create</value>
</element>
<element>
<name>dds.sec.crypto.rtps_psk_secret_passphrase</name>
<value>data:,0:PLEASE-CHANGE-THIS-DEFAULT-SEED</value>
</element>
<element>
<name>dds.sec.crypto.symmetric_cipher_algorithm</name>
<value>AES256+GCM</value>
</element>
<element>
<name>com.rti.serv.secure.logging.verbosity</name>
<property>
<value>
<element>
<name>com.rti.serv.load_plugin</name>
<value>com.rti.serv.secure</value>
</element>
<element>
<name>com.rti.serv.secure.library</name>
<value>nddslightweightsecurity</value>
</element>
<element>
<name>com.rti.serv.secure.create_function</name>
<value>RTI_SecurityLightweight_PluginSuite_create</value>
</element>
<element>
<name>com.rti.serv.secure.psl_library</name>
<value>psl_openssl3</value>
</element>
<element>
<name>com.rti.serv.secure.psl_get_interface</name>
<value>PSL_OSSL_get_interface</value>
</element>
<element>
<name>com.rti.serv.secure.psl_get_configuration</name>
<value>PSL_OSSL_get_default_configuration</value>
</element>
<element>
<name>dds.sec.crypto.rtps_psk_secret_passphrase</name>
<value>data:,0:PLEASE-CHANGE-THIS-DEFAULT-SEED</value>
</element>
<element>
<name>dds.sec.crypto.symmetric_cipher_algorithm</name>
<value>AES256+GCM</value>
</element>
<element>
<name>com.rti.serv.secure.logging.verbosity</name>
<value>INFORMATIONAL</value>
</element>
</value>
</property>

</domain_participant_qos>
</element>
</value>
</property>
</domain_participant_qos>
</qos_profile>

</qos_library>
Expand Down
Loading