README.md

Nested App Auth Test App

This is a TeamsJS app designed to test nested app authentication (NAA) in app hosts.

How to run this app locally

Prerequisites

To run the command bot template in your local dev machine, you will need:

• Node.js, supported versions: 16, 18
• A Microsoft 365 account for development
• Set up your dev environment for extending Teams apps across Microsoft 365 Please note that after you enrolled your developer tenant in Office 365 Target Release, it may take couple days for the enrollment to take effect.
• Teams Toolkit Visual Studio Code Extension version 5.0.0 and higher or Teams Toolkit CLI

1. First, select the Teams Toolkit icon on the left in the VS Code toolbar.
2. In the Account section, sign in with your Microsoft 365 account if you haven't already.
3. Press F5 to start debugging which launches your app in Teams using a web browser. Select Debug (Edge) or Debug (Chrome).
4. When Teams launches in the browser, select the Add button in the dialog to install your app to Teams.
5. To sideload your app on a host not included in the Teams Toolkit configurations, find the compiled manifest package under appPackage > build > appPackage.local.zip.

Configuring NAA for deployment

If you plan on deploying this app to the web, you will need to create a new AAD app registration and configure it for NAA with your web URL.

1. Go to Azure Portal
2. Navigate to Microsoft Entra ID and find your app registrations in the left nav bar.
3. Create a new registration by clicking the "New registration" button at the top of the page.
4. Provide a name for your registration and select the supported account type.
5. Under the Redirect URI heading, select "Single-page application" and provide "brk-multihub://<YOUR_WEB_APP_DOMAIN_HERE>" as the URI value.
6. Select register and note the application client ID.
7. In the naa-test-app repo, navigate to src/AuthModule.ts and replace the client ID in msalConfig with your AAD client ID.

Additional Teams Toolkit Template info

What's included in the template

Folder	Contents
.vscode	VSCode files for debugging
appPackage	Templates for the Teams application manifest
env	Environment files
infra	Templates for provisioning Azure resources
src	The source code for the Teams application

The following are Teams Toolkit specific project files. You can visit a complete guide on Github to understand how Teams Toolkit works.

File	Contents
teamsapp.yml	This is the main Teams Toolkit project file. The project file defines two primary things: Properties and configuration Stage definitions.
teamsapp.local.yml	This overrides teamsapp.yml with actions that enable local execution and debugging.
aad.manifest.json	This file defines the configuration of Azure Active Directory app. This template will only provision single tenant Azure Active Directory app.

Extend the React with Fluent UI template

Following documentation will help you to extend the React with Fluent UI template.

• Add or manage the environment
• Create multi-capability app
• Use an existing Azure Active Directory application
• Customize the Teams app manifest
• Host your app in Azure by provision cloud resources and deploy the code to cloud
• Collaborate on app development
• Set up the CI/CD pipeline
• Publish the app to your organization or the Microsoft Teams app store
• Enable the app for multi-tenant
• Preview the app on mobile clients