Skip to content

basic-permissions.md

Latest commit

 

History

History
91 lines (61 loc) · 3.35 KB

basic-permissions.md

File metadata and controls

91 lines (61 loc) · 3.35 KB

title: Use basic permissions to access the portal description: Learn how to use basic permissions to access the Microsoft Defender for Endpoint portal. ms.service: defender-endpoint ms.subservice: onboard ms.author: painbar author: paulinbar ms.localizationpriority: medium ms.custom:

  • has-azure-ad-ps-ref
  • azure-ad-ref-level-one-done manager: bagol audience: ITPro ms.collection:
  • m365-security
  • tier2 ms.topic: how-to search.appverid: met150 ms.date: 06/25/2024 appliesto:
    • Microsoft Defender for Endpoint Plan 1
    • Microsoft Defender for Endpoint Plan 2

Use basic permissions to access the portal

If you want to use basic permissions management for the Microsoft Defender portal, keep in mind that permissions are set to either full access or read only. For granular control over permissions, use role-based access control.

Assign user access using Microsoft Graph PowerShell

You can assign users with one of the following levels of permissions:

  • Full access (Read and Write)
  • Read-only access

Before you begin

  • Install Microsoft Graph PowerShell. For more information, see, How to install Microsoft Graph PowerShell.

    [!NOTE] You need to run the PowerShell cmdlets in an elevated command-line.

  • Connect to your Microsoft Entra ID. For more information, see Connect-MgGraph.

    • Full access: Users with full access can log in, view all system information and resolve alerts, submit files for deep analysis, and download the onboarding package. Assigning full access rights requires adding the users to a role, such as Security Administrator, using Microsoft Entra built-in roles.

    • Read-only access: Users with read-only access can log in, view all alerts, and related information.

      They will not be able to change alert states, submit files for deep analysis or perform any state changing operations.

      Assigning read-only access rights requires adding the users to the "Security Reader" Microsoft Entra built-in role.

Use the following steps to assign security roles:

  • For read and write access, assign users to the security administrator role by using the following command:

    $Role = Get-MgDirectoryRole -Filter "DisplayName eq 'Security Administrator'"
$UserId = (Get-MgUser -UserId "[email protected]").Id

$DirObject = @{
  "@odata.id" = "https://graph.microsoft.com/v1.0/directoryObjects/$UserId"
}

New-MgDirectoryRoleMemberByRef -DirectoryRoleId $Role.Id -BodyParameter $DirObject

  • For read-only access, assign users to the security reader role by using the following command:

    $Role = Get-MgDirectoryRole -Filter "DisplayName eq 'Security Reader'"
$UserId = (Get-MgUser -UserId "[email protected]").Id

$DirObject = @{
  "@odata.id" = "https://graph.microsoft.com/v1.0/directoryObjects/$UserId"
}

New-MgDirectoryRoleMemberByRef -DirectoryRoleId $Role.Id -BodyParameter $DirObject

For more information, see Add or remove group members using Microsoft Entra ID.

Related articles