Criar emailThreatSubmissionPolicy
Namespace: microsoft.graph.security
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.
Criar um novo objeto emailThreatSubmissionPolicy .
Essa API está disponível nas seguintes implantações nacionais de nuvem.
Serviço global | Governo dos EUA L4 | GOVERNO DOS EUA L5 (DOD) | China operada pela 21Vianet |
---|---|---|---|
✅ | ❌ | ❌ | ❌ |
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | ThreatSubmissionPolicy.ReadWrite.All | Indisponível. |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | ThreatSubmissionPolicy.ReadWrite.All | Indisponível. |
Solicitação HTTP
POST /security/threatSubmission/emailThreatSubmissionPolicies
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Content-Type | application/json. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON do objeto emailThreatSubmissionPolicy .
Você também pode especificar as propriedades a seguir ao criar um emailThreatSubmissionPolicy. Essas propriedades estão relacionadas às configurações de mensagem relatadas pelo usuário. Para obter detalhes, consulte Configurações de mensagem relatadas pelo usuário.
Propriedade | Tipo | Descrição |
---|---|---|
personalizedNotificationSenderEmailAddress | Cadeia de caracteres | Especifica o endereço de email do remetente do qual notificações por email será enviado aos usuários finais para informá-los se um email é spam, phish ou limpo. O valor padrão é null . Opcional para criação. |
personalizedReportRecipientEmailAddress | Cadeia de caracteres | Especifica o destino em que as mensagens relatadas dos usuários finais pousarão sempre que relatarem algo como phish, lixo eletrônico ou não lixo eletrônico. O valor padrão é null . Opcional para criação. |
isAlwaysReportEnabledForUsers | Booliano | Indica se os usuários finais podem relatar uma mensagem como spam, phish ou lixo eletrônico diretamente sem uma confirmação (pop-up). O valor padrão é true . Opcional para criação. |
isAskMeEnabledForUsers | Booliano | Indica se os usuários finais podem confirmar o uso de um pop-up antes de relatar mensagens como spam, phish ou não lixo eletrônico. O valor padrão é true . Opcional para criação. |
isCustomizedMessageEnabled | Booliano | Indica se o notificações por email enviado aos usuários finais para informá-los se um email é phish, spam ou lixo eletrônico é personalizado ou não. O valor padrão é false . Opcional para criação. |
isCustomizedMessageEnabledForPhishing | Booliano | Se habilitada, a mensagem personalizada só será exibida quando o email é relatado como phishing. O valor padrão é false . Opcional para criação. |
isCustomizedNotificationSenderEnabled | Booliano | Indica se deve usar o conjunto de endereços de email do remetente usando o personalizadoNotificationSenderEmailAddress para enviar notificações por email para usuários finais. O valor padrão é false . Opcional para criação. |
isNeverReportEnabledForUsers | Booliano | Indica se os usuários finais podem simplesmente mover a mensagem de uma pasta para outra com base na ação de spam, phish ou não lixo eletrônico sem realmente reportá-la. O valor padrão é true . Opcional para criação. |
isOrganizationBrandingEnabled | Booliano | Indica se o logotipo da marca deve ser usado no notificações por email enviado aos usuários finais. O valor padrão é false . Opcional para criação. |
isReportFromQuarantineEnabled | Booliano | Indica se os usuários finais podem enviar na página de quarentena. O valor padrão é true . Opcional para criação. |
isReportToCustomizedEmailAddressEnabled | Booliano | Indica se os emails relatados pelos usuários finais devem ser enviados para a caixa de correio personalizada configurada usando personalizadoReportRecipientEmailAddress. O valor padrão é false . Opcional para criação. |
isReportToMicrosoftEnabled | Booliano | Se habilitado, o email será enviado à Microsoft para análise. O valor padrão é false . Requeried para criação. |
isReviewEmailNotificationEnabled | Booliano | Indica se uma notificação por email é enviada ao usuário final que relatou o email quando ele foi revisado pelo administrador. O valor padrão é false . Opcional para criação. |
Resposta
Se for bem-sucedido, esse método retornará um 201 Created
código de resposta e um objeto emailThreatSubmissionPolicy no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
POST https://graph.microsoft.com/beta/security/threatSubmission/emailthreatSubmissionPolicies
Content-type: application/json
{
"isReportToMicrosoftEnabled": true
}
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 201 Created
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.security.emailThreatSubmissionPolicy",
"id": "DefaultReportSubmissionPolicy",
"isReportToMicrosoftEnabled": true,
"isReportToCustomizedEmailAddressEnabled": false,
"isAskMeEnabledForUsers": true,
"isAlwaysReportEnabledForUsers": true,
"isNeverReportEnabledForUsers": true,
"isCustomizedMessageEnabledForPhishing": false,
"isCustomizedMessageEnabled": false,
"customizedReportRecipientEmailAddress": null,
"isReviewEmailNotificationEnabled": false,
"isCustomNotificationSenderEnabled": false,
"isOrganizationBrandingEnabled": false,
"customizedNotificationSenderEmailAddress": null,
"isReportFromQuarantineEnabled": false
}