Ownership

One of the most powerful features of Cortex is the ability to track ownership for entities. This powers many features, including automated notifications to owners when a new Initiative is created.

Entity descriptor

The x-cortex-owners field allows you to define a list of owners of type email or group.

x-cortex-owners:
  - type: email
    email: user@example.com
    description: This is a description for this owner # optional
  # Groups can be pulled from various integrations
  - type: group
    name: my-team
    provider: CORTEX
    description: This is a description for this owner # optional

For groups, we support the following integrations:

• Azure Active Directory
• BambooHR
• GitHub
• GitLab
• Google
• Okta
• Opsgenie
• ServiceNow
• Workday

The value of provider is the name of the integration that the group is coming from. The available list is:

• ACTIVE_DIRECTORY
• BAMBOO_HR
• CORTEX: Use when referring to a Cortex managed team
• GITHUB
• GITLAB
• GOOGLE
• OKTA
• OPSGENIE
• SERVICE_NOW
• WORKDAY

name is a case-sensitive field that refers to the following:

• if your provider is CORTEX, name corresponds to the x-cortex-tag for the Cortex team you want to identify as an owner
• otherwise, name corresponds to the upstream identifier of your owner from your integration

Discovery

AWS

Cortex can automatically discover ownership for your AWS resources using their owner tag. To enable this, make sure that your AWS resources have an owner tag matching the x-cortex-tag of the corresponding Cortex team and enable the “Sync ownership from AWS” toggle in Settings → Entities → Teams.

caution

We sync ownership from AWS every day at 6 am UTC.