/* * $HeadURL: http://svn.apache.org/repos/asf/httpcomponents/httpclient/trunk/module-client/src/main/java/org/apache/http/auth/NTCredentials.java $ * $Revision: 658430 $ * $Date: 2008-05-20 14:04:27 -0700 (Tue, 20 May 2008) $ * * ==================================================================== * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed with * this work for additional information regarding copyright ownership. * The ASF licenses this file to You 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. * ==================================================================== * * This software consists of voluntary contributions made by many * individuals on behalf of the Apache Software Foundation. For more * information on the Apache Software Foundation, please see * <http://www.apache.org/>. * */ package org.apache.http.auth; import java.security.Principal; import java.util.Locale; import org.apache.http.util.LangUtils; /** {@link Credentials} specific to the Windows platform. * * @author <a href="mailto:adrian@ephox.com">Adrian Sutton</a> * @author <a href="mailto:mbowler@GargoyleSoftware.com">Mike Bowler</a> * @author <a href="mailto:oleg at ural.ru">Oleg Kalnichevski</a> * * @since 2.0 */ public class NTCredentials implements Credentials { /** The user principal */ private final NTUserPrincipal principal; /** Password */ private final String password; /** The host the authentication request is originating from. */ private final String workstation; /** * The constructor with the fully qualified username and password combined * string argument. * * @param usernamePassword the domain/username:password formed string */ public NTCredentials(String usernamePassword) { super(); if (usernamePassword == null) { throw new IllegalArgumentException("Username:password string may not be null"); } String username; int atColon = usernamePassword.indexOf(':'); if (atColon >= 0) { username = usernamePassword.substring(0, atColon); this.password = usernamePassword.substring(atColon + 1); } else { username = usernamePassword; this.password = null; } int atSlash = username.indexOf('/'); if (atSlash >= 0) { this.principal = new NTUserPrincipal( username.substring(0, atSlash).toUpperCase(Locale.ENGLISH), username.substring(atSlash + 1)); } else { this.principal = new NTUserPrincipal( null, username.substring(atSlash + 1)); } this.workstation = null; } /** * Constructor. * @param userName The user name. This should not include the domain to authenticate with. * For example: "user" is correct whereas "DOMAIN\\user" is not. * @param password The password. * @param workstation The workstation the authentication request is originating from. * Essentially, the computer name for this machine. * @param domain The domain to authenticate within. */ public NTCredentials( final String userName, final String password, final String workstation, final String domain) { super(); if (userName == null) { throw new IllegalArgumentException("User name may not be null"); } this.principal = new NTUserPrincipal(domain, userName); this.password = password; if (workstation != null) { this.workstation = workstation.toUpperCase(Locale.ENGLISH); } else { this.workstation = null; } } public Principal getUserPrincipal() { return this.principal; } public String getUserName() { return this.principal.getUsername(); } public String getPassword() { return this.password; } /** * Retrieves the name to authenticate with. * * @return String the domain these credentials are intended to authenticate with. */ public String getDomain() { return this.principal.getDomain(); } /** * Retrieves the workstation name of the computer originating the request. * * @return String the workstation the user is logged into. */ public String getWorkstation() { return this.workstation; } @Override public int hashCode() { int hash = LangUtils.HASH_SEED; hash = LangUtils.hashCode(hash, this.principal); hash = LangUtils.hashCode(hash, this.workstation); return hash; } @Override public boolean equals(Object o) { if (o == null) return false; if (this == o) return true; if (o instanceof NTCredentials) { NTCredentials that = (NTCredentials) o; if (LangUtils.equals(this.principal, that.principal) && LangUtils.equals(this.workstation, that.workstation)) { return true; } } return false; } @Override public String toString() { StringBuilder buffer = new StringBuilder(); buffer.append("[principal: "); buffer.append(this.principal); buffer.append("][workstation: "); buffer.append(this.workstation); buffer.append("]"); return buffer.toString(); } }