インテル® エンドポイント・マネジメント・アシスタント (インテル® EMA) アプリケーション・プログラミング・インターフェイス (API) ガイド
コンテンツタイプ: 製品情報 & ドキュメント | 記事 ID: 000055621 | 最終改訂日: 2025/04/11
インテル® EMA API ガイドでは、IT 管理者および開発者向けにインテル® エンドポイント・マネジメント・アシスタント (インテル® EMA) アプリケーション・プログラミング・インターフェイス (API) の概要を紹介します。
PDF ドキュメントは、インテル® EMA アプリケーション・プログラミング・インターフェイス (API) に関する一般的な情報を開発者に提供します。個々の API URI に関する詳細情報 (説明やパラメーターなど) は、次の 2 つの HTML ファイルに含まれています。 Latestswagger.html には、常に最新の API バージョンを指す API パスが含まれています。さらに、バージョン 9 API URI 詳細ファイル V9swagger.html も提供されています。この API URI 詳細情報 を表示するには、ご希望の HTML ファイルをダウンロードし、ブラウザーで 開きます (Chrome が最適です)。
インテル EMA API に関する追加情報:
インテル® エンドポイント・マネジメント・アシスタント (インテル® EMA) API は、開発者や IT 管理者がインテル® EMAと対話できるように設計されたプログラムによるインターフェイスのセットです。この API は、エンドポイント・デバイスの管理と監視を容易にし、管理タスクを自動化し、インテル® EMA機能を他のソフトウェア・ソリューションに統合します。
必要な環境:
インテル® EMAサーバーがインストールされ、実行されている必要があります。
適切な API アクセス許可と資格情報が必要です。
主な特長と性能:
デバイス管理:
エンドポイントデバイスをリモートで管理および監視します。
自動化: ソフトウェアの更新、デバイスの再起動、構成の変更などの管理タスクを自動化します。
統合:インテル® EMA機能を他のソフトウェアソリューションやワークフローに統合します。
セキュリティ: 認証および承認メカニズムを使用してデバイスを安全に管理します。
ユースケース:
自動デバイス プロビジョニング: 新しいデバイスを自動的にプロビジョニングして構成します。
リモートトラブルシューティング: エンドポイントデバイスの問題をリモートで診断して解決します。
ソフトウェア展開: ソフトウェア更新プログラムとパッチの展開を自動化します。
コンプライアンスの監視: デバイスが組織のポリシーと標準に準拠していることを確認します。
はじめ：
ソフトウェア要件:
インテル® EMAサーバーがインストールされ、実行されている必要があります。
アクセス許可: 適切な API アクセス許可と資格情報が必要です。これらのアクセス許可については、Swagger JSON ファイルで詳しく説明されています。
API キーの生成: インテル® EMA コンソールから API キーを生成します。
構成: ネットワーク設定を構成し、インテル® EMA サーバーにアクセスできるようにします。
認証とセキュリティ:
トークン認証:
インテル® EMAサーバサーバアカウントにユーザ名と関連付けられたパスワードを使用します。
Active Directory 認証: Active Directory の資格情報を使用します。インテル® EMA が Windows* ドメイン認証モードでインストールされ、インテル® EMAサーバーがアクティブ・ディレクトリー・ドメインに参加している場合にのみ使用できます。
クライアント資格情報認証: インテル® EMA サーバーへの API アクセス用に設計されています。インテル® EMA サーバー サーバーにクライアント資格情報アカウントとクライアント シークレットを作成する必要があります。
Microsoft* Entra 認証: インテル® EMA 1.9.0 で導入されたこの認証により、Microsoft Entra と呼ばれる Azure Active Directory を使用した インテル® EMA Web インターフェイスの認証が可能になります。
セキュリティのベストプラクティス:
HTTPS を使用する: 転送中のデータを暗号化するには、常に HTTPS を使用します。
最小特権: API ユーザーに必要最小限のアクセス許可を付与します。
パスワード ハッシュ: パスワードをクリア テキスト ファイルに保存しません。
エラー処理とトラブルシューティング:
一般的なエラーコード:
400 要求が正しくありません: 入力パラメーターが無効です。
401 未承認: 認証資格情報が無効または不足しています。
404 見つかりません: リソースが見つかりません。
500 内部サーバー エラー: サーバーで予期しない状態が発生しました。
トラブルシューティングのヒント:
API キーを確認する: API キーが有効であり、必要なアクセス許可があることを確認します。
入力の検証: 入力パラメーターが正しく、適切に書式設定されていることを確認します。
ネットワークの問題: クライアントとインテル® EMA サーバーの間にネットワーク接続の問題がないことを確認します。