For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/ko/api/latest/security-monitoring/activate-an-entity-context-sync-integration.md. A documentation index is available at /llms.txt.
Language
Datadog site

엔터티 컨텍스트 동기화 통합 활성화

경고Note: This endpoint is in preview and is subject to change. If you have any feedback, contact Datadog support.
POSThttps://api.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.us3.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.us5.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.datadoghq.eu/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.ap1.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.ap2.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.uk1.datadoghq.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.ddog-gov.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activatehttps://api.us2.ddog-gov.com/api/v2/security_monitoring/configuration/integration_config/{integration_type}/activate

개요

수동으로 자격 증명을 입력할 필요가 없는 소스 유형에 대해 엔터티 컨텍스트 동기화 통합을 활성화합니다(예: Entra ID). 이 유형의 통합이 이미 존재하는 경우 중복 생성 대신 해당 통합이 반환되며(비활성화된 경우 먼저 다시 활성화됩니다).

This endpoint requires the manage_integrations permission.

OAuth apps require the manage_integrations authorization scope to access this endpoint.

인수

경로 파라미터

이름
유형
설명
integration_type [required]
string

The integration type to activate (for example, entra_id).

요청

Body Data

활성화할 통합에 대한 선택적 구성 재정의입니다.

항목
유형
설명
data
object

비밀 정보가 필요하지 않은 소스 유형에 대해 엔터티 컨텍스트 동기화 통합을 활성화하기 위한 요청 본문입니다.

응답

OK

Response containing a single entity context sync configuration.

항목
유형
설명
data [required]
object

An entity context sync configuration.

코드 예시

엔터티 컨텍스트 동기화 통합 활성화
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF
# Path parameters
export integration_type="entra_id"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X POST "https://api.${DD_SITE}/api/v2/security_monitoring/configuration/integration_config/${integration_type}/activate" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "data": {
    "attributes": {
      "name": "My Entra ID Integration"
    },
    "type": "activate_entra_id_request"
  }
}
EOF