Title: FtpServer Managing users
Notice:    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.


# Managing users

Since FtpServer user manager might encrypt user passwords before saving them, manually administering the user database can be hard. There is basically three ways:

## Manually

Using either the PropertiesUserManager or DbUserManager you can access the data store (file or database) directly to edit users. For clear text passwords you can simply edit them. For MD5 hashed passwords, you can you use any of the available MD5 tools, for example <http://www.iwebtool.com/md5>, to hash the password before editing it. For salted passwords, use one of the methods described below.

## Using the API

Using the FtpServer API, you can create a user manager, configure it as your real user manager and use that to edit users. This is a simple example:

	PropertiesUserManagerFactory userManagerFactory = new PropertiesUserManagerFactory();
	userManagerFactory.setFile(new File(&quot;myusers.properties&quot;));
	userManagerFactory.setPasswordEncryptor(new SaltedPasswordEncryptor());
	UserManager um = userManagerFactory.createUserManager();
	BaseUser user = new BaseUser();
	user.setName(&quot;myNewUser&quot;);
	user.setPassword(&quot;secret&quot;);
	user.setHomeDirectory(&quot;ftproot&quot;);
	um.save(user);

## Using command line tool

If you're using the XML configuratio, there is a command line tool available for adding new users to your user manager.

In the examples below, make sure you update the versions to reflect the correct versions for your release

Windows:

	java -cp ftpserver-core-1.0.0-M4.jar;ftplet-api-1.0.0-M4.jar;mina-core-2.0.0-M3.jar; 
		[slf4j-api-1.5.2.jar;<br>slf4j-simple-1.5.2.jar 
		[ org.apache.ftpserver.main.AddUser path/to/your/config.xml

MacOS/Linux/Unix

	java -cp ftpserver-core-1.0.0-M4.jar:ftplet-api-1.0.0-M4.jar:mina-core-2.0.0-M3.jar:\
		slf4j-api-1.5.2.jar:<br>slf4j-simple-1.5.2.jar \
		org.apache.ftpserver.main.AddUser path/to/your/config.xml

The program will ask you for the required data.