ESET PROTECT On-Prem

オフライン | オンライン

ESET PROTECT On-Prem – 目次

# ESET PROTECT On-Prem REST APIを設定する

現在の記事のURLをコピー 電子メールで共有

以下の手順に従って、ESET PROTECT On-Prem REST APIを設定します。

1.詳細 > 設定でREST APIを有効にします。

|  | •ローカルファイアウォールのAPIポートを必ず開いてください。 •REST APIを使用するには、ESET PROTECTサーバーのピア証明書(RESTサーバー証明書として使用されているかどうかにかかわらず)の共通名/ホストフィールドにlocalhostが含まれている必要があります。ピア(サーバー)証明書がこの要件を満たしていない場合は、新しい証明書を作成し、サーバー証明書を変更します。

2.APIユーザーにAPI 権限セットを割り当てます。

|  | 管理者アカウントは、APIを使用できません。

3.ESET PROTECT On-Prem APIとのやり取りを自動化するには、組み込みSwagger UI (ESET PROTECT On-Premバージョン13.1以降で使用可能)を使用します。

Swagger UIはどんなものですか?

Swagger UIは、開発者がRESTful Webサービスを設計、構築、文書化、および使用するのに役立つオープンソースのフレームワークです。Swagger UIを使用すると、WebページでAPIコールをテストできます。 1.ESET PROTECTサーバー設定でSwagger UIを有効化します。 2.有効な組み込みのSwagger UIには、https://localhost:9443/swaggerからアクセスできます。必要に応じて、localhostをサーバー名またはIPアドレスで置換します。 Swagger UIは完全なプレハブAPIコールを提供します。コールでパラメーター値を変更するだけで済みます。
|  | Swagger UIは英語でのみ提供されています。

あるいは、RESTクライアントアプリケーションへのAPIコール(例: Postman)を実装するか、コマンドライン(curl)を使用します。

|  | RESTサーバーはESET PROTECTサーバーのローカルで実行されます。 ESET ConnectとESET PROTECT On-Prem REST APIはご利用いただけません。

4.RESTサーバーへログインするには、GetTokensリクエストを実行します。Swagger UIで、GetTokensを展開し、試すをクリックし、要求本文に正しいデータを入力して、実行をクリックします。

方法 | POST
関数 | getTokens
URL | https://protect_server:9443/GetTokens
本文 | { "username" : "api", "password" : "Admin.12345678", "grant_type" : "password" }

5.応答はaccessTokenを返します。その後、他のAPIリクエストでベアラートークン(Authorization: Bearer)としてaccessTokenを使うことができます。Swagger UIで、承認をクリックし、accessTokenを貼り付けて、承認をクリックします。他のコールを実行でき、Swagger UIは各コールに認証トークンを自動的に含めます。

|  | APIコールの例やESET PROTECT On-Premで利用可能なすべてのAPIコールのリストも参照してください。

˄˅