Install Salem Teams App

Create and Deploy Teams App to Teams App Store

1. Customize Salem App Manifest ✧ The latest app manifest can be found here ✦ Add in the Deployment ID, and Salem Bot Name. These values can be found from the Salem app in Azure under Parameters and Outputs. This ID is NOT the ID of the App registration

2. Create App package ✧ create a zip archive containing the manifest.json, Salem_color.png, and Salem_outline.png files at the root level of the archive.

3. From Microsoft Teams, navigate to "Apps", then select "Manage your apps"

4. Select "Upload an app"

5. If you are a Teams admin, you will have the option to Upload an app directly to your organization. If you are not an admin, you will need to submit the app to your org for approval. When submitting an app to your organization, your admins should receive a notification, but it's probably best to follow up with them directly about app approval.

Install Team App

1. Click the "App" button of Microsoft Teams to go to the App Store. It's towards the bottom left of the window.

1. Go to the search bar in the top banister of the second division of the window from the left side and type "Salem Cyber Analyst". The App name may vary based on the name configured in Create and Deploy Teams App to Teams App Store

1. In the main partition [third from the left in the window], you should see an app with a title of the previous search entry. << TODO Verify this>>

1. Click the app to open the App Page.

1. In the newly formed sub-window, click the purple button with the text "Add". Salem is now successfully installed and can further be authenticated for proper use.

Single User Authentication and Bot Preparation

Authentication is a necessary step that only takes a few clicks.

1. Add Salem to a new chat by:

   • Returning to the App Page from the previous step.

   • Clicking the Open button which has replaced the App button.

1. If you are not already logged in there should be a card with a button offering the ability to log in. Click it to inform Salem you wish to log-in.

2. Follow the prompts on screen in a new window. Depending on the situation, the authentication may be automatic and not need input. If authentication was successful, you should acquire a thank you from the bot. Thank you!

Group Authentication and Bot Preparation

Authentication for groups is just as simple.

1. First, create a new team by:

   • Clicking the Teams Tab in the sidebar.

   

   • Clicking the "Create or Join Team" button at the bottom of the updated divider.

   • Then following on-screen prompts to create a team [this is in the primary division to the right of the previous], create a team with your desired settings.

2. Viewing the new team, click the double dots and continue to the "Manage Team" option in the drop-down.

1. Click on the Apps Tab in the main portion of the screen.

1. Click on "Get More Apps" in the upper left corner.

1. You should see an option to open the bot's App Page. If not, follow the prior steps [from the installation guide] to search for the bot and open the App Page. Otherwise, continue to open the App Page.

2. In the app view, there should be a drop-down next to the "Open" button. click that and further click "Add to Team".

3. Follow the on-screen prompt to select a team.

4. You will then be returned to a team with a new message from the bot asking to enable group notifications.

5. Select the desired choice. Salem will now be fully authenticated for group interaction!