Skip to content

Commit

Permalink
Merge pull request #1079 from OfficeDev/v-mfurquan/AAD-Entra-Readme-U…
Browse files Browse the repository at this point in the history
…pdates-2

Second PR For Readme Updates from AAD To Microsoft Entra ID
  • Loading branch information
Pawank-MSFT authored Jan 11, 2024
2 parents 00b22e6 + 0330af6 commit 4547630
Show file tree
Hide file tree
Showing 81 changed files with 133 additions and 133 deletions.
6 changes: 3 additions & 3 deletions samples/app-auth/nodejs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -143,7 +143,7 @@ Registering a bot with the Microsoft Bot Framework automatically creates a corre
- **WebApplicationInfo** - The parent of the following elements.
- **Id** - The client ID of the application. This is an application ID that you obtain as part of registering the application with Azure AD 1.0 endpoint.
- **Resource** - The domain and subdomain of your application. This is the same URI (including the `api://` protocol) that you used when registering the app in AAD. The domain part of this URI should match the domain, including any subdomains, used in the URLs in the section of your Teams application manifest.
- **Resource** - The domain and subdomain of your application. This is the same URI (including the `api://` protocol) that you used when registering the app in Microsoft Entra ID. The domain part of this URI should match the domain, including any subdomains, used in the URLs in the section of your Teams application manifest.
```json
"webApplicationInfo": {
Expand All @@ -165,7 +165,7 @@ Registering a bot with the Microsoft Bot Framework automatically creates a corre
```
Notes:
- The resource for an AAD app will usually just be the root of its site URL and the appID (e.g. api://subdomain.example.com/6789/c6c1f32b-5e55-4997-881a-753cc1d563b7). We also use this value to ensure your request is coming from the same domain. Therefore make sure that your contentURL for your tab uses the same domains as your resource property.
- The resource for an Microsoft Entra ID app will usually just be the root of its site URL and the appID (e.g. api://subdomain.example.com/6789/c6c1f32b-5e55-4997-881a-753cc1d563b7). We also use this value to ensure your request is coming from the same domain. Therefore make sure that your contentURL for your tab uses the same domains as your resource property.
- You need to be using manifest version 1.5 or higher for these fields to be used.
- Scopes aren’t supported in the manifest and instead should be specified in the API Permissions section in the Azure portal
- If you are facing any issue in your app, please uncomment [this](https://github.com/OfficeDev/Microsoft-Teams-Samples/blob/main/samples/app-auth/nodejs/src/AuthBot.ts#L119) line and put your debugger for local debug.
Expand Down Expand Up @@ -219,7 +219,7 @@ Bot authentication
![Bot SSO](Images/login-card.png)
![Bot AAD login](Images/sso-bot.png)
![Bot Microsoft Entra ID login](Images/sso-bot.png)
## Outlook on the web
Expand Down
4 changes: 2 additions & 2 deletions samples/app-checkin-location/csharp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Please find below demo manifest which is deployed on Microsoft Azure and you can
## Setup

1) Setup for Bot
- Register a AAD aap registration in Azure portal.
- Register a Microsoft Entra ID aap registration in Azure portal.
- Also, register a bot with Azure Bot Service, following the instructions [here](https://docs.microsoft.com/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-3.0).
- Ensure that you've [enabled the Teams Channel](https://docs.microsoft.com/azure/bot-service/channel-connect-teams?view=azure-bot-service-4.0)
- While registering the bot, use `https://<your_tunnel_domain>/api/messages` as the messaging endpoint.
Expand Down Expand Up @@ -77,7 +77,7 @@ Please find below demo manifest which is deployed on Microsoft Azure and you can
```
- Modify the `/appsettings.json` and fill in the following details:
- `{{Microsoft-App-Id}}` - Generated from Step 1 while doing AAd app registration in Azure portal.
- `{{Microsoft-App-Id}}` - Generated from Step 1 while doing Microsoft Entra ID app registration in Azure portal.
- `{{ Microsoft-App-Password}}` - Generated from Step 1, also referred to as Client secret
- `{{ Application Base Url }}` - Your application's base url. E.g. https://12345.ngrok-free.app if you are using ngrok and if you are using dev tunnels, your URL will be https://12345.devtunnels.ms.

Expand Down
6 changes: 3 additions & 3 deletions samples/app-sso/csharp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ This bot has been created using [Bot Framework](https://dev.botframework.com), i

The focus of this sample is how to use the Bot Framework support for oauth in your bot. Teams behaves slightly differently than other channels in this regard. Specifically an Invoke Activity is sent to the bot rather than the Event Activity used by other channels. _This Invoke Activity must be forwarded to the dialog if the OAuthPrompt is being used._ This is done by subclassing the ActivityHandler and this sample includes a reusable TeamsActivityHandler. This class is a candidate for future inclusion in the Bot Framework SDK.

The sample uses the bot authentication capabilities in [Azure Bot Service](https://docs.botframework.com), providing features to make it easier to develop a bot that authenticates users to various identity providers such as Azure AD (Azure Active Directory), GitHub, Uber, etc. The OAuth token is then used to make basic Microsoft Graph queries. Refer the **SSO** setup [documentation](https://docs.microsoft.com/microsoftteams/platform/bots/how-to/authentication/add-authentication?tabs=dotnet%2Cdotnet-sample).
The sample uses the bot authentication capabilities in [Azure Bot Service](https://docs.botframework.com), providing features to make it easier to develop a bot that authenticates users to various identity providers such as Microsoft Entra ID, GitHub, Uber, etc. The OAuth token is then used to make basic Microsoft Graph queries. Refer the **SSO** setup [documentation](https://docs.microsoft.com/microsoftteams/platform/bots/how-to/authentication/add-authentication?tabs=dotnet%2Cdotnet-sample).

> IMPORTANT: The manifest file in this app adds "token.botframework.com" to the list of `validDomains`. This must be included in any bot that uses the Bot Framework OAuth flow.
Expand Down Expand Up @@ -124,7 +124,7 @@ Refer to [Bot SSO Setup document](https://github.com/OfficeDev/Microsoft-Teams-S

### 4. Register your Teams Auth SSO with Azure AD

1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
2. Select **New Registration** and on the *register an application page*, set following values:
* Set **name** to your app name.
* Choose the **supported account types** (any account type will work)
Expand Down Expand Up @@ -195,7 +195,7 @@ Refer to [Bot SSO Setup document](https://github.com/OfficeDev/Microsoft-Teams-S
## Running the sample
You can interact with this bot by sending it a message. The bot will respond by requesting you to login to AAD, then making a call to the Graph API on your behalf and returning the results.
You can interact with this bot by sending it a message. The bot will respond by requesting you to login to Microsoft Entra ID, then making a call to the Graph API on your behalf and returning the results.
**Install App:**
Expand Down
4 changes: 2 additions & 2 deletions samples/app-sso/nodejs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ This bot has been created using [Bot Framework](https://dev.botframework.com), i

The focus of this sample is how to use the Bot Framework support for oauth in your bot. Teams behaves slightly differently than other channels in this regard. Specifically an Invoke Activity is sent to the bot rather than the Event Activity used by other channels. _This Invoke Activity must be forwarded to the dialog if the OAuthPrompt is being used._ This is done by subclassing the ActivityHandler and this sample includes a reusable TeamsActivityHandler. This class is a candidate for future inclusion in the Bot Framework SDK.

The sample uses the bot authentication capabilities in [Azure Bot Service](https://docs.botframework.com), providing features to make it easier to develop a bot that authenticates users to various identity providers such as Azure AD (Microsoft Entra ID), GitHub, Uber, etc. The OAuth token is then used to make basic Microsoft Graph queries. Refer the **SSO** setup [documentation](https://docs.microsoft.com/microsoftteams/platform/bots/how-to/authentication/add-authentication?tabs=node-js%2Cnode-js-dialog-sample).
The sample uses the bot authentication capabilities in [Azure Bot Service](https://docs.botframework.com), providing features to make it easier to develop a bot that authenticates users to various identity providers such as Microsoft Entra ID, GitHub, Uber, etc. The OAuth token is then used to make basic Microsoft Graph queries. Refer the **SSO** setup [documentation](https://docs.microsoft.com/microsoftteams/platform/bots/how-to/authentication/add-authentication?tabs=node-js%2Cnode-js-dialog-sample).

> IMPORTANT: The manifest file in this app adds "token.botframework.com" to the list of `validDomains`. This must be included in any bot that uses the Bot Framework OAuth flow.
Expand Down Expand Up @@ -196,7 +196,7 @@ Refer to [Bot SSO Setup document](https://github.com/OfficeDev/Microsoft-Teams-S
## Running the sample
You can interact with this bot by sending it a message. The bot will respond by requesting you to login to AAD, then making a call to the Graph API on your behalf and returning the results.
You can interact with this bot by sending it a message. The bot will respond by requesting you to login to Microsoft Entra ID, then making a call to the Graph API on your behalf and returning the results.
**Install App:**
Expand Down
2 changes: 1 addition & 1 deletion samples/bot-archive-groupchat-messages/csharp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ This feature shown in this sample is currently available in Public Developer Pre
- Complete the form as follows:
- **Name:** Enter a name for the connection. You'll use this name in your bot in the appsettings.json file. For example BotTeamsAuthADv1.
- **Service Provider:** Select Azure Active Directory v2. Once you select this, the Azure AD-specific fields will be displayed.
- **Service Provider:** Select Azure Active Directory V2. Once you select this, the Azure AD-specific fields will be displayed.
- **Client id:** Enter the Application (client) ID .
- **Client secret:** Enter the Application (client) secret.
- Provide **Scopes** like "User.Read Chat.ReadWrite ChatMessage.Read"
Expand Down
2 changes: 1 addition & 1 deletion samples/bot-archive-groupchat-messages/nodejs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ The simplest way to run this sample in Teams is to use Teams Toolkit for Visual

a. **Name:** Enter a name for the connection. You'll use this name in your bot in the appsettings.json file. For example BotTeamsAuthADv1.

b. **Service Provider:** Select Azure Active Directory v2. Once you select this, the Azure AD-specific fields will be displayed.
b. **Service Provider:** Select Azure Active Directory V2. Once you select this, the Azure AD-specific fields will be displayed.

c. **Client id:** Enter the Application (client) ID .

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ This bot has been created using [Bot Framework](https://dev.botframework.com), i

The focus of this sample is how to use the Bot Framework support for OAuth SSO in your bot. Teams behaves slightly differently than other channels in this regard. Specifically an Invoke Activity is sent to the bot rather than the Event Activity used by other channels. _This Invoke Activity must be forwarded to the dialog if the OAuthPrompt is being used._ This is done by subclassing the ActivityHandler and this sample includes a reusable TeamsActivityHandler. This class is a candidate for future inclusion in the Bot Framework SDK.

The sample uses the bot authentication capabilities in [Azure Bot Service](https://docs.botframework.com), providing features to make it easier to develop a bot that authenticates users to various identity providers such as Azure AD (Microsoft Entra ID), GitHub, Uber, etc. The OAuth token is then used to make basic Microsoft Graph queries.
The sample uses the bot authentication capabilities in [Azure Bot Service](https://docs.botframework.com), providing features to make it easier to develop a bot that authenticates users to various identity providers such as Microsoft Entra ID, GitHub, Uber, etc. The OAuth token is then used to make basic Microsoft Graph queries.

> IMPORTANT: The manifest file in this app adds "token.botframework.com" to the list of `validDomains`. This must be included in any bot that uses the Bot Framework OAuth flow.
Expand Down
2 changes: 1 addition & 1 deletion samples/graph-activity-feed-broadcast/csharp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ This sample shows a feature where user can broadcast a message to all members of

- Register your Teams Auth SSO with Azure AD

1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
2. Select **New Registration** and on the *register an application page*, set following values:
* Set **name** to your app name.
* Choose the **supported account types** (any account type will work)
Expand Down
2 changes: 1 addition & 1 deletion samples/graph-activity-feed-broadcast/nodejs/Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ The simplest way to run this sample in Teams is to use Teams Toolkit for Visual

### 1. Setup for App Registration

1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
2. Select **New Registration** and on the *register an application page*, set following values:
* Set **name** to your app name.
* Choose the **supported account types** (any account type will work)
Expand Down
10 changes: 5 additions & 5 deletions samples/graph-activity-feed/csharp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,11 +42,11 @@ This sample has been created using [Microsoft Graph](https://docs.microsoft.com/

## Setup

1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.

### Register your Teams Auth SSO with Azure AD

- Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
- Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
Select **New Registration** and on the *register an application page*, set following values:
* Set **name** to your app name.
* Choose the **supported account types** (any account type will work)
Expand Down Expand Up @@ -98,7 +98,7 @@ This sample has been created using [Microsoft Graph](https://docs.microsoft.com/
- Navigate to the **Certificates & secrets**. In the Client secrets section, click on "+ New client secret". Add a description (Name of the secret) for the secret and select “Never” for Expires. Click "Add". Once the client secret is created, copy its value, it need to be placed in the appsettings.json.

2. Setup for Bot
- Register a AAD aap registration in Azure portal.
- Register a Microsoft Entra ID aap registration in Azure portal.
- Also, register a bot with Azure Bot Service, following the instructions [here](https://docs.microsoft.com/en-us/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-3.0).
- Ensure that you've [enabled the Teams Channel](https://docs.microsoft.com/en-us/azure/bot-service/channel-connect-teams?view=azure-bot-service-4.0)
Expand Down Expand Up @@ -126,8 +126,8 @@ This sample has been created using [Microsoft Graph](https://docs.microsoft.com/
```
- Modify the `/appsettings.json` and fill in the following details:
- `{{MicrosoftAppId}}` - Generated from Step 1 while doing AAd app registration in Azure portal.
- `{{TenantId}}` - Generated from Step 1 while doing AAd app registration in Azure portal Directory (tenant) ID.
- `{{MicrosoftAppId}}` - Generated from Step 1 while doing Microsoft Entra ID app registration in Azure portal.
- `{{TenantId}}` - Generated from Step 1 while doing Microsoft Entra ID app registration in Azure portal Directory (tenant) ID.
- `{{ MicrosoftAppPassword}}` - Generated from Step 1, also referred to as Client secret
- `{{ ApplicationIdURI }}` - Your application's ApplicationIdURI ex: `api://%ngrokDomain%.ngrok-free.app/00000000-0000-0000-0000-000000000000`..

Expand Down
2 changes: 1 addition & 1 deletion samples/graph-activity-feed/nodejs/Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ The simplest way to run this sample in Teams is to use Teams Toolkit for Visual

### 1. Setup for App Registration

1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
2. Select **New Registration** and on the *register an application page*, set following values:
* Set **name** to your app name.
* Choose the **supported account types** (any account type will work)
Expand Down
6 changes: 3 additions & 3 deletions samples/graph-app-installation-lifecycle/csharp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,13 +44,13 @@ Please find below demo manifest which is deployed on Microsoft Azure and you can

## Setup

1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.

- You need to add following permissions mentioned in the below screenshots to call respective Graph API
![](https://user-images.githubusercontent.com/50989436/116188975-e155a300-a745-11eb-9ce5-7f467007e243.png)

2. Setup for Bot
- Register a AAD aap registration in Azure portal.
- Register a Microsoft Entra ID aap registration in Azure portal.
- Also, register a bot with Azure Bot Service, following the instructions [here](https://docs.microsoft.com/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-3.0).
- Ensure that you've [enabled the Teams Channel](https://docs.microsoft.com/azure/bot-service/channel-connect-teams?view=azure-bot-service-4.0)
- While registering the bot, use `https://<your_tunnel_domain>/api/messages` as the messaging endpoint.
Expand Down Expand Up @@ -79,7 +79,7 @@ Please find below demo manifest which is deployed on Microsoft Azure and you can
```
- Modify the `/appsettings.json` and fill in the following details:
- `{{Your Microsoft App Id}}` - Generated from Step 1 while doing AAd app registration in Azure portal.
- `{{Your Microsoft App Id}}` - Generated from Step 1 while doing Microsoft Entra ID app registration in Azure portal.
- `{{ Your Microsoft App Password }}` - Generated from Step 1, also referred to as Client secret
Expand Down
2 changes: 1 addition & 1 deletion samples/graph-app-installation-lifecycle/nodejs/Readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ The simplest way to run this sample in Teams is to use Teams Toolkit for Visual
> If you do not have permission to upload custom apps (sideloading), Teams Toolkit will recommend creating and using a Microsoft 365 Developer Program account - a free program to get your own dev environment sandbox that includes Teams.
## Setup
1. Register a new application in the [Azure Active Directory – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.
1. Register a new application in the [Microsoft Entra ID – App Registrations](https://go.microsoft.com/fwlink/?linkid=2083908) portal.

- Your app must be registered in the Azure AD portal to integrate with the Microsoft identity platform and call Microsoft Graph APIs. See [Register an application with the Microsoft identity platform](https://docs.microsoft.com/graph/auth-register-app-v2).
- You need to add following permissions mentioned in the below screenshots to call respective Graph API
Expand Down
Loading

0 comments on commit 4547630

Please sign in to comment.