Applications for integrating with third-party technologies

K2 provides different apps which allow K2 to integrate with certain technologies. For example, if you need to integrate your K2 environment with Azure Active Directory (AAD), you may need to add one or more apps to your Azure environment to allow K2 to integrate with that environment.

You can use the following diagram to understand what apps are installed in certain scenarios in a K2 environment.


*Also installs K2 for Office 365

Below is a list of the applications that are used to integrate with Azure Active Directory (AAD), SharePoint Online, and Exchange Online. You may not need or see many of these apps, but they are listed here for visibility and to understand how K2 integration works.

Below is a list of required and optional applications when provisioning a K2 Five with SharePoint Online environment .

K2 application details

Microsoft is deprecating Azure AD Graph API and as of June 30th, 2020, stopped adding new features to the API. They strongly recommend upgrading to Microsoft Graph API to access Azure AD APIs as well as APIs from other Microsoft services. Since permissions required for Azure AD Graph API differ from those for Microsoft Graph API, you will be consenting to similar permissions scopes for backward and future compatibility. The tables below list both sets of permissions for the relevant K2 applications.
  • Required when integrating with SharePoint Online.

    If this app is used, then the Azure Active Directory for K2 app is not required.
  • Provides integration with AAD and SharePoint, such as AAD Identity Caching, reading AAD user information, and reading and writing to SharePoint Online. If used in K2 Five, consent is granted during the provisioning process.
Permission Display string Description Tenant Admin consent required
Microsoft Graph permissions
Directory.Read.All (Application) Read directory data Allows the app to read data in your organization's directory, such as users, groups, and apps, without a signed-in user. Yes
Diretory.Read.All (Delegated) Read directory data Allows the app to read data in your organization's directory, such as users, groups, and apps. Note: Users may consent to applications that require this permission if the application is registered in their own organization’s tenant. Yes
User.Read (Delegated) Sign-in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
Azure AD Graph permissions
Directory.Read.All (Application) Read directory data Read directory data* Yes
Diretory.Read.All (Delegated) Read directory data Read directory data* Yes
User.Read (Delegated) Sign in and read user profile Sign in and read user profile No
Permission for SharePoint Online
  • Read and write user profiles*
  • Read and write managed metadata*
  • Have full control of all site collections*
 Yes

* Requires Tenant/Global administrator credentials

  • Required when integrating with Azure Active Directory but not SharePoint Online.

    If this app is used, then the K2 for Office 365 app is not required.
  • Provides integration with Azure Active Directory, such as reading and caching AAD user information.

    If used in K2 Five, consent is granted during the provisioning process.
Permission Display string Description Tenant Admin consent required
Microsoft Graph permissions
Directory.Read.All (Application) Read directory data Allows the app to read data in your organization's directory, such as users, groups, and apps, without a signed-in user. Yes
Diretory.Read.All (Delegated) Read directory data Allows the app to read data in your organization's directory, such as users, groups, and apps. Note: Users may consent to applications that require this permission if the application is registered in their own organization’s tenant. Yes
User.Read (Delegated) Sign-in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
Azure AD Graph permissions
Directory.Read.All (Application) Read directory data Read directory data* Yes
Diretory.Read.All (Delegated) Read directory data Read directory data* Yes
User.Read (Delegated) Sign in and read user profile Sign in and read user profile No

* Requires Tenant/Global administrator credentials

  • Optional.
  • Provides authentication against AAD when using the SmartObject OData API for consumption of SmartObject data within third-party clients such as Excel, Power BI, and Tableau.
  • Authenticates (Undefined variable: K2Variables.OnPremProductName) users when using Remote Package and Deployment (P&D) to migrate solutions from one environment to another.
Permission Display string Description Tenant Admin consent required
Microsoft Graph permissions
Directory.AccessAsUser.All (Delegated) Access directory as the signed-in user Allows the app to have the same access to information in the directory as the signed-in user. Yes
Diretory.Read.All (Delegated) Read directory data Allows the app to read data in your organization's directory, such as users, groups, and apps. Note: Users may consent to applications that require this permission if the application is registered in their own organization’s tenant. Yes
User.Read (Delegated) Sign-in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
Azure AD Graph permissions
Directory.Read.All (Application) Read directory data Access the directory as the signed-in user* Yes
Diretory.Read.All (Delegated) Read directory data Read directory data* Yes
User.Read (Delegated) Sign in and read user profile

Sign in and read user profile

 No

* Requires Tenant/Global administrator credentials

For information on how to consent to the Azure Active Directory Management for K2 app and to update your broker to use a different OAuth resource, see Azure Active Directory Management (Read/Write to AAD).
Permission Display string Description Tenant Admin consent required
Microsoft Graph permissions
Diretory.ReadWrite.All (Delegated) Read and write directory data Allows the app to read and write data in your organization's directory, such as users, and groups. It does not allow the app to delete users or groups or reset user passwords. Yes
Directory.ReadWrite.All (Application) Read and write directory data Allows the app to read and write data in your organization's directory, such as users, and groups, without a signed-in user. Does not allow user or group deletion. Yes
Directory.AccessAsUser.All (Delegated) Access directory as the signed-in user Allows the app to have the same access to information in the directory as the signed-in user. Yes
Azure AD Graph permissions
Directory.ReadWrite.All (Application) Read directory data Read and write directory data* Yes
Diretory.ReadWrite.All (Delegated) Read directory data Read and write directory data* Yes
Directory.AccessAsUser.All (Delegated) Sign in and read user profile

Access the directory as the signed-in user*

 Yes

* Requires Tenant/Global administrator credentials

  • Optional.
  • Provides AAD authentication for K2 Mobile apps.
Permission Display string Description Tenant Admin consent required
Microsoft Graph permissions
User.Read (Delegated) Sign in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
User.ReadBasic.All (Delegated)

Read all users' basic profiles

 Allows the app to read a basic set of profile properties of other users in your organization on behalf of the signed-in user. This includes display name, first and last name, email address, open extensions, and photo. Also allows the app to read the full profile of the signed-in user. No
Azure AD Graph permissions
User.Read (Delegated) Sign in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
User.ReadBasic.All (Delegated)

Read all users' basic profiles

 Allows the app to read a basic set of profile properties of other users in your organization on behalf of the signed-in user. This includes display name, first and last name, email address, open extensions, and photo. Also allows the app to read the full profile of the signed-in user. No
  • Optional.
  • Required for Exchange feature to be activated and gives K2 the ability to integrate with Exchange Online functionality.
  • Full access rights to all mailboxes
  • Access mailboxes as the signed-in user via Exchange Web Services
This app is not required for SmartActions or for the K2 server to send email.
Permission Display string Description Tenant Admin consent required
Microsoft Graph permissions
User.Read (Delegated) Sign in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
Azure AD Graph permissions
User.Read (Delegated) Sign in and read user profile Allows users to sign-in to the app and allows the app to read the profile of signed-in users. It also allows the app to read basic company information of signed-in users. No
Name of Application Details Permissions Requested Needs Tenant Admin to consent?
K2 Five for SharePoint Required when integrating with SharePoint.

This app is included in the (Undefined variable: K2Variables.OnPremProductName) installer as part of the AppDeployment.exe utility.
This app is available from the Office Store, but should be installed from the extracted product installer folder.
If you're using AAD, then either the Azure Active Directory for K2 or the K2 for Office 365 app is also required.		 Not applicable, this app requires K2 for Office 365 if you use AAD identities N/A

K2 Five for SharePoint Application and Delegation Scope Requests

Below is a list of application scope requests and delegation scope requests when onboarding with K2 Five for SharePoint against a SharePoint online environment. For more information about the permission scopes in Microsoft Office 365, see Microsoft Graph Permission Reference.

SharePoint scopes only apply within site collections where the K2 Five for SharePoint app has been added.
App Scope Request Type Notes
K2 for Office 365 Read directory data (Directory.Read.All) Application Required: Allow the application to read data in your organization’s directory, such as users and groups.
K2 Five for SharePoint Have full control of all site collections (Sites.FullControl.All) Application Required: Allows the application to have full control of all site collections without a signed in user.
Read and write user profiles (User.ReadWrite.All) Application Required: Allows the application to read and update user profiles and to read basic site info without a signed in user.
Have full control of all site collections (AllSites.FullControl) Delegation (on behalf of) Required: Allows the application to have full control of all site collections on behalf of the signed-in user. SharePoint honors security so if a user does not have permissions to create, edit, delete, or access a SharePoint site, they cannot do that through K2.
Read and write user profiles (User.ReadWrite.All) Delegation (on behalf of) Required: Allows the application to read and update user profiles and to read basic site info on behalf of the signed-in user. This permission is not used.
Read and write items in all site collections(AllSites.Write) Delegation (on behalf of) Required: Allows the application to create, read, update, and delete documents and list items in all site collections without a signed in user. This permission is legacy and not used.
Read and write managed metadata (TermStore.ReadWrite.All) Delegation (on behalf of) Required: Allows the application to read, create, update, and delete managed metadata and to read basic site info on behalf of the signed-in user. The write permission is not used.

K2 Five for AAD Application and Delegation Scope Requests

Below is a list of application scope requests and delegation scope requests when onboarding K2 Five with AAD.

App Scope Request Type Notes
Azure Active Directory for K2 (non-SharePoint scenarios) Read directory data (Directory.Read.All) Application Required: Allow the application to read data in your organization’s directory, such as users and groups.
Azure Active Directory for K2 Enable sign-on and read users’ profiles (User.Read) Delegation (on behalf of) Required: Allow users to sign into the application with their organizational accounts and let the application read the profiles of signed-in users, such as their email address and contact information.
Access your organization’s directory (Directory.AccessAsUser.All) Delegation (on behalf of) Required: Allow the application to access your organization’s directory on behalf of the signed-in user. This permission is legacy and not used.
Azure Active Directory Management for K2 Write directory data (Directory.Write.All) Application Optional: Allows the application to read and write data in your organization's directory. Necessary if you use the AAD user and group management wizards and/or SmartObjects. For more information and configuration information, see Azure Active Directory Management (Read/Write to AAD)Account Management