Cisco Prime Access Registrar 9.1 User Guide Published: March 20, 2020
Total Page:16
File Type:pdf, Size:1020Kb
Cisco Prime Access Registrar 9.1 User Guide Published: March 20, 2020 Last Modified: August 27, 2021 Cisco Systems, Inc. www.cisco.com Cisco has more than 200 offices worldwide. Addresses, phone numbers, and fax numbers are listed on the Cisco website at www.cisco.com/go/offices. THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS. THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY. The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB’s public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California. NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS” WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE. IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1721R) Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental. Cisco Prime Access Registrar 9.1 User Guide © 2020 Cisco Systems, Inc. All rights reserved. CONTENTS CHAPTER 1 Overview 1-1 Prime Access Registrar Hierarchy 1-2 UserLists and Groups 1-3 Profiles 1-3 Scripts 1-3 Services 1-3 Session Management Using Resource Managers 1-4 RADIUS Protocol 1-5 Types of RADIUS Messages 1-5 Packet Contents 1-6 The Attribute Dictionary 1-6 Enhanced IP Allocation in Prime Access Registrar 1-7 5G Data Network-AAA (DN-AAA) Compliance 1-7 Related Documentation 8 CHAPTER 2 Using the Graphical User Interface 2-1 Launching the GUI 2-1 Disabling HTTP 2-2 Disabling HTTPS 2-2 Login Page 2-3 Logging In 2-3 Logging Out 2-4 Common Methodologies 2-4 Filtering Records 2-4 Editing Records 2-5 Deleting Records 2-5 Setting Record Limits per Page 2-6 Performing Common Navigations 2-6 Relocating Records 2-7 Dashboard 2-8 Sessions 2-8 Configuring Cisco Prime Access Registrar 2-9 RADIUS 2-10 Setting Up or Changing the Radius Properties 2-11 Cisco Prime Access Registrar 9.0 User Guide iii Contents Profiles 2-11 Adding Profile Details 2-12 UserGroups 2-12 Adding UserGroup Details 2-14 UserList 2-14 Adding UserList Details 2-15 Users 2-16 Adding User Details 2-17 Scripts 2-18 Adding Script Details 2-21 Policies 2-22 Adding Policy Details 2-22 GroupServers 2-22 Adding Group Server Details 2-24 Services 2-24 Simple Services 2-24 ServiceWithRS 2-32 PEAP Service 2-36 EAP Service 2-40 Diameter Service 2-51 CommandSets 2-56 Adding a Command Set 2-56 DeviceAccessRules 2-57 Adding a Device Access Rule 2-57 FastRules 2-58 Adding a Fast Rule 2-58 Replication 2-59 Adding Replication Details 2-60 Adding the Replication Member Details 2-61 RADIUSDictionary 2-61 Adding RADIUS Dictionary Details 2-62 VendorDictionary 2-62 Adding Vendor Dictionary Details 2-63 Vendor Attributes 2-64 Adding Vendor Attributes 2-64 Vendors 2-65 Adding Vendor Details 2-65 Translations 2-66 Adding Translation Details 2-67 TranslationGroups 2-68 Cisco Prime Access Registrar 9.0 User Guide iv Contents Adding Translation Group Details 2-68 Diameter 2-69 General 2-69 Session Management 2-72 Applications 2-73 Commands 2-74 DiameterAttributes 2-76 Advanced 2-77 Default 2-77 BackingStore/ServerParam 2-83 RemoteSessionServer 2-88 SNMP and Server Monitor 2-90 DDNS 2-94 Encrypted IMSI Private Keys 2-95 ODBC DataSources 2-96 Log 2-97 Ports 2-100 Interfaces 2-101 Attribute Groups 2-101 DOIC Priorities 2-102 Health Monitor 2-103 Rules 2-105 Setting Rules 2-106 SessionManagers 2-106 Adding Session Manager Details 2-110 ResourceManager 2-111 Adding Resource Manager Details 2-119 Network Resources 2-119 Clients 2-120 Adding Client Details 2-126 Remote Servers 2-126 LDAP 2-127 LDAP Accounting 2-131 ODBC/OCI 2-134 ODBC/OCI-Accounting 2-136 Diameter 2-139 REST 2-144 Others 2-145 Administration 2-150 Administrators 2-151 Cisco Prime Access Registrar 9.0 User Guide v Contents Adding Administrator Details 2-151 Statistics 2-152 Resetting Server Statistics 2-156 DiameterStatistics 2-156 TACACSStatistics 2-166 Back Up and Restore 2-168 LicenseUpload 2-168 HealthMonitor 2-169 Read-Only GUI 2-169 CHAPTER 3 RADIUS Accounting 3-1 Understanding RADIUS Accounting 3-1 Setting Up Accounting 3-2 Accounting Log File Rollover 3-2 FilenamePrefix 3-3 MaxFileSize 3-4 MaxFileAge 3-4 RolloverSchedule 3-5 UseLocalTimeZone 3-5 FileType 3-5 EnableRolloverIntelligence 3-5 AttributesToBeLogged 3-6 Oracle Accounting 3-6 Configuring Oracle Accounting 3-7 ODBC-Accounting Service 3-7 ODBC RemoteServers 3-7 Configuration Examples 3-9 Packet Buffering 3-10 When Using Packet Buffering 3-11 With Packet Buffering Disabled 3-11 Dynamic SQL Feature 3-11 LDAP Accounting 3-12 Configuring LDAP Accounting 3-12 LDAP-Accounting Service 3-12 LDAP RemoteServers 3-13 Configuration Examples 3-15 Configuring the LDAP Service for Accounting 3-16 Configuring an LDAP-Accounting RemoteServer 3-17 Setting LDAP-Accounting As Accounting Service 3-19 Cisco Prime Access Registrar 9.0 User Guide vi Contents MySQL Support 3-20 Configuring MySQL 3-20 Example Configuration 3-21 Proxying Accounting Records 3-21 Configuring the Local Cisco Prime Access Registrar Server 3-22 Configuring the Local Accounting Service 3-22 Configuring the Remote Accounting Service 3-22 Configuring the Group Accounting Service 3-23 Configuring the RemoteServer Object 3-23 CHAPTER 4 Diameter 4-1 Diameter with EAP Support 4-2 Advertising Application Support 4-2 Diameter EAP Conversation Flow 4-2 Diameter Server Startup Log 4-3 Diameter Stack Level Messages 4-4 Capabilities Exchange Message 4-5 Watchdog Message 4-6 Disconnect Message 4-6 Configuring Authentication and Authorization for Diameter 4-6 Configuring Local Authentication and Authorization 4-6 Configuring a Local Service and UserList 4-7 Configuring External Authentication Service 4-8 Configuring the Diameter Application in Prime Access Registrar 4-8 Configuring the Transport Management Properties 4-9 Registering Applications IDs 4-10 Configuring the Diameter Peers 4-11 Configure the Diameter Service 4-12 Group-Based Load Balancing in Diameter Proxy Server Configuration 4-15 Writing Diameter Application in Prime Access Registrar 4-17 Configuring rex script/service for Diameter 4-17 Scripting in Diameter 4-18 Diameter Environment Variables 4-18 Sample rex script/service 4-19 Traces/Logs 4-20 Translation Framework for Diameter 4-21 TLS Support for Diameter 4-22 Managing Diameter Sessions 4-24 Cisco Prime Access Registrar 9.0 User Guide vii Contents Blacklisting Support for Diameter Remote Server 4-24 SCTP Multihoming Support for Diameter Client and Remote Server 4-24 Diameter Multiple Proxy Support 4-26 Diameter Overload Indication Conveyance Support for Diameter 4-27 CHAPTER 5 Extensible Authentication Protocols 5-1 EAP-AKA 5-2 Configuring EAP-AKA 5-2 Testing EAP-AKA with radclient 5-6 EAP-AKA-Prime (EAP-AKA’) 5-6 Configuring EAP-AKA’ 5-7 Testing EAP-AKA’ with radclient 5-8 EAP-FAST 5-8 Configuring EAP-FAST 5-9 EAP-FAST Keystores 5-13 Testing EAP-FAST with radclient 5-13 PAC Provisioning 5-14 Authentication 5-15 Parameters Used for Certificate-Based Authentication 5-15 radclient Command Reference 5-16 PAC—Credential Export Utility 5-18 PAC Export 5-18 PAC Display 5-19 Syntax Summary 5-19 EAP-GTC 5-19 Configuring EAP-GTC 5-19 Testing EAP-GTC with radclient 5-20 EAP-LEAP 5-21 Configuring EAP-LEAP 5-21 EAP-MD5 5-22 Configuring EAP-MD5 5-22 EAP-Negotiate 5-23 Configuring EAP-Negotiate 5-23 Negotiating PEAP Tunnel Services 5-24 Testing EAP-Negotiate with radclient 5-24 EAP-MSChapV2 5-24 Configuring EAP-MSChapV2 5-24 Testing EAP-MSChapV2 with radclient 5-25 Cisco Prime Access Registrar 9.0 User Guide viii Contents EAP-SIM 5-26 Configuring EAP-SIM 5-26 Quintets to Triplets Conversion 5-30 EAP-Transport Level Security (TLS) 5-31 Configuring EAP-TLS 5-31 Configuring EAP-TLS with OCSP Support 5-34 Testing EAP-TLS with RSA or ECC Certificate using radclient 5-35 Testing EAP-TLS with Client Certificates 5-35 EAP-TTLS 5-35