1 /* |
1 /* |
2 * Copyright 2000-2001 Sun Microsystems, Inc. All Rights Reserved. |
2 * Copyright 2000-2009 Sun Microsystems, Inc. All Rights Reserved. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
4 * |
4 * |
5 * This code is free software; you can redistribute it and/or modify it |
5 * This code is free software; you can redistribute it and/or modify it |
6 * under the terms of the GNU General Public License version 2 only, as |
6 * under the terms of the GNU General Public License version 2 only, as |
7 * published by the Free Software Foundation. Sun designates this |
7 * published by the Free Software Foundation. Sun designates this |
676 * end this method may block on the <code>InputStream</code> if only |
676 * end this method may block on the <code>InputStream</code> if only |
677 * part of the token is available. If the start and end of the token |
677 * part of the token is available. If the start and end of the token |
678 * are not definitive then the method will attempt to treat all |
678 * are not definitive then the method will attempt to treat all |
679 * available bytes as part of the token.<p> |
679 * available bytes as part of the token.<p> |
680 * |
680 * |
681 * Other than the possible blocking behaviour described above, this |
681 * Other than the possible blocking behavior described above, this |
682 * method is equivalent to the byte array based {@link #unwrap(byte[], |
682 * method is equivalent to the byte array based {@link #unwrap(byte[], |
683 * int, int, MessageProp) unwrap} method.<p> |
683 * int, int, MessageProp) unwrap} method.<p> |
684 * |
684 * |
685 * @param inStream an InputStream that contains the wrap token generated |
685 * @param inStream an InputStream that contains the wrap token generated |
686 * by the peer. |
686 * by the peer. |
824 * end this method may block on the <code>InputStream</code> if only |
824 * end this method may block on the <code>InputStream</code> if only |
825 * part of the token is available. If the start and end of the token |
825 * part of the token is available. If the start and end of the token |
826 * are not definitive then the method will attempt to treat all |
826 * are not definitive then the method will attempt to treat all |
827 * available bytes as part of the token.<p> |
827 * available bytes as part of the token.<p> |
828 * |
828 * |
829 * Other than the possible blocking behaviour described above, this |
829 * Other than the possible blocking behavior described above, this |
830 * method is equivalent to the byte array based {@link #verifyMIC(byte[], |
830 * method is equivalent to the byte array based {@link #verifyMIC(byte[], |
831 * int, int, byte[], int, int, MessageProp) verifyMIC} method.<p> |
831 * int, int, byte[], int, int, MessageProp) verifyMIC} method.<p> |
832 * |
832 * |
833 * @param tokStream an InputStream containing the token generated by the |
833 * @param tokStream an InputStream containing the token generated by the |
834 * peer's getMIC method. |
834 * peer's getMIC method. |
915 * doesn't. Therefore, the application should check to see if the |
915 * doesn't. Therefore, the application should check to see if the |
916 * request was honored with the {@link #getMutualAuthState() |
916 * request was honored with the {@link #getMutualAuthState() |
917 * getMutualAuthState} method.<p> |
917 * getMutualAuthState} method.<p> |
918 * |
918 * |
919 * @param state a boolean value indicating whether mutual |
919 * @param state a boolean value indicating whether mutual |
920 * authentication shouls be used or not. |
920 * authentication should be used or not. |
921 * @see #getMutualAuthState() |
921 * @see #getMutualAuthState() |
922 * |
922 * |
923 * @throws GSSException containing the following |
923 * @throws GSSException containing the following |
924 * major error codes: |
924 * major error codes: |
925 * {@link GSSException#FAILURE GSSException.FAILURE} |
925 * {@link GSSException#FAILURE GSSException.FAILURE} |
926 */ |
926 */ |
927 public void requestMutualAuth(boolean state) throws GSSException; |
927 public void requestMutualAuth(boolean state) throws GSSException; |
928 |
928 |
929 /** |
929 /** |
930 * Requests that replay detection be enabled for the |
930 * Requests that replay detection be enabled for the |
931 * per-message security services after context establishemnt. This |
931 * per-message security services after context establishment. This |
932 * request can only be made on the context initiator's side and it has |
932 * request can only be made on the context initiator's side and it has |
933 * to be done prior to the first call to |
933 * to be done prior to the first call to |
934 * <code>initSecContext</code>. During context establishment replay |
934 * <code>initSecContext</code>. During context establishment replay |
935 * detection is not an option and is a function of the underlying |
935 * detection is not an option and is a function of the underlying |
936 * mechanism's capabilities.<p> |
936 * mechanism's capabilities.<p> |
956 */ |
956 */ |
957 public void requestReplayDet(boolean state) throws GSSException; |
957 public void requestReplayDet(boolean state) throws GSSException; |
958 |
958 |
959 /** |
959 /** |
960 * Requests that sequence checking be enabled for the |
960 * Requests that sequence checking be enabled for the |
961 * per-message security services after context establishemnt. This |
961 * per-message security services after context establishment. This |
962 * request can only be made on the context initiator's side and it has |
962 * request can only be made on the context initiator's side and it has |
963 * to be done prior to the first call to |
963 * to be done prior to the first call to |
964 * <code>initSecContext</code>. During context establishment sequence |
964 * <code>initSecContext</code>. During context establishment sequence |
965 * checking is not an option and is a function of the underlying |
965 * checking is not an option and is a function of the underlying |
966 * mechanism's capabilities.<p> |
966 * mechanism's capabilities.<p> |