Joining PM Agent to a Privilege Manager for Unix policy server
To join a PM Agent to a policy server
- Log on as the root user and change to the directory containing the qpm-agent package for your specific platform. For example, on a 64-bit Red Hat Linux, enter:
# cd agent/linux-x86_64
- Run:
# pmjoin <primary_policy_server>
where <primary_policy_server> is the hostname of the primary policy server.
Running pmjoin performs the configuration of the PM Agent, including modifying the pm.settings file.
NOTE: The pmjoin command supports many command line options. See pmjoin for details or run pmjoin with the -h option to display the help.
-
When you run pmjoin with no options, the configuration script automatically configures the agent with default settings. See Agent configuration settings for details about the default and alternate agent configuration settings.
NOTE: You can modify the /etc/opt/quest/qpm4u/pm.settings file later, if you want to change one of the settings. See PM settings variables for details.
- When you run pmjoin with the -i (interactive) option, the configuration script gathers information from you by asking you a series of questions. During this interview, you are allowed to either accept a default setting or set an alternate setting.
Once you have completed the configuration script interview, it configures the agent and joins it to the policy server.
-
- When you run pmjoin for the first time, it asks you to read and accept the End User License Agreement (EULA).
Once you complete the agent configuration script (by running the pmjoin command), it:
- Enables the pmlocald service
- Updates the pm.settings file
-
Adds the Privilege Manager shells to the system's list of valid shells and creates wrappers for the installed (system) shells. The following shells are provided, based on standard shells:
- pmksh, a Privilege Manager enabled version of the Korn shell
- pmsh, a Privilege Manager enabled version of the Bourne shell
- pmcsh, a Privilege Manager version of c shell
- pmbash, a Privilege Manager version of the Bourne Again Shell
Each shell provides command-control for every command entered by the user during a login session. You can configure each command the user enters to require authorization with the policy server for execution. This includes the shell built-in commands.
- Updates /etc/shells
- Reloads the pmserviced configuration
- Checks the connection to the policy server host
- To verify that the agent installation has been successful, as an unprivileged user, run a command that is permitted by the default Privilege Manager for Unix security policy, demo.profile. For example, the default security policy allows any user to run the id command as the root user:
# pmrun id
This returns the root user id, not the user’s own id, to show that the command ran as root.
Agent configuration settings
The following table lists the pmjoin command options, the default settings, and alternatives. See PM settings variables for more information about the policy server configuration settings.
| Option | Default | Alternate setting | ||
|---|---|---|---|---|
| Enable agent daemon command line options: | none |
Enter:
| ||
| Enable client daemon? | YES | Enter No | ||
| Configure host components to communicate with remote hosts through firewall? | NO | Enter Yes | ||
| Enable Privilege Manager shells (pmksh, pmsh, pmcsh, pmbash)? |
YES That is, you want to use a Privilege Manager shell to control or log Privilege Manager sessions, regardless of how the user logs in (telnet, ssh, rsh, rexec). |
Enter No if you do NOT want to add the Privilege Manager shells to the system. That is, you do not want to use the Privilege Manager shells as a login shell. | ||
| Add the entries to the /etc/services file? | YES |
Enter No
| ||
| Edit list of policy servers with which this agent can communicate? | none | Enter valid policy server names to add to the list. | ||
| Indicate if the list is correct | YES | Enter No | ||
| Policy Server daemon port # | 12345 | Enter a port number | ||
| Specify the agent daemon port number: | 12346 | Enter a port number for the agent to communicate with the policy server. | ||
| Specify a range of local port numbers for this host to connect to other defined Privilege Manager hosts across a firewall? | NO | Enter Yes, then enter:
| ||
| Allow short host names? | YES | Enter No to use fully qualified host names instead. | ||
| Configure Kerberos on your network? | NO | Enter Yes, then enter:
| ||
| Specify encryption level:
See Encryption for details. |
AES | Enter one of these encryption options:
| ||
| Enable certificates? | NO |
Enter Yes, then answer: Generate a certificate on this host? (Default is NO.) Enter Yes and specify a passphrase for the certificate.
| ||
| Activate the failover timeout? | YES |
Enter No, then assign the failover timeout in seconds. Default: 10 seconds | ||
| Assign the failover timeout | 10 | Enter a timeout value in seconds | ||
| Select random policy server | YES | Enter No | ||
| Send errors reported by agent to syslog? | YES | |||
| Store errors reported by the agent daemon in /var/log/pmlocald.log? | YES | Enter No, then enter a location. | ||
| Store errors reported by the run agent in /var/log/pmrun.log? | YES | Enter No, then enter a location. |
Swap and install keys
If certificates are enabled in the /etc/opt/quest/qpm4u/pm.settings file of the primary server, then you must exchange keys (swap certificates) prior to joining a client or secondary server to the primary server. Optionally, you can run the configuration or join with the -i option to interactively join and exchange keys.
|
|
NOTE: One Identity recommends that you enable certificates for higher security. |
|
|
NOTE: The examples below use the keyfile paths that are created when using interactive configuration or join if certificates are enabled. |
To swap certificate keys
- Copy Host2's key to Host1. For example:
# scp /etc/opt/quest/qpm4u/.qpm4u/.keyfiles/key_localhost \
root@Host1:/etc/opt/quest/qpm4u/.qpm4u/.keyfiles/key_server2 - Copy Host1's certificate to Host2. For example:
# scp root@host1:/etc/opt/quest/qpm4u/.qpm4u/.keyfiles/key_localhost \
/etc/opt/quest/qpm4u/.qpm4u/.keyfiles/key_host1 - Install Host1's certificate on Host2. For example:
# /opt/quest/sbin/pmkey -i /etc/opt/quest/qpm4u/.qpm4u/.keyfiles/key_host1
-
Log on to Host1 and install Host2's certificate. For example:
# /opt/quest/sbin/pmkey -i /etc/opt/quest/qpm4u/.qpm4u/.keyfiles/key_host2
NOTE: If you use the interactive configure or join, the script will exchange and install keyfiles automatically.
See Configuring certificates for more information.
Configure a secondary policy server
The primary policy server is always the first server configured in the policy server group; secondary servers are subsequent policy servers set up in the policy server group to help with load balancing. The "master" copy of the policy is kept on the primary policy server.
All policy servers (primary and secondary) maintain a production copy of the security policy stored locally. The initial production copy is initialized by means of a checkout from the repository when you configure the policy server. Following this, the policy servers automatically retrieve updates as required.
By adding one or more secondary policy servers, the work of validating policy is balanced across all of the policy servers in the group, and provides failover in the event a policy server becomes unavailable. Use pmsrvconfig with the –s option to configure the policy server as a secondary server.