> ## Documentation Index
> Fetch the complete documentation index at: https://docs.keephq.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# AppDynamics

> AppDynamics provider allows you to get AppDynamics `alerts/actions` via webhook installation

## Authentication

This provider requires authentication.

* **appDynamicsAccountName**: AppDynamics Account Name (required: True, sensitive: False)
* **appId**: AppDynamics appId (required: True, sensitive: False)
* **host**: AppDynamics host (required: True, sensitive: False)
* **appDynamicsAccessToken**: AppDynamics Access Token (required: False, sensitive: False)
* **appDynamicsUsername**: Username (required: False, sensitive: False)
* **appDynamicsPassword**: Password (required: False, sensitive: True)

Certain scopes may be required to perform specific actions or queries via the provider. Below is a summary of relevant scopes and their use cases:

* **authenticated**: User is Authorized (mandatory)
* **administrator**: Administrator privileges (mandatory)

## In workflows

This provider can't be used as a "step" or "action" in workflows. If you want to use it, please let us know by creating an issue in the [GitHub repository](https://github.com/keephq/keep/issues).

## Connecting with the Provider

1. Ensure you have a AppDynamics account with the necessary [permissions](https://docs.appdynamics.com/accounts/en/cisco-appdynamics-on-premises-user-management/roles-and-permissions). The basic permissions required are `Account Owner` or `Administrator`. Alternatively you can create an account [instructions](https://docs.appdynamics.com/accounts/en/global-account-administration/access-management/manage-user-accounts)

## Provider configuration

1. Find your account name [here](https://accounts.appdynamics.com/overview).
2. Get the appId of the Appdynamics instance in which you wish to install the webhook into.
3. Determine the Host [here](https://accounts.appdynamics.com/overview).

### Basic Auth authentication

1. Obtain AppDynamics **Username** and **Password**
2. Go to **Basic Auth** tab under **Authentication** section
3. Enter **Username** and **Password**

![Keep add AppDynamics Username and Password](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_9.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=42fbd357229eed32b81b5a22801d3702)

### Access Token authentication

1. Log in to the **Controller UI** as an **Account Owner** or other roles with the **Administer users**, **groups**, **roles** permission.
2. Go to **Administration**

![AppDynamics Administration](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_1.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=fd0db00526f61b614d69181d0e9421ff)

3. Go to **API Client** tab

![AppDynamics API Client tab](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_2.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=7521ae1f9e54c09712ad154ac25ae43c)

4. Click **+ Create**

![Create new AppDynamics API Client](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_3.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=39eeb35a84c50d3cac4fe0ae981a6edf)

5. Fill Client **Name** and **Description**
6. Click **Generate Secret**

![AppDynamics generate API Client Secret](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_4.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=cc0dd500246a6484faf6532b3dffbce1)

> [!TIP]
>
> This API Client secret is not an authentication token yet

7. Add **Account Owner** and/or **Administrator** roles

![AppDynamics add API Client roles](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_5.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=67b53149d8e04fd0fc3aeab2bff41c48)

8. Click **Save**

![AppDynamics save API Client](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_6.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=fd75a3554ab18f808b725a7158502ab0)

9. Click **Generate Temporary Token**

![AppDynamics Generate API Client Temporary Access Token](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_7.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=23c994199d261f452fa45155f56f4e03)

> [!TIP]
>
> This token is not persistent, but since Keep uses it just once to install Webhook, we will use it without oAuth

10. Click **Save** one again

> [!WARNING]
>
> This is important. Otherwise generated token will not be saved and authentication will fail

11. Copy generated token

![AppDynamics copy API Client Temporary Access Token](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_8.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=29399a2b15f836bc6ce382e532efea4d)

12. Go to **Access Token** tab under **Authentication** section

![Keep add AppDynamics Access Token](https://mintcdn.com/keep-docs/SMI4wgz6Tw4qDsiL/images/appdynamics_10.png?fit=max\&auto=format\&n=SMI4wgz6Tw4qDsiL\&q=85\&s=7984ca7b8d31c7e3b970cd1a82349a76)

13. Enter Access Token

## Connecting provider

1. Ensure **Install webhook** is checked
2. Click **Connect**

## Webhook Integration Modifications

The webhook integration adds Keep as an alert monitor within the AppDynamics instance. It can be found under the "Alerts & Respond" section.
The integration automatically gains access to the following scopes within AppDynamics:

* `administrator`
* `authenticated`

## Useful Links

* [AppDynamics HTTP Action Templates](https://docs.appdynamics.com/appd/24.x/24.3/en/extend-cisco-appdynamics/cisco-appdynamics-apis/configuration-import-and-export-api#id-.ConfigurationImportandExportAPIv24.2-ImportHTTPActionTemplatesintoanAccount)
* [AppDynamics Permissions and Roles](https://docs.appdynamics.com/accounts/en/cisco-appdynamics-on-premises-user-management/roles-and-permissions)
* [AppDynamics User Accounts](https://docs.appdynamics.com/accounts/en/global-account-administration/access-management/manage-user-accounts)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.