346 lines
13 KiB
PowerShell
346 lines
13 KiB
PowerShell
#!powershell
|
|
# This file is part of Ansible
|
|
#
|
|
# Copyright 2015, Phil Schwartz <schwartzmx@gmail.com>
|
|
# Copyright 2015, Trond Hindenes
|
|
# Copyright 2015, Hans-Joachim Kliemeck <git@kliemeck.de>
|
|
#
|
|
# Ansible is free software: you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation, either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# Ansible is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with Ansible. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
# WANT_JSON
|
|
# POWERSHELL_COMMON
|
|
|
|
# win_acl module (File/Resources Permission Additions/Removal)
|
|
|
|
|
|
#Functions
|
|
Function UserSearch
|
|
{
|
|
Param ([string]$accountName)
|
|
#Check if there's a realm specified
|
|
|
|
$searchDomain = $false
|
|
$searchDomainUPN = $false
|
|
$SearchAppPools = $false
|
|
if ($accountName.Split("\").count -gt 1)
|
|
{
|
|
if ($accountName.Split("\")[0] -eq $env:COMPUTERNAME)
|
|
{
|
|
|
|
}
|
|
elseif ($accountName.Split("\")[0] -eq "IIS APPPOOL")
|
|
{
|
|
$SearchAppPools = $true
|
|
$accountName = $accountName.split("\")[1]
|
|
}
|
|
else
|
|
{
|
|
$searchDomain = $true
|
|
$accountName = $accountName.split("\")[1]
|
|
}
|
|
}
|
|
Elseif ($accountName.contains("@"))
|
|
{
|
|
$searchDomain = $true
|
|
$searchDomainUPN = $true
|
|
}
|
|
Else
|
|
{
|
|
#Default to local user account
|
|
$accountName = $env:COMPUTERNAME + "\" + $accountName
|
|
}
|
|
|
|
if (($searchDomain -eq $false) -and ($SearchAppPools -eq $false))
|
|
{
|
|
# do not use Win32_UserAccount, because e.g. SYSTEM (BUILTIN\SYSTEM or COMPUUTERNAME\SYSTEM) will not be listed. on Win32_Account groups will be listed too
|
|
$localaccount = get-wmiobject -class "Win32_Account" -namespace "root\CIMV2" -filter "(LocalAccount = True)" | where {$_.Caption -eq $accountName}
|
|
if ($localaccount)
|
|
{
|
|
return $localaccount.SID
|
|
}
|
|
}
|
|
Elseif ($SearchAppPools -eq $true)
|
|
{
|
|
Import-Module WebAdministration
|
|
$testiispath = Test-path "IIS:"
|
|
if ($testiispath -eq $false)
|
|
{
|
|
return $null
|
|
}
|
|
else
|
|
{
|
|
$apppoolobj = Get-ItemProperty IIS:\AppPools\$accountName
|
|
return $apppoolobj.applicationPoolSid
|
|
}
|
|
}
|
|
Else
|
|
{
|
|
#Search by samaccountname
|
|
$Searcher = [adsisearcher]""
|
|
|
|
If ($searchDomainUPN -eq $false) {
|
|
$Searcher.Filter = "sAMAccountName=$($accountName)"
|
|
}
|
|
Else {
|
|
$Searcher.Filter = "userPrincipalName=$($accountName)"
|
|
}
|
|
|
|
$result = $Searcher.FindOne()
|
|
if ($result)
|
|
{
|
|
$user = $result.GetDirectoryEntry()
|
|
|
|
# get binary SID from AD account
|
|
$binarySID = $user.ObjectSid.Value
|
|
|
|
# convert to string SID
|
|
return (New-Object System.Security.Principal.SecurityIdentifier($binarySID,0)).Value
|
|
}
|
|
}
|
|
}
|
|
|
|
# Need to adjust token privs when executing Set-ACL in certain cases.
|
|
# e.g. d:\testdir is owned by group in which current user is not a member and no perms are inherited from d:\
|
|
# This also sets us up for setting the owner as a feature.
|
|
$AdjustTokenPrivileges = @"
|
|
using System;
|
|
using System.Runtime.InteropServices;
|
|
|
|
namespace Ansible {
|
|
public class TokenManipulator {
|
|
|
|
[DllImport("advapi32.dll", ExactSpelling = true, SetLastError = true)]
|
|
internal static extern bool AdjustTokenPrivileges(IntPtr htok, bool disall,
|
|
ref TokPriv1Luid newst, int len, IntPtr prev, IntPtr relen);
|
|
|
|
[DllImport("kernel32.dll", ExactSpelling = true)]
|
|
internal static extern IntPtr GetCurrentProcess();
|
|
|
|
[DllImport("advapi32.dll", ExactSpelling = true, SetLastError = true)]
|
|
internal static extern bool OpenProcessToken(IntPtr h, int acc,
|
|
ref IntPtr phtok);
|
|
|
|
[DllImport("advapi32.dll", SetLastError = true)]
|
|
internal static extern bool LookupPrivilegeValue(string host, string name,
|
|
ref long pluid);
|
|
|
|
[StructLayout(LayoutKind.Sequential, Pack = 1)]
|
|
internal struct TokPriv1Luid
|
|
{
|
|
public int Count;
|
|
public long Luid;
|
|
public int Attr;
|
|
}
|
|
|
|
internal const int SE_PRIVILEGE_DISABLED = 0x00000000;
|
|
internal const int SE_PRIVILEGE_ENABLED = 0x00000002;
|
|
internal const int TOKEN_QUERY = 0x00000008;
|
|
internal const int TOKEN_ADJUST_PRIVILEGES = 0x00000020;
|
|
|
|
public static bool AddPrivilege(string privilege) {
|
|
try {
|
|
bool retVal;
|
|
TokPriv1Luid tp;
|
|
IntPtr hproc = GetCurrentProcess();
|
|
IntPtr htok = IntPtr.Zero;
|
|
retVal = OpenProcessToken(hproc, TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, ref htok);
|
|
tp.Count = 1;
|
|
tp.Luid = 0;
|
|
tp.Attr = SE_PRIVILEGE_ENABLED;
|
|
retVal = LookupPrivilegeValue(null, privilege, ref tp.Luid);
|
|
retVal = AdjustTokenPrivileges(htok, false, ref tp, 0, IntPtr.Zero, IntPtr.Zero);
|
|
return retVal;
|
|
}
|
|
catch (Exception ex) {
|
|
throw ex;
|
|
}
|
|
}
|
|
|
|
public static bool RemovePrivilege(string privilege) {
|
|
try {
|
|
bool retVal;
|
|
TokPriv1Luid tp;
|
|
IntPtr hproc = GetCurrentProcess();
|
|
IntPtr htok = IntPtr.Zero;
|
|
retVal = OpenProcessToken(hproc, TOKEN_ADJUST_PRIVILEGES | TOKEN_QUERY, ref htok);
|
|
tp.Count = 1;
|
|
tp.Luid = 0;
|
|
tp.Attr = SE_PRIVILEGE_DISABLED;
|
|
retVal = LookupPrivilegeValue(null, privilege, ref tp.Luid);
|
|
retVal = AdjustTokenPrivileges(htok, false, ref tp, 0, IntPtr.Zero, IntPtr.Zero);
|
|
return retVal;
|
|
}
|
|
|
|
catch (Exception ex) {
|
|
throw ex;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
"@
|
|
|
|
add-type $AdjustTokenPrivileges
|
|
|
|
Function SetPrivilegeTokens() {
|
|
# Set privilege tokens only if admin.
|
|
# Admins would have these privs or be able to set these privs in the UI Anyway
|
|
|
|
$adminRole=[System.Security.Principal.WindowsBuiltInRole]::Administrator
|
|
$myWindowsID=[System.Security.Principal.WindowsIdentity]::GetCurrent()
|
|
$myWindowsPrincipal=new-object System.Security.Principal.WindowsPrincipal($myWindowsID)
|
|
|
|
|
|
if ($myWindowsPrincipal.IsInRole($adminRole)) {
|
|
|
|
# See the following for details of each privilege
|
|
# https://msdn.microsoft.com/en-us/library/windows/desktop/bb530716(v=vs.85).aspx
|
|
|
|
[void][Ansible.TokenManipulator]::AddPrivilege("SeRestorePrivilege") #Grants all write access control to any file, regardless of ACL.
|
|
[void][Ansible.TokenManipulator]::AddPrivilege("SeBackupPrivilege") #Grants all read access control to any file, regardless of ACL.
|
|
[void][Ansible.TokenManipulator]::AddPrivilege("SeTakeOwnershipPrivilege") #Grants ability to take owernship of an object w/out being granted discretionary access
|
|
}
|
|
}
|
|
|
|
|
|
$params = Parse-Args $args;
|
|
|
|
$result = @{
|
|
changed = $false
|
|
}
|
|
|
|
$path = Get-Attr $params "path" -failifempty $true
|
|
$user = Get-Attr $params "user" -failifempty $true
|
|
$rights = Get-Attr $params "rights" -failifempty $true
|
|
|
|
$type = Get-Attr $params "type" -failifempty $true -validateSet "allow","deny" -resultobj $result
|
|
$state = Get-Attr $params "state" "present" -validateSet "present","absent" -resultobj $result
|
|
|
|
$inherit = Get-Attr $params "inherit" ""
|
|
$propagation = Get-Attr $params "propagation" "None" -validateSet "None","NoPropagateInherit","InheritOnly" -resultobj $result
|
|
|
|
If (-Not (Test-Path -Path $path)) {
|
|
Fail-Json $result "$path file or directory does not exist on the host"
|
|
}
|
|
|
|
# Test that the user/group is resolvable on the local machine
|
|
$sid = UserSearch -AccountName ($user)
|
|
if (!$sid)
|
|
{
|
|
Fail-Json $result "$user is not a valid user or group on the host machine or domain"
|
|
}
|
|
|
|
If (Test-Path -Path $path -PathType Leaf) {
|
|
$inherit = "None"
|
|
}
|
|
ElseIf ($inherit -eq "") {
|
|
$inherit = "ContainerInherit, ObjectInherit"
|
|
}
|
|
|
|
$ErrorActionPreference = "Stop"
|
|
|
|
Try {
|
|
SetPrivilegeTokens
|
|
If ($path -match "^HK(CC|CR|CU|LM|U):\\") {
|
|
$colRights = [System.Security.AccessControl.RegistryRights]$rights
|
|
}
|
|
Else {
|
|
$colRights = [System.Security.AccessControl.FileSystemRights]$rights
|
|
}
|
|
|
|
$InheritanceFlag = [System.Security.AccessControl.InheritanceFlags]$inherit
|
|
$PropagationFlag = [System.Security.AccessControl.PropagationFlags]$propagation
|
|
|
|
If ($type -eq "allow") {
|
|
$objType =[System.Security.AccessControl.AccessControlType]::Allow
|
|
}
|
|
Else {
|
|
$objType =[System.Security.AccessControl.AccessControlType]::Deny
|
|
}
|
|
|
|
$objUser = New-Object System.Security.Principal.SecurityIdentifier($sid)
|
|
If ($path -match "^HK(CC|CR|CU|LM|U):\\") {
|
|
$objACE = New-Object System.Security.AccessControl.RegistryAccessRule ($objUser, $colRights, $InheritanceFlag, $PropagationFlag, $objType)
|
|
}
|
|
Else {
|
|
$objACE = New-Object System.Security.AccessControl.FileSystemAccessRule ($objUser, $colRights, $InheritanceFlag, $PropagationFlag, $objType)
|
|
}
|
|
$objACL = Get-ACL $path
|
|
|
|
# Check if the ACE exists already in the objects ACL list
|
|
$match = $false
|
|
|
|
# Workaround to handle special use case 'APPLICATION PACKAGE AUTHORITY\ALL APPLICATION PACKAGES' and
|
|
# 'APPLICATION PACKAGE AUTHORITY\ALL RESTRICTED APPLICATION PACKAGES'- can't translate fully qualified name (win32 API bug/oddity)
|
|
# 'ALL APPLICATION PACKAGES' exists only on Win2k12 and Win2k16 and 'ALL RESTRICTED APPLICATION PACKAGES' exists only in Win2k16
|
|
$specialIdRefs = "ALL APPLICATION PACKAGES","ALL RESTRICTED APPLICATION PACKAGES"
|
|
ForEach($rule in $objACL.Access){
|
|
$idRefShortValue = ($rule.IdentityReference.Value).split('\')[-1]
|
|
|
|
if ( $idRefShortValue -in $specialIdRefs ) {
|
|
$ruleIdentity = (New-Object Security.Principal.NTAccount $idRefShortValue).Translate([Security.Principal.SecurityIdentifier])
|
|
}
|
|
else {
|
|
$ruleIdentity = $rule.IdentityReference.Translate([System.Security.Principal.SecurityIdentifier])
|
|
}
|
|
|
|
If ($path -match "^HK(CC|CR|CU|LM|U):\\") {
|
|
If (($rule.RegistryRights -eq $objACE.RegistryRights) -And ($rule.AccessControlType -eq $objACE.AccessControlType) -And ($ruleIdentity -eq $objACE.IdentityReference) -And ($rule.IsInherited -eq $objACE.IsInherited) -And ($rule.InheritanceFlags -eq $objACE.InheritanceFlags) -And ($rule.PropagationFlags -eq $objACE.PropagationFlags)) {
|
|
$match = $true
|
|
Break
|
|
}
|
|
} else {
|
|
If (($rule.FileSystemRights -eq $objACE.FileSystemRights) -And ($rule.AccessControlType -eq $objACE.AccessControlType) -And ($ruleIdentity -eq $objACE.IdentityReference) -And ($rule.IsInherited -eq $objACE.IsInherited) -And ($rule.InheritanceFlags -eq $objACE.InheritanceFlags) -And ($rule.PropagationFlags -eq $objACE.PropagationFlags)) {
|
|
$match = $true
|
|
Break
|
|
}
|
|
}
|
|
}
|
|
|
|
If ($state -eq "present" -And $match -eq $false) {
|
|
Try {
|
|
$objACL.AddAccessRule($objACE)
|
|
Set-ACL $path $objACL
|
|
$result.changed = $true
|
|
}
|
|
Catch {
|
|
Fail-Json $result "an exception occurred when adding the specified rule - $($_.Exception.Message)"
|
|
}
|
|
}
|
|
ElseIf ($state -eq "absent" -And $match -eq $true) {
|
|
Try {
|
|
$objACL.RemoveAccessRule($objACE)
|
|
Set-ACL $path $objACL
|
|
$result.changed = $true
|
|
}
|
|
Catch {
|
|
Fail-Json $result "an exception occurred when removing the specified rule - $($_.Exception.Message)"
|
|
}
|
|
}
|
|
Else {
|
|
# A rule was attempting to be added but already exists
|
|
If ($match -eq $true) {
|
|
Exit-Json $result "the specified rule already exists"
|
|
}
|
|
# A rule didn't exist that was trying to be removed
|
|
Else {
|
|
Exit-Json $result "the specified rule does not exist"
|
|
}
|
|
}
|
|
}
|
|
Catch {
|
|
Fail-Json $result "an error occurred when attempting to $state $rights permission(s) on $path for $user - $($_.Exception.Message)"
|
|
}
|
|
|
|
Exit-Json $result
|