Codeunit 9014 Azure AD Graph Impl.

System Application, System.Azure.Identity

src/System Application/App/Azure AD Graph/src/AzureADGraphImpl.Codeunit.al290 lines, Copyright (c) Microsoft Corporation. MIT

// ------------------------------------------------------------------------------------------------// Copyright (c) Microsoft Corporation. All rights reserved.// Licensed under the MIT License. See License.txt in the project root for license information.// ------------------------------------------------------------------------------------------------namespace System.Azure.Identity;using System;using System.Environment;using System.Environment.Configuration;codeunit 9014 "Azure AD Graph Impl."{    Access = Internal;    InherentEntitlements = X;    InherentPermissions = X;    var        EnvironmentInformation: Codeunit "Environment Information";        [NonDebuggable]        GraphQuery: DotNet GraphQuery;        IsGraphInitialized: Boolean;    [NonDebuggable]    procedure GetUser(UserPrincipalName: Text; var UserInfo: DotNet UserInfo)    begin        if CanQueryGraph() then            UserInfo := GraphQuery.GetUser(UserPrincipalName);    end;    [NonDebuggable]    procedure GetCurrentUser(var UserInfo: DotNet UserInfo)    begin        if CanQueryGraph() then            UserInfo := GraphQuery.GetCurrentUser();    end;    [NonDebuggable]    procedure GetUserByAuthorizationEmail(AuthorizationEmail: Text; var UserInfo: DotNet UserInfo)    begin        if CanQueryGraph() then            UserInfo := GraphQuery.GetUserByAuthorizationEmail(AuthorizationEmail);    end;    [NonDebuggable]    procedure GetUserByObjectId(ObjectId: Text; var UserInfo: DotNet UserInfo)    begin        if CanQueryGraph() then            UserInfo := GraphQuery.GetUserByObjectId(ObjectId);    end;    [NonDebuggable]    procedure TryGetUserByObjectId(ObjectId: Text; var UserInfo: DotNet UserInfo): Boolean    begin        if CanQueryGraph() then            exit(GraphQuery.TryGetUserByObjectId(ObjectId, UserInfo));    end;    [NonDebuggable]    procedure GetUserAssignedPlans(UserInfo: DotNet UserInfo; var UserAssignedPlans: DotNet GenericList1)    begin        if IsNull(UserInfo) then            exit;        if CanQueryGraph() then            UserAssignedPlans := GraphQuery.GetUserAssignedPlans(UserInfo);    end;    [NonDebuggable]    procedure GetUserRoles(UserInfo: DotNet UserInfo; var UserRoles: DotNet GenericIEnumerable1)    begin        if IsNull(UserInfo) then            exit;        if CanQueryGraph() then            UserRoles := UserInfo.Roles();    end;    [NonDebuggable]    procedure GetDirectorySubscribedSkus(var DirectorySubscribedSkus: DotNet GenericIEnumerable1)    begin        if CanQueryGraph() then            DirectorySubscribedSkus := GraphQuery.GetDirectorySubscribedSkus();    end;    [NonDebuggable]    procedure GetDirectoryRoles(var DirectoryRoles: DotNet GenericIEnumerable1)    begin        if CanQueryGraph() then            DirectoryRoles := GraphQuery.GetDirectoryRoles();    end;    [NonDebuggable]    procedure GetTenantDetail(var TenantInfo: DotNet TenantInfo)    begin        if CanQueryGraph() then            TenantInfo := GraphQuery.GetTenantDetail();    end;    [NonDebuggable]    procedure IsM365CollaborationEnabled(): Boolean    begin        if CanQueryGraph() then            exit(GraphQuery.IsM365CollaborationEnabled());        exit(false);    end;    [NonDebuggable]    procedure GetEnvironmentSecurityGroupId(): Text    begin        if CanQueryGraph() then            exit(GraphQuery.GetEnvironmentDirectoryGroup());    end;    [NonDebuggable]    procedure GetUsersPage(NumberOfUsers: Integer; var UserInfoPage: DotNet UserInfoPage)    begin        if CanQueryGraph() then            UserInfoPage := GraphQuery.GetUsersPage(NumberOfUsers);    end;    [NonDebuggable]    procedure GetLicensedUsersPage(AssignedPlans: DotNet StringArray; NumberOfUsers: Integer; var UserInfoPage: DotNet UserInfoPage)    begin        if CanQueryGraph() then            UserInfoPage := GraphQuery.GetLicensedUsersPage(AssignedPlans, NumberOfUsers);    end;    [NonDebuggable]    procedure GetGroupMembers(GroupDisplayName: Text; var GroupMembers: DotNet IEnumerable)    begin        // AzureAdGraphQuery will throw an exception if the group does not exist.        // Ignoring this exception, and letting the caller to only check for IsNull(GroupMembers)        if TryGetGroupMembers(GroupDisplayName, GroupMembers) then;    end;    [NonDebuggable]    procedure GetMembersPageForGroupId(GroupId: Text; NumberOfUsers: Integer; var UserInfoPage: DotNet UserInfoPage)    begin        // AzureAdGraphQuery will throw an exception if the group does not exist.        // Ignoring this exception, and letting the caller to only check for IsNull(GroupMembers)        if TryGetMembersPageForGroupId(GroupId, NumberOfUsers, UserInfoPage) then;    end;    [NonDebuggable]    procedure GetMemberIdsPageForGroupId(GroupId: Text; NumberOfUsers: Integer; var UserIdsPage: DotNet UserIdsPage)    begin        // AzureAdGraphQuery will throw an exception if the group does not exist.        // Ignoring this exception, and letting the caller to only check for IsNull(GroupMembers)        if TryGetMemberIdsPageForGroupId(GroupId, NumberOfUsers, UserIdsPage) then;    end;    [NonDebuggable]    [TryFunction]    local procedure TryGetGroupMembers(GroupDisplayName: Text; var GroupMembers: DotNet IEnumerable)    begin        if CanQueryGraph() then            GroupMembers := GraphQuery.GetGroupMembers(GroupDisplayName);    end;    [NonDebuggable]    [TryFunction]    local procedure TryGetMembersPageForGroupId(GroupId: Text; NumberOfUsers: Integer; var UserInfoPage: DotNet UserInfoPage)    begin        if CanQueryGraph() then            UserInfoPage := GraphQuery.GetMembersPageForGroupId(GroupId, NumberOfUsers);    end;    [NonDebuggable]    [TryFunction]    local procedure TryGetMemberIdsPageForGroupId(GroupId: Text; NumberOfUsers: Integer; var UserIdsPage: DotNet UserIdsPage)    begin        if CanQueryGraph() then            UserIdsPage := GraphQuery.GetMemberIdsPageForGroupId(GroupId, NumberOfUsers);    end;    [NonDebuggable]    procedure IsGroupMember(GroupDisplayName: Text; GraphUserInfo: DotNet UserInfo): Boolean    var        GroupInfo: DotNet GroupInfo;    begin        if IsNull(GraphUserInfo) then            exit(false);        if IsNull(GraphUserInfo.Groups()) then            exit(false);        foreach GroupInfo in GraphUserInfo.Groups() do            if not IsNull(GroupInfo.DisplayName()) then                if GroupInfo.DisplayName().ToUpper() = UpperCase(GroupDisplayName) then                    exit(true);        exit(false);    end;    [NonDebuggable]    procedure IsMemberOfGroupWithId(GroupId: Text; GraphUserInfo: DotNet UserInfo): Boolean    begin        if IsNull(GraphUserInfo) then            exit(false);        if CanQueryGraph() then            exit(GraphQuery.IsGroupMember(GraphUserInfo.ObjectId, GroupId));    end;    [NonDebuggable]    procedure GetGroupName(GroupId: Text): Text    begin        if CanQueryGraph() then            exit(GraphQuery.GetGroupInfo(GroupId).DisplayName());    end;    [NonDebuggable]    procedure GetFirstGroupIdWithName(GroupName: Text): Text    begin        if CanQueryGraph() then            exit(GraphQuery.FindFirstGroupInfoForDisplayName(GroupName).ObjectId());    end;    [NonDebuggable]    procedure GetGroups(): Dictionary of [Text, Text];    var        GroupInfoPage: DotNet GroupInfoPage;        GroupInfo: DotNet GroupInfo;        Groups: Dictionary of [Text, Text];        NumberOfGroupsPerPage: Integer;    begin        if not CanQueryGraph() then            exit;        NumberOfGroupsPerPage := 500;        GroupInfoPage := GraphQuery.GetGroupPage(NumberOfGroupsPerPage);        if IsNull(GroupInfoPage) then            exit;        repeat            foreach GroupInfo in GroupInfoPage.CurrentPage() do                Groups.Add(GroupInfo.ObjectId, GroupInfo.DisplayName);        until (not GroupInfoPage.GetNextPage());        exit(Groups);    end;    [NonDebuggable]    [TryFunction]    procedure IsGraphUserAccountEnabled(UserPrincipalName: Text; var IsEnabled: Boolean)    var        UserInfo: DotNet UserInfo;    begin        GetUser(UserPrincipalName, UserInfo);        IsEnabled := UserInfo.AccountEnabled();    end;    [NonDebuggable]    local procedure CanQueryGraph(): Boolean    begin        if not IsGraphInitialized then            Initialize();        exit(IsGraphInitialized);    end;    [NonDebuggable]    local procedure Initialize(): Boolean    var        ServerSetting: Codeunit "Server Setting";        Handled: Boolean;    begin        if not (EnvironmentInformation.IsSaaS() or ServerSetting.GetEnableEntraGroupsOnPrem()) then            exit(false);        if IsGraphInitialized then            exit(true);        OnInitialize(GraphQuery, Handled);        if not Handled then            GraphQuery := GraphQuery.GraphQuery();        IsGraphInitialized := not IsNull(GraphQuery);        exit(IsGraphInitialized);    end;    [InternalEvent(false)]    [NonDebuggable]    local procedure OnInitialize(var GraphQuery: DotNet GraphQuery; var Handled: Boolean)    begin    end;}