Integrate Microsoft Teams with Cobalt

Integration Overview

Integrate with Microsoft Teams to seamlessly collaborate with Cobalt pentesters and other pentest team members directly from Teams.

How it Works

• Install the Cobalt app, from the Microsoft Teams app store, into your Teams environment
• In Teams, a channel manager adds the Cobalt app to a Teams channel, authenticates to Cobalt, and selects the specific pentest to connect to the channel
• Members of the Teams channel can use the Cobalt app to post or reply to messages, directly from Teams
• Pentest team members with a Cobalt account, as well as Cobalt’s pentesters and staff, can see, respond, or send new messages from Cobalt’s Pentest Chat, which are syndicated to the connected Teams channels
• Pentester Updates are sent to the channel(s) connected to that specific pentest

Limitations

Please be aware of the following considerations when using this integration. We are working to improve the integration and address these limitations.

• Messages will not appear as threads in Teams or Cobalt Chat
• File attachments are not supported
• A Teams channel can only be connected to a single Cobalt pentest.

Integrate with Microsoft Teams

Connect your Microsoft Teams workspace to your Cobalt Organization in order to sync Cobalt pentests chat with Teams channels, allowing your team to collaborate on a test directly from your Teams instance.

Install Cobalt Teams Application in Your Teams Instance

As an administrator for your Microsoft Teams instance, you can add the Cobalt app to your environment by:

1. Go to Apps within your Microsoft Teams interface
2. Search “Cobalt Pentesting and Offensive Security”
3. Click “Add”

Uninstall Teams Integration

To remove the Cobalt app from your Microsoft Teams instance:

1. Navigate to the “Apps” section within Microsoft Teams, then “Manage your apps”.
2. Find the Cobalt Pentesting and Offensive Security app; expand it to see where it’s used.
3. Click the trash can icon to remove from each channel as needed. Note: If you’re a Teams Administrator, you can also remove apps from the Teams admin center.

Here’s what to expect once you’ve removed the Cobalt app:

• Data synchronization between Cobalt and Microsoft Teams stops.
• All channel connections for specific pentests are deleted. If you decide to reinstall the integration, you’ll need to set up the connection for each pentest.
• Any previously posted messages from Cobalt to your Teams channels will remain visible in Teams.
• Posting new messages, or responding to previously posted pentest messages in Teams, will no longer be possible.

Connect Channels

Once you’ve installed the Cobalt app in your Microsoft Teams instance, you can connect a Teams channel to a pentest, so your teams and pentesters can seamlessly collaborate directly from the Teams channel or through the Cobalt platform.

Connect a Teams Channel to a Pentest

To communicate with the Cobalt pentest team through Microsoft Teams, you must connect a Teams channel to a specific Cobalt pentest. The person who sets up the Teams channel connection must have a Cobalt account which has access to the Cobalt pentest.

1. Go to the Teams channel which you wish to connect to a pentest, and add the “Cobalt Pentesting and Offensive Security” app
2. Type “@Cobalt connect”
3. In the bot response, which shows instructions to set up the connection, click “Login & Select Test”
4. Sign in to the Cobalt platform
5. Select the pentest you wish to connect to the Teams channel
6. Review the confirmation message from the Cobalt bot to verify the correct pentest has been connected to the channel. Note: Only one pentest can be connected to a Teams channel.

Disconnected Teams Channel(s)

Once you’ve connected your Microsoft Teams instance, you can view all pentests connected to Teams channels.

1. After logging in to Cobalt, go to Integrations > Microsoft Teams > Configuration. Here, you can see pentests for which you have connected Teams channels.
2. Click “Disconnect” beside the desired pentest to remove the Teams connection.
3. If disconnection was successful, in the Teams channel, a new post will confirm that the channel is no longer connected.

You may also disconnect directly from Teams, by going to the desired channel, and using the bot command “@Cobalt disconnect”.

Send a Message from Teams

Once a Teams channel has been connected to a Cobalt pentest, you can send messages to the pentest chat directly from Teams.

1. In the Teams channel, click the “Cobalt” icon in the Compose Message box
2. Enter your message in the “Send Message” dialog box
3. Click “Send”

You can also use the bot command “@Cobalt chat” then type your message. Once sent, the message will appear in the Cobalt Chat for the associated pentest, and will be syndicated to your Teams channel for visibility to the other channel members.

Reply to a Message from Teams

When a message is posted to Cobalt Chat, either from the Cobalt platform or using the Microsoft Teams integration, the Cobalt bot will post the content of the message to the subscribed Teams channel. To reply to the message:

1. Click the “Reply” button on the message
2. Enter the response in the “Reply” dialog
3. Click “Send Reply”

Get Help within Teams

You can also use the bot command “@Cobalt help” to view a list of the available commands and what they are used for.

Pentester Updates in Teams

If a Teams channel has been connected to a Cobalt pentest, during the course of the pentest, updates posted by pentesters will be sent as messages to the connected channel(s).

Support

If you have issues or need support, contact support@cobalt.io.

Frequently Asked Questions

Q: Do all messages in my Teams channel get synced to the Cobalt pentest?

A: No. Only messages or replies sent using the Cobalt bot will be synced to Cobalt. Any other communication within the channel, using the standard Teams messaging features, will remain private to that channel, and are not visible to Cobalt.

Q: Do I need to provide pentesters and staff with access to Microsoft Teams?

A: No. Pentesters and Cobalt staff can see and respond to messages posted via the Microsoft Teams integration using the Pentest Chat within the Cobalt platform.

Q: Do all members of my Teams channel need to have access to the Cobalt platform?

A: No. You can invite anybody you wish from your organization to the Teams channel, even those without a Cobalt account. All members of the channel will be able to post, respond and view communications from the associated pentest.

Q: Can Cobalt access data in my Microsoft Teams instance when I use this integration?

A: No. Cobalt has no visibility or access to your Teams system, except for messages posted using the Cobalt bot.

Q: Where do messages sent from Teams appear in the Cobalt platform?

A: Messages are synchronized to the Cobalt Chat for the pentest or engagement that they are associated with.

Q: Who can see the messages sent using the integration?

A: Messages sent to Cobalt from the Teams bot will be visible to Cobalt users who have been granted access to the associated pentest (including your Cobalt Staff members, Pentesters, and any team members that you have invited to the pentest in the Cobalt platform). After you’ve connected a Teams channel to a pentest, messages posted using the Cobalt bot will be syndicated to the connected pentest’s InApp chat on the Cobalt platform, and vice versa. Users with access to the Teams channel will be able to see the messages originating from the Cobalt InApp chat on the connected pentest.

Q: How do I control who sees the Cobalt discussions in Teams?

A: Anybody you add to a Teams channel that is connected to a Cobalt pentest will be able to see the discussion. Cobalt has no visibility or control over the membership of your Teams channels. As such, it is the customer’s responsibility to manage access in Teams.

Q: Can I subscribe to multiple Cobalt pentests from the same Teams channel?

A: No, a Teams channel can only be connected to one Cobalt pentest. To connect another pentest, you may remove the original connection, then connect the new test. Otherwise, you must create a new channel.

Q: Can I discuss a specific Cobalt finding using the integration?

A: Currently the integration supports Cobalt’s Pentest Chat only, not Finding chat. You may reference a finding ID when sending a message, but the message will remain in the Pentest Chat, and will not be directly associated to the specific finding.

Q: Does the integration support threading?

A: No, threaded messaging is not currently supported, but will be in a future release.

Q: Does the integration support file attachments?

A: No, attachments are not currently supported, but will be in a future release.

Q: Does the integration support reactions?

A: No, emoji reactions are not currently supported, but will be in a future release.