Class: WindowsUser

Inherits:

UserInfo

• Object
• UserInfo
• WindowsUser

Defined in:

lib/resources/user.rb

Overview

For now, we stick with WMI Win32_UserAccount using Get-AdUser would be the best command for domain machines, but it will not be installed on client machines by default Just for reference, we could also use ADSI (Active Directory Service Interfaces)

See Also:

• https://msdn.microsoft.com/en-us/library/aa394507(v=vs.85).aspx
• https://msdn.microsoft.com/en-us/library/aa394153(v=vs.85).aspx
• https://technet.microsoft.com/en-us/library/ee617241.aspx
• https://technet.microsoft.com/en-us/library/hh509016(v=WS.10).aspx
• http://woshub.com/get-aduser-getting-active-directory-users-data-via-powershell/
• http://stackoverflow.com/questions/17548523/the-term-get-aduser-is-not-recognized-as-the-name-of-a-cmdlet
• https://mcpmag.com/articles/2015/04/15/reporting-on-local-accounts.aspx

Instance Attribute Summary

Attributes inherited from UserInfo

#inspec

Instance Method Summary

• #identity(username) ⇒ Object
• #meta_info(_username) ⇒ Object

  not implemented yet.

• #parse_windows_account(username) ⇒ Object

  parse windows account name.

Methods inherited from UserInfo

#credentials, #initialize

Methods included from Converter

#convert_to_i

Constructor Details

This class inherits a constructor from UserInfo

Instance Method Details

#identity(username) ⇒ Object

# File 'lib/resources/user.rb', line 317

def identity(username)
  # extract domain/user information
  account, domain = parse_windows_account(username)

  # TODO: escape content
  if !domain.nil?
    filter = "Name = '#{account}' and Domain = '#{domain}'"
  else
    filter = "Name = '#{account}' and LocalAccount = true"
  end

  script = "    # find user\n    $user = Get-WmiObject Win32_UserAccount -filter \"\#{filter}\"\n    # get related groups\n    $groups = $user.GetRelated('Win32_Group') | Select-Object -Property Caption, Domain, Name, LocalAccount, SID, SIDType, Status\n    # filter user information\n    $user = $user | Select-Object -Property Caption, Description, Domain, Name, LocalAccount, Lockout, PasswordChangeable, PasswordExpires, PasswordRequired, SID, SIDType, Status\n    # build response object\n    New-Object -Type PSObject | `\n    Add-Member -MemberType NoteProperty -Name User -Value ($user) -PassThru | `\n    Add-Member -MemberType NoteProperty -Name Groups -Value ($groups) -PassThru | `\n    ConvertTo-Json\n  EOH\n\n  cmd = inspec.script(script)\n\n  # cannot rely on exit code for now, successful command returns exit code 1\n  # return nil if cmd.exit_status != 0, try to parse json\n  begin\n    params = JSON.parse(cmd.stdout)\n  rescue JSON::ParserError => _e\n    return nil\n  end\n\n  user = params['User']['Caption'] unless params['User'].nil?\n  groups = params['Groups']\n  # if groups is no array, generate one\n  groups = [groups] if !groups.is_a?(Array)\n  groups = groups.map { |grp| grp['Caption'] } unless params['Groups'].nil?\n\n  {\n    uid: nil,\n    user: user,\n    gid: nil,\n    group: nil,\n    groups: groups,\n  }\nend\n"

#meta_info(_username) ⇒ Object

not implemented yet

# File 'lib/resources/user.rb', line 368

def meta_info(_username)
  {
    home: nil,
    shell: nil,
  }
end

#parse_windows_account(username) ⇒ Object

parse windows account name

# File 'lib/resources/user.rb', line 310

def parse_windows_account(username)
  account = username.split('\\')
  name = account.pop
  domain = account.pop if account.size > 0
  [name, domain]
end