1. In Dashboard Server navigate to the right-hand menu ☰ > system > Integrations

2. Under Integrations click Web API.

   

3. Click the authentication type Simple

   

4. In the service name box type in a suitable name, e.g. PagerDuty

5. The base URL should be the current PagerDuty API URL, for example:
   https://api.PagerDuty.com/

6. Under default headers click add

   

7. Add the following information to the boxes as shown below:

   First box (name): authorization

   Second box (value): Token token=API token from PagerDuty

   

   You can create an API access key (token) by logging in to PagerDuty > Integrations > API Access Keys > Create New API Key, and ticking Read-only API Key. See Generating API Keys

   Copy the API access key from PagerDuty before closing the window:

   

   Paste into the authorization value box in Dashboard Server, prepended by Token token= as shown above.

8.  Click Save.

1. Add a new provider in Dashboard Server Community Edition

1. In Dashboard Server navigate to the right-hand menu ☰ > system > Integrations

2. Under Integrations click Web API

3. Click on the authentication type OAuth

4. In the service name box type in a suitable name for this provider. This name is used to create a URL so it is best to avoid spaces and non-alphanumeric characters., e.g. GoogleAnalytics.

5. Leave the grant type as authorization code

6. The base URL should be https://www.googleapis.com/

7. The authorization URL should https://accounts.google.com/o/oauth2/v2/auth?access_type=offline&include_granted_scopes=true

   The parameters appended to the authorization URL allow Dashboard Server to continue to access the API after the first hour. Without them Dashboard Server can't reauthorize the provider automatically after the first token has expired. access_type=offline - requests that the API return a refresh token to keep the connection alive. The token expires every hour and without a refresh token, you have to manually reauthorize the provider each time. include_granted_scopes=true - allows the refreshed token to have the same permissions as the original request when the user was present.

8. The token URL should be https://oauth2.googleapis.com/token

   At this point we need to save the provider and follow the next steps to obtain a client ID and secret from the Google Developer Console, after which we will return to complete these provider details.

9. Click save to save the provider.

   

10. Copy the redirect url displayed. This will be used in the next section.

    

2. Configure the Google Developer Console

1. Visit the Google Developer Console
2. Create a new project as required.
3. Select Create Credentials > OAuth Client ID
4. Select Web Application

5. Enter the following:

   Name: This can be anything

   Authorized JavaScript origins: Should be the hostname of your SquaredUp server including the http/https

   Authorized Redirect URIs: Should be the redirect url copied from Dashboard Server right-hand menu ☰ > system > web api. It will be your Dashboard Server instance followed by /ext-core-webapi/callback/GoogleAPIProvider where GoogleAPIProvider is the name of the provider you created.

   For example: https://SquaredUpServer/SquaredUpv5/ext-core-webapi/callback/GoogleAnalytics

   Where SquaredUpServer is the name of the server where Dashboard Server is installed.

6. Click save/create
7. Copy the client ID and secret to use in the next section.

3. Complete the provider setup in Dashboard Server

1. In Dashboard Server navigate to the right-hand menu ☰ > system > Integrations

2. Click on the provider you created earlier to edit it.
3. Paste in the client id and secret copied from the Google Developer Console.
4. Paste in the relevant authorization scope from OAuth 2.0 Scopes for Google APIs. For example, for Google Analytics it should be the URL scope listed for 'View your Google Analytics data' which is https://www.googleapis.com/auth/analytics.readonly
5. Click save. You will be redirected to Google to login and authorize and then back to Dashboard Server.

If the configuration is correct then you will see a green tick.

If the provider is not authorized it could be that some of the provider configuration is incorrect (for example the username, password, secret etc), or if you use a proxy it could be that the proxy is not configured. See How to configure Dashboard Server to use a proxy

You can now add Web API tiles using this Google API provider, see How to use the Web API tile with Google APIs, such as Google Analytics

1. In Dashboard Server navigate to the right-hand menu ☰ > system > Integrations

2. Under Integrations click Web API.

   

3. Click the authentication type Simple

   

4. In the service name box type in a suitable name, e.g. Pingdom

5. The base URL should be the current Pingdom API URL, for example:
   https://api.pingdom.com/api/3.1/
   We recommend you include the API version here in the base URL, so if the API version changes you only need to update it here, rather than in every tile.

6. Under default headers click add 

   

7. Add the following:
   name: authorization
   value: Bearer<API token from Pingdom>
   

   You can create an API key (token) by logging in to Pingdom > Settings > Pingdom API > Add API token

   Enter a Name, leave the Access Level set to Read access and click Generate token.

   Copy the API token from Pingdom before closing the window:

   

   Paste the API token into the authorization value box in Dashboard Server, prepended by the word Bearer and a space

   

8.  Click Save.