1VOMS::Lite::REQ(3)    User Contributed Perl Documentation   VOMS::Lite::REQ(3)
2
3
4

NAME

6       VOMS::Lite::REQ - Perl extension for PKCS #10 Certificate Request
7       creation
8

SYNOPSIS

10         use VOMS::Lite::REQ;
11         %REQ= %{ VOMS::Lite::REQ::Create(
12                                           {
13                                             DN => ["C=GB","CN=my common name"],
14                                             subjectAltName => ["rfc822Name=my.email@address.com"]
15                                           }
16                                        )
17                };
18
19         %REQ= %{ VOMS::Lite::REQ::Examine(
20                                            {
21                                              SubjectDN => "",
22                                            }
23                                          )
24                };
25       =head1 DESCRIPTION
26
27       VOMS::Lite::REQ is primarily for internal use.  But frankly I don't
28       mind if you use this package directly :-)
29
30   VOMS::Lite::REQ::Create
31       VOMS::Lite::REQ::Create takes one argument, an anonymous hash
32       containing all the relevant information required to make the X509
33       Certificate.
34
35         In the Hash the following scalars should be defined:
36         'DN'     the array of attribute=value strings that make up the
37            Distinguished Name
38
39         The following may also be defined
40
41         'Cert' the DER encoding of the issuing (CA) certificate.
42         'Key'  the DER encoding of the issuing (CA) key.
43         'Bits' the size of the key can be any of 512,1024,2048,4096
44
45         'subjectAltName' a reference to an Array of Generalnames e.g.
46                   [ 'rfc822Name=mike.jones@manchester.ac.uk',
47                     'dNSName=a.dns.fqdn',
48                     'directoryName=300f310d300b060355040313044d696b65',
49                        # The hex can also be specified as unsigned chars
50                     'uniformResourceIdentifier=http://www.mc.manchester.ac.uk/projects/shebangs/',
51                     'IPAddress=\202\130\001\202\377\377\377\377' ]
52
53       The return value is a hash containing the Certificate request and Key
54       strings in DER format (Req and Key), a reference to an array of
55       'Warnings' (a request will still be created if warnings are present)
56       and a reference to an array of 'Errors' (if an error is encountered
57       then no Proxy will be produced).
58
59   VOMS::Lite::REQ::Examine
60       VOMS::Lite::REQ::Examine takes two arguments: the DER encoded
61       certificate request and a hash of the required information.  If defined
62       in the hash of the first element in the call to Examine the following
63       variables will be parsed from the certificate and returned in the
64       return hash.
65         Chuncks of DER encoded data directly from the certificate:
66         'REQversion'                - DER encoded version
67         'REQsubject'                - DER encoded subject
68         'REQsubjectPublicKeyInfo'   - DER encoded subject Public Key Info
69         'REQattributes'             - DER encoded attributes
70         'REQSignatureAlgorithm'     - DER encoded Signature algorithem
71         'REQSignatureValue'         - DER encoded Signature value
72
73         Other useful values:
74         'SubjectDN'                 - Subject's DN string, slash seperated
75                                       representation (yuk)
76         'KeypublicExponent'         - hex 2's complement integer string
77                                       e.g. '10001' = 65537
78         'Keymodulus'                - hex 2's complement integer string
79         'SignatureValue'            - hex 2's complement integer string
80         'SignatureType'             - one of 'md5WithRSA' 'sha1WithRSA'
81                                       'md4WithRSA' 'md2WithRSA'
82
83   EXPORT
84       None by default;
85

SEE ALSO

87       PKCS #10: Certification Request Syntax Specification
88       http://tools.ietf.org/html/2986
89
90       This module was originally designed for the SHEBANGS project at The
91       University of Manchester.
92       http://www.mc.manchester.ac.uk/projects/shebangs/ now
93       http://www.rcs.manchester.ac.uk/research/shebangs/
94
95       Mailing list, shebangs@listserv.manchester.ac.uk
96
97       Mailing list, voms-lite@listserv.manchester.ac.uk
98

AUTHOR

100       Mike Jones <mike.jones@manchester.ac.uk>
101

103       Copyright (C) 2006 2009 by Mike Jones
104
105       This library is free software; you can redistribute it and/or modify it
106       under the same terms as Perl itself, either Perl version 5.8.3 or, at
107       your option, any later version of Perl 5 you may have available.
108
109
110
111perl v5.12.3                      2011-03-17                VOMS::Lite::REQ(3)
Impressum