Creating a Microsoft Teams application

In Microsoft Teams, create an application so that you can connect to Microsoft Teams from within Cognos® Analytics.

Before you begin

Your company must be using the Microsoft 365 developer program with an E5 subscription (https://developer.microsoft.com/en-us/microsoft-365/dev-program).
Note: An E5 subscription is required because Cognos Analytics requires access to Graph API.

Procedure

  1. Create an Azure service named Azure Active Directory.
    For more information, see Manage Azure Active Directory (https://portal.azure.com/?quickstart=True#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/Overview).
  2. Sign in to the Azure portal using an account with administrator permission.
    Note: You must use an account in the same Microsoft 365 subscription (tenant) as the one in which you are registering the MS Teams application. You can also access the Azure portal through the Microsoft 365 Admin center by expanding the Admin center item in the left navigation pane and selecting Azure Active Directory.
  3. In the Azure portal, select Azure Active Directory in the left pane, select App registrations, and click New registration.
  4. In the Register an application page, enter your application's registration information:
    1. In the Name section, enter a meaningful application name that will be displayed to the users.
    2. Select Accounts in any organizational directory in the Supported account types section.
    3. In the Redirect URI field, type the following:

      https://host_name:port_number/bi/v1/collaboration/auth/msteams

      or

      https://web_server_name:443/virtual_directory/bi/v1/collaboration/auth/msteams
    4. Click Register to create the application.
  5. On the app Overview page, hover over the Application (client) ID value and click the Copy to clipboard icon to copy the value.
    Note: You will need to specify this value in your application's authentication code or app.config file, where appropriate.
  6. Click the Manifest tab.
  7. In the Manifest Editor, set the allowPublicClient* property to true, and then click Save.
  8. Click the API permissions tab.
  9. Click Add a permission, and then set permissions according to the following table:
    Note: The permissions in the table must be granted by the administrator.
    Permission name Description Admin consent request
    user.read.all Read all users' full profiles Yes
    directory.read.all Read directory data Yes
    channelMessage.send Send channel messages No
    channelSettings.read.all Read the names, descriptions, and settings of channels Yes
    group.read.all Read all groups Yes
    groupMember.read.all Read group memberships Yes
    chat.readBasic Read names and members of user chat threads No
    chatMember.read Read the members of chats Yes
    chatMessage.Send Send user chat messages No
    chat.create Create a chat with single or multi No
  10. Search for and choose Dataverse in the APIs my organization uses tab. If Dataverse is not found, search for Common Data Service.
  11. Click Delegated permissions, check the options, and then click Add permissions.
  12. Go to Certificates & secrets and click New client secret to create an application secret key.

What to do next

You are now ready to Adding a collaboration platform in Cognos Analytics.