Set Up New Integration with Microsoft Teams

Prerequisites

  1. Complete the Initial Setup for the app.

  2. Work with your Microsoft/Azure Admin to:

    1. Add the Developer Portal App to Microsoft Teams. See Microsoft's documentation Developer Portal for Teams or contact Microsoft for further instructions.

    2. Determine whether your Microsoft Teams Environment is single tenant or multiple tenant. The procedures for integrating TufinMate vary between the two environments. Select the relevant procedure for your environment.

Single Tenant Microsoft Teams Environments

To establish an integration between the TufinMate Management App and Microsoft Teams, you must generate a unique plugin application that will be installed on Microsoft Teams using the form below:

  1. From TufinMate Management App > Home > Available Integrations, locate the Microsoft Teams Integration and click Manage Integration.

    The Integration Setup screen is displayed.

    1. Navigate to the Azure Portal, stay on the main screen.

    2. Search for the phrase ‘Azure Bot’ in the main search bar. Select Azure Bot from the dropdown, as shown here:

      You are automatically directed to Create an Azure Bot.

    3. Complete the form:

      Bot Handle

      		 Any unique string

      Subscription

      		 Choose relevant resource group
      Data Residency According to your organizational needs
      Pricing

      Change to Free
      Microsoft App ID Single Tenant
      Creation Type Create New

      No action is needed on the two additional tabs of the form.

    4. Hit Review + Create. Then confirm Create.

    5. Select the name of the bot you just created.

    6. Navigate to the Configuration Page of the Bot. Locate the Messaging Endpoint field. The field will be empty.

    7. Navigate back to the TufinMate Management App. Copy the Bot endpoint address from the bottom of the form.

    8. Go back to the Bot Configuration page and paste the value there.

    9. Next, in the Azure Bot console, navigate to the Channels page. Verify that Microsoft Teams is selected. This is the only application that is required to be selected.

    10. Navigate back to the Configuration page and retrieve the Microsoft App ID. This is your Bot ID.

    11. Paste the Bot ID in correct field in the TufinMate Management App.

  3. From the Configuration page, copy the App Tenant ID and paste into the Tenant ID field of the TufinMate Management App:

    1. From the Configuration page, click the hyperlink for Manage Password.

      A new screen loads. You should land on the Certificates and Secrets page automatically.

    2. Click New Client Secret.

      Each secret is uniquely generated, and only visible at the time it’s created. Once the first secret is generated, it must be pasted into the TufinMate form immediately. Once the window is closed, you will not be able to retrieve the secret, and a new one must be generated.
    3. Copy the client secret.
    4. Add it to the form in the TufinMate Management Application.

      All fields of the form have been filled in.

  5. From the TufinMate Management Application, click Save now that all the form parameters have been added.

  6. Download the Custom Teams App.

  7. Refer to your Microsoft Administrator to install the unique application that was just created, see Microsoft Teams Installation and User Permissions.

Multiple Tenant Microsoft Teams Environments

To establish an integration between the TufinMate Management App and Microsoft Teams, you must generate a unique plugin application that will be installed on Microsoft Teams using the form below:

  1. From TufinMate Management App > Home > Available Integrations, locate the Microsoft Teams Integration and click Manage Integration.

    The Integration Setup screen is displayed.

  2. Input tenant ID. This ID is obtained from your Microsoft Administrator.

    1. From Microsoft Team Developer Portal, navigate to the Tools tab.

    2. Click Bot Management.

    3. Click + New Bot.

      The Add bot screen appears.

    4. Name your bot and click add. The new bot's configuration details appear:

    5. From the TufinMate Management App, copy the bot endpoint address.

    6. In the Configuration page, paste the address into Messaging endpoint.

    7. In Teams, click Save.

      The new Bot is created, along with a Bot ID.

    8. Copy the Bot ID. It can now be entered into the relevant field in the TufinMate Management App.

    1. From Microsoft Team Developer Portal, navigate to the Client secrets tab.

    2. Generate a new client secret.

      Each secret is uniquely generated, and only visible at the time it’s created. Once the first secret is generated, it must be pasted into the TufinMate form immediately. Once the window is closed, you will not be able to retrieve the secret, and a new one must be generated.

    3. Copy the client secret.

    4. Copy the client secret.
    5. Add it to the form in the TufinMate Management Application.

      All fields of the form have been filled in.

  5. From the TufinMate Management Application, click Save now that all the form parameters have been added.

  6. Download the Custom Teams App.

  7. Refer to your Microsoft Administrator to install the unique application that was just created, see Microsoft Teams Installation and User Permissions.