109 lines
3.5 KiB
Java
109 lines
3.5 KiB
Java
/*
|
|
* Copyright (c) 2000, 2012, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
package sun.security.jgss.spi;
|
|
|
|
import org.ietf.jgss.*;
|
|
import java.security.Provider;
|
|
|
|
/**
|
|
* This interface is implemented by a mechanism specific credential
|
|
* element. A GSSCredential is conceptually a container class of several
|
|
* credential elements from different mechanisms.
|
|
*
|
|
* @author Mayank Upadhyay
|
|
*/
|
|
public interface GSSCredentialSpi {
|
|
|
|
public Provider getProvider();
|
|
|
|
/**
|
|
* Called to invalidate this credential element and release
|
|
* any system recourses and cryptographic information owned
|
|
* by the credential.
|
|
*
|
|
* @exception GSSException with major codes NO_CRED and FAILURE
|
|
*/
|
|
public void dispose() throws GSSException;
|
|
|
|
/**
|
|
* Returns the principal name for this credential. The name
|
|
* is in mechanism specific format.
|
|
*
|
|
* @return GSSNameSpi representing principal name of this credential
|
|
* @exception GSSException may be thrown
|
|
*/
|
|
public GSSNameSpi getName() throws GSSException;
|
|
|
|
/**
|
|
* Returns the init lifetime remaining.
|
|
*
|
|
* @return the init lifetime remaining in seconds
|
|
* @exception GSSException may be thrown
|
|
*/
|
|
public int getInitLifetime() throws GSSException;
|
|
|
|
|
|
/**
|
|
* Returns the accept lifetime remaining.
|
|
*
|
|
* @return the accept lifetime remaining in seconds
|
|
* @exception GSSException may be thrown
|
|
*/
|
|
public int getAcceptLifetime() throws GSSException;
|
|
|
|
/**
|
|
* Determines if this credential element can be used by a context
|
|
* initiator.
|
|
* @return true if it can be used for initiating contexts
|
|
*/
|
|
public boolean isInitiatorCredential() throws GSSException;
|
|
|
|
/**
|
|
* Determines if this credential element can be used by a context
|
|
* acceptor.
|
|
* @return true if it can be used for accepting contexts
|
|
*/
|
|
public boolean isAcceptorCredential() throws GSSException;
|
|
|
|
/**
|
|
* Returns the oid representing the underlying credential
|
|
* mechanism oid.
|
|
*
|
|
* @return the Oid for this credential mechanism
|
|
* @exception GSSException may be thrown
|
|
*/
|
|
public Oid getMechanism();
|
|
|
|
/**
|
|
* Impersonates another client.
|
|
*
|
|
* @param name the client to impersonate
|
|
* @return the new credential
|
|
* @exception GSSException may be thrown
|
|
*/
|
|
public GSSCredentialSpi impersonate(GSSNameSpi name) throws GSSException;
|
|
}
|