Skip to Content

Changes for page Microsoft 365

Last modified by Sabrina V. on 2026/10/06 13:13
From version 8.1
edited by Sabrina V.
on 2026/06/10 06:16
Change comment: There is no comment for this version
To version 11.1
edited by Sabrina V.
on 2026/10/06 13:13
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -2,7 +2,7 @@
2 2  
3 3  = Register preparations for Microsoft Entra ID and enterprise application =
4 4  
5 -To use Microsoft 365, you must first navigate to the Microsoft Entra Admin Centre, register a business application, and grant the necessary permissions within that application. These steps are necessary to allow ACMP to access and import the required Microsoft 365 data. Detailed instructions on how to do this can be found [[here>>doc:ACMP.610.Unternehmensanwendung registrieren in der Microsoft Entra ID.WebHome]], along with all the permissions you will need to grant.
5 +To use Microsoft 365, you must first navigate to the Microsoft Entra Admin Centre, register a business application, and grant the necessary permissions within that application. These steps are necessary to allow acmp to access and import the required Microsoft 365 data. Detailed instructions on how to do this can be found [[here>>doc:ACMP.610.Unternehmensanwendung registrieren in der Microsoft Entra ID.WebHome]], along with all the permissions you will need to grant.
6 6  
7 7  
8 8  = Settings for Microsoft 365 =
... ... @@ -11,15 +11,15 @@
11 11  
12 12  == Managing Micrsoft 365 portals ==
13 13  
14 -To manage the portals, in the open ACMP console, navigate to //System// > //Settings// > //Licence// //Management// > //Microsoft// //365//. The view is split into two parts. On the left, you will see the action fields where you can add ([[image:1731318667592-246.png]]), edit ([[image:1731318667592-758.png]]) or delete ([[image:1731318667592-156.png]]) the Microsoft 365 portals. At the bottom is a list of all the existing portals that you have previously created. On the right, you can see the details of the portal you selected.
14 +To manage the portals, in the open acmp console, navigate to //System// > //Settings// > //Licence// //Management// > //Microsoft// //365//. The view is split into two parts. On the left, you will see the action fields where you can add ([[image:1731318667592-246.png||data-cmp-info="10"]]), edit ([[image:1731318667592-758.png||data-cmp-info="10"]]) or delete ([[image:1731318667592-156.png||data-cmp-info="10"]]) the Microsoft 365 portals. At the bottom is a list of all the existing portals that you have previously created. On the right, you can see the details of the portal you selected.
15 15  
16 -[[Microsoft 365 portals overview>>image:68_M365_Hinzugefügtes Portal_1361.png||alt="67_M365_Hinzugefügtes Portal_1361.png"]]
16 +[[Microsoft 365 portals overview>>image:68_M365_Hinzugefügtes Portal_1361.png||alt="67_M365_Hinzugefügtes Portal_1361.png" data-cmp-info="10"]]
17 17  
18 18  == Add a Microsoft 365 portal ==
19 19  
20 -To add a new portal, click the //Add// button ([[image:1731318849239-880.png]]) in the toolbar. A wizard will open to guide you through the next steps. First, under //General//, enter a name for the portal. Note that the portal name is used as a prefix for the imported licences and products and must be unique. Optionally, you can enter a description if you wish to provide additional information. Otherwise, click //Next >// to proceed.
20 +To add a new portal, click the //Add// button ([[image:1731318849239-880.png||data-cmp-info="10"]]) in the toolbar. A wizard will open to guide you through the next steps. First, under //General//, enter a name for the portal. Note that the portal name is used as a prefix for the imported licences and products and must be unique. Optionally, you can enter a description if you wish to provide additional information. Otherwise, click //Next >// to proceed.
21 21  
22 -[[General information when adding a Microsoft 365 portal>>image:67_M365_Wizard Allgemein_965.png]]
22 +[[General information when adding a Microsoft 365 portal>>image:67_M365_Wizard Allgemein_965.png||data-cmp-info="10"]]
23 23  
24 24  Now enter the Application ID (Client) and Directory ID (Client) in the fields provided. This information refers to the information provided in the Microsoft Entra ID (see Application Properties).
25 25  
... ... @@ -31,9 +31,9 @@
31 31  
32 32  === Certificate ===
33 33  
34 -Select the //Certificate// authentication type and click the //Add// button. A new window will open where you must enter the public and private keys. To do this, click on the button [[image:1731318914156-387.png]] uand insert the appropriate key that you used earlier [[prepare the Microsoft Entra ID>>doc:||anchor="HVorbereitungenfFCrdieMicrosoftEntraID"]] Click //OK// to complete this step.
34 +Select the //Certificate// authentication type and click the //Add// button. A new window will open where you must enter the public and private keys. To do this, click on the button [[image:1731318914156-387.png||data-cmp-info="10"]] uand insert the appropriate key that you used earlier [[prepare the Microsoft Entra ID>>doc:||anchor="HRegisterpreparationsforMicrosoftEntraIDandenterpriseapplication"]] Click //OK// to complete this step.
35 35  
36 -[[Adding a client certificate>>image:67_M365_Client Zertifikat hinzufügen_508.png]]
36 +[[Adding a client certificate>>image:67_M365_Client Zertifikat hinzufügen_508.png||data-cmp-info="10"]]
37 37  
38 38  If you want to delete the certificate, click //Remove//.
39 39  
... ... @@ -41,9 +41,9 @@
41 41  
42 42  To add a secret client key, you have to click on the button of the same name below the selection. A new window will open in which you have to enter the secret ID and the value of the secret client key. You also have to specify a validity period. Exit the step by clicking on //OK //and returning to the wizard.
43 43  
44 -[[Adding the secret client key>>image:67_M365_Geheimen Clientschlüssel hinzufügen_508.png]]
44 +[[Adding the secret client key>>image:67_M365_Geheimen Clientschlüssel hinzufügen_508.png||data-cmp-info="10"]]
45 45  
46 -[[Connection information for the Microsoft 365 portal>>image:67_M365_Microsoft 365 Portal hinzufügen Verbindungsinformationen_965.png]]
46 +[[Connection information for the Microsoft 365 portal>>image:67_M365_Microsoft 365 Portal hinzufügen Verbindungsinformationen_965.png||data-cmp-info="10"]]
47 47  
48 48  Depending on the authentication type you have chosen, the corresponding fields will be filled in. In this explanation, the authentication type //Certificate// was used.
49 49  
... ... @@ -51,20 +51,20 @@
51 51  
52 52  Here you have the option of excluding irrelevant licences from the import. The wizard page is divided into two: On the left side, you will find a list of all available licences. By enabling the checkbox below, you can display only the licences subscribed to in the portal.
53 53  
54 -Now drag all the items you want to exclude for the import to the right side ([[image:1731319034566-617.png]])). The items will be explicitly excluded for the upcoming import. You can remove excluded licences from the list by clicking the button([[image:1731319034566-751.png]]).
54 +Now drag all the items you want to exclude for the import to the right side ([[image:1731319034566-617.png||data-cmp-info="10"]])). The items will be explicitly excluded for the upcoming import. You can remove excluded licences from the list by clicking the button([[image:1731319034566-751.png||data-cmp-info="10"]]).
55 55  
56 -[[Exclusions for the import>>image:67_M365_Ausschlüsse für den Import_965.png]]
56 +[[Exclusions for the import>>image:67_M365_Ausschlüsse für den Import_965.png||data-cmp-info="10"]]
57 57  
58 -Finish the wizard by clicking //Done//. You will return to the overview page within the ACMP settings, where the new portal has been added to the list.
58 +Finish the wizard by clicking //Done//. You will return to the overview page within the acmp settings, where the new portal has been added to the list.
59 59  
60 -[[Added portal in the Microsoft 365 settings>>image:68_M365_Hinzugefügtes Portal_1361.png||alt="67_M365_Hinzugefügtes Portal_1361.png"]]
60 +[[Added portal in the Microsoft 365 settings>>image:68_M365_Hinzugefügtes Portal_1361.png||alt="67_M365_Hinzugefügtes Portal_1361.png" data-cmp-info="10"]]
61 61  
62 62  == Editing or deleting Microsoft 365 portals ==
63 63  
64 -Existing Microsoft 365 portals can be edited or deleted. If you want to edit an existing portal, for example to change the authentication type or the licenses excluded from the import, click the //Edit //button ([[image:1731319340289-250.png]]). A window will open where you can customise the information that is now available. The information is divided into three tabs: //General//, //Connection Information //and //Exclusions for Import//. Change the desired information and then click //Save//.
64 +Existing Microsoft 365 portals can be edited or deleted. If you want to edit an existing portal, for example to change the authentication type or the licenses excluded from the import, click the //Edit //button ([[image:1731319340289-250.png||data-cmp-info="10"]]). A window will open where you can customise the information that is now available. The information is divided into three tabs: //General//, //Connection Information //and //Exclusions for Import//. Change the desired information and then click //Save//.
65 65  
66 66  {{aagon.infobox}}
67 -When making any changes, follow the procedure described in the section [[Adding Microsoft 365 portals>>doc:||anchor="HMicrosoft365PortalhinzufFCgen"]] and note the information provided.
67 +When making any changes, follow the procedure described in the section [[Adding Microsoft 365 portals>>doc:||anchor="HAddaMicrosoft365portal"]] and note the information provided.
68 68  {{/aagon.infobox}}
69 69  
70 70  {{aagon.infobox}}
... ... @@ -71,7 +71,7 @@
71 71  If you subsequently exclude licences from an import, you may have to manually delete licences that have already been imported and the associated product in the licence management.
72 72  {{/aagon.infobox}}
73 73  
74 -To delete a portal, simply click the //Delete //button// //([[image:1731319500514-463.png]]) and confirm the action
74 +To delete a portal, simply click the //Delete //button// //([[image:1731319500514-463.png||data-cmp-info="10"]]) and confirm the action
75 75  
76 76  {{aagon.infobox}}
77 77  After deleting the portal, already imported licenses and products remain. These must be deleted manually in License Management.
... ... @@ -79,7 +79,7 @@
79 79  
80 80  = Licenses, products and compliance =
81 81  
82 -The execution of two [[server tasks>>doc:ACMP.610.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HGeplanteServeraufgaben"]] is required to import licenses and products and to calculate the status:
82 +The execution of two [[server tasks>>doc:ACMP.610.ACMP-Solutions.System.Einstellungen.ACMP Server.WebHome||anchor="HScheduledServerTasks"]] is required to import licenses and products and to calculate the status:
83 83  
84 84  |**Server task**|**Description**
85 85  |1. Import Microsoft 365 licence data|The server task imports the Microsoft 365 licence and product data for License Management and creates the licences and products.
... ... @@ -86,7 +86,7 @@
86 86  |2. Recalculation of the data for the compliance view|The compliance data is recalculated to determine the consumers and the status of the licence.
87 87  
88 88  {{aagon.infobox}}
89 -The execution interval of the Scheduled Server Tasks depends on the configured start condition. You can view the status of the server jobs using the [[Server Monitor>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HServermonitor"]].
89 +The execution interval of the Scheduled Server Tasks depends on the configured start condition. You can view the status of the server jobs using the [[Server Monitor>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HServerMonitor"]].
90 90  {{/aagon.infobox}}
91 91  
92 92  The licences, products and required contacts are created when the data is imported. The compliance recalculation is used to calculate the status.
... ... @@ -101,13 +101,13 @@
101 101  All licence and product data from the portal is read-only and cannot be edited. The Microsoft 365 portal is the leading system and cannot be changed by the administrator.
102 102  {{/aagon.infobox}}
103 103  
104 -[[Read linked product from licence>>image:68_M365_Lizenzen Verknüpfte Produkte_1831.png||alt="67_M365_Lizenzen Verknüpfte Produkte_1831.png"]]
104 +[[Read linked product from licence>>image:68_M365_Lizenzen Verknüpfte Produkte_1831.png||alt="67_M365_Lizenzen Verknüpfte Produkte_1831.png" data-cmp-info="10"]]
105 105  
106 106  == Products ==
107 107  
108 108  Products are created on initial creation in the following output directory //Microsoft 365// > //Portal name// (here: Microsoft 365 Portal). Products can be dragged and dropped into other directories as required. The product name is made up of the portal name (prefix) and the licence title.
109 109  
110 -[[Reading Microsoft 365 portal products>>image:68_M365_Produkte markiert_1280.png||alt="67_M365_Produkte markiert_1280.png"]]
110 +[[Reading Microsoft 365 portal products>>image:68_M365_Produkte markiert_1280.png||alt="67_M365_Produkte markiert_1280.png" data-cmp-info="10"]]
111 111  
112 112  {{aagon.infobox}}
113 113  There is a new automatic consumer (type: Microsoft 365) to correctly identify consumers. This is only used for Microsoft 365 imports and is not available for selection when manually creating a product
... ... @@ -119,33 +119,33 @@
119 119  
120 120  == Status //Producat cannot be synchronised// ==
121 121  
122 -When recalculating compliance, the status of the products and licenses is compared. If, during the import of Microsoft 365 data, it is not possible to update data for a product or license that has already been imported, this is indicated by the new status [[image:1731319766843-853.png]]// Product cannot be synchronised//.
122 +When recalculating compliance, the status of the products and licenses is compared. If, during the import of Microsoft 365 data, it is not possible to update data for a product or license that has already been imported, this is indicated by the new status [[image:1731319766843-853.png||data-cmp-info="10"]]// Product cannot be synchronised//.
123 123  
124 -[[Licence status 'Product cannot be synchronised'>>image:67_M365_Lizenzstatus.png]]
124 +[[Licence status 'Product cannot be synchronised'>>image:67_M365_Lizenzstatus.png||data-cmp-info="10"]]
125 125  
126 126  There can be three reasons for this status:
127 127  
128 128  |**Reason**|**Description**|**Solution**
129 -|The product and/or license no longer exists in the Microsoft 365 portal. |The product and/or license has been deleted from the Microsoft 365 portal, which is why there is no connection between the ACMP Server and the product/license.|The products and/or licenses can be deleted from ACMP. Select the corresponding items and remove them by clicking on //Delete //in the ribbon bar.
129 +|The product and/or license no longer exists in the Microsoft 365 portal. |The product and/or license has been deleted from the Microsoft 365 portal, which is why there is no connection between the acmp Server and the product/license.|The products and/or licenses can be deleted from acmp. Select the corresponding items and remove them by clicking on //Delete //in the ribbon bar.
130 130  |The license was defined retrospectively for the exclusion.|A license was subsequently excluded from import because changes were made to an existing portal.|(((
131 131  If you no longer require the newly added licence exclusion on the portal, you must delete the imported license and the products.
132 132  
133 133  If the newly added exclusion was the result of a misconfiguration when editing the portal, you can edit the portal again and remove the exclusion. The next time the Microsoft 365 import is executed, the data will be updated again automatically. After recalculating compliance, the status will now be displayed correctly.
134 134  )))
135 -|The portal has been deleted.|The complete portal has been deleted from the settings and no longer exists.|If you have deleted the portal in the ACMP settings, you must manually delete the already imported products and licenses from the License Management.
135 +|The portal has been deleted.|The complete portal has been deleted from the settings and no longer exists.|If you have deleted the portal in the acmp settings, you must manually delete the already imported products and licenses from the License Management.
136 136  
137 137  {{aagon.infobox}}
138 -You can find out more about the different statuses of the licenses [[here>>doc:ACMP.610.ACMP-Solutions.Lizenzmanagement.Compliance.WebHome||anchor="HStatusderLizenzen"]].
138 +You can find out more about the different statuses of the licenses [[here>>doc:ACMP.610.ACMP-Solutions.Lizenzmanagement.Compliance.WebHome||anchor="HLicenseStatus"]].
139 139  {{/aagon.infobox}}
140 140  
141 141  = Error messages when accessing the Microsoft 365 GraphAPI =
142 142  
143 -An access token is required to access the Microsoft 365 GraphAPI. This token is generated by the scheduled server task when importing Microsoft 365 data for each configured portal. If there are problems generating the token, this will be displayed as an error message in the log. You can find the corresponding entry in the [[Server Monitor>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HServermonitor"]].
143 +An access token is required to access the Microsoft 365 GraphAPI. This token is generated by the scheduled server task when importing Microsoft 365 data for each configured portal. If there are problems generating the token, this will be displayed as an error message in the log. You can find the corresponding entry in the [[Server Monitor>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HServerMonitor"]].
144 144  
145 145  Generally, there are two basic errors that can occur:
146 146  
147 147  1. An error reported by the GraphAPI was generated by the corresponding web server.
148 -1. An error occurred during the connection from the ACMP Server to the GraphAPI or during the evaluation of the GraphAPI response.
148 +1. An error occurred during the connection from the acmp Server to the GraphAPI or during the evaluation of the GraphAPI response.
149 149  
150 150  The following are some detailed error messages that may appear on your system:
151 151  
... ... @@ -158,7 +158,7 @@
158 158  |(((
159 159  Die GraphAPI meldet einen Fehler und eine Fehlerbeschreibung.
160 160  )))|(((
161 -The ACMP Server could reach the Microsoft GraphAPI and received an error.
161 +The acmp Server could reach the Microsoft GraphAPI and received an error.
162 162  
163 163  The error descriptions come from Microsoft and indicate the type of error reported by the Microsoft GraphAPI.
164 164  )))
... ... @@ -165,23 +165,23 @@
165 165  |(((
166 166  „Could not connect to GraphAPI server.“
167 167  )))|(((
168 -The ACMP Server could not establish a connection to the Microsoft GraphAPI.
168 +The acmp Server could not establish a connection to the Microsoft GraphAPI.
169 169  
170 -**Solution**: Check if you have released the [[necessary URLs>>doc:ACMP.610.ACMP installieren.Checkliste zur Installation.WebHome||anchor="HErforderlicheURLs"]] for your environment.
170 +**Solution**: Check if you have released the [[necessary URLs>>doc:ACMP.610.ACMP installieren.Checkliste zur Installation.WebHome||anchor="HRequiredURLs"]] for your environment.
171 171  )))
172 172  |(((
173 173  „GraphAPI webcall returned success but information could not be deserialized.“
174 174  )))|(((
175 -The ACMP Server was able to establish a connection and the remote station reported a success (HTTP status 200), but the delivered response could not be successfully evaluated. It is possible that the format is different than expected.
175 +The acmp Server was able to establish a connection and the remote station reported a success (HTTP status 200), but the delivered response could not be successfully evaluated. It is possible that the format is different than expected.
176 176  
177 -A possible source of error is when a system retains information in the cache and returns it as a response. For example, check your proxy settings to see if the ACMP Server has stored the correct configurations to resolve the URL. If you have excluded this, please contact our Support.
177 +A possible source of error is when a system retains information in the cache and returns it as a response. For example, check your proxy settings to see if the acmp Server has stored the correct configurations to resolve the URL. If you have excluded this, please contact our Support.
178 178  )))
179 179  |(((
180 180  „GraphAPI webcall returned failure but error information could not be deserialized.“
181 181  )))|(((
182 -The ACMP Server was able to establish a connection successfully, but the remote station reports an error. The response could not be evaluated
182 +The acmp Server was able to establish a connection successfully, but the remote station reports an error. The response could not be evaluated
183 183  
184 -**Solution**: Check if the [[firewall/proxy settings>>doc:ACMP.610.ACMP installieren.Checkliste zur Installation.WebHome||anchor="HErforderlicheURLs"]] are configured correctly or whether you have something else in the network that is intercepting or blocking the communication.. If this has been excluded by you, please contact our Support.
184 +**Solution**: Check if the [[firewall/proxy settings>>doc:ACMP.610.ACMP installieren.Checkliste zur Installation.WebHome||anchor="HRequiredURLs"]] are configured correctly or whether you have something else in the network that is intercepting or blocking the communication.. If this has been excluded by you, please contact our Support.
185 185  )))
186 186  |(((
187 187  „Thumbprint from public key could not be read.“
... ... @@ -188,7 +188,7 @@
188 188  )))|(((
189 189  This error only occurs if you have used the certificate as the authentication method.
190 190  
191 -In this case, the ACMP Server tries to generate a JSON Web Token for the GraphAPI. The fingerprint of the certificate's public key must be noted. An error occurred when reading this value.
191 +In this case, the acmp Server tries to generate a JSON Web Token for the GraphAPI. The fingerprint of the certificate's public key must be noted. An error occurred when reading this value.
192 192  
193 193  **Solution**: When the error occurs, reinstall the certificate.
194 194  )))
... ... @@ -197,7 +197,7 @@
197 197  )))|(((
198 198  This error only occurs if you have used the certificate as the authentication method.
199 199  
200 -The ACMP Server tries to sign a JSON Web Token for the GraphAPI with the certificate's private key. An error occurs.
200 +The acmp Server tries to sign a JSON Web Token for the GraphAPI with the certificate's private key. An error occurs.
201 201  
202 202  **Solution**: This may be an expired certificate. Either create a new certificate or re-import the certificate when the error occurs.
203 203  )))
© Aagon GmbH 2026
Besuchen Sie unsere aagon-Community