OpenCA Guides for 0.9.2+

Table of Contents

Introduction

I. Installation and Configuration Guide

Preface

1. Installation

1. Preparations

1.1. Software

1.2. Hardware

2. Configure

2.1. Host System Configuration

2.2. Filesystem paths

2.3. Webserver specific stuff

2.4. Email

2.5. Compiling features

2.6. Hierarchy Level

3. Installation

4. config.xml (for RPMs and DEBs too)

4.1. Configuration sections of config.xml

4.2. How to setup two management interfaces on one server?

2. Configuration

1. Access Control

1.1. Channel verification

1.2. Login

1.3. Session management

1.4. ACLs

2. Token and keyconfiguration

2.1. OpenSSL

2.2. Empty

2.3. LunaCA3

3. OpenSSL

3.1. Certificate Extensions

3.2. Profiles

4. CSRs

4.1. Additional Attributes

4.2. PKCS#10 Requests

4.3. Basic CSR

4.4. SCEP

5. Subject

5.1. Common stuff

5.2. dc style

6. Subject Alternative Name

7. LDAP

7.1. Configuration of the Directory

7.2. Configuration of the RA components

7.3. Writing Certifciates to the Directory

8. SCEP

8.1. OPENCADIR/etc/servers/scep.conf

8.2. OPENCADIR/etc/config.xml

9. Dataexchange

9.1. Configuration

9.2. Adding a new node

II. User Guide

Preface

3. Interface Descriptions

1. Public PKI Server

1.1. CA

1.2. User

1.3. Certificates

1.4. Requests

2. Registration Authority

2.1. Administration

2.2. Pending Requests

2.3. Information

2.4. Utilites

3. Registration Authority Node

3.1. Gateways

3.2. Administration

3.3. Utilites

4. LDAP Interface

4.1. Update LDAP

4.2. View CA-Certificates

4.3. View Certificates

4.4. View CRLs

4. Functionality Descriptions

1. CA Initialization

1.1. Phase I: Initialize the Certification Authority

1.2. Phase II and III: Create the initial administrator and RA certificate

2. CSR Handling - a request HOWTO

2.1. Ways to request a certificate

2.2. Edit a certificate signing requests

2.3. Approve certificate signing requests

2.4. Issue a certificate from a certificate signing request

2.5. Certificate enrollment

2.6. Delete certificate signing requests

3. Certificate Handling

3.1. Find a certificate

3.2. Download

3.3. Start revocation

3.4. Write an email to the owner

3.5. Informations and their meaning

4. SCEP

4.1. SSCEP

4.2. NetScreen ScreenOS

4.3. F-Secure VPN+

III. Design Guide

Preface

5. General Design

1. Basic Hierarchy

2. Interfaces

2.1. Node

2.2. CA

2.3. RA

2.4. LDAP

2.5. Pub

3. Configuration

4. Database

5. Interface

6. Lifecycle of the objects

7. Sub-Ca

7.1. Example 1

7.2. Example 2

6. Recommendations

1. Hardware Issues

1.1. Computers

1.2. Buildings

2. Network Issues

3. Certificate Issues

4. Organizational Aspects

IV. Technology Guide

Preface

7. Introduction

1. Slotechnology

8. XML

9. Cryptolayer

10. Accesscontrol

11. Logging

12. Webinterfaces

1. Interfacebuilding

1.1. HTML

1.2. cmds

1.3. configuration files

1.4. configure_etc.sh

2. CSS

3. Configuration after installation

13. Hierarchy

1. Nodemanagement

2. Dataexchange

14. LDAP

1. supported options

2. LDAP schema specification

2.1. Used objectclasses

2.2. Supported attributes

2.3. Common definitions for distinguished names

2.4. Special definitions for user certificates

3. Sourcecodeorganization

3.1. Structure of the code

3.2. The relevant commands

3.3. export-import.lib

3.4. ldap-utils.lib

15. Software Design (legacy from design guide)

1. Database(s)

2. Interface construction

3. openca.cgi

4. libraries

5. modules

6. commands

7. Dataexchange and Node management

A. FAQ

1. General PKI Issues

1.1. What is a certificate?

1.2. Which informations does a certificate contain?

1.3. What is a request?

1.4. Which information does a CSR contain?

1.5. What is a CA?

1.6. Why should I not place the CA on the same machine like the RA?

1.7. What is an extensions?

1.8. I use Windows 2000 and Internet Explorer 6 SP1 and it don't show any CSPs.

1.9.

2. General OpenCA Issues

2.1. Does it be possible to revoke a certificate without any user interaction?

2.2. I try to add a role and get the message The role XYZ exists already!

2.3. All cryptographic operations fail.

2.4. Apache's error_log reports a nonexistent option -subj of openssl req

2.5. Apache's error_log contains a message from IBM DB2 that the environment is not setted

2.6. What do the new features of 0.9.2 be?

2.7. I try to approve and sign a request with Mozilla and it fails.

2.8. I try to approve and sign a request with Konqueror (KDE) and it fails.

2.9. How is the format of the disc to import the CA certificate from the root CA?

3. Configuration Issues

3.1. What is a hierarchy level?

3.2. How can I configure my httpd.conf for virtual hosts?

3.3. How can I configure virtual hosts with ./configure?

3.4. I have some users which should not be published in LDAP. Does it be possible with OpenCA?

3.5. Does it be possible to authenticate users by their certificates at the apache before they will be authenticated by OpenCA itself?

3.6. I want update to 0.9.2. How can I update my sql database?

3.7. If I run openca-ocspd then I obtain a segmentation fault.

3.8. I installed a second public interface, run configure_etc.sh and now are all the paths in the other public interface wrong.

3.9. I issue a certificate for a mailserver but sendmail doesn't work and reports an errormessage which includes reason=unsupported certificate purpose

3.10. My (Microsoft) client hangs after it tries to start a secured connection

3.11. Outlook freezes when receiving a signed Mail but worked already fine for some days

3.12. During the request generation OpenCA fails and reports a too short textfield

3.13. Can I place my organization's logo on the web interface?

4. Access Control problems

4.1. Error 6251023: Aborting connection - you are using a wrong channel

4.2. Error 6251026: Aborting connection - you are using a wrong security protocol

4.3. Error 6251029: Aborting connection - you are using the wrong computer

4.4. Error 6251033: Aborting connection - you are using a wrong asymmetric cipher

4.5. Error 6251036: Aborting connection - you are using a too short asymmetric keylength

4.6. Error 6251039: Aborting connection - you are using a wrong symmetric cipher

4.7. Error 6251043: Aborting connection - you are using a too short symmetric keylength

5. Dataexchange

5.1. I try to export something but I get error 512 permission denied for /dev/fd0

5.2. I try to import the CA certificate but it doesn't work.

5.3. I crashed the database of the online server and now I want to import all data again. How can I do it?

5.4. I try to export the requests to the CA but it doesn't work

6. LDAP

6.1. Errormessage: Connection refused.

6.2. Errormessage: Bind failed. Errorcode 49.

6.3. The resultcode of the nodeinsertion was 65.

6.4. How can I get more debugging messages from OpenCA's LDAP code?

6.5. How can I get more debugging messages from OpenLDAP?

Bibliography

Glossary