AWS deadline-cloud medium security documentation change
Summary
Added new 'Securing your worker host' section with log folder permission guidance for Linux/Windows to prevent unauthorized access to sensitive logs
Security assessment
Explicitly addresses security by restricting log access to prevent exposure of sensitive information from scripts/jobs. Provides concrete ACL configurations to mitigate unauthorized data access risks.
Diff
diff --git a/deadline-cloud/latest/developerguide/worker-host.md b/deadline-cloud/latest/developerguide/worker-host.md index 177672da3..0bf3c825b 100644 --- a//deadline-cloud/latest/developerguide/worker-host.md +++ b//deadline-cloud/latest/developerguide/worker-host.md @@ -5 +5 @@ -Configure a Python environmentInstall worker agentConfigure worker agentCreate job users and groups +Configure a Python environmentInstall worker agentConfigure worker agentCreate job users and groupsSecuring your worker host @@ -253,0 +254,57 @@ To use a Windows user as the `jobRunAsUser`, it must meet the following requirem +## Securing your worker host + +When setting up your worker host, follow security best practices to protect sensitive information and maintain proper access controls. + +### Configuring log folder permissions + +The worker agent writes log files that may contain sensitive information from host configuration scripts and job execution. The `install-deadline-worker` command creates the log directory with secure permissions. If you need to create the directory manually before installation, use the following procedures to match the permissions used by service-managed fleets: + +Linux + + +###### To configure log directory permissions on Linux + + 1. Create the log directory: + + sudo mkdir -p /var/log/amazon/deadline + + 2. Set the owner and group to the worker agent user: + + sudo chown -R deadline-worker:deadline-worker /var/log/amazon/deadline + + 3. Set permissions to 750: + + sudo chmod -R 750 /var/log/amazon/deadline + +These permissions ensure that only the worker agent user and group can access the log files, preventing job users and other unauthorized users from reading potentially sensitive information. + + + + +Windows + + +###### To configure log directory permissions on Windows + + 1. Open an administrator PowerShell terminal. + + 2. Create the log directory: + + New-Item -ItemType Directory -Force -Path "$env:PROGRAMDATA\Amazon\Deadline\Logs" + + 3. Configure restricted ACLs to allow only the worker agent user and Administrators: + + $acl = Get-Acl "$env:PROGRAMDATA\Amazon\Deadline\Logs" + $acl.SetAccessRuleProtection($true, $false) + $acl.Access | ForEach-Object { $acl.RemoveAccessRule($_) } + $agentRule = New-Object System.Security.AccessControl.FileSystemAccessRule("deadline-worker", "FullControl", "ContainerInherit,ObjectInherit", "None", "Allow") + $adminRule = New-Object System.Security.AccessControl.FileSystemAccessRule("Administrators", "FullControl", "ContainerInherit,ObjectInherit", "None", "Allow") + $acl.AddAccessRule($agentRule) + $acl.AddAccessRule($adminRule) + Set-Acl "$env:PROGRAMDATA\Amazon\Deadline\Logs" $acl + +These commands restrict access to the log directory to only the worker agent user and Administrators group, preventing job users and other unauthorized users from reading potentially sensitive information. + + + +