git clone https://github.com/CiscoIT-DAE/appdynamics-onboarding-api.git
cd appdynamics-onboarding-api

### Configuration (src/main/resources/config.properties) - Below is the config.properties changes required before building this project
appd.controller={AppD SaaS Controller Name}  

The controller name should be picked from the SaaS controller URL.  For example, If the controller URL is https://abc.saas.appdynamics.com/controller/, then the 'appd.controller' value should be 'abc'.

The below mentioned json files are instrumented with default permissions and can be used to extend further set of permissions, if required 

src/main/resources/AdminRole.json
- This file contains the default permission settings for the Admin role to be configured on the AppD controller
- Admin Role used to view and modify components that change state, such as applications, business transactions, dashboards, and so on

src/main/resources/ViewRole.json
- This file contains the default permission settings for the View role to be configured on the AppD controller
- View Role used to view components such as applications, business transactions, dashboards, and so on

src/main/resources/HealthRule.json
- This file contains the default Health Rules to be configured on the AppD controller
- Health rules let you specify the parameters that represent what you consider normal or expected operations for your environment

src/main/resources/Actions.json
- This file contains the default Actions to be configured on the AppD controller
- An action is a predefined, reusable, automated response to an event

src/main/resources/Policies.json
- This file contains the default Policies to be configured on the AppD controller
- A policy consists of a trigger based on one or more events and an action in response to the trigger. You can use policies to automate monitoring, alerting, and problem remediation

src/main/resources/createLicenseRule.json
- This file contains the License information to be configured on the AppD controller


mvn clean install
docker build -t appd-onboarding-api:v1.0.0 .

1) Make sure ports 8080 and 27017 are not used by another services 
2) Replace {db_user} and {db_password} with the db credentials that you want to set for Mongodb
3) Replace {AppDUser}, {AppDPass} and {WelcomePass} with the Base64 encoded format AppDynamics Controller credentials. 
   AppDUser and AppDPass are the AppDynamics controller local user credentials, with administration privileges for for this API automation to work. 
   {WelcomePass} is the default password for the users created through this automation. User should reset this password
4) Replace {mongo_user} and {mongo_password} with the base64 encoded version of {db_user} and {db_password}

docker network create --driver bridge dev-net
docker run --name local-mongodb -e MONGO_INITDB_ROOT_USERNAME={db_user} -e MONGO_INITDB_ROOT_PASSWORD={db_password} --network dev-net -d -p 27017:27017 mongo:5.0.6
docker run --name appd-onboarding-api --network dev-net  -e appd_user='{base64 encoded AppDUser}' -e appd_pass='{base64 encoded AppDPass}' -e appd_localUserDefaultPassword='{base64 encoded WelcomePass}' -e mongo_user='{base64 encoded db_user}' -e mongo_passwd='{base64 encoded db_password}' -d -p 8080:8080 appd-onboarding-api:v1.0.0

POST /api​/v1​/applications - Onboard Applications into AppDynamics Controller
GET /api​/v1​/applications​/{id} - Get the Onboarded Applications Details in AppDynamics Controller
PATCH /api​/v1​/applications​/{id} - Update the Onboarded Applications in AppDynamics Controller

curl -X POST "http://localhost:8080/appd-onboarding-api/api/v1/applications" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{\"apmApplicationGroupName\":\"DemoApplication1\",\"alertAliases\":[\"alertalias@domain.com\"],\"adminUsers\":[\"adminUser1\",\"adminUser2\"],\"viewUsers\":[\"viewUser1\",\"viewUser2\"],\"apmLicenses\":6,\"eumApplicationGroupNames\":[\"Demo_EUM_APP_1\",\"Demo_EUM_APP_2\"]}"

HTTP Response Headers: 
	TrackingID: S1_c33f6c30-eb73-43fe-b0d9-6ffc786c13fa_1645113524688
	Content-Type: application/json
	Transfer-Encoding: chunked
	Date: Thu, 17 Feb 2022 16:15:20 GMT
	Keep-Alive: timeout=20
	Connection: keep-alive

HTTP Response Code: 202

HTTP Response Body: {
    "eumApplicationGroupNames": [
        "Demo_EUM_APP_1",
        "Demo_EUM_APP_2"
    ],
    "viewUsers": [
        "viewUser1",
        "viewUser2"
    ],
    "apmLicenses": 6,
    "apmApplicationGroupName": "DemoApplication1",
    "id": "8d10b1de-d0ca-4c21-ae23-ddb3979e07f6",
    "alertAliases": ["alertalias@domain.com"],
    "adminUsers": [
        "adminUser1",
        "adminUser2"
    ]
}

curl -X PATCH "http://localhost:8080/appd-onboarding-api/api/v1/applications/8d10b1de-d0ca-4c21-ae23-ddb3979e07f6" -H  "accept: application/json" -H  "Content-Type: application/json" -d "{\"alertAliases\":[\"alertalias@domain.com\"],\"adminUsers\":[\"adminUser1\",\"adminUser3\"],\"viewUsers\":[\"viewUser2\",\"viewUser3\"],\"apmLicenses\":10,\"eumApplicationGroupNames\":[\"Demo_EUM_APP_1\",\"Demo_EUM_APP_2\",\"Demo_EUM_APP_3\"]}"

HTTP Response Headers: 
	TrackingID: S1_2c0f0a07-5185-4116-b46d-39457ca84a58_1645114520064
	Content-Type: application/json
	Transfer-Encoding: chunked
	Date: Thu, 17 Feb 2022 16:15:20 GMT
	Keep-Alive: timeout=20
	Connection: keep-alive

HTTP Response Code: 202

HTTP Response Body: {
    "eumApplicationGroupNames": [
        "Demo_EUM_APP_1",
   	    "Demo_EUM_APP_2",
        "Demo_EUM_APP_3"
    ],
    "viewUsers": [
        "viewUser2",
        "viewUser3"
    ],
    "apmLicenses": 10,
    "apmApplicationGroupName": "DemoApplication1",
    "id": "8d10b1de-d0ca-4c21-ae23-ddb3979e07f6",
    "alertAliases": ["alertalias@domain.com"],
    "adminUsers": [
        "adminUser1",
        "adminUser3"
    ]
}

curl -X GET "http://localhost:8080/appd-onboarding-api/api/v1/applications/8d10b1de-d0ca-4c21-ae23-ddb3979e07f6" -H  "accept: application/json"

HTTP Response Headers: 
	TrackingID: S1_4a6b896c-1081-46fd-a888-e2762a547b44_1645113849612
	Content-Type: application/json
	Transfer-Encoding: chunked
	Date: Thu, 17 Feb 2022 16:04:09 GMT
	Keep-Alive: timeout=20
	Connection: keep-alive

HTTP Response Code: 200

HTTP Response Body: {
    "eumApplicationGroupNames": [
        "Demo_EUM_APP_1",
   	    "Demo_EUM_APP_2",
        "Demo_EUM_APP_3"
    ],
    "apmLicenses": 10,
    "viewRoleName": "AppD-914fb361-5ff6-33ae-999d-3c97a96ef490-devv",
    "adminUsers": [
        "adminUser1",
        "adminUser3"
    ]
    "licenseKey": "1e95f674-d0e8-4a72-833c-22c8a806werf",
    "viewUsers": [
        "viewUser2",
        "viewUser3"
    ],
    "adminRoleName": "AppD-914fb361-5ff6-33ae-999d-3c97a96ef490-deva",
    "apmApplicationGroupName": "DemoApplication1",
    "id": "8d10b1de-d0ca-4c21-ae23-ddb3979e07f6",
    "operation": "create",
    "alertAliases": ["alertalias@domain.com"],
    "status": "ACTIVE"
}