In Microsoft Teams, create an application so that you can connect to Microsoft Teams from
within Cognos®
Analytics.
Procedure
- 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).
-
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.
-
In the Azure portal, select Azure Active Directory in the left pane,
select App registrations, and click New
registration.
-
In the Register an application page, enter your application's
registration information:
- In the Name section, enter a meaningful application name that
will be displayed to the users.
- Select Accounts in any organizational directory in the
Supported account types section.
- 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
- Click Register to create the application.
-
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.
-
Click the Manifest tab.
- In the Manifest Editor, set the allowPublicClient* property to
true, and then click Save.
- Click the API permissions tab.
- 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 |
- Search for and choose Dataverse in the APIs my
organization uses tab. If Dataverse is not found, search for
Common Data Service.
- Click Delegated permissions, check the options, and then click
Add permissions.
- Go to Certificates & secrets and click New client
secret to create an application secret key.