org.eclipse.jetty.setuid

Class SetUIDServer

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.handler.AbstractHandler

org.eclipse.jetty.server.handler.AbstractHandlerContainer

org.eclipse.jetty.server.handler.HandlerWrapper

org.eclipse.jetty.server.Server

org.eclipse.jetty.setuid.SetUIDServer

All Implemented Interfaces:

org.eclipse.jetty.server.Handler, org.eclipse.jetty.server.HandlerContainer, org.eclipse.jetty.util.Attributes, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.LifeCycle

Deprecated.

@Deprecated
public class SetUIDServer
extends org.eclipse.jetty.server.Server

This extension of Server will make a JNI call to set the unix UID. This can be used to start the server as root so that privileged ports may be accessed and then switch to a non-root user for security. Depending on the value of setStartServerAsPrivileged(boolean), either the server will be started and then the UID set; or the Server.getConnectors() will be opened with a call to Connector#open(), the UID set and then the server is started. The later is the default and avoids any webapplication code being run as a privileged user, but will not work if the application code also needs to open privileged ports.

The configured umask is set before the server is started and the configured uid is set after the server is started.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

org.eclipse.jetty.util.component.LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

_handler

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
SetUIDServer() Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doStart() Deprecated.
int	getGid() Deprecated.
String	getGroupname() Deprecated.
RLimit	getRLimitNoFiles() Deprecated.
int	getUid() Deprecated.
int	getUmask() Deprecated.
String	getUmaskOctal() Deprecated.
String	getUsername() Deprecated.
boolean	isStartServerAsPrivileged() Deprecated.
void	setGid(int gid) Deprecated.
void	setGroupname(String groupname) Deprecated.
void	setRLimitNoFiles(RLimit rlimit) Deprecated.
void	setStartServerAsPrivileged(boolean startContextsAsPrivileged) Deprecated.
void	setUid(int uid) Deprecated.
void	setUmask(int umask) Deprecated.
void	setUmaskOctal(String umask) Deprecated.
void	setUsername(String username) Deprecated.

Methods inherited from class org.eclipse.jetty.server.Server

addConnector, clearAttributes, doStop, dump, getAttribute, getAttributeNames, getConnectors, getDateField, getSessionIdManager, getStopAtShutdown, getThreadPool, getURI, getVersion, handle, handleAsync, handleOptions, isDumpAfterStart, isDumpBeforeStop, join, main, removeAttribute, removeConnector, setAttribute, setConnectors, setDumpAfterStart, setDumpBeforeStop, setSessionIdManager, setStopAtShutdown, start, toString

Methods inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

destroy, expandChildren, getHandler, getHandlers, handle, setHandler, setServer

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandlerContainer

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

dumpThis, getServer

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, contains, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, stop, unmanage, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Constructor Detail

SetUIDServer

public SetUIDServer()

Deprecated.

Method Detail

setUsername

public void setUsername(String username)

Deprecated.

getUsername

public String getUsername()

Deprecated.

setGroupname

public void setGroupname(String groupname)

Deprecated.

getGroupname

public String getGroupname()

Deprecated.

getUmask

public int getUmask()

Deprecated.

getUmaskOctal

public String getUmaskOctal()

Deprecated.

setUmask

public void setUmask(int umask)

Deprecated.

setUmaskOctal

public void setUmaskOctal(String umask)

Deprecated.

getUid

public int getUid()

Deprecated.

setUid

public void setUid(int uid)

Deprecated.

setGid

public void setGid(int gid)

Deprecated.

getGid

public int getGid()

Deprecated.

setRLimitNoFiles

public void setRLimitNoFiles(RLimit rlimit)

Deprecated.

getRLimitNoFiles

public RLimit getRLimitNoFiles()

Deprecated.

doStart

protected void doStart()
                throws Exception

Deprecated.

Overrides:

doStart in class org.eclipse.jetty.server.Server

Throws:

Exception

isStartServerAsPrivileged

public boolean isStartServerAsPrivileged()

Deprecated.

Returns:

the startServerAsPrivileged

setStartServerAsPrivileged

public void setStartServerAsPrivileged(boolean startContextsAsPrivileged)

Deprecated.

Parameters:

startContextsAsPrivileged - if true, the server is started and then the process UID is switched. If false, the connectors are opened, the UID is switched and then the server is started.