Een aangepaste toepassing maken

In dit artikel leert u hoe u een aangepaste toepassing maakt en deze machtigingen verleent met behulp van Microsoft Entra PowerShell. Dit proces omvat het definiëren van rollen, het toewijzen van gebruikers en groepen en het instellen van API-machtigingen voor het effectief beheren van Microsoft Entra resources.

Inzicht in deze stappen is essentieel voor het veilig beheren van de toegang en ervoor zorgen dat toepassingen over de juiste machtigingen beschikken. Het helpt bij het handhaven van beveiliging en operationele efficiëntie binnen het Microsoft Entra ecosysteem.

Prerequisites

Als u een aangepaste toepassing wilt maken en deze machtigingen wilt verlenen, hebt u het volgende nodig:

Een toepassing maken met Behulp van PowerShell

Gebruik de aangepaste toepassing om de machtigingen te isoleren en te beperken die zijn verleend voor een Microsoft Entra resource.

# Connect to Entra with required scopes
Connect-Entra -Scopes 'Application.ReadWrite.All'

# Define application name and redirect URI
$appName = 'Entra PowerShell Helpdesk App'
$redirectUri = 'http://localhost'

# Create a new application
$app = New-EntraApplication -DisplayName $appName -PublicClient @{ RedirectUris = $redirectUri } -IsFallbackPublicClient $False

# Create a service principal for the application
$servicePrincipal = New-EntraServicePrincipal -AppId $app.AppId

De functie 'Toewijzing vereist' inschakelen met PowerShell

# Set service principal parameters
Set-EntraServicePrincipal -ServicePrincipalId $servicePrincipal.Id -AppRoleAssignmentRequired $True

Gebruikers en groepen toewijzen met Behulp van PowerShell

# Get a user and a group
$user = Get-EntraUser -UserId 'AdeleV@contoso.com'
$group = Get-EntraGroup -Search 'Sales and Marketing'

# Assign users and groups to the application
$emptyGuidUser = [Guid]::Empty.ToString()
New-EntraUserAppRoleAssignment -ObjectId $user.Id -PrincipalId $user.Id -ResourceId $servicePrincipal.Id -Id $emptyGuidUser

$emptyGuidGroup = [Guid]::Empty.ToString()
New-EntraGroupAppRoleAssignment -GroupId $group.Id -PrincipalId $group.Id -ResourceId $servicePrincipal.Id -Id $emptyGuidGroup

Vereiste resources en machtigingen definiëren met behulp van PowerShell

# Get Graph service principal
$graphApiId = '00000003-0000-0000-c000-000000000000'
$graphServicePrincipal = Get-EntraServicePrincipal -Filter "AppId eq '$graphApiId'"
$delegatedPermission = 'User.Read.All'
$app = Get-EntraApplication -Filter "DisplayName eq '$appName'"

# Create resource access object
$resourceAccessDelegated = New-Object Microsoft.Open.MSGraph.Model.ResourceAccess
$resourceAccessDelegated.Id = ((Get-EntraServicePrincipal -ServicePrincipalId $graphServicePrincipal.Id).Oauth2PermissionScopes | Where-Object { $_.Value -eq $delegatedPermission }).Id
$resourceAccessDelegated.Type = 'Scope'

# Create required resource access object
$requiredResourceAccessDelegated = New-Object Microsoft.Open.MSGraph.Model.RequiredResourceAccess
$requiredResourceAccessDelegated.ResourceAppId = $graphApiId
$requiredResourceAccessDelegated.ResourceAccess = $resourceAccessDelegated

# Set application required resource access
Set-EntraApplication -ApplicationId $app.Id -RequiredResourceAccess $requiredResourceAccessDelegated

API-machtigingen toewijzen aan de app met behulp van PowerShell

U kunt gedelegeerde machtigingen of toepassingsmachtigingen toewijzen aan de toepassing.

$delegatedPermission = 'User.Read.All'
$graphApiId = '00000003-0000-0000-c000-000000000000'
$servicePrincipal = Get-EntraServicePrincipal -Filter "DisplayName eq '$appName'"
$graphServicePrincipal = Get-EntraServicePrincipal -Filter "AppId eq '$graphApiId'"

# Grant OAuth2 permission
New-EntraOauth2PermissionGrant -ClientId $servicePrincipal.Id -ConsentType 'AllPrincipals' -ResourceId $graphServicePrincipal.Id -Scope $delegatedPermission

Resources

Download en voer het volledige script uit:

Een toepassing maken in de Microsoft Entra-beheercentrum

Als u aangepaste toepassingen wilt maken om verbinding te maken met Microsoft Entra ID met behulp van Microsoft Entra PowerShell, volgt u de stappen in de volgende sectie. Gebruik de aangepaste toepassing om de machtigingen te isoleren en te beperken die zijn verleend voor een Microsoft Entra resource.

  1. Meld u aan bij het Microsoft Entra-beheercentrum als ten minste een cloudtoepassingsbeheerder.
  2. Blader naar Identiteitstoepassingen>>App-registraties en selecteer vervolgens Nieuwe registratie.
  3. Voer een naam in voor uw toepassing, bijvoorbeeld Entra PowerShell Five.
  4. Voor ondersteunde accounttypen selecteert u Accounts in deze organisatiemap.
  5. Selecteer bij omleidings-URI: - Openbare client/eigen client in de vervolgkeuzelijst - URI-waarde: http://localhost
  6. Selecteer Registreren.

Note

Kopieer in de sectie Overzicht van de app de toepassings-id (client-id) en directory-id (tenant-id). U gebruikt de waarden bij het maken van verbinding met Microsoft Entra ID.

Vereiste toewijzingsfunctie inschakelen in de Microsoft Entra-beheercentrum

Als u de resources wilt beheren waartoe uw toepassing toegang krijgt in uw tenant, zoekt u de service-principal van de toepassing in het deelvenster Bedrijfstoepassingen .

  1. Blader naar Identiteit>Toepassingen>Bedrijfstoepassingen>Alle toepassingen en selecteer de toepassing die u hebt gemaakt.
  2. Selecteer onder BeherenEigenschappen en stel Toewijzing vereist? in op Ja.
  3. Selecteer Opslaan.

Gebruikers en groepen toewijzen in de Microsoft Entra-beheercentrum

  1. Selecteer onder Beheren de optie Gebruikers en groepen.
  2. Selecteer Gebruiker/groep toevoegen en voeg de gebruikers en groepen toe die deze toepassing mogen gebruiken.
  3. Nadat u alle gebruikers en groepen hebt toegevoegd, selecteert u Toewijzen.

API-machtigingen toewijzen aan de app in de Microsoft Entra-beheercentrum

U moet Microsoft Graph machtigingen instellen voor de nieuwe toepassing om verbinding te maken met Microsoft Entra ID en Microsoft Entra resources te beheren.

  1. Blader naar Identiteit>Toepassingen>App-registraties>Alle toepassingen en selecteer de toepassing die u hebt gemaakt.
  2. Selecteer onder API-machtigingenEen machtiging toevoegen> en selecteer Microsoft-API's > Microsoft Graph.
  3. Kies het type machtigingen dat u nodig hebt, gedelegeerde machtigingen of toepassingsmachtigingen.
    • Als u zich moet aanmelden bij de app om uw resources in Microsoft Entra ID te beheren, selecteert u Gedelegeerde machtigingen.
    • Als u wilt dat de app toegang krijgt tot Microsoft Entra resources zonder tussenkomst van de gebruiker, selecteert u Toepassingsmachtigingen
  4. Zoek bijvoorbeeld naar de vereiste machtiging User.Read.All.
  5. Selecteer Beheerderstoestemming verlenen voor TenantName. Selecteer Ja. Zorg ervoor dat de status een groen vinkje weergeeft.

Aanmelden met de nieuwe app

U kunt nu de zojuist gemaakte app gebruiken door verbinding te maken met:

Connect-Entra -ClientId <Your_APPLICATION_Id_Here> -TenantId <Your_TENANT_Id_Here>

Zie de opdrachtdetails Connect-Entra voor meer verbindingsopties.

Verwante onderwerpen

  • Last updated on