Svc/Ccsds/ClearTextEncryptor/docs/sdd.md
[!WARNING] This component provides NO security. It performs no authentication, no integrity protection, and no encryption. All data passes through unmodified. It is intended only for clear-mode operation (e.g. as the default encryptor in a standard subtopology) and for testing. Do not use it where confidentiality, integrity, or authenticity of the data link is required.
The Svc::Ccsds::ClearTextEncryptor component is a pass-through implementation of the Svc.Ccsds.CcsdsSdlsEncrypt interface. It is a pure pass-through in both dimensions: requests received on encryptIn are forwarded out encryptOut with the buffer and context unmodified (alongside an SdlsStatus.SUCCESS status), and buffer ownership returned on encryptReturnIn is passed upstream via bufferReturnOut for deallocation. No memory is allocated.
encryptIn port; the SA index is ignored.encryptOut alongside an SdlsStatus.SUCCESS status.encryptReturnIn upstream via bufferReturnOut (the forwarded buffer is the incoming buffer, as no allocation occurs).| Kind | Name | Port Type | Description |
|---|---|---|---|
| guarded input | encryptIn | Svc.Ccsds.CcsdsSdlsEncryption | Receives the SA index and iv/data buffer (from CcsdsSdlsEncrypt interface). |
| output | encryptOut | Svc.Ccsds.CcsdsSdlsData | Sends the operation status and (unmodified) data downstream. |
| sync input | encryptReturnIn | Svc.ComDataWithContext | Receives back ownership of buffers sent on encryptOut. |
| output | bufferReturnOut | Svc.ComDataWithContext | Returns the incoming iv/data buffer for deallocation. |
| Name | Description | Validation |
|---|---|---|
| SVC-CCSDS-CLEARTEXT-ENCRYPTOR-001 | The ClearTextEncryptor shall accept an SA index, iv/data buffer, and frame context via the Svc.Ccsds.CcsdsSdlsEncrypt interface (guarded encryptIn). | Unit Test |
| SVC-CCSDS-CLEARTEXT-ENCRYPTOR-002 | The ClearTextEncryptor shall perform no authentication and no encryption, passing the received buffer and context unmodified out encryptOut. | Unit Test |
| SVC-CCSDS-CLEARTEXT-ENCRYPTOR-003 | The ClearTextEncryptor shall pass an SdlsStatus.SUCCESS status forward for every request. | Unit Test |
| SVC-CCSDS-CLEARTEXT-ENCRYPTOR-004 | Upon receiving ownership of a buffer back on encryptReturnIn, the ClearTextEncryptor shall pass it upstream via bufferReturnOut for deallocation. | Unit Test |