com.dtolabs.rundeck.plugin.overthere

Class OTWinRMNodeExecutor

java.lang.Object

com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor

All Implemented Interfaces:

com.dtolabs.rundeck.core.execution.service.NodeExecutor, com.dtolabs.rundeck.core.plugins.configuration.Describable

public class OTWinRMNodeExecutor
extends java.lang.Object
implements com.dtolabs.rundeck.core.execution.service.NodeExecutor, com.dtolabs.rundeck.core.plugins.configuration.Describable

Executes a command via WinRM. Subclass to extend, there are places to alter the generation of user@realm, and to alter the password resolution mechanism. See getKerberosUsername(com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConnectionOptionsBuilder) and getClearAuthPassword(com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConnectionOptionsBuilder). The connection options can be altered as well by overriding willUseConnectionOptions(com.xebialabs.overthere.ConnectionOptions).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	OTWinRMNodeExecutor.ConnectionOptionsBuilder
static class	OTWinRMNodeExecutor.Reason

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	AUTH_TYPE_BASIC
static java.lang.String	AUTH_TYPE_KERBEROS
static java.lang.String	CERT_TRUST_ALL
static java.lang.String	CERT_TRUST_DEFAULT
static java.lang.String	CERT_TRUST_SELF_SIGNED
static java.lang.String	CONFIG_AUTHENTICATION
static java.lang.String	CONFIG_CERT_TRUST
static java.lang.String	CONFIG_HOSTNAME_VERIFY
static java.lang.String	CONFIG_LOCALE
static java.lang.String	CONFIG_PROTOCOL
static java.lang.String	CONFIG_SPN_ADD_PORT
static java.lang.String	CONFIG_SPN_USE_HTTP
static java.lang.String	CONFIG_WINRM_TIMEOUT
static java.lang.String	DEBUG_KERBEROS_AUTH
static java.lang.String	DEFAULT_AUTH_TYPE
static com.xebialabs.overthere.cifs.WinrmHttpsCertificateTrustStrategy	DEFAULT_CERT_TRUST
static java.lang.Boolean	DEFAULT_DEBUG_KERBEROS_AUTH
static com.xebialabs.overthere.cifs.WinrmHttpsHostnameVerificationStrategy	DEFAULT_HOSTNAME_VERIFY
static int	DEFAULT_HTTP_PORT
static int	DEFAULT_HTTPS_PORT
static java.lang.Boolean	DEFAULT_IS_DOMAIN_MEMBER
static java.lang.Boolean	DEFAULT_KERBEROS_CACHE
static boolean	DEFAULT_WINRM_CONNECTION_ENCRYPTED
static int	DEFAULT_WINRM_CONNECTION_TIMEOUT
static java.lang.String	DEFAULT_WINRM_PASSWORD_OPTION
static java.lang.String	DEFAULT_WINRM_PROTOCOL
static java.lang.String	HOSTNAME_TRUST_ALL
static java.lang.String	HOSTNAME_TRUST_BROWSER_COMPATIBLE
static java.lang.String	HOSTNAME_TRUST_STRICT
static java.lang.String	KERBEROS_CACHE
static java.lang.String	SERVICE_PROVIDER_TYPE
static java.lang.String	WINRM_AUTH_TYPE
static java.lang.String	WINRM_CERT_TRUST
static java.lang.String	WINRM_CONNECTION_TIMEOUT_PROPERTY
static java.lang.String	WINRM_DOMAIN
static java.lang.String	WINRM_HOSTNAME_TRUST
static java.lang.String	WINRM_IS_DOMAIN_MEMBER
static java.lang.String	WINRM_LOCALE
static java.lang.String	WINRM_PASSWORD_OPTION
static java.lang.String	WINRM_PASSWORD_STORAGE_PATH
static java.lang.String	WINRM_PORT
static java.lang.String	WINRM_PROTOCOL
static java.lang.String	WINRM_PROTOCOL_HTTP
static java.lang.String	WINRM_PROTOCOL_HTTPS
static java.lang.String	WINRM_SPN_ADD_PORT
static java.lang.String	WINRM_SPN_USE_HTTP
static java.lang.String	WINRM_TIMEOUT
static java.lang.String	WINRM_USER

Constructor Summary

Constructors

Constructor and Description
OTWinRMNodeExecutor(com.dtolabs.rundeck.core.common.Framework framework)

Method Summary

Modifier and Type	Method and Description
static com.xebialabs.overthere.CmdLine	buildCmdLineRaw(java.lang.String... args) Build a CmdLine without escaping any part, using Raw arguments
protected com.xebialabs.overthere.CmdLine	buildCommandLine(java.lang.String[] command) Create the CmdLine to run from the input string array, the default behavior is to use buildCmdLineRaw(String...)
com.dtolabs.rundeck.core.execution.service.NodeExecutorResult	executeCommand(com.dtolabs.rundeck.core.execution.ExecutionContext context, java.lang.String[] command, com.dtolabs.rundeck.core.common.INodeEntry node)
protected java.lang.String	getClearAuthPassword(OTWinRMNodeExecutor.ConnectionOptionsBuilder options) Return the cleartext user password
com.dtolabs.rundeck.core.plugins.configuration.Description	getDescription()
protected java.lang.String	getKerberosUsername(OTWinRMNodeExecutor.ConnectionOptionsBuilder options) Return the full username@domain to use for kerberos authentication.
protected com.xebialabs.overthere.ConnectionOptions	willUseConnectionOptions(com.xebialabs.overthere.ConnectionOptions options) Called before connecting with the ConnectionnOptions that will be used, which can be altered here by a subclass.

Methods inherited from class java.lang.Object

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

Field Detail

SERVICE_PROVIDER_TYPE

public static final java.lang.String SERVICE_PROVIDER_TYPE

See Also:

Constant Field Values

DEFAULT_WINRM_CONNECTION_TIMEOUT

public static final int DEFAULT_WINRM_CONNECTION_TIMEOUT

See Also:

Constant Field Values

DEFAULT_WINRM_CONNECTION_ENCRYPTED

public static final boolean DEFAULT_WINRM_CONNECTION_ENCRYPTED

See Also:

Constant Field Values

WINRM_PASSWORD_OPTION

public static final java.lang.String WINRM_PASSWORD_OPTION

See Also:

Constant Field Values

WINRM_PASSWORD_STORAGE_PATH

public static final java.lang.String WINRM_PASSWORD_STORAGE_PATH

See Also:

Constant Field Values

DEFAULT_WINRM_PASSWORD_OPTION

public static final java.lang.String DEFAULT_WINRM_PASSWORD_OPTION

See Also:

Constant Field Values

DEFAULT_HTTPS_PORT

public static final int DEFAULT_HTTPS_PORT

See Also:

Constant Field Values

DEFAULT_HTTP_PORT

public static final int DEFAULT_HTTP_PORT

See Also:

Constant Field Values

WINRM_CONNECTION_TIMEOUT_PROPERTY

public static final java.lang.String WINRM_CONNECTION_TIMEOUT_PROPERTY

See Also:

Constant Field Values

WINRM_USER

public static final java.lang.String WINRM_USER

See Also:

Constant Field Values

WINRM_PORT

public static final java.lang.String WINRM_PORT

See Also:

Constant Field Values

WINRM_AUTH_TYPE

public static final java.lang.String WINRM_AUTH_TYPE

See Also:

Constant Field Values

WINRM_CERT_TRUST

public static final java.lang.String WINRM_CERT_TRUST

See Also:

Constant Field Values

WINRM_HOSTNAME_TRUST

public static final java.lang.String WINRM_HOSTNAME_TRUST

See Also:

Constant Field Values

WINRM_PROTOCOL

public static final java.lang.String WINRM_PROTOCOL

See Also:

Constant Field Values

AUTH_TYPE_KERBEROS

public static final java.lang.String AUTH_TYPE_KERBEROS

See Also:

Constant Field Values

AUTH_TYPE_BASIC

public static final java.lang.String AUTH_TYPE_BASIC

See Also:

Constant Field Values

WINRM_PROTOCOL_HTTPS

public static final java.lang.String WINRM_PROTOCOL_HTTPS

See Also:

Constant Field Values

WINRM_PROTOCOL_HTTP

public static final java.lang.String WINRM_PROTOCOL_HTTP

See Also:

Constant Field Values

WINRM_SPN_ADD_PORT

public static final java.lang.String WINRM_SPN_ADD_PORT

See Also:

Constant Field Values

WINRM_SPN_USE_HTTP

public static final java.lang.String WINRM_SPN_USE_HTTP

See Also:

Constant Field Values

WINRM_LOCALE

public static final java.lang.String WINRM_LOCALE

See Also:

Constant Field Values

WINRM_TIMEOUT

public static final java.lang.String WINRM_TIMEOUT

See Also:

Constant Field Values

WINRM_IS_DOMAIN_MEMBER

public static final java.lang.String WINRM_IS_DOMAIN_MEMBER

See Also:

Constant Field Values

WINRM_DOMAIN

public static final java.lang.String WINRM_DOMAIN

See Also:

Constant Field Values

DEFAULT_IS_DOMAIN_MEMBER

public static final java.lang.Boolean DEFAULT_IS_DOMAIN_MEMBER

HOSTNAME_TRUST_BROWSER_COMPATIBLE

public static final java.lang.String HOSTNAME_TRUST_BROWSER_COMPATIBLE

See Also:

Constant Field Values

HOSTNAME_TRUST_STRICT

public static final java.lang.String HOSTNAME_TRUST_STRICT

See Also:

Constant Field Values

HOSTNAME_TRUST_ALL

public static final java.lang.String HOSTNAME_TRUST_ALL

See Also:

Constant Field Values

CERT_TRUST_DEFAULT

public static final java.lang.String CERT_TRUST_DEFAULT

See Also:

Constant Field Values

CERT_TRUST_ALL

public static final java.lang.String CERT_TRUST_ALL

See Also:

Constant Field Values

CERT_TRUST_SELF_SIGNED

public static final java.lang.String CERT_TRUST_SELF_SIGNED

See Also:

Constant Field Values

DEFAULT_AUTH_TYPE

public static final java.lang.String DEFAULT_AUTH_TYPE

See Also:

Constant Field Values

DEBUG_KERBEROS_AUTH

public static final java.lang.String DEBUG_KERBEROS_AUTH

See Also:

Constant Field Values

DEFAULT_DEBUG_KERBEROS_AUTH

public static final java.lang.Boolean DEFAULT_DEBUG_KERBEROS_AUTH

DEFAULT_WINRM_PROTOCOL

public static final java.lang.String DEFAULT_WINRM_PROTOCOL

See Also:

Constant Field Values

KERBEROS_CACHE

public static final java.lang.String KERBEROS_CACHE

See Also:

Constant Field Values

DEFAULT_KERBEROS_CACHE

public static final java.lang.Boolean DEFAULT_KERBEROS_CACHE

DEFAULT_CERT_TRUST

public static final com.xebialabs.overthere.cifs.WinrmHttpsCertificateTrustStrategy DEFAULT_CERT_TRUST

DEFAULT_HOSTNAME_VERIFY

public static final com.xebialabs.overthere.cifs.WinrmHttpsHostnameVerificationStrategy DEFAULT_HOSTNAME_VERIFY

CONFIG_AUTHENTICATION

public static final java.lang.String CONFIG_AUTHENTICATION

See Also:

Constant Field Values

CONFIG_PROTOCOL

public static final java.lang.String CONFIG_PROTOCOL

See Also:

Constant Field Values

CONFIG_CERT_TRUST

public static final java.lang.String CONFIG_CERT_TRUST

See Also:

Constant Field Values

CONFIG_HOSTNAME_VERIFY

public static final java.lang.String CONFIG_HOSTNAME_VERIFY

See Also:

Constant Field Values

CONFIG_SPN_ADD_PORT

public static final java.lang.String CONFIG_SPN_ADD_PORT

See Also:

Constant Field Values

CONFIG_SPN_USE_HTTP

public static final java.lang.String CONFIG_SPN_USE_HTTP

See Also:

Constant Field Values

CONFIG_LOCALE

public static final java.lang.String CONFIG_LOCALE

See Also:

Constant Field Values

CONFIG_WINRM_TIMEOUT

public static final java.lang.String CONFIG_WINRM_TIMEOUT

See Also:

Constant Field Values

Constructor Detail

OTWinRMNodeExecutor

public OTWinRMNodeExecutor(com.dtolabs.rundeck.core.common.Framework framework)

Method Detail

getDescription

public com.dtolabs.rundeck.core.plugins.configuration.Description getDescription()

Specified by:

getDescription in interface com.dtolabs.rundeck.core.plugins.configuration.Describable

executeCommand

public com.dtolabs.rundeck.core.execution.service.NodeExecutorResult executeCommand(com.dtolabs.rundeck.core.execution.ExecutionContext context,
                                                                                    java.lang.String[] command,
                                                                                    com.dtolabs.rundeck.core.common.INodeEntry node)

Specified by:

executeCommand in interface com.dtolabs.rundeck.core.execution.service.NodeExecutor

buildCommandLine

protected com.xebialabs.overthere.CmdLine buildCommandLine(java.lang.String[] command)

Create the CmdLine to run from the input string array, the default behavior is to use buildCmdLineRaw(String...)

Parameters:

command -

Returns:

willUseConnectionOptions

protected com.xebialabs.overthere.ConnectionOptions willUseConnectionOptions(com.xebialabs.overthere.ConnectionOptions options)
                                                                      throws com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConfigurationException

Called before connecting with the ConnectionnOptions that will be used, which can be altered here by a subclass.

Parameters:

options - configured options

Returns:

the ConnectionOptions to use

Throws:

com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConfigurationException

buildCmdLineRaw

public static com.xebialabs.overthere.CmdLine buildCmdLineRaw(java.lang.String... args)

Build a CmdLine without escaping any part, using Raw arguments

Parameters:

args - the regular arguments which will be added without escaping

Returns:

the created command line

getClearAuthPassword

protected java.lang.String getClearAuthPassword(OTWinRMNodeExecutor.ConnectionOptionsBuilder options)
                                         throws com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConfigurationException

Return the cleartext user password

Returns:

Throws:

com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConfigurationException

getKerberosUsername

protected java.lang.String getKerberosUsername(OTWinRMNodeExecutor.ConnectionOptionsBuilder options)
                                        throws com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConfigurationException

Return the full username@domain to use for kerberos authentication. The default implementation will append "@HOSTNAME" if no "@DOMAIN" is present, otherwise it will convert "@domain" to "@DOMAIN" and return the value. if winrm-is-domain-member is true, the hostname will be reduced by one part of the fqdn, from host.domain.tld to domain.tld, and user@DOMAIN.TLD returned. If winrm-domain is set, it will be used.

Parameters:

options - options builder

Returns:

Throws:

com.dtolabs.rundeck.plugin.overthere.OTWinRMNodeExecutor.ConfigurationException