Skip to content
Merged
Changes from 1 commit
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
83647a3
[Doc Issue][Develop single sign on experience in Teams][4030650]
v-bvishnu Oct 9, 2024
f84a377
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 9, 2024
f9cd87f
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
e8b8c0b
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
a558a8c
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
fccd6e1
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
820f31c
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
16a8818
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
5ad1626
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
b3f1d10
Update develop-single-sign-on-experience-in-Teams.md
v-bvishnu Oct 10, 2024
dd07288
Update add-single-sign-on.md
v-bvishnu Oct 10, 2024
bc11760
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Nov 12, 2024
eb02b79
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Nov 12, 2024
53dfdbb
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Nov 12, 2024
f15c865
Merge branch 'main' into develop-single-sign-on-experience-in-Teams
V-bvishnu5 Dec 16, 2024
864edf1
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 16, 2024
ed95d7f
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
679daf9
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
fb497c3
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
377f8cd
Merge branch 'main' into develop-single-sign-on-experience-in-Teams
V-bvishnu5 Dec 17, 2024
82e972e
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
9033839
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
a73f33e
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
aa507d3
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
da5cc3a
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
b0a8d03
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
c7000d5
Update develop-single-sign-on-experience-in-Teams.md
V-bvishnu5 Dec 17, 2024
2850a0e
Merge branch 'main' into develop-single-sign-on-experience-in-Teams
v-kushals Dec 17, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Update develop-single-sign-on-experience-in-Teams.md
  • Loading branch information
V-bvishnu5 committed Dec 17, 2024
commit da5cc3a69d9f8b93f7c812008d5bcfc34632950a
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ To enable SSO, configure your Teams app as follows:

1. Download the Microsoft Entra app manifest [template](https://github.com/OfficeDev/teams-toolkit/blob/dev/packages/fx-core/templates/plugins/resource/aad/manifest/tab/aad.manifest.template.json).

1. Add the downloaded app manifest code to `./aad.manifest.json` file. This allows you to customize different aspects of your app registration and update the manifest as required. For more information, see [app manifest](/entra/identity-platform/reference-app-manifest).
1. Add the downloaded app manifest template code to `./aad.manifest.json` file. This allows you to customize different aspects of your app registration and update the manifest as required. For more information, see [app manifest](/entra/identity-platform/reference-app-manifest).

## Update Teams app manifest

Expand Down Expand Up @@ -89,15 +89,15 @@ In the `./appPackages/manifest.json` file, add the following code:

1. For a React project, update `cli/runNpmCommand` under `deploy`.

1. If you're building a tab app using the React framework in CLI, find the `cli/runNpmCommand` action with `build app` in the `teamsapp.yml` file. Then, add the following environment variable:
1. If you're building a tab app using the React framework in CLI, find the `cli/runNpmCommand` action with `build app` in the `teamsapp.yml` file and add the following environment variable:

```yaml
env:
REACT_APP_CLIENT_ID: ${{AAD_APP_CLIENT_ID}}
REACT_APP_START_LOGIN_PAGE_URL: ${{TAB_ENDPOINT}}/auth-start.html
```

1. If you're building a tab app with React framework, find the `file/createOrUpdateEnvironmentFile` action for deployment in `teamsapp.local.yml` file and add the following environment:
1. If you're building a tab app with React framework, find the `file/createOrUpdateEnvironmentFile` action for deployment in `teamsapp.local.yml` file and add the following environment variable:

```yaml
envs:
Expand All @@ -112,7 +112,7 @@ With the above changes implemented, your environment is prepared. You can now up

### Vanilla JavaScript

Use the following code to retrieve the SSO token and user information:
For a tab app that doesn't uses React, use the following code as a basic example to obtain the SSO token:

```javascript
function getSSOToken() {
Expand All @@ -136,7 +136,7 @@ function getBasicUserInfo() {

For React projects, ensure the following environment variables are set in your deployment process:

* For a JavaScript project, see [tab JavaScript sample.](https://github.com/OfficeDev/teams-toolkit/blob/dev/packages/fx-core/templates/plugins/resource/aad/auth/tab/ts/sso/InitTeamsFx.tsx#L12)
* For a JavaScript project, see [tab JavaScript sample.](https://github.com/OfficeDev/teams-toolkit/tree/main/packages/fx-core/templates/plugins/resource/aad/auth/tab/js)

* For a TypeScript project, see [tab TypeScript sample.](https://github.com/OfficeDev/teams-toolkit/tree/main/packages/fx-core/templates/plugins/resource/aad/auth/tab/ts)

Expand All @@ -151,15 +151,15 @@ To update your source code, follow these steps:

1. Import and add `InitTeamsFx` in `Welcome.*`.

For more information, see [sample app.](https://github.com/OfficeDev/teams-toolkit-samples/tree/dev/hello-world-tab-with-backend)
For more information, see [SSO enabled tab app.](https://github.com/OfficeDev/teams-toolkit-samples/tree/dev/hello-world-tab-with-backend)

# [Bot/message extension app](#tab/message-extension-app)

## Create Microsoft Entra app manifest

1. Download the Microsoft Entra app manifest [template](https://github.com/OfficeDev/teams-toolkit/blob/dev/packages/fx-core/templates/plugins/resource/aad/manifest/bot/aad.manifest.template.json).

1. Add the downloaded app manifest code to `./aad.manifest.json` file. This allows you to customize different aspects of your app registration and update the manifest as required. For more information, see [app manifest](/entra/identity-platform/reference-app-manifest).
1. Add the downloaded app manifest template code to `./aad.manifest.json` file. This allows you to customize different aspects of your app registration and update the manifest as required. For more information, see [app manifest](/entra/identity-platform/reference-app-manifest).

## Update Teams app manifest

Expand Down Expand Up @@ -437,7 +437,7 @@ To use the `teamsFx` tab or bot template, follow these steps:
"build": "tsc --build && copyfiles ./public/*.html lib/",
```

The HTML pages used for auth redirect are copied when building this bot project.
The HTML pages used for auth redirect are copied when building this bot project.

1. Update `templates/appPackage/aad.template.json` file with the scopes you use in the `handleMessageExtensionQueryWithSSO` function:

Expand Down