データマネージャー - Qualys アダプター

Jira Service Management Cloud のアセットデータマネージャーは Premium と Enterprise のみの機能であり、現在はオープンベータ版を開発中です。公開予定の機能のリストを見て、投票してください。

バグを発見した場合、ご質問がある場合は、アトラシアンサポートまたはアトラシアンコミュニティにご連絡ください。

はじめに

Qualys は同名の会社 Qualys が開発したツールで、環境全体のネットワークの脆弱性を検出するために使用されます。

Qualys アダプターは API 接続によってデータをアセットデータマネージャーに取り込みます。

セットアップを始める前に

このタスクを完了するには、データマネージャーアダプターの管理者権限が必要です。データマネージャーでの権限とロールの仕組みをご覧ください。

Qualys ソースが API 対応で、関連するファイアウォールルールが確立されていることを確認してください。また、ソースにアクセスするための認証情報があることを確認してください。

Qualys API は 3 種類の方法で機能することも理解しておく必要があります。

ホストアセット (SQL への直接インポート) - これは、HostAsset 呼び出しを使用した定型クエリで、フィールドのリストを返し、それらをデータマネージャーに直接読み込みます。
レポート (CSV に保存) - Qualys に保存されたレポートと必要なフィールドを使用して、CSV ファイルからデータマネージャーにファイルを読み込みます。この方法では、データマネージャーに読み込む前に、必要に応じて CSV ファイルを変更できます。
レポート (SQL への直接インポート) - この方法では、レポートを必要なフィールドとともに Qualys に書き込みます。ただし、レポートのデータは操作オプションなしで直接データマネージャーに読み込まれます。

オプション 2 または 3 を使用する場合は、レポート ID の選択を試みる前に、API URL とトークン ID を入力する必要があります。これらの情報は、アセットデータマネージャーがレポートを収集するために必要となります。

このツールをアセットデータマネージャーに接続するにはどうすればいいですか?

カスタムビルドのアダプターを使用して、このツールをアセットデータマネージャーに接続するには、次の手順に従います。

名前、オブジェクトクラス、データソース名、データソースタイプなど、「データマネージャーフィールド」のセクションにリストされているすべての情報を収集します。
「Qualys フィールド」セクションに記載のすべての情報を集めます。これを行うには、Qualys に関するエキスパート (SME) への相談が必要となる場合があります。
データマネージャー内:
1. ご利用のツールに合ったアダプターを選択して、新しいジョブを作成します。
2. すべての必須フィールドに適切な情報を設定します。
Qualys 内:
1. 認証と承認を適切に設定するには、次の「認証と承認」セクションに記載されているすべての手順に従います。
2. 「API 呼び出し」セクションの情報を確認してください。このセクションは、ホストアセット (SQL への直接インポート) を選択した場合にのみ適用されます。
3. 以下の「取得したフィールド」セクションの情報をご確認ください。

このジョブが実行されるたびに、選択したデータは、構成されたアダプタを使用してデータマネージャーに取り込まれ、生データになります。

データマネージャーフィールド

アセットデータマネージャーから取得した次の情報を指定する必要があります。

名前 - 接続の名前。[アダプター] でジョブ名として表示されます。
オブジェクトクラス - データをロードするオブジェクトクラスの名前。
データソース名 - 作成されるデータのタイプ。通常はツールの名前 (例: AD、Qualys) となります。注意: [名前] と同じ名前でも問題はありません。
データソースタイプ - ツールが提供するデータのタイプ。たとえば、アセット、CMDB、ユーザーの場所などです。

Qualys フィールド

Qualys からの次の情報を指定する必要があります。

API URL - データマネージャーで Qualys ソースに接続するための Qualys インスタンスの URL。
ユーザー名とパスワード - API アクセストークンを生成するためのユーザー名とパスワード。
API アクセストークン: Qualys API アクセスの認証に使用される Base64 エンコード文字列。このトークンは、ユーザー名とパスワードのフィールドに入力し、[生成] ボタンをクリックすると生成されます。
アクションタイプ - Qualys には 3 種類のアクションがあります。
- ホストアセット (SQL への直接インポート) - 追加のフィールドは必要ありません。
- レポート (CSV に保存) - Qualys のレポート番号と読み込む CSV ファイルの場所 (ファイルパス) が必要です。
- レポート (SQL への直接インポート) - Qualys のレポート番号が必要です。
API タイムアウト - レポート生成プロセスが完了するまでの最大時間 (分単位)。

API Timeout

An API Timeout occurs if the service takes longer than expected to respond to a call. If a timeout occurs, it results in a ‘500 error’ status code with details about the timeout in the response. Timeouts are typically caused by one of two things:

呼び出しに関連するデータが多すぎる場合
ネットワークまたはサービスに問題がある場合

The default value for this field is 0, but we recommend setting this field manually to a value of 9000.

If the data source server cannot handle this value, we recommend gradually lowering the API Timeout value to a minimum of 2000, or to consult the vendor documentation for further guidance.

API 制限 - 返されるレコードの最大数。これにより、データマネージャーアダプターによって消費されるリクエスト/データ (またはレコード) の量を設定できます。

API 制限は既定で 0 に設定されています。これは制限がないことを意味します。ただし、接続先の Qualys ソースに大量のデータが格納されている場合は、数値を 1000 に制限するのがベストプラクティスです。

API 呼び出し

ホストアセット (SQL への直接インポート) を選択した場合の Qualys の API 呼び出しは次のとおりです。POST ApiUrl/qps/rest/2.0/search/am/hostasset.

ホストアセットに取得したフィールド

返されたフィールドが正しくない場合や、ホストアセット (SQL への直接インポート) オプションを選択していない場合は、Qualys SME にご連絡の上、Qualys のソースレポートを修正するように手配してください。

次のフィールドが取得されます。

Id
Name
Type
Os
Created
LastVulnScan
LastCheckedIn
Address
Fqdn
TrackingMethod

この内容はお役に立ちましたか?

正確ではなかった

明確ではなかった

関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問

データ マネージャー - Qualys アダプター