Azure Active Directory Management (Read/Write to Azure Active Directory)

Microsoft Azure Active Directory is now Microsoft Entra ID

When you integrate Nintex Automation with SharePoint Online, you must consent permissions to the K2 for Office 365 app. In addition to SharePoint Online permissions, this app also requests read-only permissions to your Azure Active Directory (Azure Active Directory). This permission, along with the SharePoint requested permissions, allows solutions to read data from Azure Active Directory and read and write data to SharePoint Online. If you need to build solutions that write data to Azure Active Directory, you must consent the write permission using the Azure Active Directory Management for K2 app. Use this topic to reconfigure your existing Azure Active Directory service instance and consent to the Azure Active Directory Management for K2 app requested read and write permissions.

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.
  1. Confirm the AADMGMT OAuth resource exists
  2. Rebind the Azure Active Directory service instance to use the AADMGMT OAuth resource
  3. Consent to the Azure Active Directory Management for K2 app in your Azure Active Directory tenant

Background

When the Azure Active Directory 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 Azure Active Directory 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 Azure Active Directory-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."

When you integrate Nintex Automation with SharePoint Online, a resource called AADMGMT is created with your Azure Active Directory 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 Management.

  1. Find your Azure Active Directory service instance using the Integration > Service Instances page in Management. It's Service Type is Azure Active Directory.
  2. Select the Azure Active Directory 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 Azure Active Directory. You must do this using an Azure Active Directory Tenant Admin account and agree to the permissions requested on your tenancy.
  2. Login with Azure Active Directory Tenant Admin credentials when presented with the Azure Active Directory 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 Azure Active Directory 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 Management and click OK on the service instance configuration.
  5. You can now use Azure Active Directory SmartObject methods that update or write data to Azure Active Directory.