# AWS Session Manager Plugin

Systems Manager管理対象ノードへの認可済みシェル、SSHトランスポート、ポートフォワーディングセッションを提供するAWS CLIプラグイン。別途デスクトップアプリは不要。

> これは OpenNavo の AWS Session Manager Plugin ページの Markdown 版で、内容はウェブページと同じです： <https://opennavo.com/ja/apps/session-manager-plugin>

- **最新バージョン**: `1.2.896.0`
- **開発元**: Amazon Web Services
- **ホームページ**: <https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html>
- **カテゴリ**: [開発ツール](https://opennavo.com/ja/categories/developer-tools)
- **インストール**: `brew install --cask session-manager-plugin`
- **過去 30 日間のインストール数**: 14,585
- **Homebrew**: インストール可能、Homebrew で更新
- **ダウンロードURL**: <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
- **SHA-256**: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`
- **付属コマンド**: session-manager-plugin
- **インストーラーパッケージ**: session-manager-plugin.pkg

SHA-256 はダウンロードしたファイルが完全かを確かめるためのもので、安全性の認証ではありません。

## インストールとアンインストールの内容

```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"
  }
]
```

## 紹介

Session Manager pluginを使うと、AWS CLIからAWS Systems Managerの管理対象ノードへの対話型シェル、SSHトランスポート、ポートフォワーディングのセッションを開始できます。クラウド管理者、開発者、運用チーム向けのローカルコマンドラインコンポーネントであり、リモートノードにインストールするSSM Agentでも、単体のデスクトップアプリでもありません。

### 機能
- AWS CLIコマンドとIAM認可を通じてセッションを開始、終了します。
- 通常のSession Managerシェルセッションでは、インバウンドSSHポートを開かずに管理対象ノードへアクセスできます。
- サポート対象のセッションドキュメントを使用して、管理対象ノードまたは到達可能なリモートホストにポートを転送できます。
- セッションの種類が対応する場合、設定済みのセッションシェルプロファイルやAWSのログ記録オプションを使用できます。
- バージョン1.2.835.0では、SSH形式のシェルエスケープシーケンス（終了するには~.、ヘルプには~?）を使用できます。

### macOSへのインストールと初回利用
`brew install --cask session-manager-plugin`をインストールします。caskは、公式のアーキテクチャ別署名付きPKGを/usr/local/sessionmanagerpluginにインストールし、実行ファイルをHomebrewのbinディレクトリにリンクします。管理者による承認が必要な場合があります。`session-manager-plugin --version`とAWS CLIの設定を確認し、認可されたセッションを`aws ssm start-session --target i-EXAMPLE`で開始します。例の値を実際の管理対象ノードIDに置き換え、適切なリージョンとプロファイルを選択してください。これは手順の説明であり、お客様のアカウントでセッションの動作を確認したという意味ではありません。

### 依存関係とリモート側の前提条件
AWSの説明では、ローカル環境の最小要件はAWS CLI 1.16.12以降です。現在サポートされているCLIリリースを使用してください。適切なIAM権限を持つAWS認証情報が必要です。リモートノードには、SSM Agent、適切なインスタンスロールまたはハイブリッドアクティベーション設定、および必要なSystems Managerエンドポイントへのアウトバウンド接続が必要です。基本的なセッションの前提条件はSSM Agent 2.3.68.0以降です。ポートフォワーディングなどの機能には、より新しいAgentバージョンが必要な場合があります。ローカルプラグインをインストールしても、未管理のマシンが管理対象ノードになるわけではありません。Session Manager経由のSSHには、通常のSSHクライアント／サーバーと認証の設定も必要です。

Homebrewで使用する署名付きPKGは、AWSが提供する別のZIPバンドルとは異なります。AWSは、ZIPインストーラースクリプトにPython 3.10以降を必要とすると説明しています。このスクリプトの要件を、Homebrewの追加ランタイム依存関係とみなさないでください。ソースREADMEに記載されているGoとビルドツールは、ソースからビルドする場合に必要です。Homebrewでは、追加のformula依存関係、macOSの明示的な最小バージョン、パッケージの競合は宣言されていません。既存の手動インストールやPATHリンクがcaskの実行ファイルの配置先と競合する場合があります。再インストールする前に、選択されているバイナリを確認してください。

### プラットフォームのサポート
AWSは、macOSのIntel版とApple Silicon版のネイティブパッケージに加え、Windows用とLinux用の個別のインストーラーを提供しています。このHomebrewのcaskでインストールされるのはMac用パッケージのみです。AWSが参照するインストールガイドには、macOSの共通の数値による最小バージョンが指定されていないため、ここでは根拠のない最小要件を示していません。管理対象ノードのOSサポートはSystems Managerの別要件であり、プラグインを実行するローカルホストのサポートとは異なります。これはiOSまたはAndroidアプリではありません。AWSは、サポート対象の操作にプラグイン1.2.764.0以降を現在必要としています。記載されている1.2.835.0はこの最小要件を上回っています。

### アカウント、料金、ライセンス
このプラグインはApache License 2.0に基づくオープンソースであり、プラグイン自体に別途サブスクリプション料金はありません。運用にはAWSアカウント、またはアカウントへの認可済みアクセスが必要です。EC2リソース、ハイブリッド／高度な管理、ログ記録、ストレージ、ネットワークサービス、その他の任意のAWS機能には料金が発生する場合があります。無料のプラグインをインストールしても、周辺のクラウドリソースが無料になるわけではありません。予定している構成について、AWSの最新料金を確認してください。通常のシェルセッションではログ記録を設定できますが、SSHおよびポートフォワーディングされたコンテンツには異なるログ記録上の制限があります。

### 公式リファレンス
- [プラグインのリポジトリとApacheライセンス](https://github.com/aws/session-manager-plugin)
- [プラグインのインストール](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html)
- [macOSインストーラー](https://docs.aws.amazon.com/systems-manager/latest/userguide/install-plugin-macos-overview.html)
- [セッションの前提条件](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-prerequisites.html)
- [リリース履歴](https://docs.aws.amazon.com/systems-manager/latest/userguide/plugin-version-history.html)
- [Systems Managerの料金](https://aws.amazon.com/systems-manager/pricing/)

## システム要件

- macOS 27, 26, 15, 14, 13, 12, 11 向けのビルド · アプリのバージョン: 1.2.896.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 2026-11-21 に確認
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac/session-manager-plugin.pkg>
  - SHA-256: `d9d960f04acb5ba419e0a12f769f9af4f3263e098b9b63e2de659189c138341a`
- macOS 27, 26, 15, 14, 13, 12, 11 向けのビルド · アプリのバージョン: 1.2.896.0 · Apple シリコン · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 2026-11-21 に確認
  - <https://session-manager-downloads.s3.amazonaws.com/plugin/1.2.896.0/mac_arm64/session-manager-plugin.pkg>
  - SHA-256: `b95139a76cb473654d92185c200ac65205244b20f96aeb240b53837ba4973084`

## AWS Session Manager Plugin のセキュリティ情報

ここでは確認できる事実だけを、出典と日付を添えて掲載しています。安全性を認証するものではありません。ダウンロードしたファイルを確かめるには、OpenNavo を使ってお使いの Mac 上でスキャンできます。

- <https://github.com/aws/session-manager-plugin> · オープンソース: はい — <https://github.com/aws/session-manager-plugin> · 2026-11-13 に確認

## アンインストール

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

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

### アンインストール時にあわせて処理されるもの

- インストール記録（pkgutil）: `session-manager-plugin` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 以上の項目は Homebrew の定義に基づくもので、2026-11-21 に確認しました。定義で削除対象と宣言されている内容を示すだけで、お使いの Mac にすべてがあるとは限りません。

### 完全な削除（任意）

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

`--zap` は Homebrew の定義に記載された設定やキャッシュなどのファイルも削除します。ほかのアプリと共有しているデータが含まれる場合があり、削除すると元に戻せません。何も残らないことを保証するものでもありません。残しておきたいデータは先にバックアップしてください。設定とキャッシュを残す場合は、`--zap` を付けないでください。

通常のアンインストールではアプリ本体だけを削除し、設定とキャッシュは残ります。

- ファイルとフォルダ: `/Library/LaunchDaemons/SessionManagerPlugin.plist` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 以上の項目は Homebrew の定義に基づくもので、2026-11-21 に確認しました。定義で削除対象と宣言されている内容を示すだけで、お使いの Mac にすべてがあるとは限りません。

## 最新バージョンのリリースノート

### 1.2.896.0 (2026-10-21)

「セッション失敗理由の確認とセッション停止の回避」という変更を元に戻しました。

「セッション失敗理由の確認とセッション停止の回避」という変更を元に戻しました。

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

## 情報と出典

- <https://opennavo.com/ja/apps/session-manager-plugin>
- <https://opennavo.com/ja/apps/session-manager-plugin/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/s/session-manager-plugin.rb> · 2026-11-21 に確認
- <https://formulae.brew.sh/cask/session-manager-plugin>
- <https://github.com/aws/session-manager-plugin> · 2026-11-13 に確認
