Page 9852 Effective Permissions

Base Application, System.Security.AccessControl

src/Layers/W1/BaseApp/System/Permissions/EffectivePermissions.Page.al324 lines, Copyright (c) Microsoft Corporation. MIT

namespace System.Security.AccessControl;using Microsoft.Foundation.Company;using System.Environment;using System.Security.User;using System.Telemetry;page 9852 "Effective Permissions"{    ApplicationArea = All;    Caption = 'Effective Permissions';    AboutTitle = 'About Effective Permissions';    AboutText = 'View the permissions a user actually has in Business Central. Effective permissions combine all assigned permission sets and filters to show the final access to objects and data, helping you verify access, troubleshoot permission issues, and support audits.';    DeleteAllowed = false;    InsertAllowed = false;    ModifyAllowed = false;    PageType = Worksheet;    SourceTable = Permission;    SourceTableTemporary = true;    UsageCategory = Administration;    layout    {        area(content)        {            group(General)            {                Caption = 'General';                field(ChooseUser; ChosenUserName)                {                    ApplicationArea = All;                    Caption = 'User';                    ToolTip = 'Specifies the user that the effective permissions apply to.';                    trigger OnLookup(var Text: Text): Boolean                    var                        UserSelection: Codeunit "User Selection";                        ChosenUser: Record User;                        User: Record User;                        Users: Page Users;                    begin                        UserSelection.FilterSystemUserAndGroupUsers(User);                        Users.SetTableView(User);                        ChosenUser.SetRange("User Name", Text);                        if ChosenUser.FindFirst() then                            Users.SetRecord(ChosenUser);                        Users.LookupMode(true);                        if Users.RunModal() = ACTION::LookupOK then begin                            Users.GetRecord(User);                            if Text <> User."User Name" then begin                                Text := User."User Name";                                ChosenUserName := Text;                                CurrentUserID := User."User Security ID";                                FillByObject();                            end;                        end;                    end;                    trigger OnValidate()                    var                        User: Record User;                    begin                        User.SetRange("User Name", ChosenUserName);                        User.FindFirst();                        CurrentUserID := User."User Security ID";                        FillByObject();                    end;                }                field(ChooseCompany; CurrentCompanyName)                {                    ApplicationArea = All;                    Caption = 'Company';                    ToolTip = 'Specifies the company for which effective permissions for the chosen user will be shown.';                    trigger OnLookup(var Text: Text): Boolean                    var                        Company: Record Company;                        Companies: Page Companies;                    begin                        if Company.Get(CurrentCompanyName) then                            Companies.SetRecord(Company);                        Companies.LookupMode(true);                        if Companies.RunModal() = ACTION::LookupOK then begin                            Companies.GetRecord(Company);                            if Text <> Company.Name then begin                                Text := Company.Name;                                CurrentCompanyName := Text;                                FillByObject();                            end;                        end;                    end;                    trigger OnValidate()                    var                        Company: Record Company;                    begin                        Company.Get(CurrentCompanyName);                        FillByObject();                    end;                }                field(ShowAllObjects; ShowAllObjects)                {                    ApplicationArea = All;                    Caption = 'Show All Objects';                    ToolTip = 'Specifies if the effective permissions are shown for all objects or only for objects in the user''s assigned permission sets.';                    trigger OnValidate()                    begin                        CurrentObjectId := 0;                        FillByObject();                    end;                }            }            group(Permissions)            {                Caption = 'Permissions';                repeater(EffectivePermissions)                {                    field("Object Type"; Rec."Object Type")                    {                        ApplicationArea = All;                        ToolTip = 'Specifies the type of object that the permissions apply to in the current database.';                    }                    field("Object ID"; Rec."Object ID")                    {                        ApplicationArea = All;                        Editable = false;                        ToolTip = 'Specifies the ID of the object to which the permissions apply.';                        Visible = false;                    }                    field("Object Name"; Rec."AL Object Name")                    {                        ApplicationArea = All;                        Caption = 'Object Name';                        Editable = false;                    }                    field("Read Permission"; Rec."Read Permission")                    {                        ApplicationArea = All;                        ToolTip = 'Specifies information about whether the permission set has read permission to this object. The values for the field are blank, Yes, and Indirect. Indirect means permission only through another object. If the field is empty, the permission set does not have read permission.';                    }                    field("Insert Permission"; Rec."Insert Permission")                    {                        ApplicationArea = All;                        ToolTip = 'Specifies information about whether the permission set has insert permission to this object. The values for the field are blank, Yes, and Indirect. Indirect means permission only through another object. If the field is empty, the permission set does not have insert permission.';                    }                    field("Modify Permission"; Rec."Modify Permission")                    {                        ApplicationArea = All;                        ToolTip = 'Specifies information about whether the permission set has modify permission to this object. The values for the field are blank, Yes, and Indirect. Indirect means permission only through another object. If the field is empty, the permission set does not have modify permission.';                    }                    field("Delete Permission"; Rec."Delete Permission")                    {                        ApplicationArea = All;                        ToolTip = 'Specifies information about whether the permission set has delete permission to this object. The values for the field are blank, Yes, and Indirect. Indirect means permission only through another object. If the field is empty, the permission set does not have delete permission.';                    }                    field("Execute Permission"; Rec."Execute Permission")                    {                        ApplicationArea = All;                        ToolTip = 'Specifies information about whether the permission set has execute permission to this object. The values for the field are blank, Yes, and Indirect. Indirect means permission only through another object. If the field is empty, the permission set does not have execute permission.';                    }                    field(ContainedInCustomPermissionSet; ContainedInCustomPermissionSet)                    {                        ApplicationArea = All;                        Caption = 'In User-Defined Permission Set';                        Editable = false;                        ToolTip = 'Specifies if the object is included in a User-Defined permission set.';                    }                }            }            part(ByPermissionSet; "Effective Permissions By Set")            {                ApplicationArea = All;                UpdatePropagation = Both;            }        }    }    actions    {        area(processing)        {            action("Permission Sets")            {                ApplicationArea = All;                Caption = 'Permission Sets';                Image = Permission;                RunObject = Page "Permission Sets";                ToolTip = 'View or edit which feature objects that users need to access and set up the related permissions in permission sets that you can assign to the users of the database.';            }            action("Permission Set by User")            {                ApplicationArea = All;                Caption = 'Permission Set by User';                Image = Permission;                RunObject = Page "Permission Set by User";                ToolTip = 'View or edit the available permission sets and apply permission sets to existing users.';            }        }        area(Promoted)        {            group(Category_Process)            {                Caption = 'Process';                actionref("Permission Sets_Promoted"; "Permission Sets")                {                }                actionref("Permission Set by User_Promoted"; "Permission Set by User")                {                }            }        }    }    trigger OnAfterGetCurrRecord()    var        EffectivePermissionsMgt: Codeunit "Effective Permissions Mgt.";    begin        // Refresh        if Rec."Object ID" <> 0 then begin // handle case when there are no records at all            EffectivePermissionsMgt.PopulatePermissionRecordWithEffectivePermissionsForObject(Rec, CurrentUserID, CurrentCompanyName,              Rec."Object Type", Rec."Object ID");            Rec.Modify();        end;        CurrPage.ByPermissionSet.PAGE.SetRecordAndRefresh(CurrentUserID, CurrentCompanyName, Rec."Object Type", Rec."Object ID");    end;    trigger OnAfterGetRecord()    var        TenantPermission: Record "Tenant Permission";        ZeroGuid: Guid;    begin        if Rec."Object ID" = 0 then            exit;        TenantPermission.SetRange("App ID", ZeroGuid); // does not come from an extension        TenantPermission.SetRange("Object Type", Rec."Object Type");        TenantPermission.SetRange("Object ID", Rec."Object ID");        ContainedInCustomPermissionSet := not TenantPermission.IsEmpty();    end;    trigger OnInit()    begin        CurrentUserID := UserSecurityId();        ChosenUserName := UserId();        CurrentCompanyName := CompanyName();    end;    trigger OnOpenPage()    var        AuditLog: Codeunit "Audit Log";        EffectivePermissionsMgt: Codeunit "Effective Permissions Mgt.";        EffectivePermissionsPageOpenLbl: Label 'The Effective Permissions page has been opened by UserSecurityId %1.', Locked = true;    begin        EffectivePermissionsMgt.DisallowViewingEffectivePermissionsForNonAdminUsers(UserSecurityId());        FillByObject();        AuditLog.LogAuditMessage(StrSubstNo(EffectivePermissionsPageOpenLbl, UserSecurityId()), SecurityOperationResult::Success, AuditCategory::ApplicationManagement, 2, 0);    end;    var        CurrentUserID: Guid;        CurrentObjectType: Option;        CurrentObjectId: Integer;        CurrentCompanyName: Text[30];        ChosenUserName: Code[50];        LastUsedUserID: Guid;        LastUsedCompanyName: Text[30];        LastUsedObjectType: Option;        LastUsedObjectId: Integer;        LastUsedShowAllObjects: Boolean;        ShowAllObjects: Boolean;        ContainedInCustomPermissionSet: Boolean;        OnlyAadUsersAllowedErr: Label 'The effective permissions content can be shown only for Microsoft Entra ID users.';    local procedure FillByObject()    var        UserProperty: Record "User Property";        EffectivePermissionsMgt: Codeunit "Effective Permissions Mgt.";        EnvironmentInfo: Codeunit "Environment Information";    begin        if (LastUsedUserID = CurrentUserID) and           (LastUsedCompanyName = CurrentCompanyName) and           (LastUsedObjectType = CurrentObjectType) and           (LastUsedObjectId = CurrentObjectId) and           (LastUsedShowAllObjects = ShowAllObjects)        then            exit;        if EnvironmentInfo.IsSaaS() then            if (not UserProperty.Get(CurrentUserID)) or (UserProperty."Authentication Object ID" = '') then                Error(OnlyAadUsersAllowedErr);        EffectivePermissionsMgt.PopulateEffectivePermissionsBuffer(Rec,          CurrentUserID, CurrentCompanyName, CurrentObjectType, CurrentObjectId, ShowAllObjects);        CurrPage.Update(false);        LastUsedUserID := CurrentUserID;        LastUsedCompanyName := CurrentCompanyName;        LastUsedObjectType := CurrentObjectType;        LastUsedObjectId := CurrentObjectId;        LastUsedShowAllObjects := ShowAllObjects;        OnEffectivePermissionsPopulated(CurrentUserID, CurrentCompanyName, CurrentObjectType, CurrentObjectId);    end;    procedure SetUserSID(UserSID: Guid)    var        User: Record User;    begin        User.Get(UserSID);        CurrentUserID := UserSID;        ChosenUserName := User."User Name";    end;    [IntegrationEvent(false, false)]    local procedure OnEffectivePermissionsPopulated(CurrUserId: Guid; CurrCompanyName: Text[30]; CurrObjectType: Integer; CurrObjectId: Integer)    begin    end;}