TSS 2.0 Enhanced System API Rust Wrapper

The tss-esapi Rust crate provides an idiomatic interface to the TCG TSS 2.0 Enhanced System API. We expose both direct FFI bindings and abstracted versions, aimed at improved convenience of using the API.

Disclaimer

The current version of the API does not offer any security or code safety guarantees. The implementation that is provided is suitable for exploratory testing and experimentation only. This test implementation does not offer any tangible security benefits and therefore is not suitable for use in production. Documentation pages may be incomplete and are subject to change without notice. Interfaces may change in such a way as to break compatibility with client code. Contributions from the developer community are welcome. Please refer to the contribution guidelines.

Requirements

This crate has currently only been tested with the TSS 2.0 open-source implementation. It uses pkg-config to find the include and library files for the tss2-esys and tss2-tctildr libraries. pkg-config tool is needed to build this crate.

Having installed the open-source implementation libraries at /usr/local/lib (by default), it might happen that pkg-config can not find them. Run the following command if that is the case:

$ export PKG_CONFIG_PATH=/usr/local/lib/pkgconfig

Community channel

Come and talk to us in our Slack channel! Here is how to join the workspace.

Contributing

We would be happy for you to contribute to the tss-esapi crate! Check the Contributing file to know more about the contribution process. Check the open issues on the board if you need any ideas 🙂!

License

The software is provided under Apache-2.0. Contributions to this project are accepted under the same license.

This project uses the following third party crates:

• serde (MIT and Apache-2.0)
• bindgen (BSD-3-Clause)
• log (MIT and Apache-2.0)
• env_logger (MIT and Apache-2.0)
• mbox (MIT)
• bitfield (MIT and Apache-2.0)
• pkg-config (MIT and Apache-2.0)