Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Importante
As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.
Representa uma campanha de formação de simulação de ataques num inquilino.
A simulação e a preparação de ataques são um serviço disponível como parte do Microsoft Defender para Office 365. Este serviço permite que os utilizadores inquilinos experimentem um ataque de phishing benigno realista e aprendam com o mesmo. O serviço permite que os administradores inquilinos simulem, atribuam formações e leiam informações derivadas sobre os comportamentos online dos utilizadores nas simulações de phishing. O serviço fornece relatórios de simulação de ataques que ajudam os inquilinos a identificar lacunas de conhecimento de segurança, para que possam preparar ainda mais os seus utilizadores para diminuirem a sua suscetibilidade a ataques.
A API de simulação e preparação de ataques permite que os administradores inquilinos listem exercícios e formações de simulação iniciados e obtenham relatórios sobre informações derivadas sobre comportamentos online dos utilizadores nas simulações de phishing.
Herda de entidade.
Methods
| Método | Tipo de retorno | Descrição |
|---|---|---|
| Listar simulações | coleção de simulação | Obtenha uma lista de campanhas de simulação de ataques para um inquilino. |
| Criar simulação | simulação | Crie um novo objeto de simulação . |
| Obter simulação | simulação | Obter uma campanha de simulação de ataques para um inquilino. |
| Simulação de atualização | simulação | Atualize as propriedades de um objeto de simulação . |
| Eliminar simulação | Nenhum | Eliminar um objeto de simulação . |
| Obter payload | Nenhum | Obter um objeto payload . |
| Obter página de início de sessão | Nenhum | Obter um objeto loginPage . |
| Obter página de destino | Nenhum | Obter um objeto landingPage . |
Propriedades
| Propriedade | Tipo | Descrição |
|---|---|---|
| attackTechnique | simulationAttackTechnique | A técnica de engenharia social utilizada na campanha de simulação e formação de ataques. Oferece suporte para $filter e $orderby. Os valores possíveis são: unknown, , credentialHarvestingattachmentMalware, driveByUrl, , linkToMalwareFilelinkInAttachment, unknownFutureValue, , oAuthConsentGrant, . phishTraining Utilize o cabeçalho do Prefer: include-unknown-enum-members pedido para obter os seguintes valores desta enumeração evoluível: oAuthConsentGrant, phishTraining. Para obter mais informações sobre os tipos de técnicas de ataque de engenharia social, veja simulações. |
| attackType | simulationAttackType | Tipo de ataque da simulação de ataque e da campanha de preparação. Oferece suporte para $filter e $orderby. Os valores possíveis são: unknown, social, cloud, endpoint, unknownFutureValue. |
| automationId | Cadeia de caracteres | Identificador exclusivo para a automatização da simulação de ataques. |
| completionDateTime | DateTimeOffset | Data e hora de conclusão da simulação de ataque e da campanha de formação. Oferece suporte para $filter e $orderby. |
| createdBy | emailIdentity | Identidade do utilizador que criou a simulação de ataque e a campanha de formação. |
| createdDateTime | DateTimeOffset | Data e hora da criação da simulação de ataque e da campanha de formação. |
| description | Cadeia de caracteres | Descrição da simulação de ataque e da campanha de formação. |
| displayName | Cadeia de caracteres | Nome a apresentar da simulação de ataque e da campanha de formação. Oferece suporte para $filter e $orderby. |
| durationInDays | Int32 | Duração da simulação em dias. |
| endUserNotificationSetting | endUserNotificationSetting | Detalhes sobre a definição de notificação do utilizador final. |
| excludedAccountTarget | accountTargetContent | Utilizadores excluídos da simulação. |
| id | Cadeia de caracteres | Identificador exclusivo para a simulação de ataque e a campanha de preparação. Herdado da entidade. |
| includedAccountTarget | accountTargetContent | Utilizadores visados na simulação. |
| isAutomated | Booliano | Sinalizador que representa se a simulação de ataque e a campanha de preparação foram criadas a partir de um fluxo de automatização de simulação. Oferece suporte para $filter e $orderby. |
| lastModifiedBy | emailIdentity | Identidade do utilizador que modificou recentemente a simulação de ataque e a campanha de formação. |
| lastModifiedDateTime | DateTimeOffset | Data e hora da modificação mais recente da simulação de ataque e da campanha de formação. |
| launchDateTime | DateTimeOffset | Data e hora do início/início da simulação de ataque e da campanha de formação. Oferece suporte para $filter e $orderby. |
| oAuthConsentAppDetail | oAuthConsentAppDetail | Detalhes da aplicação OAuth para a técnica OAuth. |
| payloadDeliveryPlatform | payloadDeliveryPlatform | Método de entrega do payload de phishing utilizado na simulação de ataque e na campanha de preparação. Os valores possíveis são: unknown, sms, email, teams, unknownFutureValue. |
| relatório | simulationReport | Relatório da simulação de ataque e da campanha de formação. |
| status | simulationStatus | Estado da simulação de ataque e da campanha de formação. Oferece suporte para $filter e $orderby. Os valores possíveis são: unknown, , draftrunning, scheduled, , failedsucceeded, cancelled, , excluded, . unknownFutureValue |
| trainingSetting | trainingSetting | Detalhes sobre as definições de preparação de uma simulação. |
simulationStatus values (valores simulationStatus)
| Member | Descrição |
|---|---|
| desconhecido | A simulação status não está definida. |
| rascunho | A simulação está no modo de rascunho. |
| em execução | A simulação está em execução. |
| agendado | A simulação está agendada. |
| com êxito | A simulação está completa com status de êxito. |
| falha | A simulação está concluída com status de falha. |
| cancelado | A simulação foi cancelada. |
| excluído | A simulação está excluída. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
simulationAttack Valorestechnique
| Member | Descrição |
|---|---|
| desconhecido | Técnica de ataque não definida. |
| credentialHarvesting | Técnica de ataque que envolve um utilizador final a fornecer credenciais. |
| attachmentMalware | Técnica de ataque que envolve um utilizador final a clicar num anexo. |
| driveByUrl | Técnica de ataque que envolve um utilizador final a clicar numa ligação de URL no payload de phishing. |
| linkInAttachment | Técnica de ataque que envolve um utilizador final a clicar numa ligação de URL num anexo. |
| linkToMalwareFile | Técnica de ataque que envolve um utilizador final a clicar numa ligação de URL para um ficheiro de software maligno. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
| oAuthConsentGrant | Técnica de ataque que envolve um utilizador final que dá consentimento de acesso a uma aplicação. |
| phishTraining | Técnica de ataque que envolve a preparação de utilizadores finais sobre ações a serem executadas num e-mail de phish. |
valores simulationAttackType
| Member | Descrição |
|---|---|
| desconhecido | Tipo de ataque não identificado. |
| social | Ataque que usa habilidades sociais para manipular as vítimas psicologicamente, criando um falso sentimento de curiosidade, urgência ou medo. |
| cloud | Ataque a um anfitrião ou utilizador num ambiente na cloud, por exemplo, ataques denial of service. |
| ponto final | Ataque a pontos finais de uma rede empresarial, como computadores de secretária, portáteis, telemóveis e dispositivos IoT (Internet das Coisas). |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
simulationContentStatus values (valores simulationContentStatus)
| Member | Descrição |
|---|---|
| desconhecido | O conteúdo de simulação status não está definido. |
| rascunho | O conteúdo de simulação status está no estado de rascunho. |
| pronto | O conteúdo de simulação status está no estado pronto. |
| arquivar | O conteúdo de simulação status é o estado de arquivo. |
| delete | O conteúdo de simulação status está no estado de eliminação. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
valores simulationContentSource
| Member | Descrição |
|---|---|
| desconhecido | A origem de conteúdo de simulação não está definida. |
| global | A origem de conteúdo de simulação é global. |
| locatário | A origem de conteúdo de simulação é o inquilino. |
| unknownFutureValue | Valor da sentinela de enumeração evoluível. Não usar. |
Relações
| Relação | Tipo | Descrição |
|---|---|---|
| landingPage | landingPage | A página de destino associada a uma simulação durante a criação. |
| loginPage | loginPage | A página de início de sessão associada a uma simulação durante a criação. |
| payload | payload | O payload associado a uma simulação durante a criação. |
Representação JSON
A representação JSON seguinte mostra o tipo de recurso.
{
"@odata.type": "#microsoft.graph.simulation",
"attackTechnique": "String",
"attackType": "String",
"automationId": "String",
"completionDateTime": "String (timestamp)",
"createdBy": {"@odata.type": "microsoft.graph.emailIdentity"},
"createdDateTime": "String (timestamp)",
"description": "String",
"displayName": "String",
"durationInDays": "Int32",
"endUserNotificationSetting": {"@odata.type": "microsoft.graph.endUserNotificationSetting"},
"excludedAccountTarget": {"@odata.type": "microsoft.graph.accountTargetContent"},
"id": "String (identifier)",
"includedAccountTarget": {"@odata.type": "microsoft.graph.accountTargetContent"},
"isAutomated": "Boolean",
"lastModifiedBy": {"@odata.type": "microsoft.graph.emailIdentity"},
"lastModifiedDateTime": "String (timestamp)",
"launchDateTime": "String (timestamp)",
"oAuthConsentAppDetail": {"@odata.type": "microsoft.graph.oAuthConsentAppDetail"},
"payloadDeliveryPlatform": "String",
"report": {"@odata.type": "microsoft.graph.simulationReport"},
"status": "String",
"trainingSetting": {"@odata.type": "microsoft.graph.trainingSetting"}
}