# AWS Session Manager Plugin

Complemento de AWS CLI para sesiones autorizadas de shell, transporte SSH y reenvío de puertos a nodos administrados por Systems Manager; sin aplicación de escritorio independiente.

> Esta es la versión en Markdown de la página de AWS Session Manager Plugin en OpenNavo, con el mismo contenido que la página web: <https://opennavo.com/es/apps/session-manager-plugin>

- **Última versión**: `1.2.896.0`
- **Desarrollador**: Amazon Web Services
- **Inicio**: <https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html>
- **Categorías**: [Herramientas de desarrollo](https://opennavo.com/es/categories/developer-tools)
- **Instalación**: `brew install --cask session-manager-plugin`
- **Instalaciones en los últimos 30 días**: 14.585
- **Homebrew**: Se puede instalar; la actualiza Homebrew
- **URL de descarga**: <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
- **SHA-256**: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`
- **Comandos incluidos**: session-manager-plugin
- **Paquete de instalación**: session-manager-plugin.pkg

SHA-256 solo comprueba que la descarga esté completa; no es una certificación de seguridad.

## Contenido de instalación y desinstalación

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "pkgutil": "session-manager-plugin"
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "session-manager-plugin.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "session-manager-plugin.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "binary": [
        "/usr/local/sessionmanagerplugin/bin/session-manager-plugin"
      ],
      "target": "$HOMEBREW_PREFIX/bin/session-manager-plugin"
    },
    "phase": "install",
    "sources": [
      "/usr/local/sessionmanagerplugin/bin/session-manager-plugin"
    ],
    "target": "$HOMEBREW_PREFIX/bin/session-manager-plugin",
    "type": "binary"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "/Library/LaunchDaemons/SessionManagerPlugin.plist"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## Descripción

El complemento Session Manager permite que AWS CLI inicie sesiones interactivas de shell, de transporte SSH y de reenvío de puertos a nodos administrados por AWS Systems Manager. Es un componente local de línea de comandos para administradores de la nube, desarrolladores y equipos de operaciones; no es el SSM Agent instalado en los nodos remotos ni una aplicación de escritorio independiente.

### Funciones
- Iniciar y finalizar sesiones mediante comandos de AWS CLI y autorización de IAM.
- Acceder a nodos administrados sin abrir puertos SSH entrantes para las sesiones de shell ordinarias de Session Manager.
- Reenviar puertos a nodos administrados o a hosts remotos accesibles mediante documentos de sesión compatibles.
- Usar perfiles de shell de sesión configurados y opciones de registro de AWS cuando el tipo de sesión lo permita.
- Usar secuencias de escape de shell al estilo SSH en la versión 1.2.835.0, incluidas ~. para terminar y ~? para obtener ayuda.

### Instalación y primer uso en macOS
Instala `brew install --cask session-manager-plugin`. El cask instala el PKG oficial firmado y específico para cada arquitectura en /usr/local/sessionmanagerplugin, y enlaza su ejecutable en el directorio bin de Homebrew. Puede ser necesaria la aprobación de un administrador. Comprueba `session-manager-plugin --version` y la configuración de AWS CLI y, a continuación, inicia una sesión autorizada con `aws ssm start-session --target i-EXAMPLE`. Sustituye el ejemplo por el ID de un nodo administrado real y selecciona la región y el perfil correctos. Estas son instrucciones, no afirmaciones de que se haya probado una sesión en tu cuenta.

### Dependencias y requisitos previos remotos
AWS documenta AWS CLI 1.16.12 o posterior como requisito local mínimo; utiliza una versión de CLI que siga teniendo soporte. Necesitas credenciales de AWS con los permisos de IAM adecuados. Los nodos remotos necesitan SSM Agent, un rol de instancia adecuado o una configuración de activación híbrida, y conectividad saliente a los endpoints de Systems Manager necesarios. El requisito previo básico para las sesiones es SSM Agent 2.3.68.0 o posterior; el reenvío de puertos y otras funciones pueden requerir versiones más recientes del agente. Un complemento local no convierte una máquina no administrada en un nodo administrado. El uso de SSH sobre Session Manager también requiere la configuración habitual del cliente y el servidor SSH, así como de la autenticación.

El PKG firmado que utiliza Homebrew es distinto del paquete ZIP alternativo de AWS. AWS documenta Python 3.10 o posterior para el script de instalación ZIP; no consideres ese requisito del script como una dependencia adicional de ejecución de Homebrew. Go y las herramientas de compilación mencionadas en el README del código fuente son para compilar desde el código fuente. Homebrew no declara dependencias adicionales de fórmula, un requisito explícito de versión mínima de macOS ni conflictos con paquetes. Las instalaciones manuales existentes o los enlaces de PATH pueden entrar en conflicto con la ubicación del ejecutable de cask; comprueba el binario seleccionado antes de reinstalar.

### Compatibilidad con plataformas
AWS proporciona paquetes nativos para Mac Intel y Apple Silicon, además de instaladores independientes para Windows y Linux. Este Homebrew cask instala únicamente el paquete para Mac. La guía de instalación citada por AWS no especifica una versión mínima universal de macOS, por lo que aquí no se afirma ninguna versión mínima sin respaldo. La compatibilidad del sistema operativo de los nodos administrados es un requisito independiente de Systems Manager y no equivale a la compatibilidad del host local del complemento. No es una aplicación para iOS ni Android. Actualmente, AWS requiere el complemento 1.2.764.0 o posterior para las operaciones admitidas; la versión indicada, 1.2.835.0, supera ese mínimo.

### Cuentas, costes y licencia
El complemento es de código abierto bajo la Licencia Apache 2.0 y no tiene una suscripción independiente. Para utilizarlo se necesita una cuenta de AWS o acceso autorizado a una. Los recursos de EC2, la administración híbrida o avanzada, el registro, el almacenamiento, los servicios de red y otras capacidades opcionales de AWS pueden generar cargos; instalar un complemento gratuito no hace que los recursos en la nube asociados sean gratuitos. Consulta los precios actuales de AWS para la configuración prevista. Se puede configurar el registro de las sesiones de shell ordinarias, pero el contenido de SSH y del reenvío de puertos tiene distintas limitaciones de registro.

### Referencias oficiales
- [Repositorio del complemento y licencia Apache](https://github.com/aws/session-manager-plugin)
- [Instalación del complemento](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
- [Instaladores para macOS](https://docs.aws.amazon.com/systems-manager/latest/userguide/install-plugin-macos-overview.html)
- [Requisitos previos de las sesiones](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-prerequisites.html)
- [Historial de versiones](https://docs.aws.amazon.com/systems-manager/latest/userguide/plugin-version-history.html)
- [Precios de Systems Manager](https://aws.amazon.com/systems-manager/pricing/)

## Requisitos del sistema

- Versión para macOS 27, 26, 15, 14, 13, 12, 11 · Versión de la app: 1.2.896.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Comprobado el 2026-11-22
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac/session-manager-plugin.pkg>
  - SHA-256: `d9d960f04acb5ba419e0a12f769f9af4f3263e098b9b63e2de659189c138341a`
- Versión para macOS 27, 26, 15, 14, 13, 12, 11 · Versión de la app: 1.2.896.0 · Chip Apple · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Comprobado el 2026-11-22
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
  - SHA-256: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`

## Datos de seguridad de AWS Session Manager Plugin

Aquí solo aparecen datos verificables, cada uno con su fuente y su fecha; no es una certificación de seguridad. Para comprobar los archivos que has descargado, puedes analizarlos en tu Mac con OpenNavo.

- <https://github.com/aws/session-manager-plugin> · Código abierto: Sí — <https://github.com/aws/session-manager-plugin> · Comprobado el 2026-11-13

## Desinstalación

- `brew uninstall --cask session-manager-plugin`

Una desinstalación normal elimina la App y conserva sus ajustes y cachés.

### Qué más gestiona la desinstalación

- Recibos de instalación (pkgutil): `session-manager-plugin` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Estas entradas proceden de la definición de Homebrew, comprobada el 2026-11-22. Solo indican lo que la definición declara que se eliminará, no que todo esté en tu Mac.

### Limpieza a fondo (opcional)

- `brew uninstall --zap --cask session-manager-plugin`

`--zap` también borra los ajustes, cachés y otros archivos que indica la definición de Homebrew. Pueden incluir datos compartidos con otras apps y no se pueden recuperar tras borrarlos; tampoco garantiza que no quede ningún resto. Haz primero una copia de seguridad de los datos que necesites conservar. Para conservar los ajustes y cachés, no añadas `--zap`.

Una desinstalación normal elimina la App y conserva sus ajustes y cachés.

- Archivos y carpetas: `/Library/LaunchDaemons/SessionManagerPlugin.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Estas entradas proceden de la definición de Homebrew, comprobada el 2026-11-22. Solo indican lo que la definición declara que se eliminará, no que todo esté en tu Mac.

## Notas de la última versión

### 1.2.896.0 (2026-10-21)

Revierte el cambio titulado «Comprobar el motivo de fallo de la sesión y evitar sesiones bloqueadas».

Revierte el cambio titulado «Comprobar el motivo de fallo de la sesión y evitar sesiones bloqueadas».

Source: https://github.com/aws/session-manager-plugin/releases/tag/1.2.896.0

## Datos y fuentes

- <https://opennavo.com/es/apps/session-manager-plugin>
- <https://opennavo.com/es/apps/session-manager-plugin/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · Comprobado el 2026-11-22
- <https://formulae.brew.sh/cask/session-manager-plugin>
- <https://github.com/aws/session-manager-plugin> · Comprobado el 2026-11-13
