Configurazione di SSM Agent per utilizzare un proxy per le istanze Windows Server - AWS Systems Manager
Precedenza impostazione proxy SSM AgentImpostazioni del proxy di SSM Agent e servizi di Systems Manager

AWS Systems ManagerChange Managernon è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta AWS Systems ManagerChange Managerla pagina Modifica della disponibilità.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configurazione di SSM Agent per utilizzare un proxy per le istanze Windows Server

Le informazioni incluse in questo argomento valgono per le istanze di Windows Server create a partire da novembre 2016 che non utilizzano l'opzione di installazione Nano. Se intendi utilizzare Session Manager, ricorda che i server proxy HTTPS non sono supportati.

Prima di iniziare

Prima di configurare SSM Agent per l'utilizzo di un proxy, considera quanto segue.

Nella procedura seguente, si esegue un comando per configurare SSM Agent per l'utilizzo di un proxy. Il comando include un'impostazione no_proxy con un indirizzo IP. L'indirizzo IP è l'endpoint dei servizi di metadati di istanza (IMDS) per Systems Manager. Se non viene specificatono_proxy, le chiamate a Systems Manager acquisiscono l'identità del servizio proxy (se il IMDSv1 fallback è abilitato) o le chiamate a Systems Manager hanno esito negativo (se IMDSv2 applicato).

  • Per IPv4, specificare. no_proxy=169.254.169.254

  • Per IPv6, specificano_proxy=[fd00:ec2::254]. L' IPv6 indirizzo del servizio di metadati dell'istanza è compatibile con IMDSv2 i comandi. L' IPv6 indirizzo è accessibile solo sulle istanze create sul sistema AWS Nitro. Per ulteriori informazioni, consulta come funziona Instance Metadata Service versione 2 nella Amazon EC2 User Guide.

Per configurare l'SSM Agent per l'utilizzo di un proxy

  1. Utilizzando Remote Desktop o Windows PowerShell, connettiti all'istanza che desideri configurare per utilizzare un proxy.

  2. Esegui il seguente blocco di comandi in PowerShell. Sostituisci hostname e port con le informazioni sul tuo proxy.

    $serviceKey = "HKLM:\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent"
$keyInfo = (Get-Item -Path $serviceKey).GetValue("Environment")
$proxyVariables = @("http_proxy=hostname:port", "https_proxy=hostname:port", "no_proxy=IP address for instance metadata services (IMDS)")

if ($keyInfo -eq $null) {
    New-ItemProperty -Path $serviceKey -Name Environment -Value $proxyVariables -PropertyType MultiString -Force
} else {
    Set-ItemProperty -Path $serviceKey -Name Environment -Value $proxyVariables
}

Restart-Service AmazonSSMAgent

Dopo aver eseguito il comando precedente, è possibile esaminare i registri SSM Agent per confermare che le impostazioni proxy siano state applicate. Le voci nei registri sono simili alle seguenti. Per ulteriori informazioni sui log SSM Agent, consulta Visualizzazione dei registri di SSM Agent.

2020-02-24 15:31:54 INFO Getting IE proxy configuration for current user: The operation completed successfully.
2020-02-24 15:31:54 INFO Getting WinHTTP proxy default configuration: The operation completed successfully.
2020-02-24 15:31:54 INFO Proxy environment variables:
2020-02-24 15:31:54 INFO http_proxy: hostname:port
2020-02-24 15:31:54 INFO https_proxy: hostname:port
2020-02-24 15:31:54 INFO no_proxy: IP address for instance metadata services (IMDS)
2020-02-24 15:31:54 INFO Starting Agent: amazon-ssm-agent - v2.3.871.0
2020-02-24 15:31:54 INFO OS: windows, Arch: amd64
Per reimpostare la configurazione proxy dell'SSM Agent

  1. Utilizzando Remote Desktop o Windows PowerShell, connettiti all'istanza da configurare.

  2. Se ti sei connesso tramite Remote Desktop, avvia PowerShell come amministratore.

  3. Esegui il seguente blocco di comandi in PowerShell.

    Remove-ItemProperty -Path HKLM:\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent -Name Environment
Restart-Service AmazonSSMAgent

Precedenza impostazione proxy SSM Agent

Quando si configurano le impostazioni proxy per le istanze SSM Agent su Windows Server, è importante capire che queste impostazioni vengono valutate e applicate alla configurazione dell'agente quando SSM Agent viene avviato. La modalità di configurazione delle impostazioni proxy per un'istanza Windows Server consente di determinare se altre impostazioni potrebbero sostituire quelle desiderate. L'agente utilizza le prime impostazioni proxy che trova.

Importante

SSM Agent comunica utilizzando il protocollo HTTPS. Per questo motivo, è necessario configurare il parametro HTTPS proxy utilizzando una delle seguenti opzioni di impostazione.

Le impostazioni proxy di SSM Agent sono valutate nel seguente ordine.

  1. Impostazioni del registro AmazonSSMAgent (HKLM:\SYSTEM\CurrentControlSet\Services\AmazonSSMAgent)

  2. Variabili di ambiente System (http_proxy, https_proxy, no_proxy)

  3. Variabili di ambiente dell'account utente LocalSystem (http_proxy, https_proxy, no_proxy)

  4. Impostazioni del browser (HTTP, secure, exceptions)

  5. Impostazioni del proxy WinHTTP (http=, https=, bypass-list=)

Impostazioni del proxy di SSM Agent e servizi di Systems Manager

Se lo hai configurato SSM Agent per utilizzare un proxy e utilizzi AWS Systems Manager strumenti come Run Command e Patch Manager che utilizzano PowerShell il client Windows Update durante la loro esecuzione sulle Windows Server istanze, configura impostazioni proxy aggiuntive. In caso contrario, l'operazione potrebbe non riuscire perché le impostazioni proxy utilizzate dal PowerShell client Windows Update non vengono ereditate dalla configurazione del SSM Agent proxy.

Per Run Command, configurare le impostazioni del proxy WinINet sulle istanze di Windows Server. I comandi [System.Net.WebRequest] forniti sono per sessione. Per applicare queste configurazioni ai comandi di rete successivi eseguiti inRun Command, questi comandi devono precedere gli altri PowerShell comandi nello stesso aws:runPowershellScript input del plug-in.

I seguenti PowerShell comandi restituiscono le impostazioni WinINet proxy correnti e applicano le impostazioni proxy a. WinINet

[System.Net.WebRequest]::DefaultWebProxy

$proxyServer = "http://hostname:port"
$proxyBypass = "169.254.169.254"
$WebProxy = New-Object System.Net.WebProxy($proxyServer,$true,$proxyBypass)

[System.Net.WebRequest]::DefaultWebProxy = $WebProxy

Per Patch Manager, configurare le impostazioni proxy a livello di sistema in modo che il client Windows Update possa eseguire la scansione e il download degli aggiornamenti. Si consiglia di utilizzare Run Command per eseguire i comandi seguenti perché questi vengono eseguiti sull'account SYSTEM e le impostazioni si applicano a livello di sistema. I seguenti comandi netsh restituiscono le impostazioni del proxy corrente e applicano le impostazioni del proxy al sistema locale.

netsh winhttp show proxy

netsh winhttp set proxy proxy-server="hostname:port" bypass-list="169.254.169.254"

Per ulteriori informazioni sull'utilizzo di Run Command, consultare AWS Systems Manager Run Command.