class twisted.conch.interfaces.ISessionSetEnv(Interface): (source)
A session that can set environment variables.
| Method | setEnv | Set an environment variable for the shell or command to be started. |
Set an environment variable for the shell or command to be started.
From RFC 4254, section 6.4: "Uncontrolled setting of environment variables in a privileged process can be a security hazard. It is recommended that implementations either maintain a list of allowable variable names or only set environment variables after the server process has dropped sufficient privileges."
(OpenSSH refuses all environment variables by default, but has an AcceptEnv configuration option to select specific variables to accept.)
| Parameters | name | The name of the environment variable to set. (type: bytes) |
| value | The value of the environment variable to set. (type: bytes) | |
| Raises | EnvironmentVariableNotPermitted | if setting this environment variable is not permitted. |