summaryrefslogtreecommitdiffstats
path: root/eurephiadm/man/eurephiadm-certs.7
blob: 55a9b12ec67b8418a24f23d8e34b672015f406ce (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
.TH "eurephiadm certs" "7" "July 2010" "David Sommerseth" ""
.SH "NAME"
.B eurephiadm-certs \- Certificate management for
.B eurephia
.SH "DESCRIPTION"
Available modes for the certificate command are:
.TP
\fB\-A\fR | \fB\-\-add\fR
Register a new certificate
.TP
\fB\-D\fR | \fB\-\-delete\fR
Delete a registered certificate
.TP
\fB\-l\fR | \fB\-\-list\fR
List all registered certificates
.HP
\fB\-h\fR | \fB\-\-help\fR <mode>
.br
Help about a specific mode
.SH "LIST MODE"
The list mode will list all registered certificates.  It accepts one parameter:
.TP
\fB\-S\fR | \fB\-\-sort\fR <sort key>
Decide the sort order of the certificate list
.PP
Available sort keys are:
.IP
.B certid
 Numeric certificate ID
.IP
.B depth
 Certificate depth
.IP
.B digest
 Certificate SHA1 digest
.IP
.B cname
 Certificate Common Name field
.IP
.B org
 Certificate organisation field
.IP
.B email
 Certificate e\-mail address field
.IP
.B registered
 When the certificate was registered in eurephia.
.SH "ADD MODE"
The add mode will register a new certificate.
.TP
\fB\-d\fR | \fB\-\-depth\fR
Certificate depth, required.
.TP
\fB\-D\fR | \fB\-\-digest\fR
SHA1 fingerprint/digest of the new certificate
.TP
\fB\-C\fR | \fB\-\-common\-name\fR
Common name (CN) field of the certificate
.TP
\fB\-O\fR | \fB\-\-organisation\fR
Organisation (O) field of the certificate
.TP
\fB\-E\fR | \fB\-\-email\fR
e\-mail address (emailAddress) of the certificate
.PP
Usually the certificate depth value needs to be 0, if you are registering user
account certificates. CA certificates usually have a value bigger than 0.
.PP
If you have the certificate file available, you can use the following
options to retrieve the needed information directly from a certificate file.
.TP
\fB\-f\fR | \fB\-\-certfile\fR
File name of the certificate file.
.TP
\fB\-p\fR | \fB\-\-pkcs12\fR
If the file is in PKCS#12 format.
.PP
The default format is PEM format, unless \fB\-\-pkcs12\fR is given.  These two options
cannot be used together with \fB\-D\fR, \fB\-C\fR, \fB\-O\fR or \fB\-E\fR.  But the certificate depth must
be given to indicate the certificate depth.
.SH "DELETE MODE"
The delete mode will remove a certificate from the certificate database.
.TP
\fB\-i\fR | \fB\-\-certid\fR
Indicates a unique certificate ID
.TP
\fB\-d\fR | \fB\-\-digest\fR
A unique SHA1 fingerprint/digest value
.TP
\fB\-C\fR | \fB\-\-common\-name\fR
Common Name (CN) field of a certificate
.TP
\fB\-O\fR | \fB\-\-organisation\fR
Organisation (O) field of a certificate
.TP
\fB\-E\fR | \fB\-\-email\fR
e\-mail address (emailAddress) of a certificate
.PP
You can use any of these parameters to indicate a search criteria for the
certificate (or certificates) you want to delete.  You will be provided with
a list over certificates which matches your search criteria and you will need
to approve the deletion of the matching certificate(s).
.SH "SEE ALSO"
\fBeurephiadm\-users\fR(7),
\fBeurephiadm\-usercerts\fR(7)
.SH "AUTHOR"
Copyright (C) 2008\-2010  David Sommerseth <dazo@users.sourceforge.net>