1VOMS::Lite::MyProxy(3)User Contributed Perl DocumentationVOMS::Lite::MyProxy(3)
2
3
4
6 VOMS::Lite::MyProxy - Perl extension for MyProxy server interaction
7
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
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
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
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.32.1 2021-01-27 VOMS::Lite::MyProxy(3)