Azure Active Directory Management (Read/Write to AAD)

The screenshots and instructions for third-party software are accurate at the time of writing. Third-party vendors may have changed or updated aspects of their systems (such as user interfaces, functionality, and security). As a result, this content may be outdated.

K2 Cloud environments require integration with your Azure Active Directory and, in turn, consent to an app. K2 Cloud uses either the K2 for Office 365 app (for SharePoint Online integration) or the Azure Active Directory for K2 app (if SharePoint Online integration is not planned). Both apps request only read permissions to your AAD, not write. If you need to build solutions that write data to AAD, you must consent the write permission using the Azure Active Directory Management for K2 app. Use this topic to reconfigure your existing AAD service instance and consent to the Azure Active Directory Management for K2 app requested read and write permissions.

  1. Confirm the AADMGMT OAuth resource exists
  2. Rebind the AAD service instance to use the AADMGMT OAuth resource
  3. Consent to the Azure Active Directory Management for K2 app in your AAD tenant

Background

When the AAD service instance is configured against the K2 for Office 365 app, all SmartObject methods are exposed even though the underlying OAuth tokens and app do not expose AAD editing permissions by default. This means that it is possible to build a solution that attempts to use these edit methods, but those calls fail. Below is an example of the error received if you use an AAD-based SmartObject method that attempts to write data. In this example, the Update method of the User SmartObject is called. Notice in the error the message "Insufficient privileges to complete the operation."

With K2 Cloud, the same resource called AADMGMT is automatically configured with your AAD tenant details as well as the parameters necessary to work with the Azure Active Directory Management for K2 app. You can find this resource using the Authentication > OAuth > Resources page in K2 Management.

  1. Find your AAD service instance using the Integration > Service Instances page in K2 Management. It's Service Type is Azure Active Directory.
  2. Select the AAD Service Instance and click “Edit”
  3. In the OAuth Resource Name drop down list, select the resource that begins with AADMGMT and followed by your tenant ID.
  1. After changing the OAuth resource and clicking OK, the following message appears:

    This message appears because you've not consented using the Azure Active Directory Management for K2 app. Click OK to initiate the consent process with AAD. You must do this using an AAD Tenant Admin account and agree to the permissions requested on your tenancy.
  2. Login with AAD Tenant Admin credentials when presented with the AAD login screen
  3. After logging in, click Accept in order to give the Azure Active Directory Management for K2 app Access the directory as the signed-in user and Read and write directory data permissions in your AAD tenancy.
  4. You then see a confirmation that your authorization is successful. If you do not see this message it means that the account you logged in with does not have sufficient privileges to grant the permissions requested.

    You can close this tab and go back to K2 Management and click OK on the service instance configuration.
  5. You can now use AAD SmartObject methods that update or write data to AAD.