Module com.aoindustries.aoserv.daemon

Package com.aoindustries.aoserv.daemon.posix

Class ShadowFile

java.lang.Object

com.aoindustries.aoserv.daemon.posix.ShadowFile

public final class ShadowFile
extends Object

Manages access to the /etc/shadow file.

Author:

AO Industries, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	ShadowFile.Entry	Represents one line of the /etc/shadow file on a POSIX server.

Field Summary

Fields

Modifier and Type	Field	Description
static final Object	shadowLock	Locks the shadow file for updates.

Method Summary

Modifier and Type	Method	Description
static byte[]	buildShadowFile(Set<User.Name> usernames)	Builds a new version of the shadow file with necessary adjustments made.
static Tuple2<String,Integer>	getEncryptedPassword(User.Name username)	Gets the encrypted password for one user on the system include the changeDate, if known.
static void	setEncryptedPassword(User.Name username, String encryptedPassword, Integer newChangedDate)	Sets the encrypted password for one user on the system.
static void	setPassword(User.Name username, String plaintext, PosixFile.CryptAlgorithm cryptAlgorithm, boolean updateChangedDate)	Sets the password for one user on the system.
static void	writeShadowFile(byte[] newContents, Set<PosixFile> restorecon)	Must hold shadowLock.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

shadowLock

public static final Object shadowLock

Locks the shadow file for updates.

Method Details

getEncryptedPassword

public static Tuple2<String,Integer> getEncryptedPassword(User.Name username)
                                                   throws IOException,
SQLException

Gets the encrypted password for one user on the system include the changeDate, if known.

If there is no entry for the user in the shadow file, returns (User.NO_PASSWORD_CONFIG_VALUE, null).

Throws:

IOException

SQLException

writeShadowFile

public static void writeShadowFile(byte[] newContents,
 Set<PosixFile> restorecon)
                            throws SQLException,
IOException

Must hold shadowLock.

Throws:

SQLException

IOException

buildShadowFile

public static byte[] buildShadowFile(Set<User.Name> usernames)
                              throws IOException

Builds a new version of the shadow file with necessary adjustments made.

Must hold shadowLock.

Throws:

IOException

setEncryptedPassword

public static void setEncryptedPassword(User.Name username,
 String encryptedPassword,
 Integer newChangedDate)
                                 throws IOException,
SQLException

Sets the encrypted password for one user on the system. This password must already be hashed.

This method is synchronized with doRebuild to ensure that passwords are never lost during updates.

Parameters:

newChangedDate - The new changeDate or null to not alter

Throws:

IOException

SQLException

See Also:

• PosixFile.crypt(java.lang.String, com.aoapps.io.posix.PosixFile.CryptAlgorithm)

setPassword

public static void setPassword(User.Name username,
 String plaintext,
 PosixFile.CryptAlgorithm cryptAlgorithm,
 boolean updateChangedDate)
                        throws IOException,
SQLException

Sets the password for one user on the system.

Throws:

IOException

SQLException