HP UX Security Products and Features Software manual Cssm Module Information Files

Page 19

Common Data Security Architecture (CDSA) White Paper

Common Security Services Manager (CSSM) API

operations.

Module veriﬁcation has three aspects:

•veriﬁcation of the module’s identity, based on a digitally-signed certiﬁcate

•veriﬁcation of object code, whose integrity is itself based on a signed hash of the object

•tightly binding the veriﬁed module identity with the veriﬁed set of object code.

CSSM Module Information Files

Each CSSM module (including CSSM itself and add-ins) must be installed on the system before applications can use it. CSSM_ModuleInstall() is the API used to install modules. CSSM_ModuleInstall() creates information ﬁles under the directory /var/cdsa/cssm. The information ﬁle for each module installed is named for its module GUID, in the form “module-guid”.info.

For example, the CSSM core has a module GUID of

{4405ee7c-eeac-11d1-b73d-0060b0b6e655}

Its module-guid.info ﬁle, named

/var/cdsa/cssm/{4405ee7c-eeac-11d1-b73d-0060b0b6e655}.info

contains the following information:

String*Location: /usr/lib/libcssm.1

String*Name: Helwett-Packard Common Security Service Managers Module

String*Version: 1.20

String*Vendor: Hewlett-Packard Company

String*Description: CSSM Module

Binary*ThreadSafe: 00000000

Binary*NumberOfServices: 00000000

String*GUID: {4405ee7c-eeac-11d1-b73d-0060b0b6e655}

Binary*ServiceMasks: 00000001

If the NumberOfServices is not 0, the directory guid contains information for each service.

CSSM_ModuleUnInstall() is the API to uninstall a module. CSSM_ModuleUnInstall() removes the module information ﬁle from /var/cdsa/cssm. After a module is uninstalled, it becomes unavailable to applications.

For HP-UX, CSSM core, the bundled CSP and the x509v3 CL are preinstalled into the system

Chapter 1

19

Image 19

Contents Contents Migrating to Cdsa ZIP format Private Key File Sample Install Program Generating the Credential FileChapter Common Data Security Architecture Cdsa White PaperGlossary of Cdsa Terms and Acronyms Glossary of Cdsa Terms and AcronymsGlossary of Cdsa Terms and Acronyms RC2 Glossary of Cdsa Terms and Acronyms Glossary of Cdsa Terms and Acronyms Glossary of Cdsa Terms and Acronyms Glossary of Cdsa Terms and Acronyms HP-UX Cdsa Product Overview What Is CDSA?What Is CDSA? HP’s Implementation of CdsaWhat Is CDSA? Cdsa Components on HP-UX Cdsa Components in HP-UXWhat Is CDSA? Example of Cdsa APIs Used for Applications vs. Shared Cdsa in the Context of Other Security ApplicationsLibraries Applications CDSA, shown relative to higher-level protocols and userHP’s Paradigm Shift Common Security Services Manager Cssm API Common Security Services Manager CssmCssm Module Information Files Cssmnotlongfilenamesys Dual Asymmetric Key Algorithm Cryptography Service Provider CSP APICryptography Service Provider CSP API Public/Private Key AlgorithmsSymmetric Key Algorithm RC2 or RC4 Authenticating a Digital SignatureCryptography Service Provider CSP API Hash Interaction between CSP and Applications CSP Operations Cryptography Service Provider CSP API Cryptography Service Provider CSP API Supported Functions and Algorithms Extensibility FunctionsCssmalgidcdmf Cssmalgiddsa Cssmalgiddh Purpose Pass-Through ID Outline of a Generic Certiﬁcate Certiﬁcate Library Services CL APIWhat is a Certiﬁcate? Certiﬁcate Library Services CL APICertiﬁcate Revocation List CRL and Operations Interaction between Certiﬁcate Library and Application Interaction between Cssm and Certiﬁcate Library Interface Operations on CertiﬁcatesCertiﬁcate Library Interface Certiﬁcate Library Services CL API Certiﬁcate Library Services CL API Certiﬁcate Library Services CL API INTELX509V3PASSTHROUGHCREATEENCODEDNAME INTELX509V3PASSTHROUGHENCODENAME INTELX509V3PASSTHROUGHENCODEALGID INTELX509V3PASSTHROUGHREADCERTFROMFILE INTELX509V3PASSTHROUGHENCODEREVOKEDCERTLIST INTELX509V3PASSTHROUGHFINDSUPPORTINGCSP INTELX509V3PASSTHROUGHCSSMKEYTOSPKI Role of Add-In Modules in the Cdsa Framework Introduction to Add-in ModulesIntroduction to Add-in Modules Global Unique Identiﬁer Guid Design Criteria for Add-In ModulesInitializer Add-In Module Install Program Code to Register Services with CssmTo Install an Add-In Library How to Create a Cdsa Add-In Module for HP-UX How to Create a Cdsa Add-In Module forLd -b -o libmylib.1 +I MyAddInInit Implementing Integrity Checking in Add-In Modules Programming Self-Check Functions into the Initializer How to Create a Cdsa Add-In Module for HP-UX How to Create a Cdsa Add-In Module for HP-UX How to Create a Cdsa Add-In Module for HP-UX How to Create a Cdsa Add-In Module for HP-UX Typeprocedure How to Create a Cdsa Add-In Module for HP-UX Or specify the following for CL/TP/DL add-ins With a Cssm capable of integrity checking Validating the CSP Credentials Validating the CSP CredentialsCredential File Certiﬁcate ChainVerifying a Certiﬁcate Chain Validation SequenceVerifying the signature on the .SF ﬁle Integrity Check prior to LoadingSHA-1 11 Verifying the validity of the CSP library Self CheckIn-Memory vs. Static Checking Bilateral AuthenticationFurther References Concluding RemarksConcluding Remarks Concluding Remarks Appendix a Sample Install ProgramAppendix a Appendix a Cssmapimemoryfuncs Appendix a Else if argc != Destpath Sample Install Program Appendix a Sample Install Program Appendix B Generating the Credential FileHP Signing Policy for CSP Add-In Vendors for Cdsa Version HP Signing Policy for CSP Add-In Vendors for Cdsa VersionAppendix C Sample Add-in Module CodeAppendix C Appendix C Sample Add-in Module Code Appendix C Cssmreturn = Null Sample Add-in Module Code == Cssmfail Cssmmodulefuncs Appendix C Sample Add-in Module Code Appendix C Sample Add-in Module Code Data 100 Appendix C 101 102 Appendix C 103 104 Appendix D 105 Functions Needed for Add-in Module Integrity106 Appendix E 107 Trouble Shooting HP CdsaCdsa API Errors Cdsa API Errors108 Appendix E 109 110 Appendix E 111 112 Appendix E 113 114 Appendix E 115 116 Appendix E 117 Cdsa Start Up Errors when calling CSSMModuleAttach Cdsa Start Up Errors when calling CSSMModuleAttach118 Appendix E 119 Debugging Core Dumps Using DDE to Debug Cdsa Applications120 Appendix F 121 Migrating to Cdsa122 Appendix F 123 124 DL data structuresAppendix G 125 ZIP format126 Appendix G 127 128 Appendix H 129 Private Key File130 Private Key File Contention

Related manuals

Manual 62 pages 27.73 Kb