ChatOps integrations

This section provides instructions for integrating with a ChatOps application, such as Slack or Microsoft Teams. The integration enables all stakeholders to collaborate and communicate.

Set up a Slack integration

To set up integration with Slack, add your workspace to a Slack workspace. This enables users to open Slack channels for discussions from within OpenText Core Software Delivery Platform items, allowing stakeholders of backlog items or pipeline run failures to communicate. For details, see Collaborate.

If you configure the integration to expose OpenText Core SDP data on Slack channels, information from the backlog item is sent to the channel.

Note: You can add your workspace to only one Slack workspace.

We recommend using different Slack workspaces for different OpenText Core SDP workspaces.

To enable your workspace users to collaborate in Slack, define Slack as a collaboration tool in OpenText Core SDP, and add your OpenText Core SDP workspace to your Slack workspace.

  1. Open the Settings menu , click Spaces, and select your workspace.

  2. Click the DevOps tab, and select Collaboration Tools.

  3. Click the More dropdown button and select Slack as the collaboration tool if it is not already selected. The Add Collaboration Tool dialog box opens.

  4. In Slack, make sure you have a workspace to use for all communication related to this OpenText Core SDP workspace. Add all of your OpenText Core SDP workspace members to the Slack workspace.

    If you do not have such a workspace, click the link in the Add Collaboration Tool dialog box to open Slack and create a workspace.

    • When creating a new Slack workspace, make sure to use an email address that you can access. Slack sends a confirmation code to this address as part of the process.

      You can use the same email address to create different Slack workspaces.

    • You can add members to the Slack workspace at any time.

    When you finish creating the Slack workspace, go back to the OpenText Core SDP browser tab.

  5. Consider whether to allow exposing internal OpenText Core SDP information on the Slack channel.

    If you select the checkbox for this option in the Add Collaboration Tool dialog box, information about the relevant backlog items are sent to the Slack channels that it opens.

    Note: You can modify this setting at any time in the Collaboration Tools grid.

  6. Click Add to Slack to add your OpenText Core SDP workspace to the Slack workspace.

    The OpenText Core SDP chat application registered on Slack requests access to your Slack workspace.

    For SaaS OpenText Core SDP, the name of the application is octanechatsapp. For on-premises OpenText Core SDP, the application is set up by your site admin.

  7. (Optional) Select a different Slack workspace and choose whether to expose more or less information about your Slack workspace to OpenText Core SDP.

  8. Click Authorize.

The integration with Slack is complete. The Chat w/ Slack button is now enabled in backlog items and in a pipeline run's Tests tab.

Troubleshooting: If the integration setup fails due to a communication failure, reporting an inaccessible redirect_url, contact your site admin to make sure that the configuration parameter SERVER_BASE_URL is defined correctly. For details, see Configuration parameters.

Back to top

Set up a Microsoft Teams integration

To prepare your system to integrate with Microsoft Teams, register the Teams app in Azure, and then enable your workspace users to collaborate in Microsoft Teams.

Registering Teams in Azure establishes a trust relationship between your application and the identity provider, the Microsoft identity platform. For more details, refer to the Azure documentation.

The integration with Microsoft Teams lets you send comments to a specific Teams channel.

To register Teams in Azure:

  1. Open the Azure portal using the organization's account.

  2. Log in as a tenant admin. This allows you to grant consent for the permissions that will be required later.

  3. Open the Active Directory service.

  4. In the navigation side pane, click App registrations, and click New application registration.

  5. In the App > Authentication section, create a redirect URI to:

    https://<server_base_url>/api/msteams-integration/auth-code

  6. In the App > API permissions section, grant the following Microsoft Graph API delegated permissions:

    Group.Read.All User.ReadBasic.All Team.ReadBasic.All ChannelMessage.Send offline_access

    Note: If you skip this step, you can provide consent to these permissions upon your login.

  7. Create a client secret for your app in the App > Certificates & Secrets section.

  8. Save the client secret which you need it to enable the integration.

To add Microsoft Teams as a collaboration tool:

  1. Open the Settings menu , click Spaces, and select your workspace.

  2. Click the DevOps tab, and select Collaboration Tools.

  3. Click the More dropdown button and select Microsoft Teams as the collaboration tool if it is not already selected. You are prompted to set up the integration.

  4. Enter the required credentials: Application (client) ID, Directory (tenant) ID, and client secret. Click Configure. The credentials can be found in the Azure portal.

  5. Exit the admin settings section, and make sure you are logged in to OpenText Core SDP as an admin.

  6. Go to any work item entity and click the Discuss on Teams button . You are prompted to provide consent for the requested permissions.

  7. Select the Consent on behalf of your organization checkbox and click Login. OpenText Core SDP authenticates on behalf of your Microsoft users through the application that you created.

Non-admin users can collaborate in Microsoft Teams from within OpenText Core SDP. For details, see Discuss on Microsoft Teams.

Back to top