SteamTokenDumperPlugin ko KR

SteamTokenDumperPlugin

SteamTokenDumperPlugin은 저희가 개발한 공식 ASF **플러그인**으로, 여러분의 Steam 계정이 접근 가능한 패키지 토큰, 앱 토큰, 디포 키를 공유함으로써 SteamDB 프로젝트에 기여할 수 있게 해줍니다. 수집된 데이터에 대한 자세한 정보와 SteamDB가 이를 필요로 하는 이유는 SteamDB의 Token Dumper 페이지에서 확인하실 수 있습니다. 제출되는 데이터에는 잠재적으로 민감한 정보가 포함되지 않으며, 위 설명에 명시된 대로 보안/개인정보 위험이 전혀 없습니다.

---

플러그인 활성화하기

ASF는 릴리스에 SteamTokenDumperPlugin을 함께 번들로 제공하지만, 이 플러그인 자체는 기본적으로 비활성화되어 있습니다. SteamTokenDumperPluginEnabled ASF 전역 설정 속성을 JSON 문법으로 true로 설정하여 플러그인을 활성화할 수 있습니다:

{
  "SteamTokenDumperPluginEnabled": true
}

ASF 프로그램이 실행되면, 표준 ASF 로깅 메커니즘을 통해 플러그인이 성공적으로 활성화되었는지 알려줍니다. 웹 기반 설정 생성기를 통해서도 플러그인을 활성화할 수 있습니다.

---

기술적 세부 사항

활성화되면, 이 플러그인은 여러분이 ASF에서 실행 중인 봇들을 활용해 해당 봇들이 접근 가능한 패키지 토큰, 앱 토큰, 디포 키 형태로 데이터를 수집합니다. 데이터 수집 모듈에는 데이터 수집으로 인해 발생하는 추가 부하를 최소화하기 위한 수동(passive) 및 능동(active) 루틴이 포함되어 있습니다.

위에서 설명한 데이터 수집 루틴에 더해, 계획된 사용 사례를 완수하기 위해 주기적으로 어떤 데이터를 SteamDB에 제출해야 하는지 결정하는 역할을 담당하는 제출 루틴도 초기화됩니다. 이 루틴은 ASF 시작 후 최대 1시간 이내에 실행되며, 이후 24시간마다 반복됩니다. 이 플러그인은 전송해야 할 데이터의 양을 최소화하기 위해 최선을 다합니다. 따라서 일부 수집된 데이터가 제출할 필요가 없는 것으로 판단되어 건너뛰어질 수 있습니다(예: 접근 토큰을 변경하지 않는 앱 업데이트).

이 플러그인은 config/SteamTokenDumper.cache 위치에 저장되는 영속적인 캐시 데이터베이스를 사용하며, 이는 ASF에서 config/ASF.db가 하는 것과 유사한 역할을 합니다. 이 파일은 수집 및 제출된 데이터를 기록하고, 서로 다른 ASF 실행 간에 수행해야 할 작업량을 최소화하기 위해 사용됩니다. 이 파일을 삭제하면 프로세스가 처음부터 다시 시작되므로, 가능하다면 삭제를 피하는 것이 좋습니다.

---

데이터

ASF는 요청에 기여자(contributor)의 steamID를 포함시키며, 이는 여러분이 ASF에서 설정한 SteamOwnerID 값이나, 설정하지 않았다면 가장 많은 라이선스를 보유한 봇의 Steam ID로 결정됩니다. 등록된 기여자는 지속적인 도움에 대한 보상으로 SteamDB로부터 추가 혜택(예: 웹사이트 후원자 등급)을 받을 수도 있지만, 이는 전적으로 SteamDB의 재량에 달려 있습니다.

어떤 경우든, SteamDB 스태프는 여러분의 도움에 미리 감사를 전하고 싶어합니다. 제출된 데이터는 SteamDB가 패키지, 앱, 디포에 대한 정보를 추적할 수 있게 해주며, 여러분의 도움 없이는 불가능한 일입니다.

---

명령어

STD 플러그인은 추가 ASF 명령어인 std [Bots]를 제공하며, 이를 통해 선택한 봇에 대해 원하는 시점에 갱신 및 제출을 실행할 수 있습니다. 이 명령어를 사용하기 위해 설정을 활성화할 필요는 없으며, 이를 통해 자동 수집 및 제출을 건너뛰고 프로세스를 직접 수동으로 제어할 수 있습니다. 물론 설정이 활성화된 상태에서도 실행할 수 있으며, 이 경우 단순히 평소보다 일찍 일반적인 수집 및 제출 절차가 실행됩니다.

사용 가능한 모든 봇에 대해 갱신을 실행하려면 !std ASF를 사용하는 것을 권장합니다. 다만 원하신다면 선택한 봇들에 대해서만 실행할 수도 있습니다.

---

고급 설정

저희 플러그인은 내부 동작을 원하는 대로 조정하고 싶은 분들을 위한 고급 설정을 지원합니다.

고급 설정은 ASF.json 내에 다음과 같은 구조로 위치합니다:

{
  "SteamTokenDumperPlugin": {
    "Enabled": false,
    "SecretAppIDs": [],
    "SecretDepotIDs": [],
    "SecretPackageIDs": [],
    "SkipAutoGrantPackages": true
  }
}

모든 옵션은 다음과 같습니다.

Enabled

bool 타입으로 기본값은 false입니다. 이 속성은 위에서 설명한 최상위 수준의 SteamTokenDumperPluginEnabled 속성과 동일하게 동작하며, 그 대신 사용할 수 있습니다. 플러그인 관련 설정 전체를 자체 구조 안에 두고 싶은 사람들을 위한 것입니다(따라서 아래에 설명된 다른 고급 속성을 이미 사용 중인 경우일 가능성이 높습니다).

---

SecretAppIDs

ImmutableHashSet<uint> 타입으로 기본값은 비어있습니다. 이 속성은 플러그인이 확인하지 않을, 그리고 이미 확인된 경우에는 토큰을 제출하지 않을 appIDs를 지정합니다. 이 속성은 미공개 항목에 대한 잠재적으로 민감한 정보에 접근할 수 있는 사람들, 특히 개발자, 퍼블리셔 또는 비공개 베타 테스터에게 유용할 수 있습니다.

---

SecretDepotIDs

ImmutableHashSet<uint> 타입으로 기본값은 비어있습니다. 이 속성은 플러그인이 확인하지 않을, 그리고 이미 확인된 경우에는 키를 제출하지 않을 depotIDs를 지정합니다. 이 속성은 미공개 항목에 대한 잠재적으로 민감한 정보에 접근할 수 있는 사람들, 특히 개발자, 퍼블리셔 또는 비공개 베타 테스터에게 유용할 수 있습니다.

---

SecretPackageIDs

ImmutableHashSet<uint> 타입으로 기본값은 비어있습니다. 이 속성은 플러그인이 확인하지 않을, 그리고 이미 확인된 경우에는 토큰을 제출하지 않을 packageIDs(subIDs라고도 함)를 지정합니다. 이 속성은 미공개 항목에 대한 잠재적으로 민감한 정보에 접근할 수 있는 사람들, 특히 개발자, 퍼블리셔 또는 비공개 베타 테스터에게 유용할 수 있습니다.

---

SkipAutoGrantPackages

bool 타입으로 기본값은 true입니다. 이 속성은 SecretPackageIDs와 매우 유사하게 동작하며, 활성화하면 EPaymentMethod가 AutoGrant인 패키지를 아래에 설명된 확인 루틴에서 건너뛰게 합니다. AutoGrant 결제 수단은 **Steamworks**가 개발자 계정에 패키지를 자동으로 부여할 때 사용됩니다. 이 옵션은 다른 Secret 옵션만큼 명시적이지 않아 무언가를 보장하지는 않지만(AutoGrant 외에도 제출하고 싶지 않은 패키지가 있을 수 있으므로), 비밀 패키지의 전부는 아니더라도 대부분을 건너뛰기에는 충분합니다. 이 옵션은 기본적으로 활성화되어 있습니다. 실제로 AutoGrant 패키지에 접근할 수 있는 사람이라면 그 정보를 일반 대중에게 유출하고 싶어 하는 경우가 거의 없기 때문이며, 따라서 false 값을 사용하는 것은 매우 상황에 따른 선택입니다.

---

추가 설명

최상위 수준에서 모든 Steam 계정은 packageID(subID라고도 함)로 분류되는 패키지(라이선스, 구독)의 집합을 소유합니다. 모든 패키지는 appID로 분류되는 여러 앱을 포함할 수 있습니다. 그리고 모든 앱은 depotID로 분류되는 여러 디포를 포함할 수 있습니다.

├── sub/124923
│     ├── app/292030
│     │     ├── depot/292031
│     │     ├── depot/378648
│     │     └── ...
│     ├── app/378649
│     └── ...
└── ...

이 플러그인에는 건너뛴 항목을 고려하는 두 가지 루틴, 즉 확인 루틴과 제출 루틴이 있습니다.

확인 루틴은 위에서 볼 수 있는 트리를 확인하는 역할을 합니다. 패키지/앱/디포를 미리 차단 목록에 추가하면, 나머지 부분을 별도로 지정할 필요 없이 차단된 가지/잎 지점에서 트리를 효과적으로 잘라낼 수 있습니다. 위의 예시에서 124923 패키지가 SecretPackageIDs 또는 SkipAutoGrantPackages에 의해 무시되었고, 그 패키지가 292030 appID에 연결된 유일한 소유 패키지였다면 292030 appID 역시 확인되지 않으며, 같은 원리로 292031 및 378648 디포에 연결된 다른 확인된 앱이 없었다면 해당 디포들도 확인되지 않습니다. 다만 플러그인이 이미 트리를 확인한 상태라면, 이는 사실상 해당 항목이 더 이상 업데이트되지 않도록 막을 뿐이며(예: 새 앱 추가), 이미 확인된 기존 항목(예: 차단하기로 결정하기 전에 해당 패키지에서 발견된 앱)을 플러그인이 "잊게" 만들지는 않는다는 점을 유의하세요. 방금 건너뛰기 옵션을 활성화했고 ASF가 이미 확인된 트리를 순회하지 않도록 하고 싶다면, 플러그인이 캐시를 보관하는 config/SteamTokenDumper.cache 파일을 한 번 삭제하는 것을 고려할 수 있습니다.

제출 루틴은 (위의 확인 루틴에 의해) 이미 확인된 항목의 패키지 토큰, 앱 토큰, 디포 키를 제출하는 역할을 합니다. 여기서는 차단 목록이 즉시 효력을 가집니다. 플러그인이 이미 정보를 확인했더라도, 차단 목록에 등록해 두었다면 확인 여부와 관계없이 제출 루틴이 해당 정보를 SteamDB로 제출하지 않기 때문입니다. 다만 이 시점에서는 더 이상 트리에 대해 이야기하는 것이 아니라는 점을 유의하세요. 제출 루틴은 앱에 대한 정보가 어느 패키지에서 온 것인지 알지 못하므로, 항목들이 서로 어떤 관계에 있든 상관없이 차단 목록에 있는 특정 항목의 정보만 건너뜁니다.

대부분의 개발자와 퍼블리셔에게는 SkipAutoGrantPackages를 활성화한 상태로 두고, 필요하다면 SecretPackageIDs만 추가로 사용하는 것으로 충분합니다. 이는 트리를 시작 가지에서 효과적으로 잘라내어, 동일한 앱에 연결된 다른 패키지가 없는 한 그 아래에 포함된 앱과 디포가 제출되지 않도록 보장하기 때문입니다. 더욱 확실히 하고 싶다면 여기에 더해 SecretAppIDs도 사용할 수 있습니다. 이 옵션은 차단하지 않은 다른 라이선스가 해당 앱에 연결되어 있더라도 앱의 확인을 건너뜁니다. SecretDepotIDs는 특별하고 구체적인 필요(예: 패키지와 앱 정보는 계속 제출하면서 특정 디포만 건너뛰기)가 있거나, 삼중으로 안전하게 하기 위해 한 겹을 더 추가하고 싶은 경우가 아니라면 사용할 필요가 없습니다.