Водич : Доделите улоге принципалима услуге (преглед)

[Овај чланак представља прелиминарну документацију и може се променити.]

Контрола приступа заснована на улози (РБАЦ) у Повер Платформ-у омогућава администраторима да доделе уграђене улоге корисницима, групама и принципалима услуга у станару, групи окружења или опсегу окружења. Овај туторијал пролази кроз уобичајени сценарио аутоматизације: додељивање улоге сарадника главници услуге у опсегу станара помоћу АПИ-ја за ауторизацију.

Да бисте сазнали више о РБАЦ концептима, уграђеним улогама и наслеђивању обима, погледајте Контрола приступа заснована на улози за Повер Платформ админ центер .

Важно

Ово је функција прегледа.
Функције верзије за преглед нису намењене за коришћење у производњи и можда имају ограничене функционалности. Ове функције подлежу додатним условима коришћења и доступне су пре званичног издања, тако да корисници могу добити рани приступ и пружити повратне информације.

У овом водичу ћете научити да:

Потврдите аутентичност помоћу Повер Платформ АПИ-ја.
Наведите доступне дефиниције улога.
Креирајте доделу улоге за главни сервис у опсегу станара.
Проверите додељивање улоге.

Предуслови

Регистрација апликације Мицрософт Ентра конфигурисана за Повер Платформ АПИ, са сертификатом или тајном клијента за аутентификацију главнице услуге. За упутства, погледајте Аутентификација .
ИД објекта Ентерприсе Апплицатион за главницу услуге (налази се у Мицрософт Ентра ИД > Ентерприсе апликацијама ).
Идентитет позивања мора имати улогу администратора Повер Платформ или Повер Платформ администратора контроле приступа засновану на улози .

Уграђене дефиниције улога

Повер Платформ обезбеђује четири уграђене улоге које се могу доделити преко РБАЦ-а. Свака улога има фиксни скуп дозвола и може се доделити на станару, групи окружења или опсегу окружења.

Име улоге	Улога ИД	Дозволе
Власник Повер Платформ-а	`0cb07c69-1631-4725-ab35-e59e001c51ea`	Све дозволе
Допринос Повер Платформ-а	`ff954d61-a89a-4fbe-ace9-01c367b89f87`	Управљајте и читајте све ресурсе, али не можете направити или променити задатке улога
Повер Платформ читач	`c886ad2e-27f7-4874-8381-5849b8d8a090`	Приступ само за читање свим ресурсима
Администратор контроле приступа заснован на улози Повер Платформ-а	`95e94555-018c-447b-8691-bdac8e12211e`	Прочитајте све ресурсе + управљајте доделама улога

Корак 1. Наведите доступне дефиниције улога

Прво , потврдите аутентичност и преузмите доступне дефиниције улога да бисте потврдили ИД улоге сарадника.

# Install the Az.Accounts module if not already installed
Install-Module -Name Az.Accounts

# Set your tenant ID
$TenantId = "YOUR_TENANT_ID"

# Authenticate and obtain an access token
Connect-AzAccount
$secureToken = (Get-AzAccessToken -TenantId $TenantId -ResourceUrl "https://api.powerplatform.com/").Token
$AccessToken = [System.Net.NetworkCredential]::new("", $secureToken).Password

$headers = @{ 'Authorization' = 'Bearer ' + $AccessToken }
$headers.Add('Content-Type', 'application/json')

# List all role definitions
$roleDefinitions = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/authorization/roleDefinitions?api-version=2024-10-01" -Headers $headers

$roleDefinitions.value | Format-Table roleDefinitionName, roleDefinitionId

Очекивани излаз:

roleDefinitionName                                          roleDefinitionId
------------------                                          ----------------
Power Platform owner                                        0cb07c69-1631-4725-ab35-e59e001c51ea
Power Platform contributor                                  ff954d61-a89a-4fbe-ace9-01c367b89f87
Power Platform reader                                       c886ad2e-27f7-4874-8381-5849b8d8a090
Power Platform role-based access control administrator      95e94555-018c-447b-8691-bdac8e12211e

using Microsoft.PowerPlatform.Management;
using Microsoft.PowerPlatform.Management.Models;

var client = ServiceClientFactory.Create(clientId);

// List all role definitions
var roleDefinitions = await client.Authorization.RoleDefinitions.GetAsync();

foreach (var role in roleDefinitions.Value)
{
    Console.WriteLine($"{role.RoleDefinitionName}: {role.RoleDefinitionId}");
}

Очекивани излаз:

Power Platform owner: 0cb07c69-1631-4725-ab35-e59e001c51ea
Power Platform contributor: ff954d61-a89a-4fbe-ace9-01c367b89f87
Power Platform reader: c886ad2e-27f7-4874-8381-5849b8d8a090
Power Platform role-based access control administrator: 95e94555-018c-447b-8691-bdac8e12211e

import asyncio
from azure.identity import InteractiveBrowserCredential
from kiota_authentication_azure.azure_identity_authentication_provider import AzureIdentityAuthenticationProvider
from kiota_http.httpx_request_adapter import HttpxRequestAdapter
from mspp_management.service_client_base import ServiceClientBase

credential = InteractiveBrowserCredential()
auth_provider = AzureIdentityAuthenticationProvider(
    credential,
    scopes=["https://api.powerplatform.com/.default"]
)
adapter = HttpxRequestAdapter(auth_provider)
adapter.base_url = "https://api.powerplatform.com"
client = ServiceClientBase(adapter)

# List all role definitions
role_definitions = await client.authorization.role_definitions.get()

for role in role_definitions.value:
    print(f"{role.role_definition_name}: {role.role_definition_id}")

Очекивани излаз:

Power Platform owner: 0cb07c69-1631-4725-ab35-e59e001c51ea
Power Platform contributor: ff954d61-a89a-4fbe-ace9-01c367b89f87
Power Platform reader: c886ad2e-27f7-4874-8381-5849b8d8a090
Power Platform role-based access control administrator: 95e94555-018c-447b-8691-bdac8e12211e

Повер Платформ АПИ референца: Role-Based Контрола приступа - Листа дефиниција улога

2. корак Доделите улогу сарадника главници услуге

Креирајте доделу улоге која додељује улогу сарадника Повер Платформ-а главници услуге у опсегу станара. Замените YOUR_TENANT_ID са ГУИД-ом станара и ИД-ом објекта апликације предузећа из Мицрософт Ентра ИД-а YOUR_ENTERPRISE_APP_OBJECT_ID .

$TenantId = "YOUR_TENANT_ID"
$EnterpriseAppObjectId = "YOUR_ENTERPRISE_APP_OBJECT_ID"

$body = @{
    roleDefinitionId = "ff954d61-a89a-4fbe-ace9-01c367b89f87"
    principalObjectId = $EnterpriseAppObjectId
    principalType = "ApplicationUser"
    scope = "/tenants/$TenantId"
} | ConvertTo-Json

$roleAssignment = Invoke-RestMethod -Method Post -Uri "https://api.powerplatform.com/authorization/roleAssignments?api-version=2024-10-01" -Headers $headers -Body $body

$roleAssignment

Очекивани излаз:

roleAssignmentId   : a1b2c3d4-e5f6-7890-abcd-ef1234567890
principalObjectId  : <your-enterprise-app-object-id>
roleDefinitionId   : ff954d61-a89a-4fbe-ace9-01c367b89f87
scope              : /tenants/<your-tenant-id>
principalType      : ApplicationUser
createdOn          : 2026-03-02T12:00:00.0000000+00:00

var request = new RoleAssignmentRequest
{
    RoleDefinitionId = "ff954d61-a89a-4fbe-ace9-01c367b89f87",
    PrincipalObjectId = "YOUR_ENTERPRISE_APP_OBJECT_ID",
    PrincipalType = "ApplicationUser",
    Scope = "/tenants/YOUR_TENANT_ID"
};

var roleAssignment = await client.Authorization.RoleAssignments.PostAsync(request);

Console.WriteLine($"Assignment ID: {roleAssignment.Value[0].RoleAssignmentId}");
Console.WriteLine($"Scope: {roleAssignment.Value[0].Scope}");
Console.WriteLine($"Principal: {roleAssignment.Value[0].PrincipalObjectId}");

from mspp_management.models.role_assignment_request import RoleAssignmentRequest

request = RoleAssignmentRequest(
    role_definition_id="ff954d61-a89a-4fbe-ace9-01c367b89f87",
    principal_object_id="YOUR_ENTERPRISE_APP_OBJECT_ID",
    principal_type="ApplicationUser",
    scope="/tenants/YOUR_TENANT_ID",
)

role_assignment = await client.authorization.role_assignments.post(request)

print(f"Assignment ID: {role_assignment.value[0].role_assignment_id}")
print(f"Scope: {role_assignment.value[0].scope}")
print(f"Principal: {role_assignment.value[0].principal_object_id}")

Повер Платформ АПИ референца: Role-Based Контрола приступа - Креирај доделу улоге

3. корак Проверите додељивање улоге

Преузмите све задатке улога да бисте потврдили да постоји нови задатак.

$roleAssignments = Invoke-RestMethod -Method Get -Uri "https://api.powerplatform.com/authorization/roleAssignments?api-version=2024-10-01" -Headers $headers

# Filter for the service principal's assignments
$roleAssignments.value | Where-Object { $_.principalObjectId -eq $EnterpriseAppObjectId } | Format-Table roleAssignmentId, roleDefinitionId, scope, principalType

Очекивани излаз:

roleAssignmentId                        roleDefinitionId                        scope                          principalType
----------------                        ----------------                        -----                          -------------
a1b2c3d4-e5f6-7890-abcd-ef1234567890    ff954d61-a89a-4fbe-ace9-01c367b89f87    /tenants/<your-tenant-id>      ApplicationUser

var roleAssignments = await client.Authorization.RoleAssignments.GetAsync();

var myAssignments = roleAssignments.Value
    .Where(a => a.PrincipalObjectId == "YOUR_ENTERPRISE_APP_OBJECT_ID");

foreach (var assignment in myAssignments)
{
    Console.WriteLine($"ID: {assignment.RoleAssignmentId}");
    Console.WriteLine($"Role: {assignment.RoleDefinitionId}");
    Console.WriteLine($"Scope: {assignment.Scope}");
    Console.WriteLine($"Type: {assignment.PrincipalType}");
}

role_assignments = await client.authorization.role_assignments.get()

my_assignments = [
    a for a in role_assignments.value
    if a.principal_object_id == "YOUR_ENTERPRISE_APP_OBJECT_ID"
]

for assignment in my_assignments:
    print(f"ID: {assignment.role_assignment_id}")
    print(f"Role: {assignment.role_definition_id}")
    print(f"Scope: {assignment.scope}")
    print(f"Type: {assignment.principal_type}")

Повер Платформ АПИ референца: Контрола приступа заснована на улози - Листа задатака улога

Повратне информације

Да ли је ова страница била од помоћи?

Last updated on 2026-06-01

Водич : Доделите улоге принципалима услуге (преглед)

Предуслови

Уграђене дефиниције улога

Корак 1. Наведите доступне дефиниције улога

2. корак Доделите улогу сарадника главници услуге

3. корак Проверите додељивање улоге

Повезани садржај

Повратне информације

Додатни ресурси