1 /*
2 Copyright (C) 2008 Grid Systems, S.A. and University of Southampton IT Innovation Centre
3
4 This library is free software; you can redistribute it and/or
5 modify it under the terms of the GNU Lesser General Public
6 License as published by the Free Software Foundation; either
7 version 2.1 of the License, or (at your option) any later version.
8
9 This library is distributed in the hope that it will be useful,
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 Lesser General Public License for more details.
13
14 You should have received a copy of the GNU Lesser General Public
15 License along with this library; if not, write to the Free Software
16 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18 package nextgrid.api.env;
19
20 import java.io.Serializable;
21
22 import org.w3c.dom.Element;
23
24 /**
25 *
26 * @author Nikolaos Matskanis
27 */
28 public interface STSModule extends Serializable {
29
30 /**
31 * Set the group service EPR whose token is required.
32 *
33 * @param groupServiceEPR the EPR of the membership group service
34 */
35 void setMembershipGroup(String groupServiceEPR);
36
37 /**
38 * Makes a request to a security token service.
39 * The security token represents the project that the workflow belongs.
40 *
41 * @return A security token as an XML DOM element
42 * @throws STSFailureException If an error occurs
43 */
44 Element requestSecurityToken() throws STSFailureException;
45
46 }