Executors syntax

Este artigo abordará cada sintaxe de plugin e um exemplo a ser usado que facilitará o entendimento de sua funcionalidade.

cURL

Executor de requisições para páginas web simples. Páginas sem ambiente JavaScript ou eventos HTML. Você pode usar este executor para sistemas legados baseados na arquitetura HTML4 pura.

Se você precisar realizar uma automação usando elementos de interfaces web simulando ações reais do usuário, dê uma olhada no executor HTTP.

Por padrão, este plugin não valida a conexão SSL e seu tempo limite padrão é de 10 segundos.

Sintaxe

Este plugin aceita comentários. Para comentários, use o caractere sustenido '#' no início da linha.

Exemplo de requisição - Criação de credencial com autorização em Oauth2.0 para enviar dados a outra aplicação

Substitua os valores dos campos abaixo conforme as informações necessárias.

set-request-method "POST"
set-oauth2 "[url_token]" "[client_id]" "[client_secret]"
set-request-header Content-type application/json
set-request-content "{\"username\": \"[#USERNAME#]\", \"content\": \"[#NEW_PASSWORD#]\", \"hostname\": \"[#HOSTNAME#]\", \"ip\": \"localhost\"}"
request "[endpoint_destino]"
expect "Credential updated successfully"

Exemplo

Alteração de senha HTTP com cabeçalho

set-request-header "X-INTRANET-TOKEN" "FF32C5E9AC1800A2"
set-request-param "username" "[#AUTH_USER#]"
set-request-param "password" "[#AUTH_PASSWORD#]"
set-request-param "tgt_user" "[#USERNAME#]"
set-request-param "tgt_npassword" "[#NEW_PASSWORD#]"

set-request-method "POST"

## If 7 bytes string 1200-OK returns, the password change was accepted
expect "1200-OK"

## If 7 bytes string 9999-NOK returns, the password change has failure
no-expect "9999-NOK"

HTTP

Executor para solicitações a páginas web complexas, onde é necessária mais interatividade, usando elementos JavaScript e acionadores de eventos.

Syntax

Exemplo

Alteração de senha Amazon AWS console

start-at https://console.aws.amazon.com/console/home
timeout 30000
user-agent "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/60.0.3112.113 Safari/537.36"

new-action
sleep 4000
test-location /signin?redirect_uri
fill #resolving_input [#USERNAME#]
jclick #next_button
sleep 2000

new-action
fill #ap_password [#CURRENT_PASSWORD#]
click #signInSubmit-input

new-action
test-location /console/home
set-location https://signin.aws.amazon.com/updateaccount?redirect_uri=https%3A%2F%2Fconsole.aws.amazon.com%2Fbilling%2Fhome%23%2Faccount
sleep 2000

new-action
test-location /ap/cnep
jclick #cnep_1A_change_password_button-input

new-action
fill #ap_password [#CURRENT_PASSWORD#]
fill #ap_password_new [#NEW_PASSWORD#]
fill #ap_password_new_check [#NEW_PASSWORD#]
click #cnep_1D_submit_button-input

new-action
test-selector #message_success

LDAP

Este plugin pode ser utilizado para interagir até mesmo com servidores Microsoft Active Directory ou OpenLDAP.

Syntax

Exemplos

Alteração de dominíno da senha do usuário no Microsoft Active Directory

## LDAP protocol version
set-option LDAP_OPT_PROTOCOL_VERSION 3

## DistinguishedName of the user who will connect to the server
bind "cn=[#AUTH_USER#],CN=Users,DC=senhasegura,DC=local"

## Search the user in which the procedure will be done.

## The system will search in general scope for a user object that has
the name of the user
find "DC=senhasegura,DC=local" "(&(objectClass=user)
(sAMAccountName=[#USERNAME#]))"

## Update user password
mod-replace unicodePwd "u([#NEW_PASSWORD#])"

Ativação da conta de usuário

## LDAP protocol version
set-option LDAP_OPT_PROTOCOL_VERSION 3
set-option LDAP_OPT_REFERRALS 3

## DistinguishedName of the user who will connect to the server
bind "CN=[#AUTH_USER#],CN=Users,DC=senhasegura,DC=local"

## Search the user in which the procedure will be done.
find "DC=senhasegura,DC=local" "(&(objectClass=user) (sAMAccountName=[#USERNAME#]))"

## Update account status
mod-replace userAccountControl 512

SSH

Sintaxe

Este plugin aceita comentários. Para comentários, utilize o caracter '#' no início da linha.

Exemplos

Alteração de senha para usuário Linux

## Put the language in English
expect "*#"
exec "export LC_ALL=C"

## Execute the password change for the user
expect "*#"
exec "passwd [#USERNAME#]"

## Fill in the new password
expect "*password:"
exec "[#NEW_PASSWORD#]"

## Confirm the new password
expect "*password:"
exec "[#NEW_PASSWORD#]"

## Validates if successfully changed
expect "*updated successfully"

Alteração de senha Apache htpasswd

expect "*#"
exec "htpasswd -bm /etc/htpasswd/.htpasswd [#USERNAME#] [#NEW_PASSWORD#]"

expect "*Updating"
expect "*#"
exec "exit"

end

Alteração de senha Apache Tomcat

## Changing tomcat-users.xml user entry
expect "*#"
exec "sed -i 's/<user username="[#USERNAME#]" password="[#CURRENT_PASSWORD#]"/<user username="[#USERNAME#]" password="[#NEW_PASSWORD#]"/' /etc/tomcat/tomcat-users.xml"

## Validating changing step
expect "*#"
exec "cat /etc/tomcat/tomcat-users.xml | grep 'username="[#USERNAME#]" password'"
expect "*[#NEW_PASSWORD#]*"

## Restarting tomcat
expect "*#"
exec "service tomcat restart"

## Finish the procedure
expect "*#"
exec "exit"
end

Red Hat JBoss Application Vault

expect "*#"
exec "/opt/wildfly/bin/vault.sh --enc-dir /opt/vault --keystore /opt/vault.keystore --keystore-password VaultK --salt $(shuf -i 10000000-99999999 -n 1) --iteration $(shuf -i 10-99 -n 1) --alias vault --vault-block [#ADD_INFO#] --attribute [#USERNAME#] --sec-attr [#NEW_PASSWORD#]"

expect "Please make note of the following:"
expect "*#"
exec "exit"

end

SSH Legacy

Sintaxe

Este plugin aceita comentários. Para fazer comentários, utilize o caracter '#' no início da linha.

Exemplo

Alteração de senha Legacy Linux

## Request password change
expect "*$"
exec "sudo passwd [#USERNAME#]"

## Fill in the sudo password
expect "*:"
exec "[#AUTH_PASSWORD#]"

## Fill in the new password
expect "*password:"
exec "[#NEW_PASSWORD#]"

## Confirm the new password
expect "*password:"
exec "[#NEW_PASSWORD#]"

## Validates if successfully changed
expect "*successfully"

Telnet

Sintaxe

Exemplo

3com Switch 5500 Family

## Waiting username
expect "*:"
exec "[#USERNAME#]"

## Waiting password
expect "*:"
exec "[#CURRENT_PASSWORD#]"

## Enter system-view
expect "*>"
exec "system-view"

## Enter local user view
expect "*]"
exec "local-user [#USERNAME#]"

expect "*]"
exec "password cipher [#NEW_PASSWORD#]"

## Exit to user.
expect "*]"
exec "quit"

## Exit to system view.
expect "*]"
exec "quit"

expect "*>"
exec "quit"

Windows RM

O dispositivo deve ter conectividade habilitada e autorizada no Microsoft®Windows®Remote Management.

Sintaxe

Exemplos

Dispositivos quem possuem Windows RM sobre HTTPS

## change user password
!change-password

Dispositivos que possuem Windows RM sobre HTTP

!unsecure

## change user password
!change-password

Ateração de senha na configuração de arquivo via PowerShell

powershell (Get-Content .Desktop\Web.config) | Foreach-Object {$_
-replace 'password=([^;"]+)','password=[#NEW_PASSWORD#]'} |
Set-Content .Desktop\Web.config

Alteração de senha COM+ Application utilizando PowerShell

## Change user password
!change-password

## Replicate the new password into COM+ application
powershell $comAdmin = New-Object -com ("COMAdmin.COMAdminCatalog.1")[nl]$applications = $comAdmin.GetCollection("Applications")[nl]$applications.Populate()[nl]foreach ($application in $applications)[nl]{[nl]$appName = $application.Value("Name")[nl]$appIdentity = $application.Value("Identity")[nl]if ($appIdentity -eq "[#ADD_INFO#]\[#USERNAME#]") {[nl]$application.Value("Password") = "[#NEW_PASSWORD#]"[nl]$comAdmin.ShutdownApplication($appName)[nl]$applications.SaveChanges()[nl]$comAdmin.StartApplication($appName)[nl]}[nl]}

Alteração de senha Windows Autologon utilizando PowerShell

## Change user password
!change-password

## Replicate the new password into Windows registry
powershell $RegPath = "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon"[nl]
Set-ItemProperty $RegPath "AutoAdminLogon" -Value "1" -type String[nl]
Set-ItemProperty $RegPath "DefaultDomain" -Value "[#DOMAIN#]" -type String[nl]
Set-ItemProperty $RegPath "DefaultUsername" -Value "[#USERNAME#]" -type String[nl]
Set-ItemProperty $RegPath "DefaultPassword" -Value "[#PASSWORD#]" -type String

IIS Website Application Pool

## Change user password
!change-password

## Replicate the new password into IIS application pool
C:\Windows\System32\inetsrv\appcmd.exe set config /section:applicationPools /"[name='[#ADD_INFO#]']".processModel.identityType:SpecificUser /"[name='[#ADD_INFO#]']".processModel.userName:[#USERNAME#] /"[name='[#ADD_INFO#]']".processModel.password:[#NEW_PASSWORD#]

Windows RPC

O dipositivo deve ter conectividade habilitada e autorizada com o Microsoft®Windows®RPC .

Sintaxe

Este executor aceita qualquer comando Microsoft®Windows®RPC, além de alguns comandos do senhasegura Microsoft®Windows®RPC Executor iniciando com exclamação.

Exemplos

Mudando o domínio da senha de um usuário

## Changing account using executor command alias
!netsmb-password

## You can also execute a native RPC command
## net user [#USERNAME#] [#NEW_PASSWORD#] /domain

Senha de usuário local e atualizar senha de usuário local Windows Task

## Change password
net user [#USERNAME#] [#NEW_PASSWORD#]

## Waiting three seconds
!sleep 3

## Update password for "Defrag"
schtasks /Change /RU [#USERNAME#] /RP [#NEW_PASSWORD#] /TN Defrag

Senha de usuário local e atualizar senha de conta Windows Service

## Change password
net user [#USERNAME#] [#NEW_PASSWORD#]

## Waiting three seconds
!sleep 3

sc config [#ADD_INFO#] obj= [#USERNAME#] password= [#NEW_PASSWORD#]

MySQL

Sintaxe

Você pode executar qualquer consulta de administração MySQL, ou ainda consultas a banco de dados.

Você pode executar funções MySQL ou funções específicas de bancos de dados. A unica limitação é executar ou criar procedimentos amrazenados.

Exemplo

Alterar senha de um usuário

ALTER USER '[#USERNAME#]'@'[#ADD_INFO#]' IDENTIFIED BY '[#NEW_PASSWORD#]';
FLUSH PRIVILEGES;

Oracle

Sintaxe

Você pode executar qualquer consulta de administração do Oracle, ou até mesmo outras pesquisas direcionadas a banco de dados.

Você também pode executar funções Oracle ou funções específicas de bancos de dados . A única limitação é executar ou criar procedimentos armazenados.

Exemplo

Alterar senha de um usuário

CONN [#USERNAME#]@[#ADD_INFO#]
ALTER USER [#USERNAME#] IDENTIFIED BY [#NEW_PASSWORD#]

PostgreSQL

Sintaxe

Você pode executar qualquer consulta de administração do PostgreSQL, ou até mesmo outras pesquisas direcionadas a banco de dados.

Você também pode executar funções PostgreSQL ou funções específicas de bancos de dados . A única limitação é executar ou criar procedimentos armazenados.

Exemplo

Alterar senha de um usuário

ALTER USER [#USERNAME#] WITH PASSWORD '[#NEW_PASSWORD#]';

SQL Server

Sintaxe

Você pode executar qualquer consulta de administração do SQL, ou até mesmo outras pesquisas direcionadas a banco de dados.

Você também pode executar funções SQL Server ou funções específicas de bancos de dados . A única limitação é executar ou criar procedimentos armazenados.

Exemplo

Alteração da senha de um usuário

ALTER LOGIN [#USERNAME#] WITH PASSWORD = '[#NEW_PASSWORD#]' OLD_PASSWORD = '[#CURRENT_PASSWORD#]' UNLOCK;

Tk Expect

Este plugin utiliza o TK Expect binary para interagir por meio de um forte stdout interpreter.

Sintaxe

Você pode utilizar o manual TK Expect para criar o seu próprio script.

Exemplos

Alteração de senha IBM AS400

use telnet script
expect {
    "User  . ." {
        send "[#USERNAME#]\t"
        exp_continue
    } "Password  . ." {
        send "[#CURRENT_PASSWORD#]\r\n"
        exp_continue
    } "Selection or command" {
        send "chgpwd\r\n"
        exp_continue
    } "Current password  . ." {
        send "[#CURRENT_PASSWORD#]\r\n"
        exp_continue
    } "New password  . ." {
        send "[#NEW_PASSWORD#]\r"
        exp_continue
    } "New password (to verify)" {
        send "[#NEW_PASSWORD#]\r"
        exp_continue
    } "Password changed successfully." {
        send "\r"
        exit 0
    } incorrect {
        send_user "FAILURE INCORRECT"
        exit 1
    } timeout {
        send_user "FAILURE TIMEOUT"
        exit 1
    } eof {
        send_user "FAILURE EOF"
        exit 1
    }
}

Sybase select

use tds
env "TDSVER" "5.0"
 
exec "SELECT CAST(GETDATE() AS DATE)"
exec "go"
 
expect "affected"

VMWare ESXi

Este plugin vai interagir sobre o VMWare ESXi console binário admnistrativo esxcli.

Sintaxe

A sintaxe de comando original esxcli deve ser utilizada.

Exemplo

Configurar a senha de um usuário

system account set -i '[#USERNAME#]' -p '[#NEW_PASSWORD#]' -c '[#NEW_PASSWORD#]'

x3270: IBM Terminal Emulator

Executor para mainframes IBM 3270. Você pode interagir com interfaces de aplicação mainframe pela interpretação do seu design.

Sintaxe

Alguns dos comandos do linux x3270 foram substituidos por aliases do executor para tornar a integração com o senhasegura fácil e segura.

• x: Número da linha inicial començando por 0;
• y: Número da coluna char inicial começando por 0;
• r: Número de linhas a serem retornadas começando por 1;
• c: Número de colunas a serem retornadas começando por 1;search SUCCESSFUL 10,17,1,10 |

| search_not [data] [x,y,r,c] | Semelhante a search, mas irá falhar caso a string fornecida seja encontrada.search_not FAILURE 10,17,1,7 |
| send [data] | Introduz informações na aplicação alvo. O comando pode aceitar sequências de escape de strings. O comando será traduzido para String() action.send T01281\t2918\r |
| screenshot | Registra a operação do executor e toda a tela ASCII renderizada (24x80 terminal only).screenshot |
| disconnect | Realiza o encerramento da conexão mainframe. O comando será convertido para Disconnect() action.disconnect |

Exemplo

Alteração de senha na aplicação mainframe

timeout 350

## AUTHENTICATION STEP ##############

echo Starting connection

connect

sleep 3

echo Performing login
search USER: 20,2,1,5

send [#USERNAME#]\t[#CURRENT_PASSWORD#]\r

echo Result screen
screenshot

## PASSWORD CHANGE STEP ##############

search USER: [C] CHANGE PASSWORD 10,5,1,19

send C\r[#NEW_PASSWORD#]\t[#NEW_PASSWORD#]\r

search_not FAILURE 12,70,1,7
search SUCCESS 12,70,1,7

echo Result screen
screenshot

disconnect