# EC2 Cloud Connector

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2FCDRRoe0Go0AsuvOBoN9K%2Fimage.png?alt=media&#x26;token=43348a0c-7b13-4f5d-b78a-429a7d787fad" alt=""><figcaption></figcaption></figure>

## はじめに

KCM Cloud Connectorと一緒にEC2インスタンスに接続するためのSSH鍵とWindowsのパスワードをKeeperボルトに保存できます。

KCMをAWS EC2インスタンスに接続する詳細は、[AWS EC2ディスカバリのドキュメント](https://newdocs.keeper.io/kcm-linux-rpm-method/using-keeper-connection-manager/aws-ec2-discovery)をご参照ください。

## 設定

### 有効化

Docker環境変数またはguacamoleプロパティを使用して、まずこの機能を有効にする必要があります。

#### Docker環境変数

Docker自動インストールメソッドおよびDocker Composeインストールメソッドの場合、`keeper/guacamole-db-mysql`イメージで、以下の新しい環境変数を定義する必要があります。

`AWS_DISCOVERY_KSM_CONFIG`

これには、Keeperシークレットマネージャーの設定が含まれている必要があります。これは、`KSM_CONFIG`変数で使用されるものと同じ設定にすることができます。

以下はその例です。

```
    guacamole:
        image: keeper/guacamole:2
        restart: unless-stopped
        ......
        AWS_DISCOVERY_KSM_CONFIG: "eyJob3N0bmFtZSI6ICJrZWVwZX.....=="
```

Linuxの高度なインストールメソッドの場合は、guacamole.propertiesファイルを更新します。

| プロパティ名                     | デフォルト値 | 説明                                               |
| -------------------------- | ------ | ------------------------------------------------ |
| `aws-discovery-ksm-config` | false  | KSMに接続されたボルトから取得したCloud Connectクレデンシャルの使用を有効化します |

#### PEMキーファイルのボリュームマウントを削除

Keeperを使用してPEMキーファイルを保存している場合は、Docker Composeファイル内の`/var/lib/guac_keys/`の場所を参照するボリュームマウントは、不要なため削除できます。

### Cloud Connectで使用するレコードを設定

EC2 Cloud Connectorは、特定のフィールドを含むKeeperのレコードを自動的に認識します。

EC2 Cloud Connectorで使用するレコードを作成するには、ご利用の鍵を含むpemファイル添付を格納するレコードを作成するか、または鍵をテキストとして格納するレコードを作成します。

### PEMファイルレコード

pemファイルを含む新しいレコードを作成します。 「ファイル添付」のレコードタイプはうまく一致しますが、「一般」以外のどのタイプでも問題ありません。

レコードのタイトルは自由です。この例では、「AWS key:my-machine」を使用しています。

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2Fyczh2R8AbtWLsl15H8xp%2Fimage.png?alt=media&#x26;token=546ff731-dfe0-47f6-b3aa-0432e63723ce" alt=""><figcaption><p>pemファイルを添付するレコードの新規作成</p></figcaption></figure>

レコード作成後、pemファイルを添付します。

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2FjitpHfUwyyxHnSKJCBdG%2Fimage.png?alt=media&#x26;token=26421431-7f09-44f0-b4bf-2d47c92babb5" alt=""><figcaption><p>新しいレコードにpemファイルを添付</p></figcaption></figure>

{% hint style="info" %}
必要に応じて、レコードにホスト名/IPフィールドとポートフィールドを含めると、KCMが、ホスト名/IPが一致するEC2接続にpemファイルを自動的に関連付けます。
{% endhint %}

最後に、新しいレコードがシークレットマネージャーのボルト接続を使用してKCMからアクセスできる共有フォルダ内にあることを確かにします。

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2F6fJ93FLrd8VztRAbAIX2%2Fimage.png?alt=media&#x26;token=fccdc7b8-2ac3-47a0-be55-f3530089ddf4" alt=""><figcaption><p>新しいレコードをシークレットマネージャーに接続された共有フォルダに移動</p></figcaption></figure>

### 秘密鍵のレコード

マシンの秘密鍵を格納する新しいレコードを作成します。レコードには、「秘密鍵」フィールドが必要です。 これには、SSH標準レコードタイプを使用できます。

レコードのタイトルは自由です。

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2FS6YEQRZ6H8ryHMHRhVRE%2Fimage.png?alt=media&#x26;token=70ea1771-e49f-4497-83ed-1b99a6c8bc82" alt=""><figcaption><p>秘密鍵フィールドを含むレコードの新規作成 (標準のSSHタイプを使用)</p></figcaption></figure>

新しいレコードには、「インスタンスID」という名前のカスタムテキストフィールドが必要になります。 カスタムフィールドメニューから「テキスト」タイプのカスタムフィールドを追加し、\[ラベルの編集]をクリックして「インスタンスID」と入力します。

{% hint style="info" %}
「インスタンスID」フィールドには、「AWS」や「EC2」で始まる自由なタイトルを付けることもできます。
{% endhint %}

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2Foc7DqPsQ3kQy1lvFpn9Y%2Fimage.png?alt=media&#x26;token=bd0eaf02-ef92-4ac3-abe4-9d34275658a3" alt=""><figcaption><p>「IDインスタンス」と表示されたカスタムテキストフィールドを追加</p></figcaption></figure>

レコードの準備ができたら、「秘密鍵」フィールドにマシンの秘密鍵を入力し、新しいカスタムフィールドにAWSインスタンスIDを入力します。

最後に、レコードがシークレットマネージャー連携を使用してKCMからアクセスできる共有フォルダ内にあることを確かにします。

<figure><img src="https://4041518992-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ7s6LQJaKa1G17O787JG%2Fuploads%2FQc2cpRC4yCBNlEVTAd9i%2Fimage.png?alt=media&#x26;token=af5b3da8-506a-49fe-b820-7556340fb93b" alt=""><figcaption><p>レコードの詳細を入力し、レコードをシークレットマネージャーがアクセス可能な共有フォルダに配置</p></figcaption></figure>

{% hint style="info" %}
必要に応じて、レコードにホスト名フィールドとポートフィールドを含めると、KCMがIPアドレスが一致するEC2接続に秘密鍵を自動的に関連付けます。
{% endhint %}

{% hint style="success" %}
これでレコードの作成は完了しました。この機能を有効にすると、KCMがレコードを自動的に検出します。
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.keeper.io/keeper-connection-manager/jp/vault-integration/ec2-cloud-connector.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.