matchblackip()

matchblackip() 함수는 지정한 주소 그룹에 특정 IP 주소가 포함되어 있는지 확인합니다.

문법

매개변수

STR_GUID

주소 그룹 GUID입니다. 유효한 주소 그룹 식별자여야 합니다. 존재하지 않는 GUID를 지정하면 쿼리 파싱 단계에서 오류가 발생합니다.

IP_ADDR_EXPR

IP 주소 표현식입니다. IPv4 주소 타입 또는 IPv4 형식의 문자열만 허용됩니다. 허용되지 않는 타입이면 false를 반환합니다.

설명

matchblackip() 함수는 지정한 주소 그룹에 IP_ADDR_EXPR 값이 포함되어 있으면 true, 없으면 false를 반환합니다.

IP_ADDR_EXPR 값이 null이면 false를 반환합니다. IP 주소 타입이면 문자열로 변환한 후 주소 그룹에서 검색합니다. IPv4 주소 또는 IPv4 형식의 문자열이 아닌 경우에는 false를 반환합니다.

주소 그룹은 소나 웹 콘솔의 정책 > 주소 그룹 메뉴에서 관리합니다.

오류 코드

해당 사항 없음

사용 예

1. src_ip 필드 값이 지정한 주소 그룹에 포함되어 있는지 확인합니다.

   json "{'src_ip': '192.0.2.1'}"
   | eval result = matchblackip("550e8400-e29b-41d4-a716-446655440000", src_ip)
   | # result: false
   

2. IP_ADDR_EXPR 값이 null인 경우

   json "{'src_ip': null}"
   | eval result = matchblackip("550e8400-e29b-41d4-a716-446655440000", null)
   | # result: false
   

3. IP_ADDR_EXPR 값이 IPv4가 아닌 타입인 경우

   json "{'src_ip': 12345}"
   | eval result = matchblackip("550e8400-e29b-41d4-a716-446655440000", src_ip)
   | # result: false
   

호환성

matchblackip() 함수는 소나 4.0 이전 버전부터 제공되었습니다.