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

NAME

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

SYNOPSIS

9         use VOMS::Lite::MyProxy;
10         use VOMS::Lite::REQ;
11         %Result= %{ VOMS::Lite::MyProxy::Init(
12                       {
13                           Server => "myproxy.grid-support.ac.uk",
14                         CertFile => "/home/fred/.globus/usercert.pem",
15                          KeyFile => "/home/fred/.globus/userkey.pem",
16                         Username => "Freds7DayCert",
17                         Password => "A Good Secret"
18                       }
19                     )
20                   };
21
22         %Proxy= %{ VOMS::Lite::MyProxy::Get(
23                      {
24                          Server => "myproxy.grid-support.ac.uk",
25                        Username => "Freds7DayCert",
26                        Password => "A Good Secret"
27                      }
28                    )
29                  };
30

DESCRIPTION

32       VOMS::Lite::MyProxy contains two subroutines, Get which offers a
33       simplistic myproxy-get-delegation, and Init which offers a simplistic
34       myproxy-init operation.
35
36       i.e. 'Init' delegates a proxy to a myproxy server and 'Get' asks the
37       server to delegate a proxy to it.
38
39   VOMS::Lite::MyProxy::Init
40       VOMS::Lite::MyProxy::Init takes one argument, an anonymous hash
41       containing all the relevant information required to delegate a Proxy to
42       a MyProxy Server.
43
44         In the Hash the following scalars should be defined:
45         'Server'   the myproxy server's FQDN e.g. myproxy.grid-support.ac.uk
46         'CertFile' the path to the file containing the certificate to be delegated
47         'KeyFile'  the path to the file containing the private key associated with the certificate
48         'Username' the username to identify the delegated credential on the MyProxy server
49         'Password' the passphrase to protect the delegated credential on the MyProxy server
50
51           Optionally 'Cert' and 'Key' can be specified instead of CertFile and KeyFile
52           where these scalars contain the DER encoded certificate and key respectively.
53
54         The following may also be defined
55
56         'Lifetime' the lifetime in seconds that the delegated credential is to have.
57         'AC' a DER encoded Attribute Certificate to place within the proxy certificate.
58
59       The return value is a reference to a hash containing
60          Username, Password, Lifetime, Server, Port,
61          Warnings => Reference to an array (A proxy will be delegated despite
62       warnings)
63          Errors => Reference to an array (It was not possible to delegate a
64       proxy)
65          ProxyCert => A copy of the GSI proxy certificate delegated to the
66       MyProxy Server DER encoded
67
68   VOMS::Lite::MyProxy::Get
69       VOMS::Lite::MyProxy::Init takes one argument, an anonymous hash
70       containing all the relevant information required to delegate a Proxy to
71       a MyProxy Server.
72
73         In the Hash the following scalars should be defined:
74         'Server'   the myproxy server's FQDN e.g. myproxy.grid-support.ac.uk
75         'CertFile' the path to the file containing the certificate to be delegated
76         'KeyFile'  the path to the file containing the private key associated with the certificate
77         'Username' the username to identify the delegated credential on the MyProxy server
78         'Password' the passphrase to protect the delegated credential on the MyProxy server
79
80           Optionally 'Cert' and 'Key' can be specified instead of CertFile and KeyFile
81           where these scalars contain the DER encoded certificate and key respectively.
82
83         The following may also be defined
84
85         'Lifetime' the lifetime in seconds that the delegated credential is to have.
86         'AC' a DER encoded Attribute Certificate to place within the proxy certificate.
87
88       The return value is a reference to a hash containing
89
90          CertChain     a reference to an array containing the certificate chain DER encoded
91          Key           the DER encoded Key
92          Warnings      a reference to an array containing any warnings
93          Errors        a reference to an array containing any errors.
94                        If there were errors there will be no CertChain or Key
95
96   EXPORT
97       None by default;
98

SEE ALSO

100       GFD-E.054 The MyProxy Protocol
101       http://www.gridforum.org/documents/GFD.54.pdf
102
103       The MyProxy Website http://grid.ncsa.uiuc.edu/myproxy/
104
105       This module was originally designed for the SHEBANGS and SARoNGS
106       project at The University of Manchester.
107       http://www.rcs.manchester.ac.uk/projects/shebangs/
108       http://www.rcs.manchester.ac.uk/projects/sarongs/
109
110       Mailing list, SARONGS-DISCUSS@jiscmail.ac.uk
111
112       Mailing list, shebangs@listserv.manchester.ac.uk
113
114       Mailing list, voms-lite@listserv.manchester.ac.uk
115

AUTHOR

117       Mike Jones <mike.jones@manchester.ac.uk>
118

120       Copyright (C) 2006 by Mike Jones
121
122       This library is free software; you can redistribute it and/or modify it
123       under the same terms as Perl itself, either Perl version 5.8.3 or, at
124       your option, any later version of Perl 5 you may have available.
125
126
127
128perl v5.12.3                      2011-03-17            VOMS::Lite::MyProxy(3)
Impressum