tlshdiff()

tlshdiff() 함수는 두 TLSH 해시 문자열 간의 유사도 점수를 정수로 반환합니다.

문법

매개변수

HASH1

비교할 첫 번째 TLSH 해시 문자열입니다.

HASH2

비교할 두 번째 TLSH 해시 문자열입니다.

설명

tlshdiff() 함수는 두 TLSH 해시 문자열을 비교하여 유사도 점수를 정수로 반환합니다. 점수가 낮을수록 두 데이터가 유사함을 나타내며, 0이면 동일한 데이터입니다. 점수가 높을수록 두 데이터의 차이가 큽니다.

HASH1 또는 HASH2가 null이거나 문자열 타입이 아니면 null을 반환합니다. 유효하지 않은 TLSH 해시 문자열을 전달하거나 비교 중 오류가 발생하면 -1을 반환합니다.

tlsh() 함수로 계산한 해시 문자열을 이 함수에 전달하여 두 데이터의 유사도를 측정할 수 있습니다.

오류 코드

해당 사항 없음

사용 예

1. 두 파일의 유사도 비교

   logdb://files
   | eval h1 = tlsh(file1_content), h2 = tlsh(file2_content),
          diff = tlshdiff(h1, h2)
   | # diff: 45
   

2. 동일한 해시 비교 (유사도 0)

   json "{}"
   | eval data = randbytes(256),
          h = tlsh(data),
          diff = tlshdiff(h, h)
   | # diff: 0
   

3. null 입력

   json "{'h1': null, 'h2': 'T1A3E...'}" | eval diff = tlshdiff(h1, h2)
   | # diff: null
   

4. 유효하지 않은 해시 문자열

   json "{}" | eval diff = tlshdiff("invalid", "invalid")
   | # diff: -1
   

호환성

tlshdiff() 함수는 소나 4.0.2308.0-u3043부터 사용 가능합니다.