Scheck Funcs 지원 목록¶

• 버전: 1.0.7-7-g251eead
• 출시일: 2023-04-06 11:17:57
• 지원 운영체제: windows/amd64,windows/386,linux/arm,linux/arm64,linux/386,linux/amd64

개요¶

기존 방식은 Lua 가상 머신 초기화 시 모든 함수를 등록했으나 Lua 스크립트에서 이러한 메서드를 사용하지 않아 가상 머신에 불필요한 오버헤드가 발생했습니다.

함수가 증가함에 따라 이러한 오버헤드 문제는 점점 더 심각해져서, 패키지 분할 및 모듈화 처리를 도입했습니다.

모듈 사용 방법¶

Go 함수는 패키지 형태로 여러 모듈로 나뉩니다. Lua 스크립트에서 모듈을 사용할 때는 먼저 패키지를 가져와야 합니다(trigger 제외).

Lua 코드:

    -- file 모듈 사용
    local file = require("file")
    local info = file.file_info("./example.exe")
    print(info['size'])
    -- do something ...

    -- cache 모듈 사용
    local cache = require("cache")
    cache.set_cache({"123","abc"})
    print(cache.get_cache("123")) -- "abc"

    -- trigger는 참조 선언 불필요
    local current = "123"
    trigger({Content=current})

모듈 및 함수 목록¶

참고: 운영체제에 따라 메서드 집합이 다르므로 크로스 시스템 호출은 불가능합니다! all_os는 모든 운영체제에 공통되는 메서드입니다.

• file
  • all_os
  • ls
  • file_exist
  • file_info
  • read_file
  • file_hash
  • sc_path_watch
  • grep
• system
  • all_os
  • hostname
  • uptime
  • time_zone
  • mounts
  • uname
  • sc_sleep
  • sc_ticker
  • linux
  • kernel_info
  • kernel_modules
  • ulimit_info
  • processes
  • process_open_files
  • users
  • logged_in_users
  • last
  • lastb
  • shadow
  • shell_history
  • crontab
  • sysctl
  • rpm_list
  • rpm_query
  • windows
• net
  • all_os
  • interface_addresses
  • linux
  • iptables
  • process_open_sockets
  • listening_ports
  • windows
• cache
  • all_os
  • get_cache
  • set_cache
  • del_cache
  • del_cache_all
  • get_global_cache
  • set_global_cache
• json
  • all_os
  • json_encode
  • json_decode
• mysql
  • all_os
  • mysql_weak_psw
  • mysql_ports_list
• 컨테이너
  • sc_docker_exist
  • sc_docker_containers
  • sc_docker_runlike
• 기타
  • trigger

file¶

file_all_os¶

ls¶

ls(dir[, rescue])

지정된 디렉터리의 파일을 나열합니다.

매개변수:

반환 값:

읽기 실패 시 오류가 발생합니다.

file_exist¶

file_exist(filepath)

파일이 존재하는지 확인합니다.

매개변수:

반환 값:

예제:

file = '/your/file/path'
exists = file_exist(file)
print(exists)

file_info¶

file_info(filepath)

파일 속성 및 메타데이터를 읽습니다.

매개변수:

반환 값:

읽기 실패 시 오류가 발생합니다.

예제:

file = '/your/file/path'
info = file_info(file)

read_file¶

read_file(filepath)

파일 내용을 읽습니다.

매개변수:

반환 값:

읽기 실패 시 오류가 발생합니다.

예제:

file='/your/file/path'
content = read_file(file)

file_hash¶

file_hash(filepath)

파일 내용의 MD5 합계를 계산합니다.

매개변수:

반환 값:

읽기 실패 시 오류가 발생합니다.

예제:

file='/your/file/path'
content = file_hash(file)

sc_path_watch¶

sc_path_watch(dir,chan)

파일 또는 디렉터리의 변경을 감시합니다.

매개변수:

반환 값:

반환 값이 없으며 중단되지 않습니다. 디렉터리나 파일이 변경되면 lua.LChannel을 통해 알림이 전송됩니다.

lua.LChannel:

grep¶

grep(option, pattern, file)

grep 명령어 실행

매개변수:

반환 값:

system¶

system_all_os¶

hostname¶

hostname()

현재 호스트 이름을 가져옵니다.

반환 값:

가져오기 실패 시 오류가 발생합니다.

uptime¶

uptime()

마지막 부팅 이후 경과 시간입니다.

반환 값:

time_zone¶

time_zone()

시스템의 현재 시간대

반환 값:

mounts¶

mounts()

시스템에 마운트된 장치 및 파일 시스템 (프로세스별 아님)

반환 값:

읽기 실패 시 오류가 발생합니다.

uname¶

uname()

운영체제 이름 및 버전

반환 값:

실패 시 오류가 발생합니다.

sc_sleep¶

sc_sleep(time)

스레드가 지정된 시간(초) 동안 대기합니다.

매개변수:

반환 값:

실패 시 오류가 발생합니다.

sc_ticker¶

sc_ticker(channel,time)

정기적으로 lua.LChannel에 신호를 보냅니다.

매개변수:

반환 값:

반환 값 없음 lua.LChannel에 Lua.LString을 전송합니다.

system_linux¶

kernel_info¶

kernel_info()

로드된 Linux 커널 모듈 및 로드 검색 경로 내의 모듈

반환 값:

읽기 실패 시 오류가 발생합니다.

kernel_modules¶

kernel_modules()

로드된 Linux 커널 모듈 및 로드 검색 경로 내의 모듈

반환 값:

읽기 실패 시 오류가 발생합니다.

ulimit_info¶

ulimit_info()

시스템 리소스 사용 제한.

반환 값:

읽기 실패 시 오류가 발생합니다.

processes¶

processes()

호스트 시스템에서 실행 중인 모든 프로세스

반환 값:

읽기 실패 시 오류가 발생합니다.

process_open_files¶

process_open_files()

각 프로세스의 파일 디스크립터.

반환 값:

읽기 실패 시 오류가 발생합니다.

users¶

users()

로컬 사용자 계정 (Windows에서 로컬로 로그온한 도메인 계정 포함)

반환 값:

읽기 실패 시 오류가 발생합니다.

logged_in_users¶

logged_in_users()

시스템에서 활성 셸을 가진 사용자.

반환 값:

읽기 실패 시 오류가 발생합니다.

last¶

last()

시스템 로그인 및 로그아웃.

반환 값:

읽기 실패 시 오류가 발생합니다.

lastb¶

lastb()

실패한 로그인.

반환 값:

읽기 실패 시 오류가 발생합니다.

shadow¶

shadow()

로컬 시스템 사용자의 암호화된 비밀번호 및 관련 정보입니다. /etc/shadow에 액세스하려면 일반적으로 슈퍼유저 권한이 필요합니다.

반환 값:

읽기 실패 시 오류가 발생합니다.

shell_history¶

shell_history()

사용자별 .*_history 데이터의 라인 구분(명령) 테이블입니다.

반환 값:

읽기 실패 시 오류가 발생합니다.

crontab¶

crontab()

시스템 및 사용자 cron/tab에서 라인을 구문 분석한 값입니다.

반환 값:

실패 시 오류가 발생합니다.

sysctl¶

sysctl([key])

운영체제 sysctl 정보

매개변수:

반환 값:

실패 시 오류가 발생합니다.

rpm_list¶

rpm_list()

현재 모든 rpm 패키지 나열

반환 값:

실패 시 오류가 발생합니다.

rpm_query¶

rpm_query(pkg)

패키지 설치 여부 확인

매개변수:

반환 값:

system_windows¶

net¶

net_all_os¶

interface_addresses¶

interface_addresses()

네트워크 인터페이스 및 관련 메타데이터.

반환 값:

읽기 실패 시 오류가 발생합니다.

net_linux¶

iptables¶

iptables()

Linux IP 패킷 필터링 및 NAT 도구

반환 값:

읽기 실패 시 오류가 발생합니다.

process_open_sockets¶

process_open_sockets()

시스템에서 열린 네트워크 소켓이 있는 프로세스

반환 값:

읽기 실패 시 오류가 발생합니다.

listening_ports¶

listening_ports()

리스닝(바인딩) 중인 네트워크 소켓/포트가 있는 프로세스

반환 값:

읽기 실패 시 오류가 발생합니다.

net_windows¶

cache¶

cache_all_os¶

get_cache¶

get_cache(key)

캐시 키의 값을 가져옵니다.

매개변수:

반환 값:

set_cache¶

set_cache(key, value)

캐시 키-값 쌍을 설정합니다.

매개변수:

반환 값:

clean_cache¶

clean_cache()

이 규칙의 캐시를 정리합니다.

매개변수:

반환 값:

del_cache¶

del_cache(key)

키로 캐시를 삭제합니다.

매개변수:

반환 값:
반환 값 없음

del_cache_all¶

del_cache()

모든 캐시를 삭제합니다.

매개변수:

반환 값:

get_global_cache¶

get_global_cache(key)

전역 캐시 키의 값을 가져옵니다.

매개변수:

반환 값:

set_global_cache¶

set_global_cache(key, value)

전역 캐시에 키-값을 설정합니다.

매개변수:

반환 값:

json¶

json_all_os¶

json_encode¶

json_encode(object)

lua 테이블을 JSON 문자열로 인코딩합니다.

매개변수:

반환 값:

인코딩 실패 시 오류가 발생합니다.

json_decode¶

json_decode(str)

JSON 문자열을 lua 테이블로 디코딩합니다.

매개변수:

반환 값:

인코딩 실패 시 오류가 발생합니다.

mysql¶

mysql_all_os¶

mysql_weak_psw¶

mysql_weak_psw(host, port [,username])

MySQL 약한 비밀번호 확인

매개변수:

반환 값:

실패 시 오류가 발생합니다.

mysql_ports_list¶

mysql_ports_list()

호스트 MySQL 포트 나열

반환 값:

읽기 실패 시 오류가 발생합니다.

출력 예제:

port    3307
protocolversion 10
statusflags 2
authpluginname  mysql_native_password
s️erverversion  5.7.34
state   LISTEN
cmdline /usr/bin/docker-proxy -proto tcp -host-ip 0.0.0.0 -host-port 3307 -container-ip 172.18.0.4 -container-port 3306
pid 7062

컨테이너 관련¶

sc_docker_exist¶

sc_docker_exist()

호스트에서 Docker 실행 여부 확인

반환 값:

실패 시 오류가 발생합니다.

sc_docker_containers¶

sc_docker_containers()

MySQL 약한 비밀번호 확인

다른 Docker 함수보다 먼저 sc_docker_exist가 먼저 실행되어야 합니다!!!

반환 값:

실패 시 오류가 발생합니다.

sc_docker_runlike¶

sc_docker_runlike(containerName)

MySQL 약한 비밀번호 확인

매개변수:

반환 값:

실패 시 오류가 발생합니다.

기타¶

trigger¶

trigger([template_vals])

이벤트를 트리거하고 라인 프로토콜로 대상에 전송합니다.

매개변수:

반환 값:

실패 시 오류가 발생합니다.