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

NAME

6       VOMS::Lite::VOMS - Perl extension for gLite VOMS server interaction
7

SYNOPSIS

9         use VOMS::Lite::VOMS;
10
11         $ref = VOMS::Lite::VOMS::Get( { Server => "voms.ngs.ac.uk",
12                                           Port => 15010,
13                                          FQANs => [ "ngs.ac.uk", "ngs.ac.uk/Role=Operations" ],
14                                       Lifetime => 86400,
15                                         CAdirs => "/path/to/CA/certificates",
16                                           Cert => [ $DERCert,
17                                                     $DERCertSigner,
18                                                     $DERCertSignerSigner, ... ],
19                                            Key => $DERKey } );
20
21         $AC       = ${ $ref }{'ac'};             # Contains PEM Encoded Attribute Certificate
22         @Errors   = @{ ${ $ref }{'Errors'} };    # An error if encountered will stop the processing
23         @Warnings = @{ ${ $ref }{'Warnings'} };  # A warning is not fatal and if no error occurs ${ $ref }{'ac'} will be set
24
25
26         VOMS::Lite::VOMS::Server - Now Implemented but experimental and undocumented
27

DESCRIPTION

29         Lightweight library to obtain a VOMS attribute certificate from a VOMS server (NOT the VOMS-Admin-Server).
30
31         Input parameters:
32           Server      Scalar: Fully Quallified Server Name (It's certificate commonName will be checked aganist this)
33           Port        Scalar: The port where the vomsd for this VO is running
34                       usually something like 15 thousand and something
35           FQANs       Reference to an array: Fully Qualified Attribute Names
36           Lifetime    Scalar: Number of seconds to ask the VOMS server to issue the AC for
37           CAdirs      Scalar: ':' delimited paths to CA certificates/signers
38                  -or- Reference to array of paths to CA certificates/signers
39           Cert        Scalar: DER formatted certificate/proxy certificate
40                  -or- Reference to array: DER formatted certificates/proxy certificates
41           Key         Scalar: DER formatted Private Key
42
43           CertFile and KeyFile may be specified instead of Cert and Key
44           in which case these must be PEM formatted.
45
46         Returns a reference to a hash containing
47           ac          Scalar: PEM encoded Attribute certificate
48           Warnings    Reference to an array: warnings encountered
49           Errors      Reference to an array: Errors encountered
50
51         For deep Debugging set
52           $VOMS::Lite::VOMS::DEBUG='yes';
53
54   EXPORT
55       None.
56

Also See

58       https://twiki.cnaf.infn.it/cgi-bin/twiki/view/VOMS/VOMSProtocol (NB
59       Command "M" should read "N")
60       http://glite.cvs.cern.ch/cgi-bin/glite.cgi/org.glite.security.voms
61
62       RFC3281 and the VOMS Attribute Specification document from the OGSA
63       Athuz Workin g Group of the Open Grid Forum http://www.ogf.org.  Also
64       see gLite from the EGEE.
65
66       RFC3548 for Base64 encoding
67
68       This module was originally designed for the JISC funded SARoNGS project
69       at developed at The University of Manchester.
70       http://www.rcs.manchester.ac.uk/projects/shebangs/
71

AUTHOR

73       Mike Jones <mike.jones@manchester.ac.uk>
74

76       Copyright (C) 2009 by Mike Jones
77
78       This library is free software; you can redistribute it and/or modify it
79       under the same terms as Perl itself, either Perl version 5.8.3 or, at
80       your option, any later version of Perl 5 you may have available.
81
82
83
84perl v5.12.3                      2011-03-17               VOMS::Lite::VOMS(3)
Impressum