identityAccounts: invokeAction

Пространство имен: microsoft.graph.security

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Выполните действия, такие как отзыв учетных записей и принудительный сброс пароля для учетных записей удостоверений, которые наблюдаются в Microsoft Defender для удостоверений. Это действие позволяет считывать и выполнять действия по обеспечению безопасности удостоверений от имени вошедшего в систему удостоверения.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальное обслуживание Правительство США L4 Правительство США L5 (DOD) Китай, обслуживаемый 21Vianet

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более высокий уровень привилегий или разрешений, только если это требуется вашему приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в статье Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения (в списке с наименьшими привилегиями в начале)
Делегированные (рабочая или учебная учетная запись) SecurityIdentitiesActions.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Не поддерживается.
Приложение SecurityIdentitiesActions.ReadWrite.All

Важно!

Для делегированного доступа с помощью рабочих или учебных учетных записей вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или пользовательская роль, предоставляющая разрешения, необходимые для этой операции. Роль администратора безопасности поддерживается для этой операции с наименьшим объемом привилегий.

HTTP-запрос

POST /security/identities/identityAccounts/{identityAccountsId}/invokeAction

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения об аутентификации и авторизации.
Content-Type application/json. Обязательно.

Текст запроса

В тексте запроса укажите JSON-представление параметров.

В следующей таблице перечислены параметры, которые необходимы при вызове этого действия.

Параметр Тип Описание
accountId String Идентификатор учетной записи, с которой нужно выполнить действие.
action microsoft.graph.security.action Тип действия, выполняемого с учетной записью. Допустимые значения: disable, enable, forcePasswordReset, revokeAllSessions, requireUserToSignInAgain, markUserAsCompromised.
identityProvider microsoft.graph.security.identityProvider Поставщик удостоверений, связанный с учетной записью. Допустимые значения: entraID, activeDirectory, okta.

В следующей таблице показаны поставщики удостоверений, поддерживаемые для каждого типа значения действия :

Значение действия Описание Поддерживаемые поставщики удостоверений
Отключение Отключить учетную запись. Учетной записи не удается пройти проверку подлинности. Если учетная запись недавно выполнила вход, у нее нет доступа к ресурсам. activeDirectory, okta
Включение Включить учетную запись. activeDirectory, okta
ForcePasswordReset Принудительный сброс пароля учетной записи. activeDirectory
RevokeAllSessions Отменить все активные сеансы для учетной записи. okta

Отклик

В случае успеха это действие возвращает код ответа 200 OK и invokeActionResult в тексте ответа.

Примеры

Запрос

Ниже показан пример запроса.

POST https://graph.microsoft.com/beta/security/identities/identityAccounts/0104216-0539-4838-88b1-55baafdc296b/invokeAction
Content-Type: application/json

{
  "accountId": "256db173-930a-4991-9061-0d51a9a93ba5",
  "action": "disable",
  "identityProvider": "activeDirectory"
}

Отклик

Ниже показан пример отклика.

Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": 
    {
      "accountId": "256db173-930a-4991-9061-0d51a9a93ba5",
      "action": "disable",
      "provider": "activeDirectory",
      "correlationId": "ed2f052b-2a01-4cd9-acb3-f6145f83e1a5"
    }
}

Примечание.

Действия, связанные с Entra ID, не охватываются текущей областью.