Page 9861 AAD Application Card

Base Application, System.Environment.Configuration

src/Layers/W1/BaseApp/System/AadApplication/AADApplicationCard.Page.al262 lines, Copyright (c) Microsoft Corporation. MIT

namespace System.Environment.Configuration;using Microsoft.Integration.Graph;using System.Security.AccessControl;using System.Security.Authentication;using System.Security.User;page 9861 "AAD Application Card"{    Caption = 'Microsoft Entra Application Card';    PageType = Card;    RefreshOnActivate = true;    SourceTable = "AAD Application";    layout    {        area(content)        {            group(General)            {                Caption = 'General';                field("Client Id"; Rec."Client Id")                {                    ApplicationArea = Basic, Suite;                    Importance = Standard;                    Editable = EditableByNotEnabled;                    Caption = 'Client ID';                    ToolTip = 'Specifies the client ID for the app.';                }                field(Description; Rec.Description)                {                    ShowMandatory = true;                    ApplicationArea = Basic, Suite;                    Caption = 'Description';                    ToolTip = 'Specifies a description of the app. The description will be automatically added in the User Name field of the card the first time the app is enabled.';                    Editable = EditableByNotEnabled;                    trigger OnValidate()                    begin                        UpdateControl();                    end;                }                field(State; Rec.State)                {                    ApplicationArea = Basic, Suite;                    Importance = Standard;                    Caption = 'State';                    ToolTip = 'Specifies if the app is enabled or disabled.';                    trigger OnValidate()                    begin                        UpdateControl();                    end;                }                field("Contact Information"; Rec."Contact Information")                {                    ApplicationArea = Basic, Suite;                    Editable = EditableByNotEnabled;                    Caption = 'Contact Information';                    ToolTip = 'Specifies the contact information of the app.';                }                group(Extension)                {                    field("App ID"; Rec."App ID")                    {                        ApplicationArea = Basic, Suite;                        Editable = EditableByNotEnabled;                        Caption = 'App ID';                        ToolTip = 'Specifies the app ID of the extension.';                    }                    field("App Name"; Rec."App Name")                    {                        Editable = EditableByNotEnabled;                        ApplicationArea = Basic, Suite;                        Caption = 'App Name';                        ToolTip = 'Specifies the app name of the extension.';                    }                }                group("User information")                {                    field("User ID"; Rec."User id")                    {                        ApplicationArea = Basic, Suite;                        Editable = false;                        Caption = 'User ID';                        ToolTip = 'Specifies the unique ID (GUID) assigned to the application. This field is automatically filled in once the app is enabled. The user ID. like the user name, is used to indicate sessions and operations that are run by the app.';                    }                    field("User name"; Username)                    {                        ApplicationArea = Basic, Suite;                        Editable = false;                        Caption = 'User Name';                        ToolTip = 'Specifies the user name assigned to the app. This field is automatically filled in with the value of the Description field once the app is enabled. The user name, like the user ID, is used to indicate sessions and operations that are run by the app..';                    }                    field("User Telemetry Id"; TelemetryUserId)                    {                        ApplicationArea = Basic, Suite;                        Editable = false;                        Caption = 'User Telemetry ID';                        ToolTip = 'Specifies a telemetry ID assigned to the app which can be used for troubleshooting purposes.';                    }                }                field(ShowEnableWarning; ShowEnableWarning)                {                    ApplicationArea = Basic, Suite;                    ShowCaption = false;                    AssistEdit = false;                    Editable = false;                    Enabled = not EditableByNotEnabled;                    trigger OnDrillDown()                    begin                        DrilldownCode();                    end;                }                field(ShowInitializeUserWarningField; ShowInitializeUserWarning)                {                    ApplicationArea = Basic, Suite;                    ShowCaption = false;                    Editable = false;                    Enabled = InitializeUserEnabled;                    Style = AttentionAccent;                    trigger OnDrillDown()                    begin                        InitializeApplicationUser();                    end;                }            }            part(Permissions; "User Subform")            {                ApplicationArea = Basic, Suite;                Caption = 'User Permission Sets';                Enabled = SetUserPermissionEnabled;                SubPageLink = "User Security ID" = field("User Id");            }        }    }    actions    {        area(Processing)        {            action(Consent)            {                ApplicationArea = Basic, Suite;                Caption = 'Grant Consent';                Image = Setup;                Enabled = not IsVEApp;                Scope = Repeater;                ToolTip = 'Grant consent for this application to access data from Business Central.';                trigger OnAction()                begin                    GrantConsent();                end;            }        }        area(Promoted)        {            group(Category_Process)            {                Caption = 'Process', Comment = 'Generated from the PromotedActionCategories property index 1.';                actionref(Consent_Promoted; Consent)                {                }            }            group(Category_Report)            {                Caption = 'Report', Comment = 'Generated from the PromotedActionCategories property index 2.';            }        }    }    trigger OnAfterGetCurrRecord()    var        AADApplicationSetup: Codeunit "AAD Application Setup";    begin        IsVEApp := LowerCase(GraphMgtGeneralTools.StripBrackets(Format(Rec."Client Id"))) = AADApplicationSetup.GetD365BCForVEAppId();        UpdateControl();    end;    var        GraphMgtGeneralTools: Codeunit "Graph Mgt - General Tools";        CommonOAuthAuthorityUrlLbl: Label 'https://login.microsoftonline.com/common/adminconsent', Locked = true;        ConsentFailedErr: Label 'Failed to give consent.';        ConsentSuccessTxt: Label 'Consent was given successfully.';        EnabledWarningTok: Label 'You must set the State field to Disabled before you can make changes to this app.';        DisableEnableQst: Label 'Do you want to disable this app?';        InitializeUserSuccessTxt: Label 'User has been created. You can now add permission sets.';        InitializeUserWarningTok: Label 'You must initialize the user before you can add permission sets. Click here to create the application user.';        UserName: Text;        TelemetryUserId: Guid;        ShowEnableWarning: Text;        IsVEApp: Boolean;        SetUserPermissionEnabled: Boolean;        EditableByNotEnabled: Boolean;        InitializeUserEnabled: Boolean;        ShowInitializeUserWarning: Text;    [Scope('OnPrem')]    local procedure GrantConsent();    var        OAuth2: Codeunit OAuth2;        Success: Boolean;        ErrorMsgTxt: Text;    begin        OAuth2.RequestClientCredentialsAdminPermissions(GraphMgtGeneralTools.StripBrackets(Format(Rec."Client Id")), CommonOAuthAuthorityUrlLbl, '', Success, ErrorMsgTxt);        if not Success then            if ErrorMsgTxt <> '' then                Error(ErrorMsgTxt)            else                Error(ConsentFailedErr);        Message(ConsentSuccessTxt);        Rec."Permission Granted" := true;        Rec.Modify();    end;    local procedure UpdateControl()    var        User: Record User;        UserProperty: Record "User Property";    begin        EditableByNotEnabled := Rec.State = Rec.State::Disabled;        SetUserPermissionEnabled := EditableByNotEnabled and not IsNullGuid(Rec."User ID");        InitializeUserEnabled := EditableByNotEnabled and IsNullGuid(Rec."User ID") and (Rec.Description <> '');        ShowEnableWarning := '';        ShowInitializeUserWarning := '';        if CurrPage.Editable and (Rec.State = Rec.State::Enabled) then            ShowEnableWarning := EnabledWarningTok;        if EditableByNotEnabled and IsNullGuid(Rec."User ID") then            ShowInitializeUserWarning := InitializeUserWarningTok;        Clear(UserName);        Clear(TelemetryUserId);        if User.Get(Rec."User Id") then begin            UserName := User."User Name";            if UserProperty.Get(User."User Security ID") then                TelemetryUserId := UserProperty."Telemetry User ID"        end;    end;    local procedure DrilldownCode()    begin        if Confirm(DisableEnableQst, true) then begin            Rec.Validate(Rec.State, Rec.State::Disabled);            UpdateControl();            CurrPage.Update();        end;    end;    local procedure InitializeApplicationUser()    begin        Rec.TestField(Description);        if not IsNullGuid(Rec."User ID") then            exit;        Rec.Validate(State, Rec.State::Enabled);        Rec.Validate(State, Rec.State::Disabled);        Rec.Modify();        UpdateControl();        CurrPage.Update();        Message(InitializeUserSuccessTxt);    end;}