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 82e972efe6b77b5738bb766a9152047789cd039b
Original file line number Diff line number Diff line change
Expand Up @@ -31,29 +31,29 @@ To enable SSO, configure as follows:

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).
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).

## Teams app manifest

In the `./appPackages/manifest.json` file, add the following code:
1. In the `./appPackages/manifest.json` file, add the following code:

```json
"webApplicationInfo": {
"id": "${{AAD_APP_CLIENT_ID}}",
"resource": "api://${{TAB_DOMAIN}}/${{AAD_APP_CLIENT_ID}}"
}
```
```json
"webApplicationInfo": {
"id": "${{AAD_APP_CLIENT_ID}}",
"resource": "api://${{TAB_DOMAIN}}/${{AAD_APP_CLIENT_ID}}"
}
```

`webApplicationInfo` provides your Microsoft Entra App ID and Microsoft Graph information to assist users sign in to your app.
1. `webApplicationInfo` provides your Microsoft Entra App ID and Microsoft Graph information to assist users sign in to your app.

> [!NOTE]
> You can use `{{ENV_NAME}}` to reference variables in `env/.env.{TEAMSFX_ENV}` file.
> [!NOTE]
> You can use `{{ENV_NAME}}` to reference variables in `env/.env.{TEAMSFX_ENV}` file.

## Teams Toolkit configuration files

Locate your Teams Toolkit configuration files, such as `./teamsapp.yml` and `./teamsapp.local.yml`. Update the required configurations related with Microsoft Entra in these files.
1. Locate your Teams Toolkit configuration files, such as `./teamsapp.yml` and `./teamsapp.local.yml`. Update the required configurations related with Microsoft Entra in these files.

* Add the following code `aadApp/create` under `provision` in `./teamsapp.yml` and `./teamsapp.local.yml` to create new Microsoft Entra app used for SSO. For more information, see [`aadApp/create`.](https://github.com/OfficeDev/teams-toolkit/wiki/Available-actions-in-Teams-Toolkit#aadappcreate):
1. Add the following code `aadApp/create` under `provision` in `./teamsapp.yml` and `./teamsapp.local.yml` to create new Microsoft Entra app used for SSO. For more information, see [`aadApp/create`.](https://github.com/OfficeDev/teams-toolkit/wiki/Available-actions-in-Teams-Toolkit#aadappcreate):

```yaml
- uses: aadApp/create
Expand All @@ -72,7 +72,7 @@ Locate your Teams Toolkit configuration files, such as `./teamsapp.yml` and `./t
> [!NOTE]
> Replace the `name` value with the desired name for your Teams app.

* Add the following code `aadApp/update` under `provision` in `./teamsapp.yml` and `./teamsapp.local.yml` to update your Microsoft Entra app. For more information, see [`aadApp/update`](https://github.com/OfficeDev/teams-toolkit/wiki/Available-actions-in-Teams-Toolkit#aadappupdate):
1. Add the following code `aadApp/update` under `provision` in `./teamsapp.yml` and `./teamsapp.local.yml` to update your Microsoft Entra app. For more information, see [`aadApp/update`](https://github.com/OfficeDev/teams-toolkit/wiki/Available-actions-in-Teams-Toolkit#aadappupdate):

```yaml
- uses: aadApp/update
Expand All @@ -85,17 +85,17 @@ Locate your Teams Toolkit configuration files, such as `./teamsapp.yml` and `./t
> * Update the `manifestPath` value to the relative path of the Microsoft Entra app manifest template `aad.manifest.json`, if you've changed the file's path.
> * In a local setup, position the `aad/update` after the `file/createOrUpdateEnvironmentFile` action. This is required because `aad/update` uses the output from `file/createOrUpdateEnvironmentFile`.

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

* 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. Then, add the following environment variable:

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

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

```yml
envs:
Expand Down