user_badge 웹훅 페이로드에 사용자 이름을 포함할 수 있을까요?

user_badge 웹훅에 user_id와 함께 username도 포함될 수 있을까요? 현재 user_badge 이벤트의 페이로드는 다음과 같습니다:

{
  "user_badge": {
    "id": 123456,
    "granted_at": "2026-09-25T14:54:42.073Z",
    "created_at": "2026-09-26T05:34:12.965Z",
    "post_id": 234567,
    "post_number": 1,
    "badge_id": 123,
    "user_id": 456,
    "granted_by_id": -1,
    "topic_id": 56789
  }
}

user_id(그리고 -1이 아닌 경우 granted_by_id)에 해당하는 사용자를 조회하려면 /admin/users/{user_id}.json에 대한 추가 호출이 필요합니다. 이는 추가 요청을 요구할 뿐만 아니라, 제 판단에 따르면 관리자 권한도 필요합니다.

관리자 권한 없이 API 키를 사용하여 주어진 user_id의 username을 조회하는 방법이 있을까요?

특정 배지가 수여될 때 트리거되기를 바라는 외부 서비스를 구축 중인데, 사용자명이 필요하지만 배지 웹훅은 사용자 ID만 반환하기 때문입니다. :confused:

참고로, 비표준 웹훅을 사용하거나 추가 데이터가 필요할 때 제 우회 방법은 Workflows를 통해 처리한 후 그것을 n8n으로 보내는 것입니다.

참고로, 사용자 ID에서 사용자 이름을 가져오는 것은 API 호출 한 번이면 됩니다. 단, 순식간에 수천 개의 배지를 수동으로 부여하는 상황이 아니라면 기본 API 제한 내에서 문제없이 사용할 수 있을 것입니다.

감사합니다! Workflows를 살펴볼게요.

좋은 소식입니다! /admin/users/{user_id}.json(관리자 권한 필요)이 아닌, 관리자 권한이 필요 없는 API 키로 이 작업을 수행할 수 있는 그 API 호출에 대한 세부 정보를 알려 주실 수 있을까요? 관리자 권한이 필요 없는 API 키로 이 작업을 수행할 수 있는 엔드포인트를 찾을 수 없었습니다.

관리자 API 키는 어떤 문제가 있나요? 이건 백그라운드 작업인 거죠?

최소 권한 원칙(Principle of Least Privilege) 때문입니다. 이 외부 서비스는 다른 서버에서 실행되며, 자신의 작업을 수행하기 위해 Discourse에 대한 읽기 전용 접근 권한만 필요합니다. 인프라 전반에 걸쳐 떠다니는 마스터 키가 적을수록 좋습니다.

여기서 흥미로운 점은, login_required가 선택되지 않은 경우 공개 필드만 표시하는 id 기반 사용자 조회용 공개 엔드포인트가 왜 없는지입니다. 유용하지 않을까요? 왜 만들어지지 않았는지 궁금합니다. 아니면 로그인한 사용자만 이러한 권한을 가질 수 있는 것일 수도 있지만, 어쨌든 관리자 엔드포인트를 사용하지 않고도 이를 접근할 수 있는 방법이 있어야 합니다…

@burke 더 번거로운 우회 방법은 /groups/trust_level_0/members.json(또는 더 구체적인 그룹)을 확인하고 id를 통해 사용자를 찾는 것입니다. 해당 응답에는 사용자 이름도 포함되어 있기 때문입니다.

이는 모든 상황과 목적에서 사용자 ID가 기본적으로 Discourse 내부의 관례이기 때문이며, 전반적으로 훨씬 더 두드러지는 사용자 이름을 의존하도록 기대하고 있기 때문입니다.

이로써 원래의 요청으로 돌아가게 됩니다. 웹훅은 해당 개념을 따르도록 사용자 ID가 아니라 사용자 이름을 전송해야 합니다.

동의합니다! 이것이 최선의 해결책인 것 같습니다. username과 granted_by_username을 추가하고 user_id와 granted_by_id를 비추천(deprecate) 처리하면 비파괴적(non-breaking) 전이 기간을 가질 수 있습니다.

현재 배지가 시스템(즉, 자동으로)에 의해 변경되면 웹훅은 granted_by_id가 -1인 값을 반환합니다. 그렇다면 granted_by_username의 동등한 값은 무엇일까요?

  • "" (빈 문자열)
  • "<system>" (사용자명이 될 수 없는 마법 값)
  • null
  • 아무것도 없음 – 즉, 시스템 주도 이벤트인 경우 페이로드에서 granted_by_username을 생략

null이거나 아무것도 없는 경우가 가장 합리적일 것 같습니다.

사실 -1은 다른 모든 사용자처럼 사용자명(보통 system)이 연관된 유효한 사용자 ID입니다. 다르게 취급할 이유는 없습니다.

여기서 확인해 보세요: https://meta.discourse.org/u/system/summary

아, 알려주셔서 감사합니다. 그렇다면 자동화된 변경 사항의 경우 granted_by_username은 단순히 "system"이 되겠군요.

@putty Workflows를 살펴보고 있었습니다. 배지 이벤트에 사용자 이름이 포함되지 않는 한(또는 Workflows의 필터를 사용하여 내 서비스가 알아야 할 변경 사항만 POST하도록 설정할 수 있으므로 무관할 수도 있지만), 이는 훌륭한 대안이 될 것 같습니다! 다시 한번 감사합니다!

웹훅의 경우, 페이로드에 시크릿을 사용하여 HMAC-SHA256 서명을 생성한 X-Discourse-Event-Signature가 있어 발신자를 검증할 수 있습니다. Workflows에서 HTTP 요청(POST)을 서명하는 방법이 있을까요? 아직 찾지 못한 것일 수도 있습니다. “시크릿으로 요청 서명” 같은 설정을 켜고 시크릿을 제공할 수 있기를 바랐습니다. 제가 본 가장 가까운 방법은 header_auth 자격 증명을 추가하여 헤더에 시크릿을 보내는 것입니다(예: X-Discourse-Event-Secret: Discourse Rocks!). 아무것도 없는 것보다는 낫지만, 시크릿 자체를 보내는 대신 시크릿을 사용한 서명이 더 바람직할 것입니다.

불행히도 저도 시크릿을 헤더를 통해 전송하는 방식을 사용하고 있습니다. 아마 @j.jaffeux 님이 더 나은 대안을 제안해 주실 수 있을 텐데, 그렇다면 저도 바로 그 방식을 채택하겠습니다. :sweat_smile:

서명을 계산하기 위한 코드 단계를 만들었습니다. Web Crypto API를 사용하면 HMAC-SHA256을 훨씬 쉽게 계산할 수 있지만, 이는 Promise를 사용하므로 eval 내부에서는 작동하지 않습니다. 그래서 AI에게 HMAC-SHA256을 계산하는 네이티브 JavaScript 메서드를 만들어 달라고 요청했고, 키 secret와 그 값인 시크릿을 변수로 추가하여 다음과 같은 코드 스크립트를 작성했습니다:

// Available variables:
//   $input.item.json       - current item's JSON data
//   $input.all()           - array of all input items
//   $json                  - shortcut for $input.item.json
//   $("NodeName").item     - access the paired item from another node
//   $vars.KEY              - workflow variables
//   $site_settings.NAME    - site settings
//   $execution             - execution metadata (id, workflow_name, ...)
//   $current_user          - user running the workflow
//   $helpers.absoluteUrl(path) - convert a relative path to an absolute URL
//   console.log/warn/error - logging

function hmacSha256(message, key) {
  function utf8Bytes(str) {
    const bytes = [];

    for (let i = 0; i < str.length; i++) {
      let code = str.charCodeAt(i);

      // Handle surrogate pairs
      if (
        code >= 0xd800 &&
        code <= 0xdbff &&
        i + 1 < str.length
      ) {
        const next = str.charCodeAt(i + 1);

        if (next >= 0xdc00 && next <= 0xdfff) {
          code =
            0x10000 +
            ((code - 0xd800) << 10) +
            (next - 0xdc00);
          i++;
        }
      }

      if (code <= 0x7f) {
        bytes.push(code);
      } else if (code <= 0x7ff) {
        bytes.push(
          0xc0 | (code >> 6),
          0x80 | (code & 0x3f)
        );
      } else if (code <= 0xffff) {
        bytes.push(
          0xe0 | (code >> 12),
          0x80 | ((code >> 6) & 0x3f),
          0x80 | (code & 0x3f)
        );
      } else {
        bytes.push(
          0xf0 | (code >> 18),
          0x80 | ((code >> 12) & 0x3f),
          0x80 | ((code >> 6) & 0x3f),
          0x80 | (code & 0x3f)
        );
      }
    }

    return bytes;
  }

  function rotr(x, n) {
    return (x >>> n) | (x << (32 - n));
  }

  function sha256(bytes) {
    const K = [
      0x428a2f98, 0x71374491, 0xb5c0fbcf, 0xe9b5dba5,
      0x3956c25b, 0x59f111f1, 0x923f82a4, 0xab1c5ed5,
      0xd807aa98, 0x12835b01, 0x243185be, 0x550c7dc3,
      0x72be5d74, 0x80deb1fe, 0x9bdc06a7, 0xc19bf174,
      0xe49b69c1, 0xefbe4786, 0x0fc19dc6, 0x240ca1cc,
      0x2de92c6f, 0x4a7484aa, 0x5cb0a9dc, 0x76f988da,
      0x983e5152, 0xa831c66d, 0xb00327c8, 0xbf597fc7,
      0xc6e00bf3, 0xd5a79147, 0x06ca6351, 0x14292967,
      0x27b70a85, 0x2e1b2138, 0x4d2c6dfc, 0x53380d13,
      0x650a7354, 0x766a0abb, 0x81c2c92e, 0x92722c85,
      0xa2bfe8a1, 0xa81a664b, 0xc24b8b70, 0xc76c51a3,
      0xd192e819, 0xd6990624, 0xf40e3585, 0x106aa070,
      0x19a4c116, 0x1e376c08, 0x2748774c, 0x34b0bcb5,
      0x391c0cb3, 0x4ed8aa4a, 0x5b9cca4f, 0x682e6ff3,
      0x748f82ee, 0x78a5636f, 0x84c87814, 0x8cc70208,
      0x90befffa, 0xa4506ceb, 0xbef9a3f7, 0xc67178f2
    ];

    const H = [
      0x6a09e667,
      0xbb67ae85,
      0x3c6ef372,
      0xa54ff53a,
      0x510e527f,
      0x9b05688c,
      0x1f83d9ab,
      0x5be0cd19
    ];

    const data = bytes.slice();
    const bitLength = data.length * 8;

    // SHA-256 padding
    data.push(0x80);

    while ((data.length % 64) !== 56) {
      data.push(0);
    }

    // Append 64-bit big-endian message length.
    // JS integers are safe here for normal workflow payload sizes.
    const high = Math.floor(bitLength / 0x100000000);
    const low = bitLength >>> 0;

    data.push(
      (high >>> 24) & 0xff,
      (high >>> 16) & 0xff,
      (high >>> 8) & 0xff,
      high & 0xff,
      (low >>> 24) & 0xff,
      (low >>> 16) & 0xff,
      (low >>> 8) & 0xff,
      low & 0xff
    );

    const w = new Array(64);

    for (let offset = 0; offset < data.length; offset += 64) {
      for (let i = 0; i < 16; i++) {
        const j = offset + i * 4;

        w[i] =
          ((data[j] << 24) |
            (data[j + 1] << 16) |
            (data[j + 2] << 8) |
            data[j + 3]) >>> 0;
      }

      for (let i = 16; i < 64; i++) {
        const s0 =
          rotr(w[i - 15], 7) ^
          rotr(w[i - 15], 18) ^
          (w[i - 15] >>> 3);

        const s1 =
          rotr(w[i - 2], 17) ^
          rotr(w[i - 2], 19) ^
          (w[i - 2] >>> 10);

        w[i] =
          (
            w[i - 16] +
            s0 +
            w[i - 7] +
            s1
          ) >>> 0;
      }

      let a = H[0];
      let b = H[1];
      let c = H[2];
      let d = H[3];
      let e = H[4];
      let f = H[5];
      let g = H[6];
      let h = H[7];

      for (let i = 0; i < 64; i++) {
        const S1 =
          rotr(e, 6) ^
          rotr(e, 11) ^
          rotr(e, 25);

        const ch = (e & f) ^ (~e & g);

        const temp1 =
          (
            h +
            S1 +
            ch +
            K[i] +
            w[i]
          ) >>> 0;

        const S0 =
          rotr(a, 2) ^
          rotr(a, 13) ^
          rotr(a, 22);

        const maj =
          (a & b) ^
          (a & c) ^
          (b & c);

        const temp2 = (S0 + maj) >>> 0;

        h = g;
        g = f;
        f = e;
        e = (d + temp1) >>> 0;
        d = c;
        c = b;
        b = a;
        a = (temp1 + temp2) >>> 0;
      }

      H[0] = (H[0] + a) >>> 0;
      H[1] = (H[1] + b) >>> 0;
      H[2] = (H[2] + c) >>> 0;
      H[3] = (H[3] + d) >>> 0;
      H[4] = (H[4] + e) >>> 0;
      H[5] = (H[5] + f) >>> 0;
      H[6] = (H[6] + g) >>> 0;
      H[7] = (H[7] + h) >>> 0;
    }

    const result = [];

    for (let i = 0; i < H.length; i++) {
      result.push(
        (H[i] >>> 24) & 0xff,
        (H[i] >>> 16) & 0xff,
        (H[i] >>> 8) & 0xff,
        H[i] & 0xff
      );
    }

    return result;
  }

  function bytesToHex(bytes) {
    return bytes
      .map(b => b.toString(16).padStart(2, "0"))
      .join("");
  }

  const blockSize = 64;

  let keyBytes = utf8Bytes(key);
  const messageBytes = utf8Bytes(message);

  // Keys longer than the SHA-256 block size are first hashed.
  if (keyBytes.length > blockSize) {
    keyBytes = sha256(keyBytes);
  }

  // Pad key to 64 bytes.
  while (keyBytes.length < blockSize) {
    keyBytes.push(0);
  }

  const innerPad = new Array(blockSize);
  const outerPad = new Array(blockSize);

  for (let i = 0; i < blockSize; i++) {
    innerPad[i] = keyBytes[i] ^ 0x36;
    outerPad[i] = keyBytes[i] ^ 0x5c;
  }

  const innerHash = sha256(
    innerPad.concat(messageBytes)
  );

  const hmac = sha256(
    outerPad.concat(innerHash)
  );

  return bytesToHex(hmac);
}

const payload = JSON.stringify({
    "the-json-payload": "goes-here"
});

const signature = "sha256=" + hmacSha256( payload, $vars.secret);

return {
    "payload": payload,
    "signature": signature
};

그다음 키가 X-Discourse-Workflow-Signature이고 값이 {{ $("Code").item.json.signature }}인 헤더, 콘텐츠 타입 JSON, 그리고 요청 본문이 {{ $("Code").item.json.payload }}인 HTTP 요청 단계가 이어집니다.

그 결과 다음과 같은 HTTP 요청이 생성됩니다:

User-Agent: Faraday v2.14.4
Content-Length: 41
Accept: */*
Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3
Content-Type: application/json
X-Discourse-Workflow-Signature: sha256=9ad2820b545013bdd18d4e7e6139624b91f576498e528201fa7759ec58dd598c

{"the-json-payload": "goes-here"}

X-Discourse-Workflow-Secret은 secret 인자의 값을 사용한 HMAC-SHA256 서명입니다… 서명된 웹훅과 정확히 같은 방식이죠! :slight_smile:

아름답지는 않지만, 작동하는 것 같습니다.

업데이트: 웹훅 서명의 스타일에 맞게 서명 앞에 sha256= 접두사를 추가했습니다.

꽤 신뢰할 만해 보여요! 공유해 주셔서 감사합니다!

참고로, 이 네이티브 HMAC-SHA256을 Web Crypto API와 비교하여 무작위 메시지 및 키에 대해 동일한 결과를 반환하는지 확인해 보았고, 서명이 일치했습니다. 특수한 경우에서 결과가 달라질 수 있다는 보장은 없지만, 프로덕션 환경에서 사용해도 될 정도로 만족스럽습니다. :slightly_smiling_face: