AppDynamics
AppDynamics is an application performance monitoring solution to provide real-time visibility and insight into IT environments (see https://www.appdynamics.com/). You can protect access to AppDynamics by integrating AppDynamics with Identity as a Service. Once integrated, users can use single sign-on to log in to their AppDynamics account through Identity as a Service.
This integration was tested using Identity as a Service version 5.14 and AppDynamics Controller build 20.11.0-1930 . Other versions of the AppDynamics Controller may require integration and configuration steps that differ from those documented in this procedure. For other versions of AppDynamics Controller, use this procedure as a starting point for integrating the AppDynamics Controller. In the event of other issues, contact support@entrust.com for assistance.
To integrate AppDynamics with Identity as a Service, you must do the following:
Step 1: Copy the SAML Configuration from Identity as a Service
-
Log into your Identity as a Service administrator account.
-
Click > Security > Applications. The Applications Lists page appears.
-
Under SAML Cloud Integrations, click SAML Configuration. The SAML Configuration dialog box appears.
This dialog box contains information you need to configure your SAML application for Identity as a Service authentication.
-
Do one of the following:
- Leave this dialog box open to reference later in this procedure.
- Copy the Entity ID, Single Sign-on URL, and Single Logout URL to a text file and save it to reference later in this procedure.
Depending on the integration you are performing, you may not need all three of these SAML configuration values.
Step 2: Export the signing certificate from Identity as a Service
- Log in to your Identity as a Service administrator account.
- Click > Security > Applications. The Applications List page appears.
- Under SAML Cloud Integrations, click SAML Signing Certificates. The SAML Signing Certificates page appears.
- Click the download icon next to the certificate to export the certificate you want to import into your SAML service provider application. The Export Certificate dialog box appears.
- If the certificate has been issued by a CA, do one of the following:
- Click Certificate to export the self-signed certificate.
- Click Root CA Certificate to export a certificate issued from a CA.
- Click Certificate Chain to export the SAML signing certificate and its CA certificates.
- Click Export.
Step 3: Add AppDynamics to Identity as a Service
-
Log into your Identity as a Service administrator account.
-
Click > Security > Applications. The Applications Lists page appears.
-
Click Add. The Select an Application Template page appears.
-
Do one of the following:
- Select SAML Cloud Integrations from the search drop-down list and scroll to find the application you want to add to IDaaS.
- In the Search bar, enter a search option to filter for the application you want to add to IDaaS.
-
Click AppDynamics. The Add AppDynamics page appears.
-
Enter an Application Name.
-
Enter an Application Description.
-
Optional. Add a custom application logo.
- Click next to Application Logo. The Upload Logo dialog box appears.
- Click to select an image file to upload.
- Browse to select your file and click Open. The Upload Logo dialog box reappears showing your selected image.
- If required, resize your image.
- Click OK.
-
Select the Authentication Flow that appears to users during login.
-
Click Next. The General page appears.
-
In the Default Assertion Consumer Service URL field, enter
https://my_domain.saas.appdynamics.com/controller/saml-auth?accountName=my_domain
Example: https://mycompany2.saas.appdynamics.com/controller/saml-auth?accountName=mycompany
-
In the Service Provider Entity ID field, enter
https://my_domain.saas.appdynamics.com/controller/saml-auth?accountName=my_domain
Example: https://mycompany.saas.appdynamics.com/controller/saml-auth?accountName=my_domain
-
In the Single Logout Service URL field, enter the AppDynamics home page URL:
-
Optional. Enter the SAML Username Parameter Name used to identity the user ID being requested for authentication. The user ID can then be passed as a parameter, for example, Username=jdoe.
-
Enter the SAML Session Timeout to the time when the SAML Assertion times out. The maximum is 720 minutes.
-
Enter the Max Authentication Age (seconds) to set the maximum amount of time that can elapse before a user is required to reauthenticate during a new login attempt. This applies for both SP-initiated and IDP-initiated login. Set this field to -1 to disable this feature.
-
From the SAML NameID Attribute drop-down list, select UserID.
-
From the SAML Signing Certificate the drop-down list, select the signing certificate.
-
Select Sign Complete SAML Response.
-
Optional: Select Respond Immediately for Unsuccessful Responses to return to the application immediately after a login failure, rather than allow user to try again with a different userID.
-
Deselect Enable Go Back Button if you do not want users to be able to go back to the AppDynamics login page to log in.
-
Select Show Default Assertion Consumer URL Service in the My Profile. When selected, the Default Assertion Consumer URL appears in a user's My Profile page in addition to relay states and Alternative Assertion Consumer URLs.
-
Optional. Add Alternative Assertion Consumer Service URLs, as follows:
- Click Add.
- Enter a Name.
- Enter a URL Value.
- Select Show in My Profile to display the Alternative Consumer Service URL in a user's My profile page.
- Optional. Add an Application Logo.
- Click Add.
- Repeat these steps to add more Alternative Assertion Consumer Service URLs.
-
Include the following user attributes in the SAML assertion, as follows:
Add a DisplayName SAML attribute:
- Under SAML Attributes, click Add. The SAML Attributes dialog box appears.
- In the Name field enter DisplayName.
- Click Add next to Value(s).
- In the Values field type < and select <First Name> add a space and type ** <** and select <LastName>.
Add an email SAML attribute:
- Under SAML Attributes, click Add. The SAML Attributes dialog box appears.
- In the Name field enter Email.
- Click Add next to Value(s).
- In the Values field type < and select <email> from the drop-down list.
Add a username SAML attribute:
- Under SAML Attributes, click Add. The SAML Attributes dialog box appears.
- In the Name field enter Username.
- Click Add next to Value(s).
- In the Values field type < and select ** <User ID>**.
- Click Add next to Value(s).
-
Click Submit.
Step 4: Add a resource rule
Step 5: Configure AppDynamics for Identity as a Service authentication
- Log in to your AppDynamics tenant account as an administrator.
- Click the settings icon and select Administration from the Settings menu. The Administration page appears.
- Click the Authentication Provider tab. The Authentication Provider page appears.
- In the Login URL field, enter the Single Sign-On URL you copied in Step 1: Copy the SAML Configurations from Identity as a Service.
- For the Login URL Method, select POST.
- In the Logout URL field, enter the Single Logout URL you copied in Step 1: Copy the SAML Configurations from Identity as a Service.
- Click the edit icon next to Identity Provider Certificate and paste the contents of the certificate your downloaded in Step 2: Export the signing certificate from Identity as a Service.
- In the SAML Attribute Mappings section, do the following:
- In the Username Attribute field, enter Username.
- In the Display Name Attribute field, enter DisplayName.
- In the Email Attribute field, enter Email.
- Click Save.
Step 6: Test the integration
Testing Service Provider Login
- Open a Web browser and enter the URL for your AppDynamics account. You are directed to Identity as a Service.
- Enter your AppDynamics account User ID and click Next.
- Respond to the second-factor authentication challenge. If you respond successfully, you are logged in to the AppDynamics Home page.
Testing Identity as a Service redirect log in
- Log in to your Identity as a Service account.
- Go to your My Profile page if you are not already there.
- Under Applications, click AppDynamics.
- Respond to the second-factor authentication challenge. If you respond successfully, you are logged in to AppDynamics.