One Identity Privilege Manager for Sudo Administration Guide
Total Page:16
File Type:pdf, Size:1020Kb
One Identity Privilege Manager for Sudo 6.1 Administration Guide Copyright 2019 One Identity LLC. ALL RIGHTS RESERVED. This guide contains proprietary information protected by copyright. The software described in this guide is furnished under a software license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of the applicable agreement. No part of this guide may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording for any purpose other than the purchaser’s personal use without the written permission of One Identity LLC . The information in this document is provided in connection with One Identity products. No license, express or implied, by estoppel or otherwise, to any intellectual property right is granted by this document or in connection with the sale of One Identity LLC products. EXCEPT AS SET FORTH IN THE TERMS AND CONDITIONS AS SPECIFIED IN THE LICENSE AGREEMENT FOR THIS PRODUCT, ONE IDENTITY ASSUMES NO LIABILITY WHATSOEVER AND DISCLAIMS ANY EXPRESS, IMPLIED OR STATUTORY WARRANTY RELATING TO ITS PRODUCTS INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON- INFRINGEMENT. IN NO EVENT SHALL ONE IDENTITY BE LIABLE FOR ANY DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE, SPECIAL OR INCIDENTAL DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF PROFITS, BUSINESS INTERRUPTION OR LOSS OF INFORMATION) ARISING OUT OF THE USE OR INABILITY TO USE THIS DOCUMENT, EVEN IF ONE IDENTITY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. One Identity makes no representations or warranties with respect to the accuracy or completeness of the contents of this document and reserves the right to make changes to specifications and product descriptions at any time without notice. One Identity does not make any commitment to update the information contained in this document. If you have any questions regarding your potential use of this material, contact: One Identity LLC. Attn: LEGAL Dept 4 Polaris Way Aliso Viejo, CA 92656 Refer to our Web site (http://www.OneIdentity.com) for regional and international office information. Patents One Identity is proud of our advanced technology. Patents and pending patents may apply to this product. For the most current information about applicable patents for this product, please visit our website at http://www.OneIdentity.com/legal/patents.aspx. Trademarks One Identity and the One Identity logo are trademarks and registered trademarks of One Identity LLC. in the U.S.A. and other countries. For a complete list of One Identity trademarks, please visit our website at www.OneIdentity.com/legal. All other trademarks are the property of their respective owners. Legend WARNING: A WARNING icon highlights a potential risk of bodily injury or property damage, for which industry-standard safety precautions are advised. This icon is often associated with electrical hazards related to hardware. CAUTION: A CAUTION icon indicates potential damage to hardware or loss of data if instructions are not followed. Privilege Manager for Sudo Administration Guide Updated - July 2019 Version - 6.1 Contents One Identity Privileged Access Suite for Unix 9 About this guide 10 Introducing Privilege Manager for Sudo 12 Features and benefits of Privilege Manager for Sudo 13 How Privilege Manager for Sudo works 15 Planning Deployment 17 System requirements 18 Supported platforms 19 Reserve special user and group names 20 Required privileges 20 Estimating size requirements 21 Privilege Manager licensing 21 Deployment scenarios 22 Single host deployment 22 Medium business deployment 23 Large business deployment 23 Installation and Configuration 25 Download Privilege Manager for Sudo software packages 26 Quick start and evaluation 26 Installing the Management Console 26 Uninstalling the Management Console 28 Configure a Primary Policy Server 28 Checking the server for installation readiness 29 TCP/IP configuration 29 Firewalls 30 Hosts database 30 Reserve special user and group names 30 Policy server daemon hosts 31 Sudo 1.8.x 31 Installing the Privilege Manager packages 31 Privilege Manager for Sudo 6.1 Administration Guide 3 Adding directories to PATH environment 32 Configuring the Privilege Manager for Sudo Primary Policy Server 32 Privilege Manager for Sudo Server Configuration Settings 33 Join hosts to policy group 37 Joining Sudo Plugin to Policy Server 38 Swap and install keys 38 Configure a secondary policy server 39 Installing secondary servers 39 Configuring a secondary server 40 Synchronizing policy servers within a group 40 Install Sudo Plugin on a remote host 40 Checking Sudo Plugin Host for installation readiness 41 Installing a Sudo Plugin on a remote host 42 Joining a Sudo Plugin to a primary policy server 42 Verifying Sudo Plugin configuration 43 Load balancing on the client 44 Remove configurations 44 Uninstalling the Privilege Manager software packages 44 Uninstalling Privilege Manager for Sudo on macOS 45 Upgrade Privilege Manager for Sudo 46 Before you upgrade 46 Upgrading Privilege Manager packages 46 Upgrading the server package 47 Upgrading the Sudo Plugin package 47 Removing Privilege Manager packages 47 Removing the server package 47 Removing the Sudo Plugin package 48 System Administration 49 Reporting basic policy server configuration information 49 Checking the status of the master policy 50 Checking the policy server 50 Checking policy server status 51 Checking the Sudo Plugin configuration status 51 Installing licenses 52 Privilege Manager for Sudo 6.1 Administration Guide 4 Displaying license usage 53 Listing policy file revisions 54 Viewing differences between revisions 54 Backup and recovery 55 Managing Security Policy 57 Security policy types 57 Specifying security policy type 59 The sudo type policy 59 Viewing the security profile changes 60 Administering Log and Keystroke Files 62 Configuring keystroke logging for Privilege Manager for Sudo policy 63 Validating Sudo commands 63 Local logging 64 Event logging 65 Keystroke (I/O) logging 65 Viewing the log files using a web browser 66 Viewing the log files using command line tools 66 Listing event logs 68 Backing up and archiving event and keystroke logs 70 Troubleshooting 73 Enabling sudo policy debug logging 73 Enabling tracing for Sudo Plugin 73 Join fails to generate a SSH key for sudo policy 74 Join to policy group failed on Sudo Plugin 74 Load balancing and policy updates 75 Policy servers are failing 75 Sudo command is rejected by Privilege Manager for Sudo 76 Sudo policy is not working properly 77 Appendix: Privilege Manager Variables 79 Global input variables 79 argc 81 argv 82 client_parent_pid 82 client_parent_uid 82 Privilege Manager for Sudo 6.1 Administration Guide 5 client_parent_procname 83 clienthost 83 command 83 cwd 84 date 84 day 84 dayname 85 domainname 85 env 86 false 86 gid 86 group 86 groups 87 host 87 hour 87 masterhost 88 masterversion 88 minute 88 month 88 nice 89 nodename 89 pid 89 pmclient_type 90 pmclient_type_pmrun 90 pmclient_type_sudo 90 pmversion 91 ptyflags 91 requestlocal 91 requestuser 91 samaccount 92 status 92 submithost 92 submithostip 92 thishost 93 time 93 Privilege Manager for Sudo 6.1 Administration Guide 6 true 94 ttyname 94 tzname 94 uid 95 umask 96 unameclient 96 uniqueid 96 user 96 year 97 Global output variables 97 disable_exec 98 eventlog 98 iolog 98 logstderr 98 logstdin 99 logstdout 99 Global event log variables 99 event 100 exitdate 100 exitstatus 101 exittime 102 PM settings variables 102 Appendix: Privilege Manager programs 109 pmcheck 112 pmjoin_plugin 115 pmkey 116 pmlicense 118 pmloadcheck 121 pmlog 123 pmlogadm 127 pmlogsearch 130 pmlogsrvd 134 pmlogxfer 136 pmmasterd 137 pmplugininfo 138 Privilege Manager for Sudo 6.1 Administration Guide 7 pmpluginloadcheck 139 pmpolicy 140 pmpolicyplugin 147 pmpoljoin_plugin 148 pmpolsrvconfig 149 pmremlog 151 pmreplay 152 Navigating the log file 154 pmresolvehost 155 pmserviced 156 pmsrvcheck 157 pmsrvconfig 159 pmsrvinfo 161 pmsum 162 pmsysid 163 Appendix: Installation Packages 164 Package locations 164 Installed files and directories 165 Appendix: Unsupported Sudo Options 168 Unsupported command line sudo options 168 Behavioral change 169 Unsupported Sudoers policy options 169 Unsupported Sudoers directives 171 Appendix: Privilege Manager for Sudo Policy Evaluation 172 About us 174 Contacting us 174 Technical support resources 174 Index 175 Privilege Manager for Sudo 6.1 Administration Guide 8 1 One Identity Privileged Access Suite for Unix Unix Security Simplified One Identity Privileged Access Suite for Unix solves the inherent security and administration issues of Unix-based systems (including Linux and macOS) while making satisfying compliance requirements easier. It unifies and consolidates identities, assigns individual accountability, and enables centralized reporting for user and administrator access to Unix. The Privileged Access Suite for Unix combines an Active Directory bridge and root delegation solutions under a unified console that grants organizations centralized visibility and streamlined administration of identities and access rights across their entire Unix environment. Active Directory Bridge Achieve unified access control, authentication, authorization, and identity administration for Unix, Linux, and macOS systems by extending them into Active Directory (AD) and taking advantage of AD’s inherent benefits. Patented technology allows non-Windows resources