2362N/A * Copyright (c) 2000, 2003, Oracle and/or its affiliates. All rights reserved. 0N/A * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 0N/A * This code is free software; you can redistribute it and/or modify it 0N/A * under the terms of the GNU General Public License version 2 only, as 2362N/A * published by the Free Software Foundation. Oracle designates this 0N/A * particular file as subject to the "Classpath" exception as provided 2362N/A * by Oracle in the LICENSE file that accompanied this code. 0N/A * This code is distributed in the hope that it will be useful, but WITHOUT 0N/A * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 0N/A * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 0N/A * version 2 for more details (a copy is included in the LICENSE file that 0N/A * accompanied this code). 0N/A * You should have received a copy of the GNU General Public License version 0N/A * 2 along with this work; if not, write to the Free Software Foundation, 0N/A * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 2362N/A * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 2362N/A * or visit www.oracle.com if you need additional information or have any 0N/A * GSS-API Utilities for using in conjunction with Sun Microsystem's 0N/A * implementation of Java GSS-API. 0N/A * Use this method to convert a GSSName and GSSCredential into a 0N/A * Subject. Typically this would be done by a server that wants to 0N/A * impersonate a client thread at the Java level by setting a client 0N/A * Subject in the current access control context. If the server is merely 0N/A * interested in using a principal based policy in its local JVM, then 0N/A * it only needs to provide the GSSName of the client. 0N/A * The elements from the GSSName are placed in the principals set of this 0N/A * Subject and those from the GSSCredential are placed in the private 0N/A * credentials set of the Subject. Any Kerberos specific elements that 0N/A * are added to the subject will be instances of the standard Kerberos 0N/A * implementation classes defined in javax.security.auth.kerberos. 0N/A * @return a Subject with the entries that contain elements from the 0N/A * given GSSName and GSSCredential. 0N/A * @param principals a GSSName containing one or more mechanism specific 0N/A * representations of the same entity. These mechanism specific 0N/A * representations will be populated in the returned Subject's principal 0N/A * @param credentials a GSSCredential containing one or more mechanism 0N/A * specific credentials for the same entity. These mechanism specific 0N/A * credentials will be populated in the returned Subject's private 0N/A * credential set. Passing in a value of null will imply that the private 0N/A * credential set should be left empty.