Cpp Development

The Pi Soft kS Engine C++ API comprises two groups of components: TEAgent and TEAdmin. Be sure to review the Environment Settings and Creating a Secure Connection to Key Services The C++ Package Overview contains a full listing of both components along with class diagrams.

TEAdmin Components

The C++ TEAdmin package provides functionalities used in managing an Pi Soft key service, such as adding a user, changing a password and changing user roles.

The general procedure for working with the C++ TEAdmin package is as follows: (1) create a TEConnection object with the secured mode and open a connection to the key service; (2) create a working object of TEADmin class and attach the connection to it; and (3) use the different methods of the TEAdmin class to do the desired work, such as adding users and assigning roles.

Below is a list of the types of code samples available using the TEAdmin component group.  These code samples can also be found in the Sample folder in the sdk.

• Managing Principals in Cpp
  • Add a Principal
  • Get a Principal in Cpp
  • Get a Principal by ID 1
  • Get a Principal by ID 2
  • Get a Principal by ID 3
  • Get Principal by Name
  • Update a Principal in Cpp
  • Remove a Principal in Cpp
  • Get a List of Principals
• Managing Roles in Cpp
  • Add a Role in Cpp
  • Get a Role in Cpp
  • Get a List of All Roles in Cpp
  • Update a Role in Cpp
  • Remove a Role in Cpp
  • Assign Roles to a Principal in Cpp
  • Remove a Role from a Principal in Cpp
• Managing Groups in Cpp
  • Assign Groups to a Principal
  • Remove Groups from a Principal in Cpp
  • Add Principals to a Group in Cpp
  • Remove Principals from a Group
  • Add Group to a Principal
  • Get Groups of a Principal in Cpp
  • Remove Group from a Principal
  • Clear Groups from a Principal in Cpp
  • Default Group
• Managing Reviewers in Cpp
  • Add Reviewer to a Principal in Cpp
  • Get the Reviewers of a Principal
  • Remove Reviewer from a Principal
  • Clear the Reviewers from a Principal
• Working with Access Control Lists
  • Add an ACL Entry in Cpp
  • Get ACL Information in Cpp
  • Update ACL Information and ACL Entry Information
  • Remove an ACL Entry in Cpp
• Managing ACL Templates in Cpp
  • Add ACL Template in Cpp
  • Get ACL Template in Cpp
  • Update ACL Template in Cpp
  • Remove ACL Template in Cpp
  • Set a Principals ACL Template in Cpp
• Managing Templated Directories
  • Add a Templated Directory
  • Get Templated Directories
  • Update Templated Directory
  • Remove Templated Directory
• Working with the TEAdminLocal Class
  • Go Online
  • Go Offline
  • Set the Status of a T-tag
  • Get the Status of a T-Tag
  • Get a Remote Engines Configuration Information
  • Set a Remote Engines Configuration Information
  • Add a Secure Folder
• Working with the TEAdminTrustedServer Class
• Additional Administrative Tasks in Cpp
  • Reset a Password
  • Get a System ID in Cpp
  • Get Version Information
  • Get a List of All Operations in Cpp
  • Generate Event Log in Cpp
  • Get Principals with Query in Cpp

TEAgent Components

The Pi Soft C++ TEAgent group of components provides functionalities such as encrypting, decrypting and hashing data. The C++ TEAgent component group is composed of a number of classes, which can be used intuitively for different purposes.

The general procedure working with the C++ TEAgent group of components is follows: (1) create a TEConnection object and open a connection a Key Server; (2) create a working object of a class such as TEAgentMatrix and attach it to the connection object; (3) use the working object to do the desired work such as encrypting, decrypting and hashing; and (4) detach the working object from the connection object and close the connection.

Below is a list of code samples using the TEAgent component group.  These code samples can also be found in the Sample folder in the sdk.

• Working with a Data Matrix in Cpp
  • Encryption with Matrix
  • Hash with Matrix
• Working with a File
• Hashing Data in Cpp
• Managing Keys in Cpp
  • Create Key in Cpp
  • Export and Import Key in Cpp
  • Export Key in Cpp
  • Expire Key in Cpp