Netscape NETSCAPE MANAGEMENT SYSTEM 4.5 Assembly instructions

Installation and Setup Guide
Netscape Certificate Management System
Version4.5
October 2001

Netscape Communications Corporation (“Netscape”), a subsidiary of America Online, Inc., and its licensors retain all ownership
rights to the software programs offered by Netscape (referred to herein as “Software”) and related documentation. Use of the
Software and related documentation is governed by the license agreement accompanying the Software and applicable copyright law.
Your right to copy this documentation is limited by copyright law. Making unauthorized copies, adaptations, or compilation works
is prohibited and constitutes a punishable violation of the law. Netscape may revise this documentation from time to time without
notice.
THIS DOCUMENTATION IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND. IN NO EVENT SHALL NETSCAPE BE
LIABLE FOR INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES OF ANY KIND ARISING FROM ANY
ERROR IN THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION ANY LOSS OR INTERRUPTION OF BUSINESS,
PROFITS, USE, OR DATA.
Software applications: © 2001 Sun Microsystems, Inc.
Some software code: © 1999, 2001 Netscape Communications Corporation.
All rights reserved.
Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the United States and
other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications
Corporation, which may be registered in other countries. Other product and brand names are the exclusive property of their
respective owners.
The downloading, exporting, or reexporting of Netscape software or any underlying information or technology must be in full
compliance with all United States and other applicable laws and regulations. Any provision of Netscape software or documentation
to the U.S. Government is with restricted rights as described in the license agreement accompanying Netscape software.

3
Contents
AboutThisGuide.............................................................. 23
What’sinThisGuide....................................................................23
WhatYouShouldAlreadyKnow .........................................................26
ConventionsUsedinThisGuide .........................................................27
WheretoGoforRelatedInformation......................................................28
Part 1 OverviewandDemoInstallation......................................... 31
Chapter 1 IntroductiontoCertificateManagementSystem.......................... 33
OverviewofKeyFeatures ...............................................................34
Flexibleend-entityregistrationservicesframework ....................................38
SystemOverview.......................................................................41
Public-KeyInfrastructure .............................................................43
CMSSubsystemsorManagers.........................................................44
CertificateManager ...............................................................45
RegistrationManager..............................................................47
DataRecoveryManager............................................................48
OnlineCertificateStatusManager ...................................................49
BasicSystemConfiguration ...........................................................50
Plug-inModules.....................................................................55
AuthenticationPlug-inModules ....................................................55
PolicyPlug-inModules ............................................................57
JobPlug-InModules...............................................................61
MapperandPublisherPlug-inModules ..............................................62
Event-DrivenNotifications............................................................64

4 Netscape Certificate Management System Installation and Setup Guide • October 2001
AuxiliaryComponents.................................................................. 64
Command-Line Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
CMSSDK .......................................................................... 65
EntryPointsforVariousTypesofUsers ................................................... 66
AgentServicesInterface .............................................................. 68
CertificateManagerAgentServices ................................................. 68
RegistrationManagerAgentServices ................................................ 69
DataRecoveryManagerAgentServices.............................................. 70
OnlineCertificateStatusManagerAgentServicesInterface............................. 71
End-EntityServicesInterface.......................................................... 72
SystemArchitecture .................................................................... 73
PKCS#11........................................................................... 74
NSS................................................................................ 76
JSSandtheJava/JNILayer ........................................................... 76
Middleware/Java2Layers ........................................................... 76
AuthenticationandPolicyModules .................................................... 77
Standards Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
CertificateManagementFormatsandProtocols.......................................... 77
SecurityandDirectoryProtocols....................................................... 78
Chapter 2 CertificateEnrollmentandLife-CycleManagement ....................... 81
StepsinEnd-EntityEnrollment .......................................................... 81
SomeEnrollmentScenarios.............................................................. 84
FirewallConsiderations .............................................................. 84
Extranet/E-Commerce:AcmeSalesCorp. .............................................. 85
EnrollingExistingCustomers....................................................... 86
EnrollingNewCustomers.......................................................... 87
EnrollingExtranetUsers ........................................................... 89
PINRegistration:AtlasManufacturing ................................................. 91
VPNClientEnrollmentandRevocation ................................................ 93
RouterEnrollmentandRevocation..................................................... 96
EndEntitiesandLife-CycleManagement.................................................. 98
Life-CycleManagementFormatsandProtocols.......................................... 98
AccesstoSubsystems ................................................................ 99
HTMLFormsforEndUsers.......................................................... 101
NetscapePersonalSecurityManager .................................................. 102
Chapter 3 DefaultDemoInstallation ........................................... 105
SystemRequirements.................................................................. 106
OperatingSystemandSoftwareRequired ............................................. 106
PlatformRequirements.............................................................. 106
OverviewoftheDefaultDemo.......................................................... 108

5
DemoPasswords ...................................................................111
Installing the Default Demo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 112
Step1.RuntheInstallationScript—UNIX .............................................112
Step1.RuntheInstallationScript—WindowsNT .......................................114
Step2.RuntheInstallationWizard....................................................122
Step3.GettheFirstUserCertificate ...................................................135
EnrollingfortheFirstAgentCertificate .............................................135
IfYouNeedtheFirstAgentFormAgain ............................................137
UsingtheDefaultDemo................................................................138
VerifytheInstallation ...............................................................138
ViewingIssuedCertificatesFromtheAgentGateway .................................139
EnrollingforaCertificateFromtheEnd-EntityGateway ..............................140
FindingandApprovingaCertificateRequest ........................................141
SettingYourBrowsertoUsetheAgentCertificate ....................................142
TestingYourNewCertificate ......................................................142
CreateaPolicy .....................................................................143
ConfiguringanRSAKeyLengthPolicy .............................................143
UseanLDAPDirectory..............................................................145
Step1.EnableDirectory-BasedAuthentication .......................................146
Step2.AddaUsertotheDirectory .................................................147
Step3.EnrollwithDirectory-BasedAuthentication ...................................149
PublishCertificatestoanLDAPDirectory..............................................150
ConfigurethePublishingDestination ...............................................151
SetRulesforPublishingCertificates ................................................153
UpdatethePublishingDirectory ...................................................154
SendRenewalReminders ............................................................156
ConfiguringaMailServerforCertificateManagementSystem .........................157
ConfiguringCertificateManagementSystemtoSendRenewalReminders ...............157
Part 2 PlanningandInstallation.............................................. 161
Chapter 4 Planning Your Deployment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163
TopologyDecisions....................................................................164
ServerGroupsandCMSInstances ....................................................164
SingleCertificateManager ...........................................................165
CertificateManagerandRegistrationManager .........................................166
CertificateManagerandDataRecoveryManager .......................................168
CertificateManager,DataRecoveryManager,andRegistrationManager...................170
ClonedCertificateManager ..........................................................172
CertificateAuthorityDecisions ..........................................................173
CA’sDistinguishedName ...........................................................173

6 Netscape Certificate Management System Installation and Setup Guide • October 2001
CASigningKeyTypeandLength .................................................... 174
CA Signing Certificate’s Validity Period . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
Self-SignedRootVersusSubordinateCA .............................................. 174
CAsandCertificateExtensions ....................................................... 175
CACertificateRenewalorReissuance ................................................. 176
CryptographicTokenDecisions ......................................................... 177
PublishingDecisions .................................................................. 177
PublishingtoCertificatesandCRLstoFiles ............................................ 178
PublishingtoCertificatesandCRLstoaDirectory ...................................... 178
PublishingCRLstotheOnlineCertificateStatusManager ............................... 179
SubsystemCertificateDecisions......................................................... 180
SSLServerCertificates .............................................................. 180
CertificateManagerCertificates ...................................................... 180
RegistrationManagerCertificates..................................................... 181
DataRecoveryManagerCertificateandStorageKey .................................... 182
OnlineCertificateStatusManagerCertificates .......................................... 182
AuthenticationDecisions............................................................... 183
PolicyDecisions....................................................................... 183
DeploymentStrategyandPortAssignments .............................................. 184
Chapter 5 InstallationWorksheet.............................................. 187
InformationforUNIXInstallationScript ................................................. 188
InstallationLocation ................................................................ 188
ConfigurationDirectoryServer....................................................... 188
User/GroupDirectoryServer ........................................................ 189
ConfigurationDirectorySettings ..................................................... 189
AdministrationServerInformation ................................................... 190
CertificateManagementSystemIdentifier ............................................. 191
InformationforNTInstallationScript.................................................... 191
InstallationDirectory ............................................................... 191
ConfigurationDirectoryServer....................................................... 191
User/GroupDirectoryServer ........................................................ 192
ConfigurationDirectorySettings ..................................................... 193
ConfigurationDirectoryServerAdministrator ......................................... 193
DirectoryServerAdministrationDomain .............................................. 193
DirectoryManagerSettings .......................................................... 193
AdministrationServerPort .......................................................... 194
CertificateManagementSystemIdentifier ............................................. 194
InitialConfiguration................................................................... 194
InternalDatabase................................................................... 195
Administrator...................................................................... 195
Subsystems ........................................................................ 195
RemoteCertificateManager ......................................................... 196

7
RemoteDataRecoveryManager ......................................................196
NetworkConfiguration..............................................................197
CertificateManagerConfiguration.......................................................197
CASigningCertificate...............................................................197
CA’sSerialNumberRange ........................................................197
Key-PairInformationforCASigningCertificate......................................198
SubjectNameforCASigningCertificate ............................................198
Validity Period for CA Signing Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199
ExtensionsforCASigningCertificate ...............................................199
CASigningCertificateRequest .......................................................200
RegistrationManagerConfiguration .....................................................201
RegistrationManagerSigningCertificateRequest .......................................201
Key-PairInformationforRegistrationManagerSigningCertificate .....................201
SubjectNameforRegistrationManagerSigningCertificate ............................202
RegistrationManagerSigningCertificateIssuer.........................................202
DataRecoveryManagerConfiguration ...................................................203
TransportCertificate ................................................................203
Key-PairInformationforTransportCertificate .......................................203
SubjectNameforTransportCertificate..............................................204
Validity Period for Transport Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
ExtensionsforTransportCertificate ................................................205
TransportCertificateRequest.........................................................206
StorageKeyandRecoveryAgentConfiguration ........................................206
StorageKeyCreation .............................................................206
DataRecoveryScheme—1.........................................................206
DataRecoveryScheme—2.........................................................207
OnlineCertificateStatusManagerConfiguration ..........................................207
OnlineCertificateStatusManagerSigningCertificateRequest ............................207
Key-Pair Information for Online Certificate Status Manager Signing Certificate . . . . . . . . . . . 208
SubjectNameforOnlineCertificateStatusManagerSigningCertificate .................208
OnlineCertificateStatusManagerSigningCertificateIssuer ..............................209
ClonedCertificateManagerConfiguration................................................209
CASigningCertificate...............................................................210
CA’sSerialNumberRange ........................................................210
ClonedKeyandCertificateMaterial ................................................210
SSLServerKeyandCertificate .....................................................211
SSLServerCertificateConfiguration .....................................................211
SSLServerCertificate ...............................................................211
Key-PairInformationforSSLServerCertificate ......................................211
SubjectNameforSSLServerCertificate .............................................212
Validity Period for SSL Server Certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 212
ExtensionsforSSLServerCertificate................................................213
SSLCertificateRequest ..............................................................214

8 Netscape Certificate Management System Installation and Setup Guide • October 2001
SingleSign-OnPassword............................................................... 214
Chapter 6 InstallingCertificateManagementSystem ............................. 215
InstallationOverview.................................................................. 215
InstallationStages .................................................................. 216
BeforeYouBegintheInstallation ..................................................... 217
Stage1.RunningtheInstallationScript................................................... 219
RunningtheInstallationScriptonUNIX............................................... 219
RunningtheInstallationScriptonWindowsNT ........................................ 222
Stage2.RunningtheInstallationWizard ................................................. 225
Installing the Certificate Manager as a Root CA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
Installing the Certificate Manager as a Subordinate CA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
Installing a Standalone Registration Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 242
Installing a Standalone Data Recovery Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 253
Installing a Online Certificate Status Manager . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 264
Stage3.EnrollingforAdministrator/AgentCertificate ..................................... 275
AgentCertificateforaCertificateManager............................................. 275
AgentCertificateforOtherCMSManagers ............................................ 278
Stage4.FurtherConfigurationOptions .................................................. 281
Stage5.CreatingAdditionalInstancesorCAClones....................................... 282
Chapter 7 Installing and Uninstalling CMS Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
Installing Multiple CMS Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
CloningaCertificateManager .......................................................... 286
Step1.BeforeYouBegin............................................................. 287
Step2.CreateInstancesforCloneCAs ................................................ 289
Installing Clone CA in Master CA’s Server Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 289
Installing Clone CA in a Different Server Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 290
Installing Clone CA on a Separate Host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291
Step3.ShutdowntheMasterCA ..................................................... 291
Step4.CopyMasterCA’sCertificateandKeyDatabase ................................. 292
Step5.StarttheMasterCA .......................................................... 292
Step6.ConfiguretheCloneCA ...................................................... 292
Step8.EstablishTrustBetweenMasterCAandCloneCAs............................... 293
StepA.LocatetheMasterCA’sSSLServerCertificate................................. 294
StepB.CreateaPrivileged-UserEntryforCloneCAs ................................. 296
Step9.TestClone-MasterConnection ................................................. 299
StepA.RequestaCertificatefromtheCloneCA ..................................... 299
StepB.ApprovetheRequest ...................................................... 300
StepC.DownloadtheCertificatetotheBrowser ..................................... 300
StepD.RevoketheCertificate ..................................................... 301
StepE.CheckMasterCA’sCRLfortheRevokedCertificate ........................... 301

9
Step10.UseMasterCA’sAgentCertificateinCloneCAs.................................302
ViewingInstanceInformation...........................................................303
ChangingtheNameofanInstance.......................................................305
RemovinganInstanceFromaSystem ....................................................306
UninstallingCertificateManagementSystem..............................................308
UninstallingFromtheCommandLine.................................................308
UninstallingbyUsingtheWindowsNTAdd/RemoveProgramsUtility ...................308
Chapter 8 Starting and Stopping CMS Instances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 311
StartingCertificateManagementSystem..................................................312
RequiredStart-upInformation........................................................312
ConfiguringtheServertoStartWithouttheSingleSign-OnPassword...................313
ConfiguringtheServertoReadtheSingleSign-onPasswordFromaFile ................314
StartingFromNetscapeConsole ......................................................317
StartingFromtheCommandLine.....................................................318
StartingFromtheWindowsNTServicesPanel..........................................319
StoppingCertificateManagementSystem.................................................320
StoppingFromNetscapeConsole .....................................................320
StoppingFromtheCommandLine....................................................321
StoppingFromtheWindowsNTServicesPanel ........................................322
RestartingCertificateManagementSystem................................................322
RestartingFromtheCMSWindow ....................................................322
RestartingFromtheCommandLine...................................................323
CheckingSystemStatus ................................................................324
AttendingtoanUnresponsiveServer ....................................................325
CMSWatchdogProcess ................................................................325
PasswordCache.......................................................................326
Password-QualityChecker .............................................................327
Part 3 Configuration ....................................................... 329
Chapter 9 Administration Tasks and Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 331
NetscapeConsole .....................................................................332
ConsoleTab........................................................................332
UsersandGroupsTab...............................................................333
NetscapeAdministrationServer ......................................................334
StartingAdministrationServer.....................................................335
ShuttingDownAdministrationServer ..............................................336
LoggingIntoNetscapeConsole .........................................................336
TheCMSWindow .....................................................................338
TasksTab..........................................................................339

10 Netscape Certificate Management System Installation and Setup Guide • October 2001
ConfigurationTab .................................................................. 339
StatusTab ......................................................................... 342
LoggingIntotheCMSWindow......................................................... 343
Chapter 10 CMS Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
EffectsofInstallationTypeonConfiguration.............................................. 345
DuplicatingConfigurationFromOneInstancetoAnother ............................... 347
LocatingtheConfigurationFile ......................................................... 348
ModifyingtheConfiguration ........................................................... 349
ChangingtheConfigurationFromtheCMSWindow.................................... 349
ChangingtheConfigurationbyEditingtheConfigurationFile............................ 349
Guidelines for Editing the Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 350
SampleConfigurationFile ........................................................... 353
RoadMaptoConfiguringSubsystems ................................................... 366
Step1.CheckWhichSubsystemsareInstalledintheInstance.......................... 366
Step2.CheckthePortNumbers ................................................... 366
Step3.VerifyKeyPairandCertificates ............................................. 366
Step4.SetupPrivilegedUsers..................................................... 367
Step5.CustomizeEnd-EntityandAgentForms...................................... 367
Step6.SetupAuthenticationforEndUsers.......................................... 367
Step7:EnableEvent-DrivenNotifications ........................................... 368
Step8.ScheduleJobs ............................................................. 368
Step9.SetupPolicies............................................................. 368
Step10.SetupPublishing......................................................... 369
Step11.SetupKeyArchivalandRecovery .......................................... 369
Step12.SetupLogging ........................................................... 369
Step13.PlanforBackingupCMSConfigurationandData ............................ 370
Chapter 11 SettingUpPorts .................................................. 371
CMSPorts............................................................................ 371
RemoteAdministrationPort ......................................................... 372
AgentPort......................................................................... 373
End-EntityPorts.................................................................... 373
ConfiguringPortNumbers ............................................................. 374
Step1.SpecifythePortNumber ...................................................... 374
Step2:SpecifyIPAddresses ......................................................... 377
Chapter 12 SettingUpInternalDatabase........................................ 379
InternalDatabase ..................................................................... 379
ConfiguringtheInternalDatabase....................................................... 380
Step1.IdentifytheDirectoryServerInstance........................................... 381
Step2.RestrictAccesstotheInternalDatabase ......................................... 382