Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Permitir que los administradores marquen un evento en los registros de inicio de sesión de Microsoft Entra como de riesgo. Los eventos marcados como de riesgo por un administrador se marcan inmediatamente como de alto riesgo en Protección de Microsoft Entra ID, reemplazando los estados de riesgo anteriores. Los administradores pueden confirmar que los eventos marcados como de riesgo por Protección de Microsoft Entra ID son de hecho de riesgo.
Para obtener más información sobre cómo investigar los riesgos de Identity Protection, consulte Investigación de riesgos.
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global |
Gobierno de EE. UU. L4 |
Us Government L5 (DOD) |
China operada por 21Vianet |
| ✅ |
✅ |
✅ |
✅ |
Permissions
Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.
| Tipo de permiso |
Permisos con privilegios mínimos |
Permisos con privilegios más altos |
| Delegado (cuenta profesional o educativa) |
IdentityRiskyUser.ReadWrite.All |
No disponible. |
| Delegado (cuenta personal de Microsoft) |
No admitida. |
No admitida. |
| Aplicación |
IdentityRiskEvent.ReadWrite.All |
No disponible. |
Importante
En escenarios delegados con cuentas profesionales o educativas, al usuario que ha iniciado sesión se le debe asignar un rol de Microsoft Entra compatible o un rol personalizado con un permiso de rol admitido.
Administrador de seguridad es el rol con privilegios mínimos admitido para esta operación.
Solicitud HTTP
POST /auditLogs/signIns/confirmCompromised
| Nombre |
Descripción |
| Authorization |
{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Content-Type |
application/json. Obligatorio. |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON de los parámetros.
La siguiente tabla muestra los parámetros que se pueden usar con esta acción.
| Parámetro |
Tipo |
Descripción |
| requestIds |
Colección string |
Los identificadores de los eventos de inicio de sesión que se deben marcar como de riesgo para Protección de Microsoft Entra ID. |
Respuesta
Si se ejecuta correctamente, esta acción devuelve un código de respuesta 204 No Content.
Ejemplos
Solicitud
POST https://graph.microsoft.com/beta/auditLogs/signIns/confirmCompromised
Content-Type: application/json
{
"requestIds": [
"f01c6af6-6683-4a37-a945-0a925501eede",
"42bf60ac-d0cb-4206-aa5c-101884298f55",
"f09c8f14-8d8e-42cf-8a7e-732b0594e79b"
]
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.AuditLogs.SignIns.ConfirmCompromised;
var requestBody = new ConfirmCompromisedPostRequestBody
{
RequestIds = new List<string>
{
"f01c6af6-6683-4a37-a945-0a925501eede",
"42bf60ac-d0cb-4206-aa5c-101884298f55",
"f09c8f14-8d8e-42cf-8a7e-732b0594e79b",
},
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
await graphClient.AuditLogs.SignIns.ConfirmCompromised.PostAsync(requestBody);
mgc-beta audit-logs sign-ins confirm-compromised post --body '{\
"requestIds": [\
"f01c6af6-6683-4a37-a945-0a925501eede",\
"42bf60ac-d0cb-4206-aa5c-101884298f55",\
"f09c8f14-8d8e-42cf-8a7e-732b0594e79b"\
]\
}\
'
// Code snippets are only available for the latest major version. Current major version is $v0.*
// Dependencies
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-beta-sdk-go"
graphauditlogs "github.com/microsoftgraph/msgraph-beta-sdk-go/auditlogs"
//other-imports
)
requestBody := graphauditlogs.NewConfirmCompromisedPostRequestBody()
requestIds := []string {
"f01c6af6-6683-4a37-a945-0a925501eede",
"42bf60ac-d0cb-4206-aa5c-101884298f55",
"f09c8f14-8d8e-42cf-8a7e-732b0594e79b",
}
requestBody.SetRequestIds(requestIds)
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
graphClient.AuditLogs().SignIns().ConfirmCompromised().Post(context.Background(), requestBody, nil)
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
com.microsoft.graph.beta.auditlogs.signins.confirmcompromised.ConfirmCompromisedPostRequestBody confirmCompromisedPostRequestBody = new com.microsoft.graph.beta.auditlogs.signins.confirmcompromised.ConfirmCompromisedPostRequestBody();
LinkedList<String> requestIds = new LinkedList<String>();
requestIds.add("f01c6af6-6683-4a37-a945-0a925501eede");
requestIds.add("42bf60ac-d0cb-4206-aa5c-101884298f55");
requestIds.add("f09c8f14-8d8e-42cf-8a7e-732b0594e79b");
confirmCompromisedPostRequestBody.setRequestIds(requestIds);
graphClient.auditLogs().signIns().confirmCompromised().post(confirmCompromisedPostRequestBody);
const options = {
authProvider,
};
const client = Client.init(options);
const confirmCompromised = {
requestIds: [
'f01c6af6-6683-4a37-a945-0a925501eede',
'42bf60ac-d0cb-4206-aa5c-101884298f55',
'f09c8f14-8d8e-42cf-8a7e-732b0594e79b'
]
};
await client.api('/auditLogs/signIns/confirmCompromised')
.version('beta')
.post(confirmCompromised);
<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\AuditLogs\SignIns\ConfirmCompromised\ConfirmCompromisedPostRequestBody;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new ConfirmCompromisedPostRequestBody();
$requestBody->setRequestIds(['f01c6af6-6683-4a37-a945-0a925501eede', '42bf60ac-d0cb-4206-aa5c-101884298f55', 'f09c8f14-8d8e-42cf-8a7e-732b0594e79b', ]);
$graphServiceClient->auditLogs()->signIns()->confirmCompromised()->post($requestBody)->wait();
Import-Module Microsoft.Graph.Beta.Reports
$params = @{
requestIds = @(
"f01c6af6-6683-4a37-a945-0a925501eede"
"42bf60ac-d0cb-4206-aa5c-101884298f55"
"f09c8f14-8d8e-42cf-8a7e-732b0594e79b"
)
}
Confirm-MgBetaAuditLogSignInCompromised -BodyParameter $params
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.auditlogs.signins.confirm_compromised.confirm_compromised_post_request_body import ConfirmCompromisedPostRequestBody
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = ConfirmCompromisedPostRequestBody(
request_ids = [
"f01c6af6-6683-4a37-a945-0a925501eede",
"42bf60ac-d0cb-4206-aa5c-101884298f55",
"f09c8f14-8d8e-42cf-8a7e-732b0594e79b",
],
)
await graph_client.audit_logs.sign_ins.confirm_compromised.post(request_body)
Respuesta
HTTP/1.1 204 No Content