IAM policy reference

  • Reference
  • 1-min read
  • Published Mar 25, 2021

The following is a complete reference of IAM permissions and corresponding conditions applicable to Dynatrace services. Refer to it when you need to define access policies based on a fine-grained set of permissions and conditions that can be enforced per service.

environment

Environment and management zone user permissions. See Migrate role-based permissions to Dynatrace IAM for more information.

Role IAM permissions work the same way as classic roles do, which means that the environment:roles:viewer permission is a part of any other role permission. For example, a policy granting environment:roles:manage-settings permission also allows a user to access the web UI.

environment:roles:viewer

Grants user the Access environment permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on the management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:manage-settings

Grants user the Change monitoring settings permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:agent-install

Grants user the Download/install OneAgent permission. Users who have this permission assigned are also able to view monitoring data for all management zones.

environment:roles:view-sensitive-request-data

Grants user the View sensitive request data permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:configure-request-capture-data

Grants user the Configure capture of sensitive data permission. Users who have this permission assigned are also able to view monitoring data for all management zones.

environment:roles:replay-sessions-without-masking

Grants user the Replay session data without masking permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:replay-sessions-with-masking

Grants user the Replay session data permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:manage-security-problems

Grants user the Manage security problems permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:view-security-problems

Grants user the View security problems permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

environment:roles:logviewer

Grants user the View logs permission.

conditions:

  • environment:management-zone - A string that uniquely identifies a management zone. Applies the permission on management zone level for the specified management zone.
    operators: IN, startsWith, NOT startsWith, =, !=, MATCH

settings

Settings service

settings:objects:read

Enables reading of settings objects belonging to the schema

conditions:

  • settings:schemaId - A string that uniquely identifies a single settings schema. The identifier of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the object's schemaId property matches.
    operators: IN, =, !=, startsWith, NOT startsWith
  • shared:app-id - A string that matches an app identifier. Only applicable to objects of schemas that have been added via apps. The condition will match if the object's app-id property matches.
    operators: IN, NOT IN, startsWith, NOT startsWith, =, !=
  • settings:schemaGroup - A schema group that allows to address multiple individual schemas at once. The group of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the schema of the object has a schemaGroup property that matches.
    operators: IN, =
  • settings:entity.hostGroup - The host group attribute of an entity for which a setting is stored. This is e.g. useful to grant access to settings scopes of all hosts which belong to the same host group.
    operators: IN, =, !=
  • settings:scope - The exact scope identifier a setting object has or will have. This condition allows to grant access to the scope of e.g., an individual host. In this case the scope equals the entity identifier, e.g. HOST-48B8F52F33098830.
    operators: IN, =, !=, startsWith, NOT startsWith
  • environment:management-zone - The name of a management zone. This condition is applicable to either: any settings object that is allowed on the scope of an entity that can be matched into a management zone or settings objects of the schemas builtin:alerting.maintenance-window, builtin:alerting.profile, builtin:anomaly-detection.metric-events, builtin:monitoring.slo and builtin:problem.notifications.
    operators: IN, =, startsWith, MATCH
  • settings:dt.security_context - The name of a security context. This condition is applicable to any settings object that is allowed on the scope of an entity that can have a security context assigned.
    operators: IN, =, startsWith

settings:objects:write

Enables writing of settings objects belonging to the schema

conditions:

  • settings:schemaId - A string that uniquely identifies a single settings schema. The identifier of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the object's schemaId property matches.
    operators: IN, =, !=, startsWith, NOT startsWith
  • shared:app-id - A string that matches an app identifier. Only applicable to objects of schemas that have been added via apps. The condition will match if the object's app-id property matches.
    operators: IN, NOT IN, startsWith, NOT startsWith, =, !=
  • settings:schemaGroup - A schema group that allows to address multiple individual schemas at once. The group of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the schema of the object has a schemaGroup property that matches.
    operators: IN, =
  • settings:entity.hostGroup - The host group attribute of an entity for which a setting is stored. This is e.g. useful to grant access to settings scopes of all hosts which belong to the same host group.
    operators: IN, =, !=
  • settings:scope - The exact scope identifier a setting object has or will have. This condition allows to grant access to the scope of e.g., an individual host. In this case the scope equals the entity identifier, e.g. HOST-48B8F52F33098830.
    operators: IN, =, !=, startsWith, NOT startsWith
  • environment:management-zone - The name of a management zone. This condition is applicable to either: any settings object that is allowed on the scope of an entity that can be matched into a management zone or settings objects of the schemas builtin:alerting.maintenance-window, builtin:alerting.profile, builtin:anomaly-detection.metric-events, builtin:monitoring.slo and builtin:problem.notifications.
    operators: IN, =, startsWith, MATCH
  • settings:dt.security_context - The name of a security context. This condition is applicable to any settings object that is allowed on the scope of an entity that can have a security context assigned.
    operators: IN, =, startsWith

settings:schemas:read

Enables reading settings schemas

conditions:

  • settings:schemaId - A string that uniquely identifies a single settings schema. The identifier of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the schema's schemaId property of the schema matches.
    operators: IN, =, !=, startsWith, NOT startsWith
  • shared:app-id - A string that matches an app identifier. Only applicable to objects of schemas that have been added via apps. The condition will match if the object's app-id property matches.
    operators: IN, NOT IN, startsWith, NOT startsWith, =, !=
  • settings:schemaGroup - A schema group that allows to address multiple individual schemas at once. The group of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the schema's schemaId property of the schema matches.
    operators: IN, =

settings:objects:admin

Enables using admin-mode to access, change ownership and share permissions of any object. Admin-mode only bypasses the ownership check - so to do anything useful, settings:objects:read and/or settings:objects:write are needed as well.

conditions:

  • settings:schemaId - A string that uniquely identifies a single settings schema. The identifier of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the object's schemaId property matches.
    operators: IN, =, !=, startsWith, NOT startsWith
  • shared:app-id - A string that matches an app identifier. Only applicable to objects of schemas that have been added via apps. The condition will match if the object's app-id property matches.
    operators: IN, NOT IN, startsWith, NOT startsWith, =, !=
  • settings:schemaGroup - A schema group that allows to address multiple individual schemas at once. The group of a schema can either be found via the dedicated schema endpoint in the Dynatrace Environment API or in the info box of a settings screen. The condition will match if the schema of the object has a schemaGroup property that matches.
    operators: IN, =
Related tags
Dynatrace Platform