名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
テナントの攻撃シミュレーション キャンペーンに関連付けられている loginPage を取得します。 ログイン ページは、 資格情報の収集 と 添付ファイルのリンク を使用する攻撃シミュレーションのソーシャル エンジニアリング手法でユーザーに表示されます。
この API は、次の国内クラウド展開で使用できます。
| グローバル サービス | 米国政府機関 L4 | 米国政府機関 L5 (DOD) | 21Vianet が運営する中国 |
|---|---|---|---|
| ✅ | ❌ | ❌ | ❌ |
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。
| アクセス許可の種類 | アクセス許可 (特権の小さいものから大きいものへ) |
|---|---|
| 委任 (職場または学校のアカウント) | AttackSimulation.Read.All、AttackSimulation.ReadWrite.All |
| 委任 (個人用 Microsoft アカウント) | サポートされていません。 |
| アプリケーション | AttackSimulation.Read.All、AttackSimulation.ReadWrite.All |
HTTP 要求
GET /security/attackSimulation/loginPages/{loginPageId}
GET /security/attackSimulation/simulations/{simulationId}/loginPage
オプションのクエリ パラメーター
現在、このメソッドでは、応答をカスタマイズするための OData クエリ パラメーター はサポートされていません。
要求ヘッダー
| 名前 | 説明 |
|---|---|
| Authorization | ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、このメソッドは応答本文で 200 OK 応答コードと loginPage オブジェクトを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/beta/security/attackSimulation/loginPages/2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc
応答
次の例は応答を示しています。
注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。
HTTP/1.1 200 OK
Content-Type: application/json
{
"id": "2f5548d1-0dd8-4cc8-9de0-e0d6ec7ea3dc",
"diplayName": "AttackSimTest loginPage",
"description": "AttackSim Test loginPage",
"status": "draft",
"source": "tenant",
"language": "en",
"createdBy": {
"email": "alexwaber@contoso.com",
"id": "1rdfcb49-1065-46a6-b1c3-672071e20a6b",
"displayName": "Alex Waber"
},
"createdDateTime": "2022-01-12T03:15:01.5906699Z",
"lastModifiedBy": {
"email": "alexwaber@contoso.com",
"id": "1rdfcb49-1065-46a6-b1c3-672071e20a6b",
"displayName": "Alex Waber"
},
"lastModifiedDateTime": "2021-10-07T12:23:18.8157586Z",
"content": "<meta http-equiv=\"Content-Type\" content=\"text/html>\">"
}