Trust table (PITRUST)
- Last UpdatedJan 13, 2023
- 2 minute read
- PI System
- PI Server
The PITRUST table allows a client application to connect to the Data Archive server as a specific PI user without requiring that the client application enter a user name and password. Such access is necessary for applications that run unattended, such as PI interfaces. When you configure trusts, credential attributes such as Domain name, IP host name, IP address, Application name, and Operating System Username are stored in the trust table.
The client and Data Archive obtain the client's credentials from the operating system, domain controller, and network software. These include any of the following: domain name, IP host name, IP address, and user name.
Select this table using the command:
@table PITRUST
The primary key is TRUST.
|
PITRUST Attributes |
Description |
|
Trust |
A name for this trust relationship |
|
Domain |
The domain name for the client machine |
|
IPAddr |
IP address of client machine |
|
NetMask |
Network address mask in the format (255.255.255.255) |
|
IPHost |
Name of client machine |
|
OSUser |
User name under which the client is running |
|
AppName |
Application name |
|
PIUser |
Associated PI user |
|
Description |
Explanation of the purpose of this trust |
|
Flags |
For internal use only; controls enabling/disabling the trust |
Any field specified as NULL string (""), is ignored when incoming connection are matched against the table.
Domain, IPHost, AppName, and OSUser must be specified exactly or not at all.
IPAddr and NetMask must be specified together. If you provide a value for one, you must also provide the other.
PIUser must always be specified as either a currently existing PI user in the user database, a PI group in the group database, a PI identity, or as a dollar sign ($). The dollar sign must be paired with a $ in either or IPHost. If the trust matches incoming credentials and there is no PIUser with the same name, an error occurs at run-time. This method of specification matches any user or any machine that passes the domain controller validation of their login credentials.
To create a trust , type:
@table pitrust
@mode create
@istr Trust,IPHost,PIUser
YourTrustName,server.domain.int,JohnDoe@ends