CP R75.40VS IdentityAwareness AdminGuide
CP R75.40VS IdentityAwareness AdminGuide
CP R75.40VS IdentityAwareness AdminGuide
R75.40VS
Administration Guide
15 July 2012
Classification: [Protected]
2012 Check Point Software Technologies Ltd. All rights reserved. This product and related documentation are protected by copyright and distributed under licensing restricting their use, copying, distribution, and decompilation. No part of this product or related documentation may be reproduced in any form or by any means without prior written authorization of Check Point. While every precaution has been taken in the preparation of this book, Check Point assumes no responsibility for errors or omissions. This publication and features described herein are subject to change without notice. RESTRICTED RIGHTS LEGEND: Use, duplication, or disclosure by the government is subject to restrictions as set forth in subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227-7013 and FAR 52.227-19. TRADEMARKS: Refer to the Copyright page (http://www.checkpoint.com/copyright.html) for a list of our trademarks. Refer to the Third Party copyright notices (http://www.checkpoint.com/3rd_party_copyright.html) for a list of relevant copyrights and third-party licenses.
Important Information
Latest Software
We recommend that you install the most recent software release to stay up-to-date with the latest functional improvements, stability fixes, security enhancements and protection against new and evolving attacks.
Latest Documentation
The latest version of this document is at: http://supportcontent.checkpoint.com/documentation_download?ID=16185 For additional technical information, visit the Check Point Support Center (http://supportcenter.checkpoint.com).
Revision History
Date 7/15/2012 Description First release of this document
Feedback
Check Point is engaged in a continuous effort to improve its documentation. Please help us by sending your comments (mailto:[email protected]?subject=Feedback on Identity Awareness R75.40VS Administration Guide).
Contents
Important Information .............................................................................................3 Getting Started With Identity Awareness ..............................................................7 Introduction ......................................................................................................... 7 AD Query .......................................................................................................10 Browser-Based Authentication .......................................................................11 Identity Agents ...............................................................................................13 Deployment ........................................................................................................14 Identity Awareness Scenarios ............................................................................15 Acquiring Identities for Active Directory Users ...............................................15 Acquiring Identities with Browser-Based Authentication .................................17 Acquiring Identities with Endpoint Identity Agents ..........................................20 Acquiring Identities in a Terminal Server Environment ...................................22 Acquiring Identities in Application Control ......................................................22 Configuring Identity Awareness ..........................................................................24 Enabling Identity Awareness on the Security Gateway .......................................24 Results of the Wizard .....................................................................................26 Creating Access Roles .......................................................................................26 Using Identity Awareness in the Firewall Rule Base ...........................................28 Access Role Objects ......................................................................................29 Negate and Drop ...........................................................................................29 Using Identity Awareness in the Application and URL Filtering Rule Base..........29 Source and Destination Fields .......................................................................31 Negate and Block ..........................................................................................31 Configuring Browser-Based Authentication in SmartDashboard .........................31 Portal Network Location .................................................................................32 Access Settings .............................................................................................32 Authentication Settings ..................................................................................32 Customize Appearance..................................................................................33 User Access ..................................................................................................33 Agent Deployment from the Portal .................................................................34 Configuring Endpoint Identity Agents ..................................................................34 Endpoint Identity Agent Types .......................................................................35 Endpoint Identity Agent Deployment Methods................................................37 Server Discovery and Trust............................................................................38 Configuring Endpoint Identity Agents in SmartDashboard ..............................39 Configuring Terminal Servers .............................................................................40 Deploying the Terminal Servers Identity Awareness Solution ........................41 Terminal Servers - Users Tab ........................................................................42 Terminal Servers Advanced Settings .............................................................42 Configuring Remote Access ...............................................................................43 Configuring Identity Logging for a Log Server .....................................................43 Enabling Identity Awareness on the Log Server for Identity Logging ..............44 Identity Sources ....................................................................................................45 Choosing Identity Sources ..................................................................................45 Advanced AD Query Configuration .....................................................................46 Configuring Identity Awareness for a Domain Forest (Subdomains) ..............46 Specifying Domain Controllers per Security Gateway ....................................47 Permissions and Timeout ..............................................................................48 Multiple Gateway Environments .....................................................................50 Non-English Language Support .....................................................................50 Performance ..................................................................................................50 Nested Groups...............................................................................................50
Troubleshooting .............................................................................................51 Advanced Browser-Based Authentication Configuration .....................................53 Customizing Text Strings ...............................................................................53 Adding a New Language................................................................................55 Server Certificates .........................................................................................57 Transparent Kerberos Authentication Configuration .......................................60 Advanced Endpoint Identity Agents Configuration ..............................................65 Customizing Parameters ................................................................................65 Prepackaging Endpoint Identity Agent Installation .........................................66 Advanced Deployment .........................................................................................67 Introduction ........................................................................................................67 Deployment Options ...........................................................................................68 Deploying a Test Environment ............................................................................68 Testing Identity Sources ................................................................................68 Testing Endpoint Identity Agents ...................................................................69 Deployment Scenarios .......................................................................................69 Perimeter Security Gateway with Identity Awareness ....................................69 Data Center Protection ..................................................................................70 Large Scale Enterprise Deployment ...............................................................71 Network Segregation .....................................................................................72 Distributed Enterprise with Branch Offices .....................................................73 Wireless Campus...........................................................................................75 Dedicated Identity Acquisition Gateway .........................................................75 Advanced Identity Agent Options ........................................................................77 Kerberos SSO Configuration ..............................................................................77 Overview........................................................................................................77 How SSO Operates .......................................................................................78 References ....................................................................................................78 SSO Configuration .........................................................................................79 Server Discovery and Trust ................................................................................83 Introduction ....................................................................................................83 Discovery and Trust Options ..........................................................................84 Option Comparison ........................................................................................85 Prepackaging Identity Agents .............................................................................91 Introduction ....................................................................................................91 Custom Endpoint Identity Agent msi ..............................................................91 Using the cpmsi_tool.exe ...............................................................................91 Sample INI File ..............................................................................................96 Deploying a Prepackaged Agent via the Captive Portal .................................97 Identity Awareness Commands ...........................................................................98 Introduction ........................................................................................................98 pdp .....................................................................................................................99 pdp monitor..................................................................................................100 pdp connections...........................................................................................101 pdp control ...................................................................................................102 pdp network .................................................................................................102 pdp debug....................................................................................................103 pdp tracker...................................................................................................104 pdp status ....................................................................................................105 pdp update...................................................................................................105 pep ...................................................................................................................106 pep show .....................................................................................................106 pep debug....................................................................................................108 adlog ................................................................................................................109 adlog query ..................................................................................................109 adlog dc .......................................................................................................110 adlog statistics .............................................................................................110 adlog debug .................................................................................................110 adlog control ................................................................................................111
adlog service_accounts ...............................................................................111 test_ad_connectivity .........................................................................................112 Regular Expressions .......................................................................................... 113 Metacharacters.................................................................................................113 Square Brackets ...............................................................................................114 Parentheses .....................................................................................................114 Hyphen .............................................................................................................114 Dot ...................................................................................................................114 Vertical Bar .......................................................................................................114 Backslash .........................................................................................................114 Escaping Symbols .......................................................................................114 Encoding Non-Printable Characters .............................................................115 Specifying Character Types .........................................................................115 Quantifiers ........................................................................................................115 Curly Brackets .............................................................................................116 Question Marks............................................................................................116 Asterisk ........................................................................................................116 Plus .............................................................................................................116 Index .................................................................................................................... 117
Chapter 1
Getting Started With Identity Awareness
In This Chapter Introduction Deployment Identity Awareness Scenarios 7 14 15
Introduction
Traditionally, firewalls use IP addresses to monitor traffic and are unaware of the user and machine identities behind those IP addresses. Identity Awareness removes this notion of anonymity since it maps users and machine identities. This lets you enforce access and audit data based on identity. Identity Awareness is an easy to deploy and scalable solution. It is applicable for both Active Directory and non-Active Directory based networks as well as for employees and guest users. It is currently available on the Firewall blade and Application Control blade and will operate with other blades in the future. Identity Awareness lets you easily configure network access and auditing based on network location and: The identity of a user The identity of a machine
When Identity Awareness identifies a source or destination, it shows the IP address of the user or machine with a name. For example, this lets you create firewall rules with any of these properties. You can define a firewall rule for specific users when they send traffic from specific machines or a firewall rule for a specific user regardless of which machine they send traffic from.
In SmartDashboard, you use Access Role objects to define users, machines and network locations as one object.
Identity Awareness also lets you see user activity in SmartView Tracker and SmartEvent based on user and machine name and not just IP addresses.
Identity Awareness gets identities from these acquisition sources: AD Query Browser-Based Authentication Endpoint Identity Agent Terminal Servers Identity Agent Remote Access
The table below shows how identity sources are different in terms of usage and deployment considerations. Depending on those considerations, you can configure Identity Awareness to use one identity source or a combination of identity sources ("Choosing Identity Sources" on page 45). Source AD Query Description Gets identity data seamlessly from Microsoft Active Directory (AD) Recommended Usage
Identity based auditing and logging Leveraging identity in Internet application control Basic identity enforcement in the internal network
Deployment Considerations
Easy configuration (requires AD administrator credentials). For organizations that prefer not to allow administrator users to be used as service accounts on third party devices there is an option to configure AD Query without AD administrator privileges, see sk43874 (http://supportcontent. checkpoint.com/soluti ons?id=sk43874). Preferred for desktop users Only detects AD users and machines Used for identity enforcement (not intended for logging purposes)
Browser-Based Authentication
Captive Portal sends Captive Portal unidentified users to Identity based a Web portal for enforcement for authentication non-AD users If Transparent Kerberos Authentication is configured, the browser attempts to authenticate users transparently by getting identity information before the Captive Portal Username/password page is shown to the user.
(non-Windows and guest users) For deployment of Endpoint Identity Agents
Endpoint Identity A lightweight Agent endpoint agent that authenticates securely with Single Sign-On (SSO)
Source
Description
Recommended Usage
Identify users that use a Terminal Servers or Citrix environment.
Deployment Considerations
See Choosing Identity Sources (on page 45).
Terminal Servers To identify multiple Identity Agent users that connect from one IP address, a Terminal Server Identity agent is installed on the application server that hosts Terminal/Citrix services.
Remote Access
Users that gain access through IPSec VPN Office Mode are seamlessly authenticated.
Identify and apply identitybased security policy on users that access the organization through VPN.
Identity aware gateways can share the identity information that they acquire with other identity aware gateways. In this way, users that need to pass through several enforcement points are only identified once. See Advanced Deployment (on page 67) for more information.
AD Query
AD Query is an easy to deploy, clientless identity acquisition method. It is based on Active Directory integration and it is completely transparent to the user. The AD Query option operates when: An identified asset (user or machine) tries to access an Intranet resource that creates an authentication request. For example, when a user logs in, unlocks a screen, shares a network drive, reads emails through Exchange, or accesses an Intranet portal. AD Query is selected as a way to acquire identities.
The technology is based on querying the Active Directory Security Event Logs and extracting the user and machine mapping to the network address from them. It is based on Windows Management Instrumentation (WMI), a standard Microsoft protocol. The Security Gateway communicates directly with the Active Directory domain controllers and does not require a separate server. No installation is necessary on the clients or on the Active Directory server. Identity Awareness supports connections to Microsoft Active Directory on Windows Server 2003 and 2008.
Browser-Based Authentication
Browser-Based Authentication acquires identities from unidentified users. You can configure these acquisition methods: Captive Portal Transparent Kerberos Authentication
Captive Portal is a simple method that authenticates users through a web interface before granting them access to Intranet resources. When users try to access a protected resource, they get a web page that must fill out to continue.
With Transparent Kerberos Authentication, the browser attempts to authenticate users transparently by getting identity information before the Captive Portal username/password page opens. When you configure this option, the Captive Portal requests authentication data from the browser. Upon successful authentication, the user is redirected to its original destination. If authentication fails, the user must enter credentials in the Captive Portal. The Captive Portal option operates when a user tries to access a web resource and all of these apply: The Captive Portal is selected as a way to acquire identities and the redirect option has been set for the applicable rule. Unidentified users cannot access that resource because of rules with access roles in the Firewall / Application Rule Base. But if users are identified, they might be able to access the resource. Transparent Kerberos Authentication was configured, but authentication failed.
Identity Awareness Administration Guide R75.40VS | 11
When these criteria are true, Captive Portal acquires the identities of users. From the Captive Portal users can: Enter an existing user name and password if they have them. For guest users, enter required credentials. Configure what is required in the Portal Settings. Click a link to download an Identity Awareness agent. Configure this in the Portal Settings.
Identity Agents
There are two types of Identity Agents: Endpoint Identity Agents - dedicated client agents installed on users' computers that acquire and report identities to the Security Gateway. Terminal Servers Identity Agent - an agent installed on an application server that hosts Citrix/Terminal services. It identifies individual users whose source is the same IP address. ("Configuring Terminal Servers" on page 40)
Using Endpoint Identity Agents gives you: User and machine identity Minimal user intervention - all necessary configuration is done by administrators and does not require user input. Seamless connectivity - transparent authentication using Kerberos Single Sign-On (SSO) when users are logged in to the domain. If you do not want to use SSO, users enter their credentials manually. You can let them save these credentials. Connectivity through roaming - users stay automatically identified when they move between networks, as the client detects the movement and reconnects. Added security - you can use the patented packet tagging technology to prevent IP Spoofing. Endpoint Identity Agents also gives you strong (Kerberos based) user and machine authentication.
These are the types of Endpoint Identity Agents you can install: Full - requires administrator permissions for installation. If installed by a user without administrator permissions, it will automatically revert to installing the Light agent. The Full agent performs packet tagging and machine authentication. Light - does not require administrator permissions for installation. Cannot be configured with packet tagging or machine authentication. The light agent supports Microsoft Windows and Mac OS X. For supported version information, see the R75.40VS Release Notes (http://supportcontent.checkpoint.com/solutions?id=sk76540). Custom - a customized installation package. For more information, see Prepackaging Identity Agents (on page 91).
Users can download and install Endpoint Identity Agents from the Captive Portal or you can distribute MSI/DMG files to computers with distribution software or any other method (such as telling them where to download the client from).
Identity Awareness Administration Guide R75.40VS | 13
Deployment
Identity Awareness is commonly enabled on the perimeter gateway of the organization. It is frequently used in conjunction with Application Control. To protect internal data centers, Identity Awareness can be enabled on an internal gateway in front of internal servers, such as data centers. This can be in addition to on the perimeter gateway but does not require a perimeter gateway. Identity Awareness can be deployed in Bridge mode or Route mode. In Bridge mode it can use an existing subnet with no change to the hosts' IP addresses. In Route mode the gateway acts as a router with different subnets connected to its network interfaces.
For redundancy, you can deploy a gateway cluster in Active-Standby (HA) or Active-Active (LS) modes. Identity awareness supports ClusterXL HA and LS modes. If you deploy Identity Awareness on more than one gateway, you can configure the gateways to share identity information. Common scenarios include: Deploy on your perimeter gateway and data center gateway. Deploy on several data center gateways. Deploy on branch office gateways and central gateways.
You can have one or more gateways acquire identities and share them with the other gateways. You can also share identities between gateways managed in different Multi-Domain Servers.
Identity Awareness Administration Guide R75.40VS | 14
He wants to move around the organization and continue to have access to the HR Web Server. To make this scenario work, the IT administrator does these steps: 1. Enables Identity Awareness on a gateway, selects AD Query as one of the Identity Sources and installs the policy. 2. Checks SmartView Tracker to make sure the system identifies John Adams in the logs. 3. Adds an access role object to the Firewall Rule Base that lets John Adams access the HR Web Server from any machine and from any location. 4. Sees how the system tracks the actions of the access role in SmartView Tracker.
This log entry shows that the system maps the source IP to the user John Adams from CORP.ACME.COM. This uses the identity acquired from AD Query. Note - AD Query maps the users based on AD activity. This can take some time and depends on user activity. If John Adams is not identified (the IT administrator does not see the log), he should lock and unlock the computer.
The IT administrator can then remove the static IP from John Adam's laptop and give it a dynamic IP. The Security Gateway lets the user John Adams access the HR Web server from his laptop with a dynamic IP as the HR_Partner access role tells it that the user John Adams from any machine and any network is permitted access.
If unidentified users try to connect to resources in the network that are restricted to identified users, they are automatically sent to the Captive Portal. If Transparent Kerberos Authentication is configured, the browser will attempt to identify users that are logged into the domain using SSO before it shows the Captive Portal. Let's examine some scenarios to understand what Browser-Based Authentication does and the configuration required for each scenario.
User Experience
Jennifer McHanry does these steps: 1. Browses to the Finance server from her iPad. The Captive Portal opens because she is not identified and therefore cannot access the Finance Server. 2. She enters her usual system credentials in the Captive Portal. A Welcome to the network window opens. 3. She can successfully browse to the Finance server.
This log entry shows that the system maps the source "Jennifer_McHanry" to the user name. This uses the identity acquired from Captive Portal.
If a user agreement is required and its text. 5. Create two new rules in the Firewall Rule Base: a) If it is not already there, create a rule that identified users can access the internet from the organization. (i) From the Source of the rule, right-click to create an Access Role. (ii) Enter a Name for the Access Role. (iii) In the Users tab, select All identified users. (iv) Click OK. (v) The Access Role is added to the rule. Name Internet Source Identified_users Destination ExternalZone VPN Service Action accept
b) Create a rule to let Unauthorized Guests access only the internet. (i) From the Source of the rule, right-click to create an Access Role. (ii) Enter a Name for the Access Role. (iii) In the Users tab, select Specific users and choose Unauthenticated Guests. (iv) Click OK. The Access Role is added to the rule. (v) Select accept as the Action. (vi) Right-click the Action column and select Edit Properties. The Action Properties window opens. (vii) Select Redirect http connections to an authentication (captive) portal. Note: redirection will not occur if the source IP is already mapped to a user. (viii) Click OK. Name Guests Source Guests Destination VPN Service Action http accept (display captive portal)
User Experience
From the perspective of a guest at ACME, she does these steps: 1. Browses to an internet site from her laptop. The Captive Portal opens because she is not identified and therefore cannot access the Internet. 2. She enters her identifying data in the Captive Portal and reads through and accepts a network access agreement. A Welcome to the network window opens. 3. She can successfully browse to the Internet for a specified period of time.
Identity Awareness Administration Guide R75.40VS | 19
Amy wants Finance users to download the Endpoint Identity Agent from the Captive Portal. She needs to configure: Identity Agents as an identity source for Identity Awareness. Agent deployment for the Finance department group from the Captive Portal. She needs to deploy the Full Identity Agent so she can set the IP spoofing protection. No configuration is necessary on the client for IP spoofing protection. A rule in the Rule Base with an access role for Finance users, from all managed machines and from all locations with IP spoofing protection enabled.
After configuration and policy install, users that browse to the Finance Web server will get the Captive Portal and can download the Endpoint Identity Agent.
g) The Access Role is added to the rule. Name Finance Web Server 7. Install policy.
Identity Awareness Administration Guide R75.40VS | 20
Source Finance_dept
Destination Finance_web_server
Action accept
User Experience
A Finance department user does this: 1. Browses to the Finance Web server. The Captive Portal opens because the user is not identified and cannot access the server. A link to download the Endpoint Identity Agent is shown.
2. The user clicks the link to download the Endpoint Identity Agent. The user automatically connects to the gateway. A window opens asking the user to trust the server. Note - The trust window opens because the user connects to the Security Gateway with Identity Awareness using the File name based server discovery option. See Server Discovery and Trust (on page 38) for more details on other server discovery methods that do not require user trust confirmation. 3. Click OK. The user automatically connects to the Finance Web server. The user can successfully browse to the internet for a specified period of time.
What's Next
Other options that can be configured for Endpoint Identity Agents: A method that determines how Endpoint Identity Agents connect to a Security Gateway enabled with Identity Awareness and trusts it. See Server Discovery and Trust (on page 38)for more details. In this scenario, the File Name server discovery method is used. Access roles ("Creating Access Roles" on page 26) to leverage machine awareness. End user interface protection so users cannot access the client settings. Let users defer client installation for a set time and ask for user agreement confirmation. See User Access (on page 33).
This log entry shows that the system maps the source IP address with the user's identity. In this case, the identity is "guest" because that is how the user is identified in the Captive Portal.
To enable the Terminal Servers solution, Amy must: Configure Terminal Server/Citrix Identity Agents as an identity source for Identity Awareness. Install a Terminal Servers Identity Agent on each of the Terminal Servers. Configure a shared secret between the Terminal Servers Identity Agents and the Identity Server. After configuration and installation of the policy, users that log in to Terminal Servers and browse to the internet will be identified and only Sales department users will be able to access Facebook.
2. Enables Identity Awareness on a gateway, selects AD Query as one of the Identity Sources. 3. Installs the policy.
Chapter 2
Configuring Identity Awareness
In This Chapter Enabling Identity Awareness on the Security Gateway Creating Access Roles Using Identity Awareness in the Firewall Rule Base Using Identity Awareness in the Application and URL Filtering Rule Base Configuring Browser-Based Authentication in SmartDashboard Configuring Endpoint Identity Agents Configuring Terminal Servers Configuring Remote Access Configuring Identity Logging for a Log Server 24 26 28 29 31 34 40 43 43
5. Select one or more options. These options set the methods for acquiring identities of managed and unmanaged assets. AD Query - Lets the Security Gateway seamlessly identify Active Directory users and computers. Browser-Based Authentication - Sends users to a Web page to acquire identities from unidentified users. If Transparent Kerberos Authentication is configured, AD users may be identified transparently.
Terminal Servers - Identify users in a Terminal Server environment (originating from one IP address). See Choosing Identity Sources (on page 45). Note - When you enable Browser-Based Authentication on a Security Gateway that is on an IP Series appliance, make sure to set the Voyager management application port to a port other than 443 or 80. 6. Click Next. The Integration With Active Directory window opens. When SmartDashboard is part of the domain, SmartDashboard suggests this domain automatically. If you select this domain, the system creates an LDAP Account Unit with all of the domain controllers in the organization's Active Directory. Note - We highly recommend that you go to the LDAP Account Unit and make sure that only necessary domain controllers are in the list. If AD Query is not required to operate with some of the domain controllers, delete them from the LDAP Servers list. With the Identity Awareness configuration wizard you can use existing LDAP Account units or create a new one for one AD domain. If you create a new domain, the LDAP account unit that the system creates contains only the domain controller you set manually. If it is necessary for AD Query to fetch data from other domain controllers, you must add them at a later time manually to the LDAP Servers list after you complete the wizard. To view/edit the LDAP Account Unit object, select Servers and OPSEC in the objects tree > LDAP Account Unit. The LDAP Account Unit name syntax is: <domain name>_ _ AD For example, CORP.ACME.COM_ _ AD. 7. From the Select an Active Directory list, select the Active Directory to configure from the list that shows configured LDAP account units or create a new domain. If you have not set up Active Directory, you need to enter a domain name, username, password and domain controller credentials.
Identity Awareness Administration Guide R75.40VS | 25
8. Enter the Active Directory credentials and click Connect to verify the credentials. Important - For AD Query you must enter domain administrator credentials. For Browser-Based Authentication standard credentials are sufficient. 9. If you selected to use Browser-Based Authentication or Terminal Servers and do not wish to configure Active Directory, select I do not wish to configure Active Directory at this time and click Next. 10. Click Next. If you selected Browser-Based Authentication on the first page, the Browser-Based Authentication Settings page opens. 11. In the Browser-Based Authentication Settings page, select a URL for the portal, where unidentified users will be directed. All IP addresses configured for the gateway show in the list. The IP address selected by default is the <gateway's main IP address>/connect. The same IP address can be used for other portals with different paths. For example: 12. 13. Identity Awareness Browser-Based Authentication - 143.100.75.1/connect DLP Portal - 2.2.2.2/DLP
14. 15.
Mobile Access Portal - 2.2.2.2/sslvpn By default, access to the portal is only through internal interfaces. To change this, click Edit. We do not recommend that you let the portal be accessed through external interfaces on a perimeter gateway. Click Next. The Identity Awareness is Now Active page opens with a summary of the acquisition methods. If you selected Terminal Servers, the page includes a link to download the agent. See Terminal Servers Configuration. ("Configuring Terminal Servers" on page 40) Click Finish. Select Policy > Install from the SmartDashboard menu.
To view/edit the LDAP Account Unit object, select Servers and OPSEC in the objects tree > LDAP Account Unit. The LDAP Account Unit name syntax is: <domain name>_ _ AD For example, CORP.ACME.COM_ _ AD. If you configured Terminal Servers, you need additional configuration. See Terminal Servers Configuration. ("Configuring Terminal Servers" on page 40)
3. Enter a Name and Comment (optional) for the access role. 4. Select a Color for the object (optional). 5. In the Networks tab, select one of these: Any network Specific networks - click the plus sign and select a network. Your selection is shown under the Networks node in the Role Preview pane. 6. In the Users tab, select one of these: Any user All identified users - includes any user identified by a supported authentication method (internal users, Active Directory users or LDAP users). Specific users - click the plus sign. A window opens. You can search for Active Directory entries or select them from the list. Your selections are shown in the Users node in the Role Preview pane. 7. In the Machines tab, select one of these: Any machine All identified machines - includes machines identified by a supported authentication method (Active Directory). Specific machines - click the plus sign. A window opens. You can search for Active Directory entries or select them from the list. Your selections are shown in the Machines node in the Role Preview pane. 8. In the Machines tab, select Enforce IP spoofing protection (requires full identity agent) if you want to enable the packet tagging feature. 9. Click OK. The access role is added to the Users and Administrators tree.
2 3
Example 1 - If an unidentified Finance Dept user tries to access the Finance Web Server with http, a redirect to the Captive Portal occurs. After the user enters credentials, the gateway allows access to the Finance Web Server. Access is allowed based on rule number 1, which identifies the user through the Captive Portal as belonging to the Finance Dept access role.
Example 2 - If an unidentified administrator tries to access the Finance Web Server with http, a redirect to the Captive Portal occurs despite rule number 2. After the administrator is identified, rule number 2 matches. To let the administrator access the Finance Web Server without redirection to the Captive Portal, switch the order of rules 1 and 2 or add a network restriction to the access role.
To prevent access to unidentified users, add another rule that ensures that only identified employees will be allowed access and that attempts by a temporary employee will be dropped. Source Temp_employees Destination VPN Service http Action drop
Any_identified_employee
http
accept
Using Identity Awareness in the Application and URL Filtering Rule Base
The Security Gateway inspects Application and URL Filtering requests and applies rules in a sequential manner. When a Security Gateway receives a packet from a connection, it examines the packet against the first rule in the Rule Base. If there is no match, it goes on to the second rule and continues until it completes the Rule Base. If no rule matches, the packet is allowed. In rules with access roles, you can add a property in the Action field to redirect traffic to the Captive Portal. If this property is added, when the source identity is unknown and traffic is HTTP, the user is redirected to the Captive Portal. If the source identity is known, the Action in the rule (Allow or Block) is enforced immediately and the user is not sent to the Captive Portal. After the system gets the credentials from the Captive Portal, it can examine the rule for the next connection.
In rules with access role objects, criteria matching operates like this: When identity data for an IP is known: If it matches an access role, the rule is applied and the traffic is allowed/blocked based on the action. If it does not match an access role, it goes on to examine the next rule. All the rules fields match besides the source field with an access role. The connection protocol is HTTP. The action is set to redirect to the Captive Portal. If all the conditions apply, the traffic is redirected to the Captive Portal to get credentials and see if there is a match. If not all conditions apply, there is no match and the next rule is examined. When the criteria does not match any of the rules in the Rule Base: The traffic is allowed.
Any
Any
Block
When browsing the Internet, different users experience different outcomes: Example 1 - An unidentified Finance user that attempts to access Salesforce is sent to the Captive Portal. This happens because the action is set to redirect to the Captive Portal. After entering credentials and being identified, the user is granted access according to rule number 1. Example 2 - An unidentified user that attempts to access the Remote Administration Tool matches rule 2, but not the Source column. Because the application is not HTTP, traffic cannot be redirected to the Captive Portal. Since none of the rules match, the user is granted access to the Remote Administration Tool. Example 3 - An unidentified user that browses to Gmail does not match rules 1 and 2 because of the application. In rule 3 there is also no match because the action is not set to redirect to the Captive Portal. Since none of the rules match, the user is granted access to Gmail.
Access Settings
Click Edit to open the Portal Access Settings window. In this window you can configure: Main URL - The primary URL that users are redirected to for the Captive Portal. You might have already configured this in the Identity Awareness Wizard. Aliases - Click the Aliases button to Add URL aliases that are redirected to the main portal URL. For example, ID.yourcompany.com can send users to the Captive Portal. To make the alias work, it must be resolved to the main URL on your DNS server. Certificate - Click Import to import a certificate for the portal website to use. If you do not import a certificate, the portal uses a Check Point auto-generated certificate. This might cause browser warnings if the browser does not recognize Check Point as a trusted Certificate Authority. See Server Certificates (on page 57) for more details. Accessibility - Click Edit to select from where the portal can be accessed. You might have already configured this in the Identity Awareness Wizard. The options are based on the topology configured for the gateway. Users are sent to the Captive Portal if they use networks connected to these interfaces. Through all interfaces Through internal interfaces Including undefined internal interfaces Including DMZ internal interfaces Including VPN encrypted interfaces According to the Firewall policy - Select this if there is a rule that states who can access the portal.
Authentication Settings
Click Settings to open the Authentication Settings window. In this window you can configure: Browser transparent Single Sign-On - Select Automatically authenticate users from machines in the domain if Transparent Kerberos Authentication is used to identify users before sending them to the Captive Portal. Main URL: The URL used to begin the SSO process. If transparent authentication fails, users are redirected to the configured Captive Portal.
IP Address: The IP address to which the Portal URL is resolved if DNS resolution fails. Note - this option is shown only when you select Browser-based Authentication as an identity source. Authentication Method - Select one method that known users must use to authenticate. Defined on user record (Legacy Authentication) - Takes the authentication method from Gateway Object Properties > Other > Legacy Authentication. User name and password - This can be configured internally or on an LDAP server. RADIUS - A configured RADIUS server. Select the server from the list.
User Directories - Select one or more places where the gateway searches to find users when they try to authenticate. Internal users - The directory of internal users.
LDAP users - The directory of LDAP users. Either: Any - Users from all LDAP servers. Specific - Users from an LDAP server that you select. External user profiles - The directory of users who have external user profiles.
The default is that all user directory options are selected. You might choose only one or two options if users are only from a specified directory or directories and you want to maximize gateway performance when users authenticate. Users with identical user names must log in with domain\user.
Customize Appearance
Click Edit to open the Portal Customization window and edit the images that users see in the Captive Portal. Configure the labeled elements of the image below.
Label Number 1
To do in GUI Enter the title of the portal. The default title is Network Access Login. Select Use my company logo and Browse to select a logo image for the portal. Select Use my company logo for mobiles and Browse to select a smaller logo image for users who access the portal from mobile devices.
Company Logo
User Access
Configure what users can do in the Captive Portal to become identified and access the network. Name and password login- Users are prompted to enter an existing username and password. This will only let known users authenticate. Unregistered guests login - Let guests who are not known by the gateway access the network after they enter required data.
Ask for user agreement - You can require that users sign a user agreement. Click Edit to upload an agreement. This option is not selected by default because a user agreement is not usually necessary for known users. Adjust portal settings for specific user groups - You can add user groups and give them settings that are different from other users. Settings specified for a user group here override settings configured elsewhere in the Portal Settings. The options that you configure per user group are: If they must accept a user agreement. If they must download an Identity Agent and which one.
If they can defer the Identity Agent installation and until when. You can only configure settings for Endpoint Identity Agent deployment if Identity Agents is selected on the Identity Awareness page.
Login Fields - Edit the table shown until it contains the fields that users complete in that sequence. Select Is Mandatory for each field that guests must complete before they can get access to the network. To add a new field, enter it in the empty field and then click Add. Use the green arrows to change the sequence of the fields. The first field will show the user name in the SmartView Tracker logs.
Server discovery and trust - Before the Identity Agent can connect to a Security Gateway with Identity Awareness, the Identity Agent must discover and trust the server that it connects to. You can configure one of five methods. Automatic authentication using Single Sign-On (SSO) - Identity Agents installed on endpoint computers authenticate users automatically when they log in to the domain using SSO. The Identity Agent identity source uses SSO to authenticate users when they enter their login credentials (Active Directory or other authentication server). The system securely gets authentication data one time without making users authenticate manually (as is necessary with Captive Portal). You get SSO with Kerberos, an inherent authentication and authorization protocol in Windows networks that is available by default on all Windows servers and workstations. If you do not use SSO, users enter credentials in another window. To set up Kerberos, see Kerberos SSO Configuration (on page 77).
Installation permissions - To install the Full Identity Agent the computer must have administrator permissions. It is not necessary to have administrator permissions to install the Light Identity Agent. User identification - Users that log in to the Active Directory domain are transparently authenticated (with SSO) and identified when using an Endpoint Identity Agent. If you do not configure SSO or you disable it, the Endpoint Identity Agent uses username and password authentication with a standard LDAP server. The system opens a window for entering credentials. Machine identification - You get machine identification when you use the Full Agent as it requires installing a service. IP change detection - When an endpoint IP address changes (interface roaming or DHCP assigns a new address), the Endpoint Identity Agent automatically detects the change. The Endpoint Identity Agent tells the Security Gateway and you stay connected. Packet tagging - A technology that prevents IP spoofing is available only for the Full Agent as it requires installing a driver.
This table shows the similarities and differences of the Light and Full Identity Agent types. Identity Agent Light Identity Agent Full Installation Elements Agent format Resident application Resident application + service + driver Administrator
Installation permissions Upgrade permissions Security Features User identification Machine identification IP change detection Packet tagging
None
None
None
SSO No
SSO Yes
Yes
Yes
No
Yes
The installation file size is 7MB for both types and the installation takes less than a minute.
Note - Packet Tagging can only be set on computers installed with the Full Identity Agent. For details, see Packet Tagging.
You can find a customizable msi version of the Endpoint Identity Agent (for distribution via a software distribution tool or Captive Portal) in these places: Installed Security Gateway - in /opt/CPNacPortal/htdocs/nac/nacclients/customAgent.msi SecurePlatform installation CD - in /linux/windows/Check_Point_Custom_Nac_Client.msi
For more information, see Prepackaging Identity Agents (on page 91).
4. Select Adjust portal settings for specific user groups - You can add user groups and give them settings that are different from other users. Settings specified for a user group here override settings configured elsewhere in the Portal Settings. The options that you configure for each user group are: If they must accept a user agreement. If they must download the Endpoint Identity Agent and which one.
If they can defer the Endpoint Identity Agent installation and until when. 5. Click OK.
Trust is verified by comparing the server fingerprint calculated during the SSL handshake with the expected fingerprint. There are 5 server discovery and trust methods: File name based server configuration - If no other method is configured (out of the box situation), any Endpoint Identity Agent downloaded from the Captive Portal is renamed to include the Captive Portal machine IP address in it. During installation, the Endpoint Identity Agent uses this IP for the Security Gateway with Identity Awareness. When you use this method, users will have to manually trust the server (a trust window opens). AD based configuration If the Endpoint Identity Agent computers are members of an Active Directory domain, you can deploy the server addresses and trust data using a dedicated "Distributed Configuration" tool.
DNS SRV record based server discovery You can configure the Security Gateway with Identity Awareness addresses in the DNS server. Because DNS is not secure, users will have to manually trust the server (a trust window opens). Note - This is the only server discovery method that is applicable for the MAC OS Endpoint Identity Agent.
Remote registry All client configuration resides in the registry. This includes the Identity Server addresses and trust data. You can deploy these values before installing the client (by GPO, or any other method that lets you control the registry remotely). The Endpoint Identity Agent can then use them immediately. PrePackaging You can create a prepackaged version of the client installation that comes with the Security Gateway with Identity Awareness IP and trust data.
For more details, see Server Discovery and Server Trust ("Server Discovery and Trust" on page 83).
Agent Access
Click Edit to select from where the Endpoint Identity Agent can be accessed. The options are based on the topology configured for the gateway. Users can communicate with the servers if they use networks connected to these interfaces. Through all interfaces Through internal interfaces Including undefined internal interfaces Including DMZ internal interfaces Including VPN encrypted interfaces
According to the Firewall policy - the Endpoint Identity Agent is accessible through interfaces associated with source networks that appear in access rules used in the Firewall policy.
Authentication Settings
Click Settings to open the Authentication Settings window. In this window you can configure: Browser transparent Single Sign-On - Select Automatically authenticate users from machines in the domain if Transparent Kerberos Authentication is used to identify users before sending them to the Captive Portal. Main URL: The URL used to begin the SSO process. If transparent authentication fails, users are redirected to the configured Captive Portal.
IP Address: The IP address to which the Portal URL is resolved if DNS resolution fails. Note - this option is shown only when you select Browser-based Authentication as an identity source.
Authentication Method - Select one method that known users must use to authenticate. Defined on user record (Legacy Authentication) - Takes the authentication method from Gateway Object Properties > Other > Legacy Authentication. User name and password - This can be configured internally or on an LDAP server. RADIUS - A configured RADIUS server. Select the server from the list.
User Directories - Select one or more places where the gateway searches to find users when they try to authenticate. Internal users - The directory of internal users. LDAP users - The directory of LDAP users. Either: Any - Users from all LDAP servers. Specific - Users from an LDAP server that you select. External user profiles - The directory of users who have external user profiles.
The default is that all user directory options are selected. You might choose only one or two options if users are only from a specified directory or directories and you want to maximize gateway performance when users authenticate. Users with identical user names must log in with domain\user.
Session
Configure data for the logged in session using the Endpoint Identity Agent. Agents send keepalive every X minutes - The interval at which the Endpoint Identity Agent sends a keepalive signal to the Security Gateway. The keepalive is used as the server assumes the user logged out if it is not sent. Lower values affect bandwidth and network performance. Users should reauthenticate every XXX minutes - For how long can users access network resources before they have to authenticate again. When using SSO, this is irrelevant. Allow user to save password - When SSO is not enabled, you can let users save the passwords they enter in the Identity Agent login window.
Agent Upgrades
Configure data for Endpoint Identity Agent upgrades. Check agent upgrades for - You can select all users or select specific user groups that should be checked for agent upgrades. Upgrade only non-compatible versions - the system will only upgrade versions that are no longer compatible. Keep agent settings after upgrade - settings made by users before the upgrade are saved. Upgrade agents silently (without user intervention) - the Endpoint Identity Agent is automatically updated in the background without asking the user for upgrade confirmation. Note - When installing or upgrading the Full Endpoint Identity Agent version, the user will momentarily experience a connectivity loss.
TCP Ports
UDP Ports
Authentication Status Indicates whether this user is authenticated on the Identity Server. The ID and User field information is automatically updated from processes running on the application server. The Terminal Servers Identity Agent assigns TCP and UDP port ranges for each connected user.
Description Ports included in this range will not be assigned to any user for TCP traffic. This field accepts a port range or list of ranges (separated with a semicolon). Ports included in this range will not be assigned to any user for UDP traffic. This field accepts a port range or list of ranges (separated with a semicolon). The maximum number of ports that can be assigned to a user in each of the TCP and UDP port ranges. The number of seconds the system waits until it assigns a port to a new user after it has been released by another user. N/A The same password that is set on Identity Server that enables trusted communication between the Security Gateway and the application server.
Chapter 3
Identity Sources
In This Chapter Choosing Identity Sources Advanced AD Query Configuration Advanced Browser-Based Authentication Configuration Advanced Endpoint Identity Agents Configuration 45 46 53 65
For Terminal Servers and Citrix environments - Set the Terminal Servers identity source and install the Terminal Servers Identity Agent on each Terminal Server. For users that access the organization through VPN - Set the Remote Access identity source to identify Mobile Access and IPsec VPN clients that work in Office Mode.
Identity Sources
Identity Sources
On the Security Gateway we want to enable AD Query only for domain controllers dc2 and dc3. This means that all other domain controllers must be set to a priority higher than 1000 in the gateway properties.
Identity Sources
6. Clear the Use default priorities checkbox and set the priority 1001 to dc1, dc4 and dc5.
Identity Sources
Multiple accounts can be connected to the same IP address. This happens because Identity Awareness does not detect user log outs and this results in IP permissions being kept until the timeout value passes. When multiple users are associated with the same IP address, SmartView Tracker logs show "user1(+) user2.... (+)userN" in the user name column. For example, when a Helpdesk administrator logs on to install a program for a user. When the administrator logs out, the user will get the Helpdesk administrator's permissions plus his own permissions until the timeout. To prevent this you must first exclude irrelevant accounts and then enable single user assumption.
Excluding Users
You can distinguish between application service accounts on a user's machine and the actual user's account by excluding the service accounts. These service accounts are used for automatic actions or services running on endpoint computers (anti-virus, backup, etc.). If you do not exclude them, they show up multiple times in logs. You can exclude user or machine accounts by entering: User names Machine names * and ? wildcard characters - For example, enter Steve* to exclude all users that start with Steve. Regular expressions - You can use regular expressions to define a complex or detailed set of accounts to exclude (see "Regular Expressions" on page 113). The regular expression syntax is regexp:<regular expression> and is case-sensitive.
These examples show how regular expressions can be used. Example 1 - To exclude all users from the query except for the user Brad1 in an Active Directory that contains users named Brad1, Brad2, Brad3, Brad4, and Brad5, enter: regexp:^Brad[2-5] Example 2 - To exclude users or machines from the query that start with Brad and have 3 digits, enter: regexp:^Brad\d\d\d Example 3 - To exclude all machines from the query that start with win, any character and 2 alphanumeric characters in an Active Directory that contains machines named win7, win-xp, win2k3, win2k8, enter: regexp:^win.\w\w This excludes all machines except for win7. Example 4 - To exclude all machines or users with 3 digits in their names from the query in an Active Directory that contains users or machines named Brad1, Brad333, win2k3, win2008, enter: regexp:\d{3} This excludes Brad333 and win2008.
Identity Sources
See the Deployment Scenarios (on page 69) section for more details.
Performance
Bandwidth between the Log server and Active Directory Domain Controllers
The amount of data transferred between the Log server and domain controllers depends on the amount of events generated. The generated events include event logs and authentication events. The amounts vary according to the applications running in the network. Programs that have many authentication requests result in a larger amount of logs. The observed bandwidth range varies between 0.1 to 0.25 Mbps per each 1000 users.
CPU Impact
When using AD Query, the impact on the domain controller's CPU is less than 3%.
Nested Groups
Identity Awareness supports the use of LDAP nested groups. When a group is nested in another group, users in the nested group are identified as part of the parent group. For example, if you make Group_B a member of Group_A, Group_B members will be identified by Identity Awareness as being part of Group A. The default nesting depth is configured to 20. This feature is enabled by default. For details on working with nested groups, see sk66561 (http://supportcontent.checkpoint.com/solutions?id=sk66561).
Identity Sources
Troubleshooting
If you experience connectivity problems between your domain controllers and Security Gateway with Identity Awareness/log servers, perform the following troubleshooting steps: In this section: Check Connectivity Use wbemtest to Verify WMI Confirm that Security Event Logs are Recorded Install Database for a Log Server 51 51 53 53
Check Connectivity
1. 2. 3. 4. Ping the domain controller from the Security Gateway with Identity Awareness/log server. Ping the Security Gateway with Identity Awareness/log server from your domain controller. Perform standard network diagnostics as required. Check SmartView Tracker and see if there are drops between a Security Gateway defined with AD Query (Source) and the domain controller (Destination). If there are drops, see Configuring the firewall (on page 52) and sk58881 (http://supportcontent.checkpoint.com/solutions?id=sk58881).
a) Domain controller in the following format: \\<IP address>\root\cimv2 For example: \\11.22.33.44\root\cimv2 b) Fully qualified AD user name. For example: ad.company.com\admin c) Password 5. Click Connect.
Identity Awareness Administration Guide R75.40VS | 51
Identity Sources
6. If the Windows Management Instrumentation Tester window re-appears with its buttons enabled, WMI is fully functional. 7. If the connection fails, or you receive an error message, check for the following conditions: a) Connectivity ("Check Connectivity" on page 51) problems b) Incorrect domain administrator credentials ("Check Domain Administrator Credentials" on page 52). c) WMI service ("Verify the WMI Service" on page 52) is not running d) A firewall is blocking traffic ("Configuring the Firewall" on page 52) between the Security Gateway with Identity Awareness/log server and domain controller.
Verify the WMI Service To verify if the WMI service is running on the domain controller:
1. Click Start > Run. 2. Enter services.msc in the Run window. 3. Locate the Windows Management Instrumentation service and verify that the service has started.
If it has not started, right-click this service and select Start from the option menu.
Identity Sources
2. Save the policy and install it on Security Gateways. Note - If there are connectivity issues on DCE RPC traffic after this policy is installed, see sk37453 (http://supportcontent.checkpoint.com/solutions?id=sk37453) for a solution.
Make sure you see the applicable events in the Event Viewer on the domain controller (My computer > Manage > Event Viewer > Security). If the domain controller does not generate these events (by default they are generated), refer to Microsoft Active Directory documentation for instructions on how to configure these events.
Identity Sources
2. Replace the line // return $stringID; with return $stringID; (delete the two backslashes that you see before the text return $stringID).
3. Reload the Captive Portal in your web browser. The Captive Portal opens showing the string IDs.
4. To revert to regular viewing mode, open the file L10N.php and put backslashes before the text return #stringID. See the highlighted text in step number 2 above.
Identity Sources
Identity Sources
2. In the $arLanguages array, create a new locale entry with the syntax: "xx_XX" => "XName". For example: "de_DE" => "German".
To disable a language:
Comment out the line of the specific language or delete the line.
Identity Sources
5. Save the file. The language selection list will show on the Network Login page. 6. To revert back to not showing the language selection list, replace the current file with the backup of the original file.
Server Certificates
For secure SSL communication, gateways must establish trust with endpoint computers by showing a Server Certificate. This section discusses the procedures necessary to generate and install server certificates. Check Point gateways, by default, use a certificate created by the Internal Certificate Authority on the Security Management Server as their server certificate. Browsers do not trust this certificate. When an endpoint computer tries to connect to the gateway with the default certificate, certificate warning messages open in the browser. To prevent these warnings, the administrator must install a server certificate signed by a trusted certificate authority. All portals on the same Security Gateway IP address use the same certificate.
Identity Sources
All other fields are optional. 4. Send the CSR file to a trusted certificate authority. Make sure to request a Signed Certificate in PEM format. Keep the .key private key file.
Identity Sources
For example: cpopenssl pkcs12 -export -out server1.p12 -in server1.crt -inkey server1.key b) Enter the certificate password when prompted.
Gateway Properties > Identity Awareness > Browser-Based Authentication > Settings > Access Settings In the Certificate section, click Import or Replace. 2. Install the policy on the gateway. Note - The Repository of Certificates on the IPsec VPN page of the SmartDashboard gateway object is only for self-signed certificates. It does not affect the certificate installed manually using this procedure.
Identity Sources
Configuration Overview
Transparent Kerberos Authentication SSO configuration includes these steps. They are described in details in this section. AD configuration - Creating a user account and mapping it to a Kerberos principal name For HTTP connections: (HTTP/<captive portal dns name>@DOMAIN) For HTTPS connections: (HTTPS/<captive portal dns name>@DOMAIN) Creating an LDAP Account Unit and configuring it with SSO. Enabling Transparent Kerberos Authentication on the Security Gateway configured with Identity Awareness.
SmartDashboard configuration
Where applicable, the procedures give instructions for both HTTP and HTTPS configuration.
Identity Sources
3. Clear User must change password at next logon and select Password Never Expires.
Identity Sources
Use Ktpass
1. Open a command line to run the ktpass tool (Start > Run > cmd). 2. At the command prompt, run ktpass with this syntax: For HTTP connections: C:> ktpass -princ HTTP/captive_portal_dns_name@DOMAIN_NAME -mapuser username@domain_name -pass password -out trans.keytab -ptype KRB5_NT_PRINCIPAL -crypto RC4-HMAC-NT For HTTPS connections: C:> ktpass -princ HTTPS/captive_portal_dns_name@DOMAIN_NAME -mapuser username@domain_name -pass password -out trans.keytab -ptype KRB5_NT_PRINCIPAL -crypto RC4-HMAC-NT Important - Make sure to enter the command exactly as shown as it is case-sensitive. The captive_portal_dns_name is lower case and the DOMAIN_NAME and KRB5_NT_PRINCIPAL are upper case. Below is an example of running ktpass with these parameters: Parameter captive_portal_dns_name@DOMAIN_NAME username@domain_name password Value [email protected] [email protected] qweQWE!@#
ktpass princ HTTP/[email protected] mapuser [email protected] pass qweQWE!@# -out trans.keytab ptype KRB5_NT_PRINCIPAL -crypto RC4-HMACNT The AD is ready to support Kerberos authentication for the Security Gateway. Important - If you have used the ktpass utility before for the same principal name (HTTP/captive_portal_dns_name@DOMAIN_NAME) but with a different account, you must either delete the different account beforehand or remove its association to the principal name (by using setspn D HTTP/domain_name old_account name i.e. setspn D HTTP/corp.acme.com ckpsso). Failure to do this will cause the authentication to fail. The above example shows the ktpass syntax on Windows 2003. When using Windows 2008/2008 R2 Server, the ktpass syntax is slightly different. Parameters are introduced using a forward slash "/" instead of a hyphen "-".
Identity Sources
HTTP example: ktpass /princ HTTP/[email protected] /mapuser [email protected] /pass qweQWE!@# /out trans.keytab /ptype KRB5_NT_PRINCIPAL /crypto RC4-HMACNT HTTPS example: ktpass /princ HTTPS/[email protected] /mapuser [email protected] /pass qweQWE!@# /out trans.keytab /ptype KRB5_NT_PRINCIPAL /crypto RC4-HMACNT
SmartDashboard Configuration
This section describes how to configure an LDAP Account Unit to support SSO.
f)
Click OK.
Identity Sources
6. In the Servers tab: a) Click Add and enter the LDAP Server properties. b) In the Host field, select the AD object you configured in step 4 above. c) In the Login DN field, enter the login DN of a predefined user (added in the AD) used for LDAP operations. d) Enter the LDAP user password and confirm it. e) In the Check Point Gateways are allowed to section, select Read data from this server. f) In the Encryption tab, select Use Encryption (SSL), fetch the fingerprint and click OK. Note - LDAP over SSL is not supported by default. If you have not configured your domain controller to support LDAP over SSL, either skip step f or configure your domain controller to support LDAP over SSL. 7. In the Objects Management tab: a) In the Manage objects on field, select the AD object you configured in step 4 above. b) Click Fetch Branches to configure the branches in use. c) Set the number of entries supported. 8. In the Authentication tab, select Check Point Password in the Default authentication scheme and click OK.
Browser Configuration
To work with Transparent Kerberos Authentication, it is necessary to configure your browser to trust Captive Portal URL. If the portal is working with HTTPS, you must also enter the URL in the Local Internet field using HTTPS.
Internet Explorer
It is not necessary to add the Captive Portal URL to Trusted Sites.
Google Chrome
If you have already configured Internet Explorer for Transparent Kerberos Authentication, that configuration also works with Chrome. Use this procedure only if you did not configure Internet Explorer for Transparent Kerberos Authentication.
Identity Sources
Firefox
or Firefox, the Negotiate authentication option is disabled by default. To use Transparent Kerberos Authentication, you must enable this option.
Nac_agent_email_for_sending_logs
Nac_agent_disable_quit
Nac_agent_disable_tagging
Identity Sources
Chapter 4
Advanced Deployment
In This Chapter Introduction Deployment Options Deploying a Test Environment Deployment Scenarios 67 68 68 69
Introduction
You can deploy Check Point Security Gateways enabled with Identity Awareness in various scenarios that provide a maximum level of security for your network environment and corporate data. This section describes recommended deployment scenarios and options available with Identity Awareness. Perimeter security gateway with Identity Awareness This deployment scenario is the most common scenario, where you deploy the Check Point security gateway at the perimeter where it protects access to the DMZ and the internal network. The perimeter security gateway can also control and inspect outbound traffic, targeted to the Internet. In this case, you can create an identity-based firewall security Rule Base together with Application Control. Data Center protection If you have a Data Center or server farm, segregated from the users' network, you can protect access to the servers with the security gateway. To do this, deploy the security gateway inline in front of the Data Center. All traffic that flows is then inspected by the gateway. You can control access to resources and applications with an identity-based access policy. You can deploy the security gateway in transparent mode (bridge mode) to avoid significant changes in the existing network infrastructure. Large scale enterprise deployment In large scale enterprise networks, there is a need to deploy multiple security gateways at different network locations, such as the perimeter firewall and multiple Data Centers. Identity Awareness capability is centrally managed through the Security Management Server and SmartDashboard. You can distribute the identity-based policy to all identity aware security gateways in the network. Identity information about all users and machines obtained by each gateway is shared between all gateways in the network to provide a complete Identity Awareness infrastructure. Network segregation The security gateway helps you migrate or design internal network segregation. Identity Awareness lets you control access between different segments in the network by creating an identity-based policy. You can deploy the security gateway close to the access network to avoid malware threats and unauthorized access to general resources in the global network. Distributed enterprise with branch offices The distributed enterprise consists of remote branch offices connected to the headquarters through VPN lines. You can deploy the security gateway at the remote branch offices to avoid malware threats and unauthorized access to the headquarters' internal network and Data Centers. When you enable Identity Awareness at the branch office gateway you make sure that users are authenticated before they reach internal resources. The identity information learned from the branch office gateways is shared between internal gateways to avoid unnecessary authentications. Wireless campus Wireless networks are not considered secure for network access, however they are intensively used to provide access to wireless-enabled corporate devices and guests. You can deploy a security gateway enabled with Identity Awareness inline in front of the wireless switch, provide an identity aware access policy and inspect the traffic that comes from WLAN users. Identity Awareness gives guests access by authenticating guests with the web Captive Portal. Important - NAT between two identity aware gateways that share information with each other is not a supported configuration.
Identity Awareness Administration Guide R75.40VS | 67
Advanced Deployment
Deployment Options
You can deploy a security gateway enabled with Identity Awareness in two different network options: IP routing mode Transparent mode (bridge mode)
IP routing mode This is a regular and standard method used to deploy Check Point security gateways. You usually use this mode when you deploy the gateway at the perimeter. In this case, the gateway behaves as an IP router that inspects and forwards traffic from the internal interface to the external interface and vice versa. Both interfaces should be located and configured using different network subnets and ranges. Transparent mode Known also as a "bridge mode". This deployment method lets you install the security gateway as a Layer 2 device, rather than an IP router. The benefit of this method is that it does not require any changes in the network infrastructure. It lets you deploy the gateway inline in the same subnet. This deployment option is mostly suitable when you must deploy a gateway for network segregation and Data Center protection purposes.
Advanced Deployment
Use the user host machine to test connectivity to the Web Server. Check logs. The user and machine names show in the connections logs. From the gateway's CLI revoke the authenticated user by: pdp control revoke_ip IP_ADDRESS On the user host machine open an Internet browser and try to connect to the web resource. You should be redirected to the Captive Portal, use the user's credentials to authenticate and access the web resource.
Deployment Scenarios
Perimeter Security Gateway with Identity Awareness
Security Challenge
The security gateway at the perimeter behaves as a main gate for all incoming and outgoing traffic to and from your corporate network. Users located in the internal networks access the Internet resource and applications daily. Not all Internet applications and web sites are secure and some are restricted according to corporate policy. Blocking all internal access may impact productivity of certain employees that must have access in the context of their daily work definition. Controlling access to the allowed applications is possible through the Application Control blade. However, you may require a more granular access policy that is based also on user and machine identity i.e. access roles. Access roles let you configure an identity aware policy together with Application Control to allow access only to specified user groups to the applications on the Internet. In this case Identity Awareness should be enabled on the perimeter security gateway.
Deployment scenario
1. Deploy the gateway at the perimeter in routing mode and define an external interface towards the ISP (the Internet) and an internal interface points to the internal corporate network LAN. Optional: you can define another internal interface which protects DMZ servers. 2. Make sure that NAT or Proxy devices do not exist between the gateway and LAN (the recommendation is to have proxy in the DMZ network). 3. Check that the gateway has connectivity to the internal AD domain controllers. 4. Make sure that users can reach the gateways internal interface. 5. Configure the Application Control blade. See the R75.40VS Application Control and URL Filtering Administration Guide (http://supportcontent.checkpoint.com/solutions?id=sk76540). 6. If you have several perimeter gateways leading to the Internet, we recommend that you manage these gateways with one Security Management Server and SmartDashboard to deploy the relevant security policy.
Advanced Deployment
Configuration
1. Enable Identity Awareness and select the appropriate identity sources. 2. Create access roles based on users and machines. You can create multiple access roles that represent different departments, user and machine groups and their location in the network. 3. Add the access roles to the source column of the relevant firewall and application control policies.
Deployment Scenario
1. Deploy the security gateway inline in front of the Date Center core switch, protecting access to the Data Center from the LAN. 2. We recommend that you deploy the gateway in the bridge mode, to avoid any changes in the network. However, IP routing mode is also supported. 3. Define at least two interfaces on the gateway and configure them to be internal or bridged. 4. Make sure that the gateway has connectivity to the Active Directory and all relevant internal domain controllers in the network (LAN). 5. Make sure that users from the LAN can connect to the Data Center through the security gateway with an ANY ANY accept policy. 6. Make sure that you do not have a proxy or NAT device between the gateway and users or the LAN.
Configuration
1. Enable Identity Awareness on the gateway and select identity sources. 2. Create access roles for users and apply the access roles to relevant Firewall security rules.
Advanced Deployment
Deployment Scenario
1. Deploy or use existing security gateways at the perimeter and in front of the Data Center. 2. Install the gateway at the perimeter in routing mode, and use at least one external interface to the Internet and one to the internal network (define it as an internal interface). 3. Deploy the gateway as an inline device in front of the Data Center in bridge mode to avoid network changes. This is not required, but is recommended. Nonetheless, IP routing mode is also supported. 4. Make sure that all gateways in the Data Centers and perimeter can communicate directly with each other. 5. We recommend that you manage the gateway from one Security Management Server and SmartDashboard. 6. Make sure that there is connectivity from each gateway to the Active Directory internal domain controllers. 7. Make sure that in an "Any Any Accept" policy, users from the LAN can connect to the desired resources. 8. Make sure that there is no NAT or proxy devices installed between the gateways and LAN segment. If there are such devices, consider moving them to DMZ if possible.
Configuration
1. Enable Identity Awareness on the gateway and choose the appropriate identity source method for each gateway, at the perimeter and at the Data Center. 2. Create access roles for users and apply access roles to the relevant firewall security rules. 3. Use the Application Control policy in the perimeter gateway and add access roles to the policy. 4. In the Gateway properties > Identity Awareness tab, make sure to select Share local identities with other gateways.
Advanced Deployment
Network Segregation
Security Challenge
Networks consist of different network segments and subnets where your internal users reside. Users that connect to the network can potentially spread viruses and malwares across the network that can infect other computers and servers on the network. You want to make sure that only compliant users and machines can pass and connect across multiple network segments, as well as authenticate users connecting to the servers and the Internet.
Advanced Deployment
Deployment scenario
We recommend that you deploy security gateways close to access networks before the core switch. Access between the segments is controlled by the gateway. Access between the LAN and Data Center is controlled by the gateway. Access between the LAN and the Internet is controlled by the gateways either at each segment or at the perimeter gateway. We recommend that you deploy the gateway in bridge mode to avoid network and routing changes. Each gateway of a particular segment authenticates users with the selected method. Share identities learned from the segment gateways with the perimeter firewall to create an outgoing traffic firewall policy or use an Application Control policy as well.
Configuration
1. Deploy gateways in each segment in bridge mode. 2. Make sure that there is no proxy or NAT device between the gateways and the LAN. 3. Make sure that the gateways can communicate with the Active Directory domain controller deployed in each segment (replicated domain controllers). If there is a general domain controller that serves all users across the segments, make sure that all gateways can connect to this domain controller. 4. Enable Identity Awareness on each gateway and select an appropriate identity source method. 5. In the Identity Awareness tab, clear the Share local identities with other gateways option. If you want to share identities with one gateway, for example, the perimeter gateway, keep this option selected and disable Get identities from other gateways in the segment gateway. Then go to the perimeter gateway and select Get identities from other gateways. 6. If you want to use Endpoint Identity Agents, then define the particular gateways DNS/IP in the agent gateway configuration per access segment.
Deployment Scenario
1. We recommend that you deploy security gateways at the remote branch offices and at headquarters in front of the Data Center and at the perimeter. 2. At remote branch offices, you can deploy low capacity gateways due to a relatively low number of users. Deploy the remote branch gateways in IP routing mode and have them function as a perimeter firewall and VPN gateway, establishing a VPN link to the corporate gateways.
Identity Awareness Administration Guide R75.40VS | 73
Advanced Deployment
3. At the corporate headquarters, we recommend that you deploy Data Center gateways to protect access to Data Center resources and applications, as well as a perimeter gateway. You can install the Data Center gateway in bridge mode to avoid changes to the existing network. 4. In this scenario, users from the branch office are identified by the local branch office gateway before connecting to the corporate network over VPN. 5. The identities learned by the branch office gateways are then shared with the headquarters' internal and perimeter gateways. When a user from a branch office attempts to connect to the Data Center, the user is identified by the gateway at the headquarters Data Center without the need for additional authentication.
Configuration
1. 2. 3. 4. 5. Select a security gateway according to a performance guideline for your remote branch offices. Deploy the gateways at the branch offices in routing mode. Define VPN site-to-site if necessary. Deploy gateways inline at the Data Center. We recommend using bridge mode. Deploy a gateway at the perimeter that protects the internal network in routing mode. The perimeter gateway can serve as a VPN gateway for branch offices as well. If you have Active Directory domain controllers replicated across your branch offices make sure that local gateways can communicate with the domain controller. In case you do not have a local domain controller, make sure that the gateways can access the headquarters' internal domain controller over VPN. Enable Identity Awareness and select the appropriate methods to get identity. Create an access role and apply the roles in the security policy on the branch office gateways, perimeter and Data Center gateway. Make sure that you share identities between the branch offices with the headquarter and Data Center gateways, by selecting these settings on the Identity Awareness tab:
6. 7. 8.
Advanced Deployment
Wireless Campus
Security Challenge
You use wireless networks to grant access to employees that use Wi-Fi enabled devices, guests and contractors. Guests and contractors in some cases cannot use the corporate wired network connection and must connect through WLAN. Furthermore, it is not intended for guests and contractors to install any endpoint agents on their devices. Wireless access is also intensively used to connect mobile devices such as smart phones where agents can be installed. These devices are not part of the Active Directory domain. Wireless networks do not give a desired level of security in terms of network access.
Deployment Scenario
1. Deploy the security gateway in bridge mode in front of the Wireless Switch. 2. Make sure that the gateway can access the Internet or any other required resource in the network. 3. Make sure that the gateway can communicate with the authentication server, such as Active Directory or RADIUS. 4. Check that there is no NAT or proxy device between the gateway and the WLAN network.
Configuration
1. Enable Identity Awareness on the gateway. 2. Select Browser-Based Authentication as an identity source. 3. In the Gateway properties > Identity Awareness tab > Browser-Based Authentication Settings, select Unregistered guests login and in Settings, select the fields you want guests to fill when they register. 4. Select Log out users when they close the portal browser.
Advanced Deployment
Deployment Scenario
In this deployment scenario, you have to choose an appropriate appliance to deploy as the dedicated Identity Awareness enabled gateway. All users authenticate with this gateway. If you enable AD Query, the dedicated gateway should communicate with all Active Directory domain controllers over WMI. 1. On the dedicated identity acquisition gateway, enable the Identity Awareness feature and select the identity method. 2. Make sure to configure the gateway to share identities with other gateways in the network.
3. On the enforcement gateways, enable Identity Awareness and select Get identities from other gateways.
Chapter 5
Advanced Identity Agent Options
In This Chapter Kerberos SSO Configuration Server Discovery and Trust Prepackaging Identity Agents 77 83 91
You get SSO in Windows domains with the Kerberos authentication protocol. Kerberos is the default authentication protocol used in Windows 2000 and above. The Kerberos protocol is based on the idea of tickets, encrypted data packets issued by a trusted authority which in this case is the Active Directory (AD). When a user logs in, the user authenticates to a domain controller that provides an initial ticket granting ticket (TGT). This ticket vouches for the users identity. When the user needs to authenticate against the Security Gateway with Identity Awareness, the Endpoint Identity Agent presents this ticket to the domain controller and requests a service ticket (SR) for a specific resource (Security Gateway that Endpoint Identity Agents connect to). The Endpoint Identity Agent then presents this service ticket to the gateway that grants access.
Item A B C D 1
Description User Active Directory Domain Controller Security Gateway that Endpoint Identity Agents connect to Data Center servers a) A logs in to B b) B sends an initial ticket (TGT) to A a) The Identity Agent connects to C b) C asks A for user authentication a) The Identity Agents requests a service ticket (SR) for C and presents the TGT to B b) B sends the SR (encrypting the user name with the shared secret between B and C) The Endpoint Identity Agent sends the service ticket to C C decrypts the ticket with the shared secret and identifies A A gets access to D based on identity
4 5 6
References
For detailed information on Kerberos SSO, see these links: http://web.mit.edu/Kerberos/ (http://web.mit.edu/Kerberos/) http://technet.microsoft.com/en-us/library/bb742433.aspx (http://technet.microsoft.com/enus/library/bb742433.aspx)
SSO Configuration
SSO configuration includes two steps: AD Configuration - Creating a user account and mapping it to a Kerberos principal name. SmartDashboard Configuration - Creating an LDAP Account Unit and configuring it with SSO.
AD Configuration
Creating a New User Account
1. In Active Directory, open Active Directory Users and Computers (Start->Run->dsa.msc) 2. Add a new user account. You can choose any username and password. For example: a user account named ckpsso with the password 'qwe123!@#' to the domain corp.acme.com.
3. Clear User must change password at next logon and select Password Never Expires.
Use Ktpass
1. Open a command line to run the ktpass tool (Start > Run > cmd). 2. At the command prompt, run ktpass with this syntax: C:> ktpass -princ ckp_pdp/domain_name@DOMAIN_NAME -mapuser username@domain_name -pass password -out unix.keytab crypto RC4-HMAC-NT Important - Make sure to enter the command exactly as shown. Mapping the username to the Kerberos principal name with ktpass is case-sensitive. Below is an example of running ktpass with these parameters: Parameter domain_name@DOMAIN_NAME username@domain_name password Value [email protected] [email protected] qwe123@#
Important - If you have used the ktpass utility before for the same principal name (ckp_pdp/domain_name@DOMAIN_NAME) but with a different account, you must either delete the different account beforehand or remove its association to the principal name (by using setspn D ckp_pkp/domain_name old_account name i.e. setspn D ckp_pdp/corp.acme.com ckpsso). Failure to do this will cause the authentication to fail. The example above shows the ktpass syntax on Windows 2003. When using Windows 2008/2008 R2 Server, the ktpass syntax is slightly different. Parameters are introduced using a forward slash " /" instead of a hyphen "-".
SmartDashboard Configuration
This section describes how to configure an LDAP Account Unit to support SSO.
f)
Click OK.
Identity Awareness Administration Guide R75.40VS | 81
6. In the Servers tab: a) Click Add and enter the LDAP Server properties. b) In the Host field, select the AD object you configured in step 4 above. c) In the Login DN field, enter the login DN of a predefined user (added in the AD) used for LDAP operations. d) Enter the LDAP user password and confirm it. e) In the Check Point Gateways are allowed to section, select Read data from this server. f) In the Encryption tab, select Use Encryption (SSL), fetch the fingerprint and click OK. Note - LDAP over SSL is not supported by default. If you have not configured your domain controller to support LDAP over SSL, either skip step f or configure your domain controller to support LDAP over SSL. 7. In the Objects Management tab: a) In the Manage objects on field, select the AD object you configured in step 4 above. b) Click Fetch Branches to configure the branches in use. c) Set the number of entries supported. 8. In the Authentication tab, select Check Point Password in the Default authentication scheme and click OK.
Server discovery refers to the process of deciding which server the client should connect to. We offer several methods for configuring server discovery from a very basic method of simply configuring one server to a method of deploying a domain wide policy of connecting to a server based on your current location. This section describes these options. Server trust refers to the process of validating that the server the end user connects to is indeed a genuine one. It also makes sure that communication between the client and the server was not tampered with by a Man In The Middle (MITM) attack. The trust process compares the server fingerprint calculated during the SSL handshake with the expected fingerprint. If the client does not have the expected fingerprint configured, it will ask the user to verify that it is correct manually. This section describes the methods that allow the expected fingerprint to be known, without user intervention.
Option Comparison
Requires Manual MultiAD User Trust Site Required? File name based AD based No Yes No Client Allows Remains Ongoing Signed? Changes Yes No Level Recommended for... Single gateway deployments Deployments with AD that you can modify Deployments without AD or with an AD you cannot modify, but the DNS can be changed Where remote registry is used for other purposes
Yes
No
Yes
Yes
Yes
DNS based
No
Yes
Yes
Simple
Remote registry
No
No
Yes
Yes
Yes
Moderate
Prepackaging
No
No
Yes
No
No
Advanced When both DNS and AD cannot be changed, and there is more than one gateway
AD Based Configuration
If your client computers are members of an Active Directory domain and you have administrative access to this domain, you can use the Distributed Configuration tool to configure connectivity and trust rules. The Distributed Configuration tool consists of three windows: Welcome - This window describes the tool and lets you to enter alternate credentials that are used to access the AD.
Server configuration This window lets you configure which Security Gateway with Identity Awareness the client should use, depending on its source location. Trusted gateways This window lets you view and change the list of fingerprints that the Security Gateways with Identity Awareness consider secure.
This configuration means: 1. If the user is coming from 192.168.0.1 192.168.0.255, then try to connect to US-GW1. If it isnt available, try BAK-GS2 (it will be used only if US-GW1 is not available, as its priority is higher). 2. Otherwise, if the user is connected from the Active Directory site UK-SITE, connect either to UK-GW1 or UK-GW2 (choose between them randomly, as they both have the same priority). If both of them are not available, connect to BAK-GS2. 3. Otherwise, connect to BAK-GS2 (the default rule is always matched when it is encountered).
Identity Awareness Administration Guide R75.40VS | 87
Trusted Gateways
The trusted gateways window shows the list of servers considered trusted no popups will open when trying to connect to them. You can add, edit or delete a server. If you have connectivity to the server, you can get the name and fingerprint by entering its address and clicking Fetch Fingerprint. Otherwise, you should enter the same name and fingerprint that is shown when connecting to that server.
Note - The entire configuration is written under a hive named Check Point under the Program Data Branch in the AD database that is added in the first run of the tool. Adding this hive wont have any effect on other AD based applications or features.
Note - If you configure AD based and DNS based configuration, the results are combined according to the specified priority (from the lowest to highest).
Remote Registry
If you have another way to deploy registry entries to your client computers (i.e. Active Directory GPO updates), you can deploy the Security Gateway with Identity Awareness addresses and trust parameters before installing the clients. That way, they will use the already deployed settings immediately after installation.
3. Configure it manually to connect to the requested servers (Use the settings dialog box). If you need the client to choose a server based on the client location, you can click Advanced and configure it that way. See AD Based Configuration (on page 86) to understand how these rules are interpreted. 4. Export the following registry keys (from HKEY_LOCAL_MACHINE / HKEY_CURRENT_USER, according to the client type installed): a) SOFTWARE\CheckPoint\NAC\TrustedGateways (the entire tree) b) SOFTWARE\CheckPoint\NAC\ (i) DefaultGateway (ii) DefaultGatewayEnabled (iii) PredefinedPDPConnRBUsed (iv) PredefinedPDPConnectRuleBase 5. Deploy the exported keys to the workstations before installing the client on your workstations.
Important - The Endpoint Identity Agents come digitally signed by Check Point Software Technologies Ltd. Any modification to the Endpoint Identity Agents, including prepackaging, will invalidate the signature, and will result in security warnings displayed to the user downloading them from the Captive Portal.
The tool has some other options that are not used for Identity Awareness.
INSTALLUITYPE
This property has these values: SILENT - No user interface is shown to the user. BASIC - An installation progress bar is shown while installation takes place. This is the default value. FULL - The user sees a full installation user interface.
HIDEFEATURES
This property determines the visibility of the Custom Setup (feature selection) dialog box in the installation process. If this dialog box is hidden then the installation process behaves as if the user clicked Next without changing anything. Values for this property: Yes No - By default, the Custom Setup dialog box is shown (it is not hidden).
INSTALLTYPE
This property lets you can choose one of these installation type values: ALLUSERS - Anyone who uses the computer SINGLEUSER - Only for the user who is installing the Endpoint Identity Agent ASKUSER - Leaves the dialog box in the installation for the end user to decide. By default, the Choose Installation orientation dialog box is shown.
MADService
This property relates to the Managed Asset Detection service. This is a service that gives you machine authentication and enables managed asset detection prior to logon authentication. This property is required if you Access Roles in the Rule Base that relate to machines. For example, if you set MADService=Yes then the feature dialog box will force install the Managed Asset Detection service. Values: Yes No Ask - the dialog box is shown to the end user who can decide whether to install or not. This is the default value.
PacketTagging
This property relates to the Packet Tagging driver. This driver signs every packet that is sent from the machine. This setting is required if you have rules in the Rule Base that use Access Roles and are set to enforce IP spoofing protection on the Machines tab.
Values: Yes No Ask - the dialog box is shown to the end user who can decide whether to install or not. This is the default value.
DisableSettings DWORD:1,0
For example:
Note - If a default gateway is not defined and the automatic server discovery fails during installation, the user will be asked to define the Security Gateway with Identity Awareness manually.
Chapter 6
Identity Awareness Commands
In This Chapter Introduction pdp pep adlog test_ad_connectivity 98 99 106 Error! Bookmark not defined. 112
Introduction
These terms are used in the CLI commands: PDP - The process on the Security Gateway responsible for collecting and sharing identities. PEP - The process on the Security Gateway responsible for enforcing network access restrictions. Decisions are made according to identity data collected from the PDP. AD Query - AD Query is the module responsible for acquiring identities of entities (users or machines) from the Active Directory (AD). AD Query was called Identity Logging in previous versions and in some cases is also referenced as AD Log. The adlog is the command line process used to control and monitor the AD Query feature. test_ad_connectivity - A utility that runs connectivity tests from the gateway to an AD domain controller.
The PEP and PDP processes are key components of the system. Through them, administrators control user access and network protection. AD Query can run either on a Security Gateway that has been enabled with Identity Awareness or on a Log Server. When it runs on a Security Gateway, AD Query serves the Identity Awareness feature, and gives logging and policy enforcement. When it runs on a Log Server, AD Query gives identity logging. The command line tool helps control users statuses as well as troubleshoot and monitor the system. The test_ad_connectivity utility runs over both the LDAP and WMI protocols. It is usually used by the SmartDashboard Identity Awareness first time wizard, but you can run it manually on the gateway when needed.
pdp
Description Provides commands to control and monitor the PDP process. Usage pdp [command]... <argument> Syntax Argument <none> debug tracker connections network status control monitor update Description Display available options for this command and exit. Control debug messages. Tracker options. pdp connections information. pdp network information. pdp status information. pdp control commands. Display monitoring data. Recalculate users and machines group membership (deleted accounts will not be updated). Operations related to AD Query. Show pdp timers information.
ad timers
pdp monitor
Description Lets you monitor the status of connected sessions. You may perform varied queries according to the usage below to get the output you are interested in. Usage pdp monitor <argument> <option> Syntax Argument <none> all user <user name> ip <IP address> machine <machine name> mad Description Display available options for this command and exit. Display information for all connected sessions. Display session information for the given user name. Display session information for the given IP. Display session information for the given machine name. Display all sessions that relate to a managed asset (i.e. all sessions that successfully performed machine authentication). Display all sessions connecting via the given client type. Possible client types are:
Unknown - User was identified by an unknown source. Portal - User was identified by the Captive Portal. Identity Agent - User/machine was identified by an Identity Awareness Agent. AD Query - User was identified by AD Query.
Display all sessions of users / machines that are members of the given group name. Display all sessions that are connected via a client version that is higher than (or equal to) the given version. Display all sessions that are connected via a client version that is lower than (or equal to) the given version.
cv_ge <version>
cv_le <version>
Example pdp monitor ip 10.10.10.1 Shows the connected user behind the given IP (10.10.10.1).
Note - The last field "Published Gateways" indicates whether the session information was already published to the PEPs whose IPs are listed.
pdp connections
Description These commands assist in monitoring and synchronizing the communication between the PDP and the PEP. Usage pdp connections <argument> Syntax Argument <none> pep Description Display available options for this command and exit. Display the connection status of all the PEPs that should be updated by the current PDP.
Example Each outgoing connection is used for identity sharing. Each incoming connection is mainly used as a control channel for exchanging network topologies for the smart pull. Local PEP (in PDP perspective) will always use "push" method and therefore no incoming control channel is needed. The same is true for remote PEP gateways using a "push" method.
pdp control
Description Provides commands to control the PDP process. Usage pdp control <argument> <option> Syntax Argument <none> revoke_ip <IP address> revoke_pt_key <session id.> sync Description Display available options for this command and exit. Log out the session that is related to the given IP.
Force an initiated synchronization operation between the PDPs and the PEPs. When running this command, the PDP will inform its related PEPs the up-to-date information of all connected sessions. At the end of this operation, the PDP and the PEPs will contain the same and latest session information.
pdp network
Description Provides information about network related features. Usage pdp network <argument> Syntax Argument <none> info registered Description Display available options for this command and exit. Display a list of networks known by the PDP. Display the mapping of a network address to registered gateways (PEP module).
pdp debug
Description Activates and deactivates the debug logs of the PDP daemon. Usage pdp debug <argument> <option> Syntax Argument <none> on Description Display available options for this command and exit. Turn on the debug logs (should be followed by the command "set" to determine the required filter). Turn off the debug logs.
off
set <topic name> Filter the debug logs that would be written to the debug file according to the [critical|surprise| given topic and severity important|events| For debug it is recommended to run: all] pdp debug set all all. Note that you can place a number of topics and severity pairs. For example: topicA severityA topicB severityB ... unset <topic name> Unset a specific topic or topics. stat reset Show the status of the debug option. Reset the debug options of severity and topic. The debug is still activated after running this command. Rotate the log files (increase the index of each log file) so that the current log file that will be written is the PDP log. For example, pdpd.elg becomes pdpd.elg.0 and so on. Allows enabling or disabling writing of the CCC debug logs into the PDP log file.
rotate
ccc [on|off]
Example
Important - Activating the debug logs affects the performance of the daemon. Make sure to turn off the debug after you complete troubleshooting.
pdp tracker
Description Adds the TRACKER topic to the PDP logs (on by default). This is very useful when monitoring the PDP-PEP identity sharing and other communication on distributed environments. This can be set manually by adding the TRACKER topic to the debug logs. Usage pdp tracker <argument> Syntax Argument <none> Description Display available options for this command and exit. Turns on logging of TRACKER events in the PDP log. Turns off the logging of TRACKER events in the PDP log.
on
off
pdp status
Description Displays PDP status information such as start time or configuration time. Usage pdp status <argument> Syntax Argument <none> show Description Display available options for this command and exit. Display PDP information.
pdp update
Description Initiates a recalculation of group membership for all users and machines. Note that deleted accounts will not be updated. Usage pdp update <argument> Syntax Argument <none> all Description Display available options for this command and exit. Recalculate group membership for all users and machines.
pep
Description Provides commands to control and monitor the PEP process. Usage pep [command]... <argument> Syntax Argument <none> debug tracker show Description Display available options for this command and exit. Control debug messages. Tracker options. Display PEP information.
Example
pep show
Description Displays information regarding pep status. Usage pep show <argument> <option> Syntax Argument <none> stat pdp <id|all> user <all|query> network <pdp|registration> Description Display available options for this command and exit. See sections below.
Display session information for the given IP. Display session information for the given session ID.
Display all session information that was published from the given PDP IP. Display all sessions of users that are members of the given user group name. Display all sessions of machines that are members of the given machine group name.
Note - You can use multiple query tokens (arguments) at once to create a logical "AND" correlation between them. For example, to display all users that have a sub string of "jo" AND are part of the user group "Employees" then you can use: # pep show user query usr jo ugrp Employees
id <IP> Example
pep debug
Description See pdp debug (on page 102).
adlog
Description Provides commands to control and monitor the AD Query process. When AD Query runs on a Security Gateway, AD Query serves the Identity Awareness feature that gives logging and policy-enforcement. In this case the command line is: adlog a <argument> (see below for options) When it runs on a Log Server, AD Query gives identity logging. In this case, the command line is: adlog l <argument>. Note: the l in adlog l is a lowercase L. Options for adlog a and adlog l are identical. Usage adlog [a | l] <command> <argument> Syntax Argument <none> [a | l] Description Display available options for this command and exit. Set the working mode: adlog l - if you are using a Log Server (identity logging) adlog a - if you are using AD Query for Identity Awareness. query debug dc statistics control service_accounts Example See sections below.
adlog query
Description Shows the database of identities acquired by AD Query, according to the given filter. Usage adlog [a|l] query <argument> Syntax
Argument ip <IP address> string <string> user <user name> machine <machine name> all
Filters identity mappings according to the given string. Filters identity mappings according to a specific user. Filters identity mappings according to a specific machine.
Example adlog a query user jo Shows the entry that contains the string "jo" in the user name.
adlog dc
Description Shows status of connection to the AD domain controller. Usage adlog [a|l] dc Syntax None
adlog statistics
Description Displays statistics regarding NT Event Logs received by adlog, per IP and by total. It also shows the number of identified IPs. Usage adlog [a|l] statistics Syntax None
adlog debug
Description Turns on/off debug flags for controlling the debug file. The debug file is located at $FWDIR/log/pdpd.elg (for Identity Awareness on a Security Gateway) or $FWDIR/log/fwd.elg (for identity logging on a log server). Usage adlog [a|l] debug <argument> Syntax Argument on off mode extended Description Turn on debug. Turn off debug. Show debug status (on/off). Turn on debug and add extended debug topics.
adlog control
Description Sends control commands to AD Query. Usage adlog [a|l] control <argument> Syntax Argument stop reconf Description Stop AD Query. New identities are not acquired via AD Query. Send a reconfiguration command to AD Query, which means it resets to policy configuration as was set in SmartDashboard.
adlog service_accounts
Description Shows accounts that are suspected to be "service accounts". Service accounts are accounts that dont belong to actual users, rather they belong to services running on a computer. They are suspected as such if they are logged in more than a certain number of times. Usage adlog [a|l] service_accounts Syntax None
test_ad_connectivity
Description Runs connectivity tests from the Security Gateway to an AD domain controller. Usage $FWDIR/bin/test_ad_connectivity <argument_1 value_1> <argument value_2> <argument_n value_n> Arguments can be set in the command line as specified below, or set in a text file located at $FWDIR/conf/test_ad_connectivity.conf . Arguments set in the test_ad_connectivity.conf file are overridden by ones provided in the command line. Important - Arguments set in $FWDIR/conf/test_ad_connectivity cannot contain whitespaces and cannot be within quotation marks. Output of the utility is provided in a file (not to STDOUT). The path of the file is specified by the o argument (see below). Syntax Argument -d <domain name> -i <DC IP> -u <user name> -o <filename> Mandatory? Mandatory Description Domain name of the AD, for example ad.checkpoint.com
Mandatory Mandatory
IP of the domain controller that is being tested. Administrator user name on the AD.
Mandatory
Output filename relative to $FWDIR/tmp. For example, if you specify -o myfile, the output will be in $FWDIR/tmp/myfile Users password.
-c <password clear>
Either this or -a should be specified Either this or -c should be specified Mandatory Optional
-a
Total timeout in milliseconds. Use this for LDAP user DN override (the utility wont try to figure out the DN automatically). Run LDAP connectivity test only (no WMI test). Run WMI connectivity test only (no LDAP test). SSL Parameters file path. Timeout for the LDAP test only. If this timeout expires and the LDAP test doesnt finish, both tests fail. Show help.
-l -w -s -L
-h
Optional
Appendix A
Regular Expressions
Regular expressions are special characters that match or capture portions of a field. This sections covers special characters supported by Check Point and the rules that govern them. In This Appendix Metacharacters Square Brackets Parentheses Hyphen Dot Vertical Bar Backslash Quantifiers 113 114 114 114 114 114 114 115
Metacharacters
Some metacharacters are recognized anywhere in a pattern, except within square brackets; other metacharacters are recognized only in square brackets. The Check Point set of regular expressions has been enhanced for R70 and above. The following table indicates if earlier versions do not support use of a given metacharacter. Metacharacter \ (backslash) Meaning Earlier? See Backslash
escape character, and partial other meanings character class definition subpattern min/max quantifier match any character zero or one quantifier yes
[ ] (square brackets)
Square Brackets
( ) (parenthesis) { } (curly brackets) . (dot) ? (question mark) * (asterisk) + (plus) | (vertical bar) ^ (circumflex anchor)
Parentheses Curly Brackets Dot Question Mark Asterisk Plus Vertical Bar Circumflex Anchor
start alternative branch yes anchor pattern to beginning of buffer anchor pattern to end of buffer yes
$ (dollar anchor)
yes
Dollar Anchor
Regular Expressions
Square Brackets
Square brackets ([ ]) designate a character class: matching a single character in the string. Inside a character class, only these metacharacters have special meaning: backslash ( \ ) - general escape character. hyphen ( - ) - character range.
Parentheses
Parentheses ( ) designate a subpattern. To match with either an open-parenthesis or closing-parenthesis, use the backslash to escape the symbol.
Hyphen
A hyphen '-' indicates a character range inside a character class. When used as a simple character in a character class, it must be escaped by using a backslash '\'. For example: [a-z] matches the lower-case alphabet.
Dot
Outside a character class, a dot (.) matches any one character in the string. For example: .* matches zero or more occurrences of any character Inside a character class, it matches a dot (.).
Vertical Bar
A vertical bar (|) is used to separate alternative patterns. If the right side is empty, this symbol indicates the NULL string: a| matches a or empty string. For example: a|b matches a or b
Backslash
The meaning of the backslash (\) character depends on the context. The following explanations are not all supported in earlier versions; see Earlier Versions for details. In R70 and above, backslash escapes metacharacters inside and outside character classes.
Escaping Symbols
If the backslash is followed by a non-alphanumeric character, it takes away any special meaning that character may have. For example, \* matches an asterisk, rather than any character. Also, you can escape the closing bracket with a backslash [\]]. If the protection against the pattern is for earlier gateways as well as for newer ones, do not write one backslash inside square brackets. Instead, write two backslashes if you want to have a literal backslash inside square brackets. You cannot use \ to escape a letter that is not a metacharacter. For example, because "g" is not a metacharacter, you cannot use \g.
Identity Awareness Administration Guide R75.40VS | 114
Regular Expressions
Quantifiers
Various metacharacters indicate how many instances of a character, character set or character class should be matched. A quantifier must not follow another quantifier, an opening parenthesis, or be th e expressions first character. These quantifiers can follow any of the following items: a literal data character an escape such as \d that matches a single character a character class a sub-pattern in parentheses
Identity Awareness Administration Guide R75.40VS | 115
Regular Expressions
Curly Brackets
Curly brackets ({ }) are used as general repetition quantifiers. They specify a minimum and maximum number of permitted matches. For example: a{2,4} matches aa, aaa, or aaaa If the second number is omitted, but the comma is present, there is no upper limit; if the second number and the comma are both omitted, the quantifier specifies an exact number of required matches. For example: [aeiou]{3,} matches at least 3 successive vowels, but may match many more \d{8} matches exactly 8 digits
Note - A closing curly bracket '}' that is not preceded by an opening curly bracket '{' is treated as a simple character. However, it is good practice to use a backslash, '\}', when using a closing curly bracket as a simple character.
Question Marks
Outside a character class, a question mark (?) matches zero or one character in the string. It is the same as using {0,1}. For example: c([ab]?)r matches car, cbr, and cr Inside a character class, it matches a question mark: [?] matches ? (question mark).
Asterisk
Outside a character class, an asterisk (*) matches any number of characters in the string. It is the same as using {0,}. For example: c([ab]*)r matches car, cbr, cr, cabr, and caaabbbr Inside a character class, it matches an asterisk: [*] matches * (asterisk).
Plus
Outside a character class, a plus (+) matches one or more characters in the string. It is the same as using {1,}. For example: c([ab]+)r matches character strings such as car, cbr, cabr, caaabbbr; but not cr Inside a character class, it matches a plus: [+] matches + (plus).
Index
A
Access Role Objects 30 Access Settings 33 Acquiring Identities for Active Directory Users 16 Acquiring Identities in a Terminal Server Environment 23 Acquiring Identities in Application Control 23 Acquiring Identities with Browser-Based Authentication 17 Acquiring Identities with Endpoint Identity Agents 20 AD Based Configuration 85 AD Configuration 60, 78 AD Query 10 Adding a New Language 55 adlog 106 adlog control 108 adlog dc 107 adlog debug 107 adlog query 106 adlog service_accounts 108 adlog statistics 107 Advanced AD Query Configuration 46 Advanced Browser-Based Authentication Configuration 53 Advanced Deployment 66 Advanced Endpoint Identity Agents Configuration 65 Advanced Identity Agent Options 76 Agent Access 40 Agent Deployment from the Portal 35 Agent Upgrades 40 Asterisk 113 Authentication Settings 33, 40 Automatic Server Discovery 93
Configuring Endpoint Identity Agents in SmartDashboard 39 Configuring Identity Awareness 25 Configuring Identity Awareness for a Domain Forest (Subdomains) 46 Configuring Identity Logging for a Log Server 44 Configuring Installation - [Properties] Section 90 Configuring Installed Features - [Features] Section 91 Configuring Remote Access 43 Configuring Terminal Servers 41 Configuring Terminal Servers Accessibility 42 Configuring the Firewall 52 Configuring the Shared Secret 41 Confirm that Security Event Logs are Recorded 53 Creating a New User Account 60, 78 Creating Access Roles 27 Creating New Language Files 56 Curly Brackets 113 Custom Endpoint Identity Agent msi 90 Customize Appearance 34 Customizing Parameters 65 Customizing Text Strings 53
D
Data Center Protection 69 Dedicated Identity Acquisition Gateway 74 Deploying a Prepackaged Agent via the Captive Portal 95 Deploying a Test Environment 67 Deploying the Terminal Servers Identity Awareness Solution 41 Deployment 14 Deployment Options 67 Deployment Scenarios 68 Discovery and Trust Options 83 Distributed Enterprise with Branch Offices 72 DNS Based Configuration 87 Dot 111
B
Backslash 111 Browser Configuration 64 Browser-Based Authentication 11
E
Editing the Language Array 55 Enabling Identity Awareness on the Log Server for Identity Logging 44 Enabling Identity Awareness on the Security Gateway 25 Enabling Transparent Kerberos Authentication 64 Encoding Non-Printable Characters 112 Endpoint Identity Agent Deployment Methods 37 Endpoint Identity Agent Types 36 Escaping Symbols 111 Excluding Users 49
C
Changing Portal Text in SmartDashboard 54 Check Connectivity 51 Check Domain Administrator Credentials 52 Checking the Status of Domain Controllers 48 Choosing Identity Sources 45 Configuration Overview 60 Configuring Agent Deployment for User Groups 38 Configuring Agent Deployment from Captive Portal 38 Configuring an Account Unit 62, 80 Configuring Browser-Based Authentication in SmartDashboard 32 Configuring Deployed Endpoint Identity Agents - [AddFiles] Section 93 Configuring Endpoint Identity Agents 35
F
File Name Based Server Discovery 84 Firefox 64
G
Generating the Certificate Signing Request 58
Generating the P12 File 58 Getting Started With Identity Awareness 7 Google Chrome 64
H
How AD Query Operates - Firewall Rule Base Example 10 How Captive Portal Operates - Firewall Rule Base 12 How SSO Operates 77 How Transparent Kerberos Authentication Operates 12 How You Download an Endpoint Identity Agent - Example 14 Hyphen 111
I
Identity Agents 12 Identity Awareness Commands 96 Identity Awareness Scenarios 16 Identity Sources 45 Important Information 3 Install Database for a Log Server 53 Installing the Signed Certificate 59 Installing the Terminal Servers Identity Agent 41 Internet Explorer 64 Introduction 7, 66, 82, 90, 96
pdp monitor 97 pdp network 99 pdp status 101 pdp tracker 101 pdp update 102 pep 103 pep debug 105 pep show 103 pep show network 105 pep show pdp 104 pep show stat 105 pep show user 103 Performance 50 Perimeter Security Gateway with Identity Awareness 68 Permissions and Timeout 48 Plus 113 Portal Network Location 32 Prepackaging Endpoint Identity Agent Installation 65 Prepackaging Endpoint Identity Agents 89 Prepackaging Identity Agents 90
Q
Quantifiers 112 Question Marks 113
R
References 77 Regular Expressions 110 Remote Registry 88 Required SmartDashboard Configuration 18, 19, 21, 23 Results of the Wizard 27
K
Kerberos SSO Configuration 76
L
Large Scale Enterprise Deployment 70
M
Making Sure the Strings Shows Correctly 57 Mapping the User Account to a Kerberos Principal Name 61, 78 Metacharacters 110 Multiple Gateway Environments 50
S
Sample INI File 94 Saving New Language Files 56 Scenario Endpoint Identity Agent Deployment and User Group Access 20 Guest Users from Unmanaged Device 19 Identifying Users Accessing the Internet through Terminal Servers 23 Identifying Users in Application Control Logs 23 Laptop Access 16 Recognized User from Unmanaged Device 18 Server Certificates 57 Server Discovery and Trust 38, 82 Session 40 Setting Captive Portal to String ID Help Mode 53 Showing the Language Selection List 56 Single User Assumption 49 SmartDashboard Configuration 62, 80 Source and Destination Fields 31 Specifying Character Types 112 Specifying Domain Controllers per Security Gateway 46 Square Brackets 111 SSO Configuration 78
Page 118
N
Name and Password Login Settings 34 Negate and Block 32 Negate and Drop 30 Nested Groups 50 Network Segregation 71 Non-English Language Support 50
O
Obtaining and Installing a Trusted Server Certificate 58 Option Comparison 84 Overview 76
P
Packet Tagging for Anti-Spoofing 37 Parentheses 111 pdp 97 pdp connections 98 pdp control 99 pdp debug 100
T
Terminal Servers - Users Tab 42 Terminal Servers Advanced Settings 43 test_ad_connectivity 109 Testing Endpoint Identity Agents 68 Testing Identity Sources 67 Transparent Kerberos Authentication Configuration 60 Troubleshooting 51 Troubleshooting - Displaying SRV Record Stored in the DNS Server 88
U
Unregistered Guest Login Settings 35 Use wbemtest to Verify WMI 51 User Access 34 User Experience 18, 20, 21 User identification in the Logs 24 User Identification in the Logs 17, 19, 22 Using Access Roles 17 Using Identity Awareness in the Application and URL Filtering Rule Base 30 Using Identity Awareness in the Firewall Rule Base 29 Using the cpmsi_tool.exe 90
V
Verify the WMI Service 52 Vertical Bar 111 Viewing the Certificate 59
W
What's Next 22 Wireless Campus 74
Page 119