Implementing Kerberos in a Websphere Application Server Environment
Total Page:16
File Type:pdf, Size:1020Kb
Front cover Implementing Kerberos in a WebSphere Application Server Environment Discusses how to implement Kerberos in a WebSphere environment Provides information on using single sign-on Includes detailed scenarios and examples Fabio Albertoni Henry Cui Elisa Ferracane James Kochuba Ut Le Bill O’Donnell Gustavo Cezar de Medeiros Paiva Vipin Rathor Grzegorz Smolko Rengan Sundararaman Tam Tran ibm.com/redbooks International Technical Support Organization Implementing Kerberos in a WebSphere Application Server Environment October 2009 SG24-7771-00 Note: Before using this information and the product it supports, read the information in “Notices” on page xv. First Edition (October 2009) This edition applies to IBM WebSphere Application Server V7. © Copyright International Business Machines Corporation 2009. All rights reserved. Note to U.S. Government Users Restricted Rights -- Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contact an IBM Software Services Sales Specialist Start SMALL, Start BIG, ... JUST START architectural knowledge, skills, research and development . that's IBM Software Services for WebSphere. Our highly skilled consultants make it easy for you to design, build, test and deploy solutions, helping you build a smarter and more efficient business. Our worldwide network of services specialists wants you to have it all! Implementation, migration, architecture and design services: IBM Software Services has the right fit for you. We also deliver just-in-time, customized workshops and education tailored for your business needs. You have the knowledge, now reach out to the experts who can help you extend and realize the value. For a WebSphere services solution that fits your needs, contact an IBM Software Services Sales Specialist: ibm.com/developerworks/websphere/services/contacts.html Contact an IBM Software Services Sales Specialist iii iv Implementing Kerberos in a WebSphere Application Server Environment Contents Contact an IBM Software Services Sales Specialist . iii Notices . xv Trademarks . xvi Preface . xvii The team who wrote this book . xvii Become a published author . xx Comments welcome. xxi Chapter 1. Introduction. 1 1.1 What is Kerberos. 2 1.2 What is SPNEGO . 2 1.3 Benefits of using Kerberos technology . 3 1.4 Kerberos terminology . 3 1.5 SSO with SPNEGO and Kerberos . 6 1.6 Kerberos with other authentication protocols . 8 1.7 Web services security using Kerberos . 8 1.7.1 Kerberos Token Profile 1.1 specification. 9 1.7.2 Support in WebSphere Application Server V7 . 10 1.7.3 Kerberos configuration models for Web services . 10 1.8 High-level look at the scenarios . 11 Chapter 2. Setting up a KDC on a z/OS system . 13 2.1 Introduction to the KDC on a z/OS system . 14 2.2 Creating the KDC on a z/OS system. 14 2.2.1 Creating the KDC on the z/OS system using RACF commands. 14 2.2.2 Starting the KDC on the z/OS system. 16 2.3 KDC administrative management tasks . 18 2.3.1 Creating the Kerberos service principal name . 19 2.3.2 Creating a Kerberos keytab file. 19 2.3.3 Creating users for Kerberos in RACF . 20 2.3.4 Changing Kerberos ticket life . 21 2.3.5 Setting the encryption type . 22 2.4 Validating the setup. 24 2.5 Enabling KDC trace. 27 2.5.1 Enabling debug with the envar file . 27 2.5.2 Enabling debug dynamically . 28 © Copyright IBM Corp. 2009. All rights reserved. v Chapter 3. Configuring IBM Network Authentication Service KDC on AIX . 29 3.1 Introduction to this chapter . 30 3.2 Configuring the IBM NAS KDC on AIX . 32 3.2.1 Add the directory suffix in IBM Tivoli Directory Server . 32 3.2.2 Load the IBM NAS Kerberos schema in IBM Tivoli Directory Server 35 3.2.3 Add Kerberos realm information in IBM Tivoli Directory Server . 35 3.2.4 Configure the IBM NAS KDC on the AIX system . 38 3.3 Additional Kerberos tasks . 41 3.3.1 Using the kadmin interface . 41 3.3.2 Creating a Kerberos principal . 42 3.3.3 Generating a keytab . 44 3.3.4 Setting the ticket lifetime . 45 3.3.5 Changing encryption types . 47 3.3.6 Starting and stopping IBM NAS Kerberos daemons . 48 3.3.7 Diagnosing Kerberos related issues . 49 Chapter 4. Setting up Microsoft Active Directory and Kerberos KDC . 51 4.1 Introduction to Microsoft Kerberos KDC . 52 4.2 Configuring a domain name system server. 52 4.3 Creating the Microsoft Kerberos KDC . 58 4.4 Establishing a trust relationship between Microsoft Active Directory realms . 69 4.5 Validating the trust relationship . 80 4.6 Adding a Kerberos service principal name . 82 4.6.1 Creating a Kerberos service principal name . 83 4.6.2 Creating the Kerberos keytab file . 86 Chapter 5. Setting up trust between an AIX KDC and a z/OS KDC. 89 5.1 Introduction to cross-realm trust . 90 5.2 Configuring the cross-realm trust relationship. 91 5.2.1 Configuring the AIX KDC for cross-realm trust . 91 5.2.2 Configuring the z/OS KDC for cross-realm trust . 95 5.2.3 Verifying the cross-realm trust setup. 97 Chapter 6. Setting up trust between a Microsoft Kerberos KDC and a z/OS KDC . 101 6.1 Introduction to the Microsoft Kerberos KDC and the z/OS KDC cross-realm trust . 102 6.2 Configuring trust on the Microsoft KDC. 103 6.2.1 Install the prerequisites . 103 6.2.2 Configure the location of the z/OS KDC . 104 6.2.3 Configure trust to the z/OS KDC . 104 6.2.4 Configure the DNS . 113 vi Implementing Kerberos in a WebSphere Application Server Environment 6.3 Configuring the Microsoft Windows client . 141 6.3.1 Install the prerequisites . 142 6.3.2 Configure the location of the z/OS KDC . 142 6.3.3 Modify the Kerberos registry settings . 143 6.4 Configuring trust on the z/OS KDC . 147 6.5 Validating the trust. 149 Chapter 7. Single sign-on to WebSphere Application Server using SPNEGO . 153 7.1 Scenario overview . 154 7.1.1 Step-by-step flow for the scenario. 155 7.1.2 Scenario components . 157 7.1.3 Basic requirements for this scenario . 157 7.2 Configuring the Microsoft Active Directory server . 158 7.3 Configuring WebSphere Application Server . 160 7.3.1 Configuring the Kerberos configuration file . 161 7.3.2 Configuring the Microsoft Active Directory as the WebSphere Application Server user repository . 162 7.3.3 Configuring the SPNEGO Web authentication in WebSphere Application Server. 165 7.4 Configuring Web browsers for SPNEGO . 168 7.5 Validating SSO with SPNEGO Web authentication . 168 Chapter 8. Single sign-on to WebSphere Application Server for z/OS using SPNEGO. 173 8.1 Scenario overview . 174 8.1.1 Step-by-step flow of the scenario . 174 8.1.2 Scenario components . 176 8.1.3 Basic requirements for this scenario . ..