pptb-standard-sample-tool 1.2.1 → 1.2.2

package/dist/app.js

@@ -269,6 +269,9 @@ function setupEventHandlers() {
     document.getElementById("list-flows-btn")?.addEventListener("click", listPowerAutomateFlows);
     document.getElementById("list-environments-btn")?.addEventListener("click", listEnvironments);
     document.getElementById("get-governance-btn")?.addEventListener("click", getGovernanceData);
+    document.getElementById("query-role-definitions-btn")?.addEventListener("click", queryRoleDefinitions);
+    document.getElementById("assign-role-btn")?.addEventListener("click", assignRole);
+    document.getElementById("query-role-assignments-btn")?.addEventListener("click", queryRoleAssignments);
     // Clear log button
     document.getElementById("clear-log-btn")?.addEventListener("click", clearLog);
     // Advanced utilities demos
@@ -1073,6 +1076,142 @@ async function getGovernanceData() {
         log(`Error getting governance data: ${error.message}`, "error");
     }
 }
+/**
+ * Query role definitions from Power Platform Authorization API
+ * Retrieves all available role definitions with their IDs and names
+ */
+async function queryRoleDefinitions() {
+    const output = document.getElementById("role-definitions-output");
+    try {
+        if (output)
+            output.textContent = "Fetching role definitions...\n";
+        // Call the Power Platform Authorization API to get role definitions
+        const result = await powerplatform.Authorization.Get("roleDefinitions?api-version=2024-10-01");
+        if (output) {
+            const roleDefinitions = result.value || [];
+            output.textContent = `Found ${roleDefinitions.length} role definition(s):\n\n`;
+            if (roleDefinitions.length === 0) {
+                output.textContent += "No role definitions found.";
+            }
+            else {
+                // Display role definitions in a formatted table
+                roleDefinitions.forEach((role, index) => {
+                    output.textContent += `${index + 1}. ${role.roleDefinitionName}\n`;
+                    output.textContent += `   ID: ${role.roleDefinitionId}\n`;
+                    if (role.description)
+                        output.textContent += `   Description: ${role.description}\n`;
+                    output.textContent += "\n";
+                });
+            }
+            log(`Retrieved ${roleDefinitions.length} role definitions`, "success");
+            await showNotification("Role Definitions Retrieved", `Found ${roleDefinitions.length} role definition(s)`, "success");
+        }
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        if (output)
+            output.textContent = `Error: ${errorMessage}`;
+        log(`Error querying role definitions: ${errorMessage}`, "error");
+        await showNotification("Error", `Failed to retrieve role definitions: ${errorMessage}`, "error");
+    }
+}
+/**
+ * Assign a role to a principal (user, service principal, or enterprise app)
+ * Creates a role assignment in the Power Platform Authorization API
+ */
+async function assignRole() {
+    const output = document.getElementById("role-assignment-output");
+    const tenantId = document.getElementById("role-assign-tenant-id")?.value;
+    const principalObjectId = document.getElementById("role-assign-principal-object-id")?.value;
+    const principalType = document.getElementById("role-assign-principal-type")?.value || "ApplicationUser";
+    const roleDefinitionId = document.getElementById("role-assign-role-definition-id")?.value;
+    if (!tenantId || !principalObjectId || !roleDefinitionId) {
+        await showNotification("Missing Fields", "Please fill in all required fields", "warning");
+        if (output)
+            output.textContent = "Please provide Tenant ID, Principal Object ID, and Role Definition ID.";
+        return;
+    }
+    try {
+        if (output)
+            output.textContent = "Assigning role...\n";
+        // Build the request body
+        const body = {
+            roleDefinitionId,
+            principalObjectId,
+            principalType,
+            scope: `/tenants/${tenantId}`,
+        };
+        // Call the Power Platform Authorization API to assign role
+        const result = await powerplatform.Authorization.Post("roleAssignments?api-version=2024-10-01", body);
+        if (output) {
+            output.textContent = "Role assignment created successfully!\n\n";
+            output.textContent += "Assignment Details:\n";
+            output.textContent += `ID: ${result.id || result.roleAssignmentId}\n`;
+            output.textContent += `Role Definition ID: ${result.roleDefinitionId}\n`;
+            output.textContent += `Principal Object ID: ${result.principalObjectId}\n`;
+            output.textContent += `Principal Type: ${result.principalType}\n`;
+            output.textContent += `Scope: ${result.scope}\n`;
+        }
+        log(`Role assigned successfully to ${principalObjectId}`, "success");
+        await showNotification("Role Assigned", `Role assigned to ${principalObjectId}`, "success");
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        if (output)
+            output.textContent = `Error: ${errorMessage}`;
+        log(`Error assigning role: ${errorMessage}`, "error");
+        await showNotification("Error", `Failed to assign role: ${errorMessage}`, "error");
+    }
+}
+/**
+ * Query existing role assignments from Power Platform Authorization API
+ * Optionally filter by principal object ID
+ */
+async function queryRoleAssignments() {
+    const output = document.getElementById("role-assignments-list-output");
+    const filterPrincipalId = document.getElementById("query-role-assign-principal-id")?.value;
+    try {
+        if (output)
+            output.textContent = "Fetching role assignments...\n";
+        // Call the Power Platform Authorization API to get role assignments
+        const result = await powerplatform.Authorization.Get("roleAssignments?api-version=2024-10-01");
+        if (output) {
+            const roleAssignments = result.value || [];
+            // Filter by principal object ID if provided
+            let filteredAssignments = roleAssignments;
+            if (filterPrincipalId && filterPrincipalId.trim()) {
+                filteredAssignments = roleAssignments.filter((assignment) => assignment.principalObjectId === filterPrincipalId);
+                output.textContent = `Found ${filteredAssignments.length} role assignment(s) for principal ${filterPrincipalId}:\n\n`;
+            }
+            else {
+                output.textContent = `Found ${roleAssignments.length} total role assignment(s):\n\n`;
+            }
+            if (filteredAssignments.length === 0) {
+                output.textContent += "No role assignments found.";
+            }
+            else {
+                // Display role assignments in a formatted table
+                filteredAssignments.forEach((assignment, index) => {
+                    output.textContent += `${index + 1}. Role Assignment ID: ${assignment.roleAssignmentId || assignment.id}\n`;
+                    output.textContent += `   Role Definition ID: ${assignment.roleDefinitionId}\n`;
+                    output.textContent += `   Principal Object ID: ${assignment.principalObjectId}\n`;
+                    output.textContent += `   Principal Type: ${assignment.principalType}\n`;
+                    output.textContent += `   Scope: ${assignment.scope}\n`;
+                    output.textContent += "\n";
+                });
+            }
+            log(`Retrieved ${filteredAssignments.length} role assignment(s)${filterPrincipalId ? ` for ${filterPrincipalId}` : ""}`, "success");
+            await showNotification("Role Assignments Retrieved", `Found ${filteredAssignments.length} role assignment(s)`, "success");
+        }
+    }
+    catch (error) {
+        const errorMessage = error.message;
+        if (output)
+            output.textContent = `Error: ${errorMessage}`;
+        log(`Error querying role assignments: ${errorMessage}`, "error");
+        await showNotification("Error", `Failed to retrieve role assignments: ${errorMessage}`, "error");
+    }
+}
 // Initialize when DOM is ready
 if (document.readyState === "loading") {
     document.addEventListener("DOMContentLoaded", initialize);

package/dist/index.html

@@ -220,6 +220,54 @@
                     </div>
                     <div id="governance-output" class="output"></div>
                 </div>
+
+                <div class="example-group">
+                    <h3>Authorization API</h3>
+                    <div class="button-group">
+                        <button id="query-role-definitions-btn" class="btn btn-primary">Query Role Definitions</button>
+                    </div>
+                    <div id="role-definitions-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Authorization API - Role Assignment</h3>
+                    <div class="input-group">
+                        <label for="role-assign-tenant-id">Tenant ID:</label>
+                        <input type="text" id="role-assign-tenant-id" placeholder="e.g., 15263562-2ed2-4856-8562-42edf998128b" />
+                    </div>
+                    <div class="input-group">
+                        <label for="role-assign-principal-object-id">Principal Object ID:</label>
+                        <input type="text" id="role-assign-principal-object-id" placeholder="e.g., 78541268-7456-7856-a7ba-04424f177c7c" />
+                    </div>
+                    <div class="input-group">
+                        <label for="role-assign-principal-type">Principal Type:</label>
+                        <select id="role-assign-principal-type">
+                            <option value="ApplicationUser">ApplicationUser</option>
+                            <option value="ServicePrincipal">ServicePrincipal</option>
+                            <option value="User">User</option>
+                        </select>
+                    </div>
+                    <div class="input-group">
+                        <label for="role-assign-role-definition-id">Role Definition ID:</label>
+                        <input type="text" id="role-assign-role-definition-id" placeholder="e.g., ff954d61-a89a-4fbe-ace9-01c367b89f87" />
+                    </div>
+                    <div class="button-group">
+                        <button id="assign-role-btn" class="btn btn-success">Assign Role</button>
+                    </div>
+                    <div id="role-assignment-output" class="output"></div>
+                </div>
+
+                <div class="example-group">
+                    <h3>Authorization API - Query Role Assignments</h3>
+                    <div class="input-group">
+                        <label for="query-role-assign-principal-id">Principal Object ID (Optional - filters results):</label>
+                        <input type="text" id="query-role-assign-principal-id" placeholder="e.g., 78541268-7456-7856-a7ba-04424f177c7c" />
+                    </div>
+                    <div class="button-group">
+                        <button id="query-role-assignments-btn" class="btn">Query Role Assignments</button>
+                    </div>
+                    <div id="role-assignments-list-output" class="output"></div>
+                </div>
             </section>
 
             <!-- Inter-tool Invocation Example -->

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pptb-standard-sample-tool",
-    "version": "1.2.1",
+    "version": "1.2.2",
     "displayName": "HTML Sample Tool",
     "description": "A sample Power Platform ToolBox tool built with HTML, CSS, and TypeScript",
     "main": "index.html",