- java.lang.Object
-
- org.ietf.jgss.MessageProp
-
public class MessageProp extends Object
This is a utility class used within the per-message GSSContext methods to convey per-message properties.When used with the GSSContext interface's wrap and getMIC methods, an instance of this class is used to indicate the desired Quality-of-Protection (QOP) and to request if confidentiality services are to be applied to caller supplied data (wrap only). To request default QOP, the value of 0 should be used for QOP.
When used with the unwrap and verifyMIC methods of the GSSContext interface, an instance of this class will be used to indicate the applied QOP and confidentiality services over the supplied message. In the case of verifyMIC, the confidentiality state will always be
false
. Upon return from these methods, this object will also contain any supplementary status values applicable to the processed token. The supplementary status values can indicate old tokens, out of sequence tokens, gap tokens or duplicate tokens.
-
-
Constructor Summary
Constructors Constructor and Description MessageProp(boolean privState)
Constructor which sets the desired privacy state.MessageProp(int qop, boolean privState)
Constructor which sets the values for the qop and privacy state.
-
Method Summary
Methods Modifier and Type Method and Description int
getMinorStatus()
Retrieves the minor status code that the underlying mechanism might have set for this per-message operation.String
getMinorString()
Retrieves a string explaining the minor status code.boolean
getPrivacy()
Retrieves the privacy state.int
getQOP()
Retrieves the QOP value.boolean
isDuplicateToken()
Tests if this is a duplicate of an earlier token.boolean
isGapToken()
Tests if an expected token was not received, i.e., one or more predecessor tokens have not yet been successfully processed.boolean
isOldToken()
Tests if this token's validity period has expired, i.e., the token is too old to be checked for duplication.boolean
isUnseqToken()
Tests if a later token had already been processed.void
setPrivacy(boolean privState)
Sets the privacy state.void
setQOP(int qop)
Sets the QOP value.void
setSupplementaryStates(boolean duplicate, boolean old, boolean unseq, boolean gap, int minorStatus, String minorString)
This method sets the state for the supplementary information flags and the minor status in MessageProp.
-
-
-
Constructor Detail
-
MessageProp
public MessageProp(boolean privState)
Constructor which sets the desired privacy state. The QOP value used is 0.- Parameters:
privState
- the privacy (i.e. confidentiality) state
-
MessageProp
public MessageProp(int qop, boolean privState)
Constructor which sets the values for the qop and privacy state.- Parameters:
qop
- the QOP valueprivState
- the privacy (i.e. confidentiality) state
-
-
Method Detail
-
getQOP
public int getQOP()
Retrieves the QOP value.- Returns:
- an int representing the QOP value
- See Also:
setQOP(int)
-
getPrivacy
public boolean getPrivacy()
Retrieves the privacy state.- Returns:
- true if the privacy (i.e., confidentiality) state is true, false otherwise.
- See Also:
setPrivacy(boolean)
-
setQOP
public void setQOP(int qop)
Sets the QOP value.- Parameters:
qop
- the int value to set the QOP to- See Also:
getQOP()
-
setPrivacy
public void setPrivacy(boolean privState)
Sets the privacy state.- Parameters:
privState
- true is the privacy (i.e., confidentiality) state is true, false otherwise.- See Also:
getPrivacy()
-
isDuplicateToken
public boolean isDuplicateToken()
Tests if this is a duplicate of an earlier token.- Returns:
- true if this is a duplicate, false otherwise.
-
isOldToken
public boolean isOldToken()
Tests if this token's validity period has expired, i.e., the token is too old to be checked for duplication.- Returns:
- true if the token's validity period has expired, false otherwise.
-
isUnseqToken
public boolean isUnseqToken()
Tests if a later token had already been processed.- Returns:
- true if a later token had already been processed, false otherwise.
-
isGapToken
public boolean isGapToken()
Tests if an expected token was not received, i.e., one or more predecessor tokens have not yet been successfully processed.- Returns:
- true if an expected per-message token was not received, false otherwise.
-
getMinorStatus
public int getMinorStatus()
Retrieves the minor status code that the underlying mechanism might have set for this per-message operation.- Returns:
- the int minor status
-
getMinorString
public String getMinorString()
Retrieves a string explaining the minor status code.- Returns:
- a String corresponding to the minor status
code.
null
will be returned when no minor status code has been set.
-
setSupplementaryStates
public void setSupplementaryStates(boolean duplicate, boolean old, boolean unseq, boolean gap, int minorStatus, String minorString)
This method sets the state for the supplementary information flags and the minor status in MessageProp. It is not used by the application but by the GSS implementation to return this information to the caller of a per-message context method.- Parameters:
duplicate
- true if the token was a duplicate of an earlier token, false otherwiseold
- true if the token's validity period has expired, false otherwiseunseq
- true if a later token has already been processed, false otherwisegap
- true if one or more predecessor tokens have not yet been successfully processed, false otherwiseminorStatus
- the int minor status code for the per-message operationminorString
- the textual representation of the minorStatus value
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-org/ietf/jgss/messageprop.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.