Amazon Quick Suite Microsoft Teams extension

1. Have a Microsoft 365 Business subscription and be a Global Admin or have administrative permissions (specifically AppCatalog.ReadWrite.All).

2. Have a Amazon Quick Suite instance.

3. Your Microsoft 365 tenant ID. You can find this by going to the Azure portal > Azure Active Directory > Properties, or by using PowerShell. For detailed steps, see How to find your tenant ID - Microsoft Entra in the Microsoft Learn portal.

1. Ensure you have an IAM Identity Center instance enabled on your AWS account.

2. Use Microsoft Entra ID as your identity provider.

3. Ensure that every user under your Entra ID provider configuration has an email associated with them.

4. Set up SCIM identity propagation between the Microsoft Entra ID instance and IAM Identity Center. For detailed steps, see Configure SAML and SCIM with Microsoft Entra ID and IAM Identity Center.

To set up an Azure tenant

1. In the Azure account, create a new app registration.

   1. Go to App registrations.

   2. In the App registrations screen, choose New registration. Under the Supported account types option, choose Accounts in this organizational directory only (Personal use only - Single tenant). Once finished, choose Register.

   3. Note the client ID. You will need this later.

   4. Create a client secret for the app registration and keep note of it. You will need this later.

2. Add callback URLs for each Region in which your Teams extension will be installed.

   1. Navigate to the app registration's Authentication tab.

   2. Choose Platform Configurations, Add a platform.

   3. Choose Web.

   4. Compose a callback URL using the following format, replacing your-region with your Amazon Quick Suite instance Region. The Teams extension supports the following Regions: ap-southeast-2, eu-west-1, us-west-2, and us-east-1.

      qbs-cell001.dp.appintegrations.your-region.prod.plato.ai.aws.dev/auth/idc-tti/callback

   5. Insert the callback URL as the redirect URI and choose Configure when done.

To configure a Trusted Token Issuer

1. Go to your AWS account and navigate to your IAM Identity Center instance.

2. Navigate to Settings, Authentication.

3. Choose Create trusted token issuer.

4. Add the issuer URL, which should follow this template, where Tenant ID refers to your Entra tenant ID:

   login.microsoftonline.com/Tenant ID/v2.0

   Note

   The issuer URL should be the OIDC discovery endpoint of your identity without the well-known document URI path. If you include the well-known document URI path, this will not work. See Trusted token issuer configuration settings.

5. Choose Email as the Identity Provider attribute and IAM Identity Center attribute.

To set up permissions

1. Navigate to Secrets Manager on AWS console.

2. Choose Store a new secret.

3. Choose Other type of secret and choose the Plaintext tab.

4. Your secret should be in the following format and use the app registration client ID and app registration client secret that you saved from the earlier steps:

   
   {
       "client_id":"Your app registration client ID",
       "client_secret":"Your app registration client secret"
   }

5. Navigate to the secret you just created and save the ARN for later.

6. Now navigate to IAM on AWS console.

7. Choose Access Management, Roles in the left navigation bar.

8. Choose Create role.

9. Choose Custom trust policy.

10. Configure the role to trust our service principal for the relevant Region that you selected when configuring your Azure app registration by adding the following statement replacing your-region with the Region you chose when creating the Azure app registration:

    
    {
        "Version": "2012-10-17", 		 	 	 
        "Statement": [
            {
                "Effect": "Allow",
                "Principal": {
                    "Service": "your-region.prod.appintegrations.plato.aws.internal"
                },
                "Action": "sts:AssumeRole",
                "Condition": {}
            }
        ]
    }

11. Choose Next.

12. Provide a name and description and choose Create role.

13. Navigate to the role you just created and choose it.

14. Choose Add Permissions, Create inline policy.

15. Choose JSON.

16. Configure the role with permissions to read secrets from Secrets Manager and permissions to invoke sso:DescribeTrustedTokenIssuer by adding the following statement:

    
    {
        "Version": "2012-10-17", 		 	 	 
        "Statement": [
            {
                "Sid": "BasePermissions",
                "Effect": "Allow",
                "Action": [
                    "secretsmanager:GetSecretValue",
                    "sso:DescribeTrustedTokenIssuer"
                ],
                "Resource": "*"
            }
        ]
    }

17. Provide a policy name and choose Create policy.

18. Copy and save the ARN of the IAM role you created for later. You will need it in the next steps.

To create an extension access configuration

1. Sign in to the Amazon Quick Suite console.

2. In the top right, choose the profile picture icon.

3. From the drop-down menu, choose Manage account.

4. Under Permissions, choose Extension access.

5. In the top right, choose New extension access.

6. Select Microsoft Teams. Then, choose Next.

7. Configure the following fields:

   • Name - A name for your extension is pre-filled for you. You can edit this and enter a descriptive name for the Teams extension (maximum 512 alphanumeric characters, hyphens allowed but no spaces).

   • Description (optional) - A description for your extension is pre-filled for you. You can edit this and enter a new description to provide additional context about this extension configuration (maximum 1000 characters).

   • M365 tenant ID - Enter your Microsoft 365 tenant identifier (must be 36 characters).

   • Secrets Role ARN - Paste the ARN of the IAM role you created from the previous steps.

   • Secrets ARN - Paste the ARN of the Secrets Manager secret you created from the previous steps.

8. Choose Add to save the new access configuration.

   A success message will open up on the top right of your screen.

9. From the success message, choose View extensions to finish installing your extension.

   Note

   You can also navigate to the installation screen from Connections > Extensions in the Amazon Quick Suite menu.

1. Sign in to the Amazon Quick Suite console.

2. In the top right, select the profile picture icon.

3. From the drop-down menu, select Manage account.

4. Under Permissions, select Extension access.

5. In the top right, select New extension access.

6. Select Microsoft Teams, then, Next.

7. Configure the following fields:

   • Name - A name for your extension is pre-filled for you. You can edit this and enter a descriptive name for the Teams extension (maximum 512 alphanumeric characters, hyphens allowed but no spaces).

   • Description (optional) - A description for your extension is pre-filled for you. You can edit this and enter a new description to provide additional context about this extension configuration (maximum 1000 characters).

   • M365 tenant ID - Enter your Microsoft 365 tenant identifier (must be 36 characters).

8. Select Add to save the new access configuration.

   A success message will open up on the top right of your screen.

9. From the success message, select View extensions to finish installing your extension.

   Note

   You can also navigate to the installation screen from Connections > Extensions in the Amazon Quick Suite menu.

1. Sign in to the Amazon Quick Suite console.

2. In the top right, select the profile picture icon.

3. From the drop-down menu, select Manage account.

4. Under Permissions, select Extension access.

5. Select the three dot menu icon for the Microsoft Teams extension you need to edit.

6. Select Edit.

7. Edit the configuration as required and select Save to confirm the changes.

1. Sign in to the Amazon Quick Suite console.

2. In the top right, select the profile picture icon.

3. From the drop-down menu, select Manage account.

4. Under Permissions, select Extension access.

5. Select the three dot menu icon for the Microsoft Teams Extension you need to delete.

6. Select Delete.

7. Enter the word, "confirm", and select DELETE.