# 활성화된 트레이스 가져오기
trace = Datadog::Tracing.active_trace

# 필수 사용자 ID 태그 설정
Datadog::Kit::Identity.set_user(trace, id: 'd131dd02c56eeec4')

# 또는 선택적 사용자 모니터링 태그 설정
Datadog::Kit::Identity.set_user(
  trace,

  # 필수 ID
  id: 'd131dd02c56eeec4',

  # 의미가 정해진 선택적 태그들
  name: 'Jean Example',
  email:, 'jean.example@example.com',
  session_id:, '987654321',
  role: 'admin',
  scope: 'read:message, write:files',

  # 선택적인 자유 형식 태그
  another_tag: 'another_value',
)

# 활성 추적 가져오기
trace = Datadog::Tracing.active_trace

# 필수 사용자 ID 태그 설정
trace.set_tag('usr.id', 'd131dd02c56eeec4')

# 의미가 정해진 선택적 사용자 모니터링 태그 설정
trace.set_tag('usr.name', 'Jean Example')
trace.set_tag('usr.email', 'jean.example@example.com')
trace.set_tag('usr.session_id', '987654321')
trace.set_tag('usr.role', 'admin')
trace.set_tag('usr.scope', 'read:message, write:files')

# 자유 형식 태그 설정
trace.set_tag('usr.another_tag', 'another_value')

import datadog.trace.api.EventTracker;
import datadog.trace.api.GlobalTracer;

public class LoginController {

    private User doLogin(String userName, String password) {
        // 여기서 userName과 password 크리덴셜을 기반으로 사용자를 가져옵니다.
        User user = checkLogin(userName, password);

        Map<String, String> metadata = new HashMap<>();
        metadata.put("email", user.getEmail());
        metadata.put("usr.login", userName);

        // 시스템에 여러 "테넌트"가 있는 경우 해당 테넌트를 입력해 주세요. 테넌트는 사용자 환경/그룹입니다
        metadata.put("usr.org", usr.getTenant());

        // 사용자 인증 성공 이벤트를 추적합니다.
        GlobalTracer
            .getEventTracker()
            .trackLoginSuccessEvent(user.getId(), metadata);

    }
}

import datadog.trace.api.EventTracker;
import datadog.trace.api.GlobalTracer;

public class LoginController {

    private User doLogin(String userName, String password) {
        // 여기서 userName/password 크리덴셜을 기반으로 사용자를 가져옵니다
        User user = checkLogin(userName, password);

        // 함수가 null을 반환하는 경우 - 사용자가 존재하지 않습니다
        boolean userExists = (user != null);
        String userId = null;
        Map<String, String> metadata = new HashMap<>();
        metadata.put("usr.login", userName);
        if (userExists != null) {
            userId = getUserId(userName)
            metadata.put("email", user.getEmail());
        } else {
            userId = userName;
        }

        // 사용자 인증 오류 이벤트를 추적합니다
        GlobalTracer
            .getEventTracker()
            .trackLoginFailureEvent(userId, userExists, metadata);
    }
}

import datadog.trace.api.EventTracker;
import datadog.trace.api.GlobalTracer;

public class LoginController {

    private User doSignup(String userId, String email) {
        // 여기서 사용자 계정을 생성합니다
        User user = createUser(userId, email);

        Map<String, String> metadata = new HashMap<>();
        metadata.put("usr.id", user.getId());

        // 사용자 가입 이벤트를 추적합니다
        GlobalTracer
            .getEventTracker()
            .trackCustomEvent("users.signup", metadata);
    }
}

using Datadog.Trace.AppSec;

void OnLogonSuccess(string userId, string login...)
{
    // 메타데이터는 선택사항입니다.
    var metadata = new Dictionary<string, string>()
    {
        { "usr.login", login }
    };
    EventTrackingSdk.TrackUserLoginSuccessEvent(userId, metadata);

    // ...
}

using Datadog.Trace.AppSec;

void OnLogonFailure(string userId, string login, bool userExists, ...)
{
    // 사용자 ID를 제공할 수 없는 경우 고유한 사용자 식별자(사용자 이름, 이메일 등)를 사용할 수 있습니다
    // 메타데이터는 선택사항입니다
    var metadata = new Dictionary<string, string>()
    {
        { "usr.login", login }
    };
    EventTrackingSdk.TrackUserLoginFailureEvent(userId, userExists, metadata);

    // ...
}

void OnUserSignupComplete(string userId, ...)
{
    // 메타데이터 파라미터는 선택 사항이지만 "usr.id"를 추가합니다
    var metadata = new Dictionary<string, string>()
    {
        { "usr.id", userId }
    };
    // 사용자 가입을 추적하기 위해 사용자 정의 비즈니스 로직 추적을 활용합니다
    EventTrackingSdk.TrackCustomEvent("users.signup", metadata);

    // ...
}

import (
  "gopkg.in/DataDog/dd-trace-go.v1/appsec" // 1.x
  // "github.com/DataDog/dd-trace-go/v2/appsec" // 2.x
)

func handler(w http.ResponseWriter, r *http.Request) {
  metadata := make(map[string]string) /* 선택적 추가 이벤트 메타데이터*/
  userdata := /* 선택적 추가 사용자 데이터 */

  metadata["usr.login"] = "user-email"

  // 로그인 성공 여부를 추적하고 `my-uid`를 사용자의 고유 식별자(숫자, 사용자 이름, 이메일 등)로 바꿉니다
  if appsec.TrackUserLoginSuccessEvent(r.Context(), "my-uid", metadata, userdata) != nil {
    // 해당 사용자 ID가 차단되었으며 핸들러는 최대한 빨리 중단되어야 합니다
    // 차단 응답은 AppSec 미들웨어에 의해 전송됩니다
    return
  }
}

import (
  "gopkg.in/DataDog/dd-trace-go.v1/appsec" // 1.x
  // "github.com/DataDog/dd-trace-go/v2/appsec" // 2.x
)

func handler(w http.ResponseWriter, r *http.Request) {
  exists := /* 주어진 사용자 ID가 존재하는지 여부 */
  metadata := make(map[string]string) /* 선택적 추가 이벤트 메타데이터 */
  metadata["usr.login"] = "user-email"

  // `my-uid`를 사용자의 고유 식별자(숫자, 사용자 이름, 이메일...)로 바꿉니다
  appsec.TrackUserLoginFailureEvent(r.Context(), "my-uid", exists, metadata)
}

import (
  "gopkg.in/DataDog/dd-trace-go.v1/appsec" // 1.x
  // "github.com/DataDog/dd-trace-go/v2/appsec" // 2.x
)

func handler(w http.ResponseWriter, r *http.Request) {
  metadata := map[string]string{"usr.id": "my-uid"}

  // 사용자 가입을 추적하기 위해 사용자 정의 비즈니스 로직 추적을 활용합니다
  appsec.TrackCustomEvent(r.Context(), "users.signup", metadata)
}

require 'datadog/kit/appsec/events'

trace = Datadog::Tracing.active_trace
# `my_user_id`를 사용자의 고유 식별자(숫자, 사용자 이름, 이메일...)로 바꾸세요
Datadog::Kit::AppSec::Events.track_login_success(trace, user: { id: 'my_user_id' }, { 'usr.login': 'my_user_email' })

require 'datadog/kit/appsec/events'
trace = Datadog::Tracing.active_trace

# `my_user_id`를 사용자의 고유 식별자(숫자, 사용자 이름, 이메일...)로 바꾸세요

# 사용자가 존재하는 경우
Datadog::Kit::AppSec::Events.track_login_failure(trace, user_id: 'my_user_id', user_exists: true, { 'usr.login': 'my_user_email' })

# 사용자가 존재하지 않는 경우
Datadog::Kit::AppSec::Events.track_login_failure(trace, user_id: 'my_user_id', user_exists: false, { 'usr.login': 'my_user_email' })

require 'datadog/kit/appsec/events'
trace = Datadog::Tracing.active_trace

# `my_user_id`를 사용자의 고유 식별자(숫자, 사용자 이름, 이메일...)로 바꾸세요

# 사용자 가입을 추적하기 위해 사용자 정의 비즈니스 로직 추적을 활용합니다
Datadog::Kit::AppSec::Events.track('users.signup', trace, nil, { 'usr.id': 'my_user_id'})

<?php
\datadog\appsec\track_user_login_success_event($id, ['usr.login' => $email])
?>

<?php
// 숫자로 된 사용자 ID가 없는 경우 대신 고유한 문자열(사용자 이름, 이메일 등)을 사용자 ID로 사용할 수 있습니다
// 값이 공격자나 IP가 아닌, 각 사용자마다 고유하도록 설정해야 합니다
\datadog\appsec\track_user_login_failure_event($id, $exists, ['usr.login' => $email])
?>

<?php
\datadog\appsec\track_custom_event('users.signup', ['usr.id' => $id]);
?>

const tracer = require('dd-trace')

// 컨트롤러에서:
const user = {
id: 'user-id', // ID는 필수입니다. ID가 없는 경우, 사용자 이름, 이메일 등 어떤 고유 식별자라도 사용 가능합니다.
  email: 'user@email.com' // 다른 필드는 선택사항입니다
}
const user = 'user-id' // 사용자를 ID 로만 나타낼 수도 있습니다
const login = 'user@email.com'
const metadata = { 'key': 'value' } // 임의의 필드를 추가할 수 있습니다

// 성공적인 사용자 인증 이벤트를 기록합니다
// 사용자 및 메타데이터는 선택 사항입니다
tracer.appsec.eventTrackingV2.trackUserLoginSuccess(login, user, metadata)

const tracer = require('dd-trace')

// 컨트롤러에서:
const login = 'user-id' // 사용자가 로그인하는 데 사용하는 문자열
const userExists = true // 예를 들어 사용자 로그인이 데이터베이스에 있는 경우
const metadata = { 'key': 'value' } // 임의의 필드를 추가할 수 있습니다

// 실패한 사용자 인증 이벤트를 기록합니다
// userExists는 선택 사항이며, 기본값은 false입니다
// 메타데이터는 선택 사항입니다.
tracer.appsec.eventTrackingV2.trackUserLoginFailure(login, userExists, metadata)

const tracer = require('dd-trace')

// 컨트롤러에서:
const eventName = 'users.signup'
const metadata = { 'usr.id': 'user-id' }

tracer.appsec.trackCustomEvent(eventName, metadata)

const tracer = require('dd-trace')

// 컨트롤러에서:
const user = {
  id: 'user-id',
  email: 'user@email.com'
} // 이전과 동일하지만 이제 객체는 선택 사항입니다. 그래도 사용자 ID를 제공하면 침해 이후 활동 연관성 파악에 도움이 됩니다

const login = 'user@email.com' // 새로운 필수 인수

const metadata = {
//  'usr.login': 'user@email.com', 더 이상 메타데이터에 포함할 필요가 없습니다. 반드시 메인 인수로 전달되어야 합니다
  'key': 'value'
}

// tracer.appsec.trackUserLoginSuccessEvent(user, metadata) // 더 이상 사용되지 않음
tracer.appsec.eventTrackingV2.trackUserLoginSuccess(login, user, metadata)

const tracer = require('dd-trace')

// 더 이상 사용되지 않는 메서드가 있는 컨트롤러에서:
const userId = 'user-id' // 더 이상 필수는 아니지만 사용 가능한 경우 도움이 됩니다.
const login = 'user@email.com' // 새로운 필수 인수
const userExists = true
const metadata = {
//  'usr.login': 'user@email.com', 더 이상 메타데이터에 포함할 필요가 없습니다. 반드시 메인 인수로 전달되어야 합니다
  'usr.id': userId, // 로그인 실패를 나머지 사용자 활동과 연관시키는 데 도움이 됩니다.
  'key': 'value'
}

// tracer.appsec.trackUserLoginFailureEvent(userId, userExists, metadata) // 더 이상 사용되지 않음
tracer.appsec.eventTrackingV2.trackUserLoginFailure(login, userExists, metadata)

from ddtrace.appsec.trace_utils import track_user_login_success_event
from ddtrace import tracer
metadata = {"usr.login": "user@email.com"}
# name, email, scope, role, session_id, propagate는 선택 인수이며 
# 기본값은 None입니다(단, propagate 기본값은 True).
# 이 인수들은 set_user() 함수에 전달됩니다.
track_user_login_success_event(tracer, "userid", metadata)

from ddtrace.appsec.trace_utils import track_user_login_failure_event
from ddtrace import tracer
metadata = {"usr.login": "user@email.com"}
# exists는 실패한 로그인 사용자가 시스템에 존재하는지 여부를 나타냅니다.
exists = False
# 숫자로 된 사용자 ID를 사용할 수 없는 경우, 고유 식별자(사용자 이름, 이메일 등)를 사용하면 됩니다
track_user_login_failure_event(tracer, "userid", exists, metadata)

from ddtrace.appsec.trace_utils import track_custom_event
from ddtrace import tracer
metadata = {"usr.id": "userid"}
event_name = "users.signup"
track_custom_event(tracer, event_name, metadata)