認証済みスキャンの方法とプロパティ
適用対象:
- Microsoft Defender for Endpoint Plan 1
- Microsoft Defender for Endpoint
- Microsoft Defender 脆弱性の管理
- Microsoft Defender XDR
Microsoft Defender ATP を試してみたいですか? 無料試用版にサインアップしてください。
Microsoft Defender 脆弱性の管理を体験するには Microsoft Defender 脆弱性の管理パブリック プレビュー試用版にサインアップする方法について説明します。
重要
この記事の一部の情報は、市販される前に大幅に変更される可能性があるプレリリース製品に関するものです。 Microsoft は、ここで提供されるいかなる情報に関して、明示または黙示を問わず、いかなる保証も行いません。
注:
米国政府機関のお客様は、 Microsoft Defender for Endpoint for US Government のお客様に記載されている URI を使用してください。
ヒント
パフォーマンスを向上させるために、地理的な場所に近いサーバーを使用できます。
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
メソッド
| メソッド | 説明 |
|---|---|
| すべてのスキャン定義を取得する | すべてのスキャン定義を一覧表示します。 |
| スキャン定義を追加、削除、または更新する | 新しいスキャン定義を追加、削除、または更新します。 |
| すべてのスキャン エージェントを取得する | すべてのスキャン エージェントを一覧表示します。 |
| ID でスキャン エージェントを取得する | 指定したエージェントの詳細を ID で取得します。 |
| 定義別にスキャン履歴を取得する | スキャン定義の履歴を一覧表示します。 |
| セッション別にスキャン履歴を取得する | セッションのスキャン履歴を一覧表示します。 |
Windows 認証スキャンとネットワーク認証スキャンの詳細を確認します。
プロパティ
| プロパティ | データ型 | 説明 |
|---|---|---|
| id | String | スキャン ID。 |
| scanType | 列挙 | スキャンの種類。 可能な値は、Windows、Network です。 |
| scanName | String | スキャンの名前。 |
| isActive | ブール型 | スキャンがアクティブに実行されているかどうかを示す状態。 |
| orgId | String | 関連する組織 ID。 |
| intervalInHours | Int | スキャンを実行する間隔。 |
| createdBy | String | スキャンを作成したユーザーの一意の ID。 |
| targetType | String | ターゲット フィールドのターゲットの種類。 使用できる型は、 IP Address または Hostnameです。 既定値は IP アドレスです。 |
| target | String | スキャンするターゲットのコンマ区切りのリスト (IP アドレスまたはホスト名)。 |
| scanAuthenticationParams | オブジェクト | 認証パラメーターを表すオブジェクトについては、「想定されるフィールドの 認証パラメーター オブジェクトのプロパティ 」を参照してください。 このプロパティは、新しいスキャンを作成するときに必須であり、スキャンを更新する場合は省略可能です。 |
| scannerAgent | オブジェクト | スキャナー エージェントを表すオブジェクトには、スキャン デバイスのマシン ID が含まれます。 |
認証パラメーター オブジェクトのプロパティ
| プロパティ | データ型 | 説明 |
|---|---|---|
| @odata.type | 列挙 | スキャンの種類の認証パラメーター。 使用可能な値は、スキャンの種類Network#microsoft.windowsDefenderATP.api.SnmpAuthParams、スキャンの種類Windows#microsoft.windowsDefenderATP.api.WindowsAuthParamsです。 |
| type | 列挙 | 認証方法。 使用可能な値は、 @odata.type プロパティによって異なります。 - @odata.type が SnmpAuthParamsの場合、使用可能な値は CommunityString、 NoAuthNoPriv、 AuthNoPriv、 AuthPriv。 - @odata.type が WindowsAuthParams 可能な値が Kerberos または Negotiateである場合。 |
| KeyVaultUrl | String (省略可能) | スキャナーが資格情報を取得する KeyVault を指定する省略可能なプロパティ。 KeyVault が指定されている場合は、ユーザー名、パスワードを指定する必要はありません。 |
| KeyVaultSecretName | String (省略可能) | スキャナーが資格情報を取得する KeyVault シークレット名を指定する省略可能なプロパティ。 KeyVault が指定されている場合は、ユーザー名、パスワードを指定する必要はありません。 |
| ドメイン | String (省略可能) |
WindowsAuthParamsを使用する場合のドメイン名。 |
| Username | String (省略可能) |
WindowsAuthParamsを使用する場合はユーザー名、CommunityString以外の種類のSnmpAuthParamsを選択する場合はユーザー名。 |
| IsGMSAUser | Boolean (省略可能) |
WindowsAuthParamsを選択する場合は、true に設定する必要があります。 |
| CommunityString | String (省略可能) | で SnmpAuthParams を選択するときに使用するコミュニティ文字列 CommunityString |
| AuthProtocol | String (省略可能) |
SnmpAuthParamsとAuthNoPrivまたはAuthPrivで使用する認証プロトコル。 使用可能な値は、 MD5、 SHA1です。 |
| AuthPassword | String (省略可能) |
SnmpAuthParamsとAuthNoPrivまたはAuthPrivで使用する認証パスワード。 |
| PrivProtocol | String (省略可能) |
SnmpAuthParamsとAuthPrivで使用する Priv プロトコル。 使用可能な値は、DES、3DES、AES です。 |
| PrivPassword | String (省略可能) |
SnmpAuthParamsとAuthPrivで使用するプライベート パスワード。 |
ヒント
さらに多くの情報を得るには、 Tech Community 内の Microsoft Security コミュニティ (Microsoft Defender for Endpoint Tech Community) にご参加ください。