AWS WorkSpaces コネクタ

このドキュメントは外部ソースを参照しています。 Nexthink はサードパーティのドキュメントの正確性や、このページに記載されている情報に矛盾を生じさせる可能性のある外部の更新または変更を制御することはできません。 エラーや矛盾をNexthink サポートに報告してください。

Nexthink の AWS WorkSpaces コネクタは、お使いの AWS WorkSpaces 仮想デスクトップインフラストラクチャ（VDI）に関する重要な情報を取得します。 このコネクタは、VDI の健全性、使用状況パターン、構成ドリフトに関する可視性を高める AWS WorkSpaces データで、お使いの Nexthink 環境を強化します。

このインストールガイドは、AWS 用コネクタを安全にデプロイするために作成されています。 Nexthink では、組織のセキュリティチームがここに記載されている設定およびインストール手順を確認し、社内のセキュリティポリシーとコンプライアンス要件に合わせて必要に応じて調整することを推奨しています。

デバイスフィールド

AWS WorkSpaces 用コネクタは、以下のデバイス仮想化フィールドを拡張します。

フィールド	説明
仮想化デスクトッププール名	関連するVMのハードウェア特性。
仮想化デスクトッププールの種類	可能な値： パーソナル プールド
仮想化ホスト名	このフィールドは、マシンがクラウド上のベンダーによってホストされている場合に補完されます。 デフォルト値: AWS host
仮想化ハイパーバイザー名	使用されているハードウェア仮想化システムの種類。 デフォルト値: AWS hypervisor
環境名	仮想デバイスを拡張するコネクタインスタンスの名前。
デスクトップブローカー	使用されているデスクトップ仮想化製品の名称。 デフォルト値: aws_workspaces
ディスクイメージ	VM のデプロイに使用されるディスクイメージの名称。
インスタンスサイズ	VM に割り当てられたハードウェア構成（vCPU、メモリ、GPU リソース）。 このフィールドには、コンピュートタイプに対して AWS で事前定義されている値のいずれかが表示されます。
リージョン	AWS WorkSpaces リージョン。
最終更新	デバイスフィールドが最後に更新された日時。

コネクタ資格情報の設定

Nexthink が AWS WorkSpaces コネクタにデータをエクスポートできるようにするには、次の手順を実行して コネクタ認証情報 をまず構成する必要があります。

1

メインメニューで Administration > Connector credentials を選択します。

2

Connector credentials ページの右上にある New credential を選択します。

3

資格情報構成の入力フィールドに入力します。

• Name: 資格情報の一意の名前。
• Protocol: AWS IAM を選択します。

設定画面は次のようになります。

Nexthink は AWS External ID を自動的に生成します。 次の手順で AWS ロールを作成し、その Amazon Resource Name (ARN) を取得する際に使用します。 その後、この ARN を AWS Role ARN テキストボックスに貼り付けることができます。

Nexthink は、Access to AWS accounts owned by third parties ドキュメントに記載されている、AWS によるサードパーティアクセス向けの推奨手順を使用しています。

4

AWS にサインインし、IAM ロールを作成します。 次のコード例は、Nexthink AWS WorkSpaces コネクタが必要とする最小限のアクセスレベルを示しています。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "DescribeWorkspacesInfo",
            "Effect": "Allow",
            "Action": [
                "workspaces:DescribeWorkspaceImages",
                "workspaces:DescribeWorkspacesPoolSessions",
                "workspaces:DescribeWorkspacesPools",
                "workspaces:DescribeWorkspaceBundles",
                "workspaces:DescribeWorkspaces"
            ],
            "Resource": "*"
        }
    ]
}

5

Nexthink にアクセス権を付与する IAM ロールを作成します:

• Name: ロール名は NexthinkConnector- という接頭辞で始める必要があります。
• Permissions: 上述のポリシーを追加します。
• Trusted Policies: 信頼ポリシーでは、Principal として次の Nexthink の AWS アカウント番号を指定する必要があります: 884848470805 さらに、信頼ポリシーに Condition 要素を追加し、ExternalId が上記フォームで生成された外部 ID と一致するかどうかを確認します。 次のコードは、ロール内の信頼関係の例です:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::884848470805:root"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "sts:ExternalId": <EXTERNAL_ID>
                }
            }
        }
    ]
}

<EXTERNAL_ID> を、認証情報フォームで生成された AWS External ID の値に置き換えてください。

6

ロールを作成したら、その AWS ロール ARN をコピーします:

7

Nexthink の Connector credentials ページで AWS 認証情報を編集し、Credential details の AWS Role ARN テキストボックスに ARN を入力して、Save を選択します:

AWS WorkSpaces コネクタを構成する

コネクタ認証情報を設定したことを確認し、新しいコネクタを作成します:

1

管理 > インバウンドコネクタ に移動します。

2

ページの右上隅にある 新しいコネクタ を選択します。

3

コネクタのリストから AWS WorkSpaces を選択します。

以下のセクションでは、コネクタの構成方法について説明します。

General タブ

• Name: コネクタのわかりやすい名前を追加します。 この名前は管理ページに表示されます。
• NQL ID: NQL クエリで AWS WorkSpaces コネクタを参照する際に使用される、コネクタの一意の ID を追加します。 提案された NQL ID は最初に変更できますが、ワークフローを保存した後は変更できません。
• Description: コネクタの目的と動作に関する簡潔な説明を追加します。

スケジューリング

• Recurrence: コネクタの実行頻度を選択します。

接続

• Credentials: Connector credentials ページで事前構成された認証情報を選択します。 AWS IAM のみがサポートされています。

Parameters タブ

• Region: ワークスペースが存在する AWS リージョンを選択します。 例えば us-east-1 など、有効な AWS リージョンである必要があります。
• Environment name: 任意に定義するテキストです。 拡張された仮想デバイスには、NQL 内でこの環境名への参照が含まれます。

テスト結果パネル

テスト結果 パネルは、サポートされているコネクタでのみ利用できます。 コネクタを利用できるかどうかは、ライセンスにも依存します。

右側の Test results パネルを使用して、実データでコネクタをオンデマンド実行し、レスポンスとエラーを確認します。 テストパネルは、セットアップ時のデバッグおよび検証を迅速化し、試行錯誤を減らしてより信頼性の高いマッピングに役立ちます。

Run test ボタンを選択して API を呼び出し、認証情報の検証および対象エンドポイントへの接続性を確認します。

レスポンスステータスコードや時間などの基本情報に加え、パネル下部にはレスポンスのサンプルレコードも表示されます。

エラーが発生した場合、システムは問題診断に役立つ API レスポンスを表示します。

AWS WorkSpaces では、レート制限が適用され、接続テストが失敗する場合があります。 Nexthinkでは、これを数回実行するか、可能であればリージョンごとに実行することを推奨しています。