org.apache.ws.security.WSUsernameTokenPrincipal Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of wss4j Show documentation
Show all versions of wss4j Show documentation
The Apache WSS4J project provides a Java implementation of the primary security standards
for Web Services, namely the OASIS Web Services Security (WS-Security) specifications
from the OASIS Web Services Security TC.
/*
* Copyright 2003-2004 The Apache Software Foundation.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package org.apache.ws.security;
import java.security.Principal;
/**
* This class implements the Principal interface and
* represents a UsernameToken user.
* In addition to the principal's name
* this principal object also contains the nonce and created time of the
* UsernameToken (refer to the OASIS WS Security specification, UsernameToken
* profile). These values are set only if the password of UsernameToken was of
* type PasswordDigest.
* Furthermore the password type is
* provided to the application. The password type is the string of the type
* attribute of the password element inside the username token. Refer to the
* OASIS WSS specification for predefined password types. The
* equals() method use the prinicipal's name only and does not
* compare nonce or created time.
* Modelled according to the example provided
* by JAAS documentation
*
*
* @author Davanum Srinivas ([email protected]).
* @author Werner Dittmann ([email protected]).
* @see java.security.Principal
* @see javax.security.auth.Subject
*/
public class WSUsernameTokenPrincipal implements Principal, java.io.Serializable {
/**
* @serial
*/
private String name = null;
private String nonce = null;
private String password = null;
private String createdTime = null;
private String passwordType = null;
private boolean digest = false;
/**
* Create a WSUsernameTokenPrincipal with a WSUsernameToken username.
*
*
* @param name the WSUsernameToken username for this user.
* @throws NullPointerException if the name
* is null.
*/
public WSUsernameTokenPrincipal(String name, boolean digest) {
if (name == null)
throw new NullPointerException("illegal null input");
this.name = name;
this.digest = digest;
}
/**
* Return the WSUsernameToken username for this WSUsernameTokenPrincipal.
*
*
*
* @return the WSUsernameToken username for this WSUsernameTokenPrincipal
*/
public String getName() {
return name;
}
/**
* Return the WSUsernameToken password type for this WSUsernameTokenPrincipal.
*
*
*
* @return true if the password type was PassowrdDigest
*/
public boolean isPasswordDigest() {
return digest;
}
/**
* Set the WSUsernameToken password for this WSUsernameTokenPrincipal.
*
*
*
* @param password
*/
public void setPassword(String password) {
this.password = password;
}
/**
* Return the WSUsernameToken password for this WSUsernameTokenPrincipal.
*
*
*
* @return the WSUsernameToken password for this WSUsernameTokenPrincipal
*/
public String getPassword() {
return password;
}
/**
* Set the WSUsernameToken nonce for this WSUsernameTokenPrincipal.
*
*
*
* @param nonce
*/
public void setNonce(String nonce) {
this.nonce = nonce;
}
/**
* Return the WSUsernameToken nonce for this WSUsernameTokenPrincipal.
*
*
*
* @return the WSUsernameToken nonce for this WSUsernameTokenPrincipal
*/
public String getNonce() {
return nonce;
}
/**
* Set the WSUsernameToken created time for this WSUsernameTokenPrincipal.
*
*
* @param createdTime
*/
public void setCreatedTime(String createdTime) {
this.createdTime = createdTime;
}
/**
* Return the WSUsernameToken created time for this WSUsernameTokenPrincipal.
*
*
* @return the WSUsernameToken created time for this WSUsernameTokenPrincipal
*/
public String getCreatedTime() {
return createdTime;
}
/**
* Return a string representation of this WSUsernameTokenPrincipal.
*
*
* @return a string representation of this WSUsernameTokenPrincipal.
*/
public String toString() {
return ("WSUsernameTokenPrincipal: " + name);
}
/**
* @return Returns the passwordType.
*/
public String getPasswordType() {
return passwordType;
}
/**
* @param passwordType The passwordType to set.
*/
public void setPasswordType(String passwordType) {
this.passwordType = passwordType;
}
/**
* Compares the specified Object with this WSUsernameTokenPrincipal
* for equality. Returns true if the given object is also a
* WSUsernameTokenPrincipal and the two WSUsernameTokenPrincipals
* have the same username.
*
*
*
* @param o Object to be compared for equality with this
* WSUsernameTokenPrincipal.
* @return true if the specified Object is equal equal to this
* WSUsernameTokenPrincipal.
*/
public boolean equals(Object o) {
if (o == null) {
return false;
}
if (this == o) {
return true;
}
if (!(o instanceof WSUsernameTokenPrincipal)) {
return false;
}
WSUsernameTokenPrincipal that = (WSUsernameTokenPrincipal) o;
if (this.getName().equals(that.getName())) {
return true;
}
return false;
}
/**
* Return a hash code for this WSUsernameTokenPrincipal.
*
*
*
* @return a hash code for this WSUsernameTokenPrincipal.
*/
public int hashCode() {
return name.hashCode();
}
}