Skip to main content

Create a service account

For secure authentication and access, you must:

  • Create a Service Account to provide a dedicated, secure identity for the DoiT integration.

  • Create an application key to authenticate the service account, allowing DoiT to integrate securely with Datadog. DoiT needs certain permissions to analyze your Datadog data. Some are required while others are optional, depending on your requirements. You can add these permissions when you create an application key. You can grant the following authorization scopes:

    • (Required) billing_read and usage_read: Grants permissions to the Cost Summary and Cost Chargebacks data. See also Cost Details.

    • (Optional) hosts_read: Allows DoiT to access the data used to populate DoiT Cloud Analytics and the Daily agent cost per provider widget. See also Datadog host costs.

    • (Optional) dashboards_read: Allows DoiT to access the data used to populate DoiT Cloud Analytics and the Daily dashboard popularity trend widget. See also Daily dashboard popularity trend.

  1. In the Datadog platform, go to Organization Settings.

  2. Navigate to IDENTITY & ACCOUNTS and select Service Accounts.

  3. Create a new Service Account.

    1. In the Name field, enter a name that fits the usage, for example, DoiT Account.

    2. In Email, enter your email address.

    3. From the Assign Roles list, select the role you created earlier, for example, DoiT Connector Role.

    4. Select Create Service Account.

  4. Navigate to ACCESS and select Application Keys.

  5. Select +New Key.

  6. In Name, enter a name that fits the usage, for example, DoiT Usage Monitor.

  7. Select Create Key. A new application key is created.

  8. You can grant the following authorization scopes.

    1. From Scope, select Edit. The Edit Key Scope dialog is displayed.

    2. In Filter Scopes, search for the following scopes:

      • (Required) billing_read
      • (Required) usage_read
      • (Optional) hosts_read
      • (Optional) dashboards_read

      Select the checkboxes next to the scopes to apply them.

    3. Select Save.

      Datadog connection custom role

    Caution

    The key is only visible once. Please ensure you copy the key before closing the browser window.

  9. Select Finish.

  10. Go to the DoiT console and in Application key, paste the application key you created above.

  11. Select Next to move to the next step.

    Datadog connection custom role