AWS systems-manager documentation change
Summary
Restructured installation documentation to emphasize signed installer, added architecture-specific download commands, and clarified security aspects of package signing
Security assessment
Added explicit note about signed installer packages and verification steps, which relates to security best practices for authentic software installation. However, no specific vulnerability is addressed.
Diff
diff --git a/systems-manager/latest/userguide/install-plugin-macos-overview.md b/systems-manager/latest/userguide/install-plugin-macos-overview.md index a74b70325..e384677c7 100644 --- a//systems-manager/latest/userguide/install-plugin-macos-overview.md +++ b//systems-manager/latest/userguide/install-plugin-macos-overview.md @@ -5 +5 @@ -Install the Session Manager plugin on macOSInstall the Session Manager plugin on macOS with the signed installer +Install the Session Manager plugin on macOS with the signed installerInstall the Session Manager plugin on macOS @@ -9 +9 @@ Install the Session Manager plugin on macOSInstall the Session Manager plugin on -Choose one of the following topics to install the Session Manager plugin on macOS. The bundled installer uses a ZIP file. Once unzipped, you can install the plugin using the binary. The signed installer is a signed .pkg file. +Choose one of the following topics to install the Session Manager plugin on macOS. @@ -11 +11,9 @@ Choose one of the following topics to install the Session Manager plugin on macO -###### Topics +###### Note + +The signed installer is a signed `.pkg` file. The bundled installer uses a `.zip` file. After the file is unzipped, you can install the plugin using the binary. + +## Install the Session Manager plugin on macOS with the signed installer + +This section describes how to install the Session Manager plugin on macOS using the signed installer. + +###### To install the Session Manager plugin using the signed installer (macOS) @@ -13 +21 @@ Choose one of the following topics to install the Session Manager plugin on macO - * Install the Session Manager plugin on macOS + 1. Download the signed installer. @@ -15 +23,16 @@ Choose one of the following topics to install the Session Manager plugin on macO - * Install the Session Manager plugin on macOS with the signed installer +x86_64 + + + curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/session-manager-plugin.pkg" -o "session-manager-plugin.pkg" + +Mac with Apple silicon + + + curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac_arm64/session-manager-plugin.pkg" -o "session-manager-plugin.pkg" + + 2. Run the install commands. If the command fails, verify that the `/usr/local/bin` folder exists. If it doesn't, create it and run the command again. + + sudo installer -pkg session-manager-plugin.pkg -target / + sudo ln -s /usr/local/sessionmanagerplugin/bin/session-manager-plugin /usr/local/bin/session-manager-plugin + + 3. Verify that the installation was successful. For information, see [Verify the Session Manager plugin installation](./install-plugin-verify.html). @@ -84,28 +106,0 @@ To uninstall the plugin, run the following two commands in the order shown. -## Install the Session Manager plugin on macOS with the signed installer - -This section describes how to install the Session Manager plugin on macOS using the signed installer. - -###### To install the Session Manager plugin using the signed installer (macOS) - - 1. Download the signed installer. - -x86_64 - - - curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac/session-manager-plugin.pkg" -o "session-manager-plugin.pkg" - -Mac with Apple silicon - - - curl "https://s3.amazonaws.com/session-manager-downloads/plugin/latest/mac_arm64/session-manager-plugin.pkg" -o "session-manager-plugin.pkg" - - 2. Run the install commands. If the command fails, verify that the `/usr/local/bin` folder exists. If it doesn't, create it and run the command again. - - sudo installer -pkg session-manager-plugin.pkg -target / - sudo ln -s /usr/local/sessionmanagerplugin/bin/session-manager-plugin /usr/local/bin/session-manager-plugin - - 3. Verify that the installation was successful. For information, see [Verify the Session Manager plugin installation](./install-plugin-verify.html). - - - -