Farsight DNSDB
Farsight Security DNSDB는 글로벌 인터넷 인프라의 구성에 대한 사실 기반 보기를 제공하는 세계 최대의 DNS 인텔리전스 데이터베이스입니다. DNSDB는 Farsight의 SIE(보안 정보 교환) 데이터 공유 플랫폼을 활용하며 선도적인 DNS 전문가가 설계하고 운영합니다. Farsight는 전역 센서 배열에서 수동 DNS 데이터를 수집, 필터링 및 확인합니다. DNSDB는 최고 품질의 가장 포괄적인 DNS 인텔리전스 데이터 서비스입니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | Premium | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | Premium | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Farsight 보안 기술 지원 |
| URL | https://service.farsightsecurity.com/ |
| 전자 메일 | support@farsightsecurity.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Farsight 보안 |
| 웹 사이트 | https://www.farsightsecurity.com/ |
| 개인 정보 보호 정책 | https://www.farsightsecurity.com/privacy-policy/ |
| 카테고리 | 안전; 데이터 |
Pre-requisites
계속하려면 다음이 필요합니다.
- 사용자 지정 커넥터 기능이 있는 Microsoft Power Apps 또는 Power Automate 계획
- Azure 구독
- Farsight DNSDB API 키
자격 증명을 가져오는 방법
에서 https://www.farsightsecurity.com/solutions/dnsdb/ 무료 API 키를 등록합니다.
지원:
모든 지원 요청 및 일반 쿼리에 대해 문의 support@farsightsecurity.com 하거나 문의할 수 있습니다.
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
| 이름 | 유형 | Description | 필수 |
|---|---|---|---|
| Farsight DNSDB API 키 | 시큐어스트링 (보안 문자열) | 이 API에 대한 Farsight DNSDB API 키 | 진실 |
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| Ping |
이 요청은 DNSDB API 엔드포인트에 대한 종단 간 연결 테스트를 위한 것으로, 방화벽 차단이 없음을 알려줍니다. 이 요청에는 API 키가 필요하지 않습니다. JSON 개체 {'ping': 'ok'}만 반환합니다. |
| RData 조회 |
RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다. |
| RRSet 조회 |
RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다. |
| RRType 및 Bailiwick을 사용하여 RRSet 조회 |
RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다. |
| RRType을 사용하여 RData 조회 |
RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다. |
| RRType을 사용하여 RRSet 조회 |
RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다. |
| 서비스 제한 |
서비스 제한 검색 |
| 유연한 검색 |
유연한 검색은 DNSDB API에 정규식 및 Globbing 지원을 모두 추가하여 검색 쿼리 유형을 확장하고 검색에 더 많은 컨트롤을 추가합니다. |
Ping
이 요청은 DNSDB API 엔드포인트에 대한 종단 간 연결 테스트를 위한 것으로, 방화벽 차단이 없음을 알려줍니다. 이 요청에는 API 키가 필요하지 않습니다. JSON 개체 {'ping': 'ok'}만 반환합니다.
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
ping
|
ping | string |
ping |
RData 조회
RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
쿼리 유형(이름, 원시) 이름: VALUE는 프레젠테이션 형식의 DNS 도메인 이름 또는 왼쪽('c.example.com') 또는 오른쪽('www.example.') 와일드카드 도메인 이름입니다. 왼쪽 와일드카드 쿼리는 오른쪽 와일드카드 쿼리보다 다소 비용이 많이 듭니다.,ip: VALUE는 접두사 길이 또는 주소 범위가 있는 IPv4 또는 IPv6 단일 주소 중 하나입니다. 접두사를 제공하는 경우 네트워크 주소와 접두사 길이 사이의 구분 기호는 HTTP URI 경로 이름 구분 기호와 충돌하지 않도록 일반적인 슬래시('/') 문자가 아닌 단일 쉼표(',') 문자입니다. raw: VALUE는 원시 8진수 문자열을 지정하는 짝수의 16진수 숫자입니다. |
|
value
|
value | True | string |
쿼리 값 |
|
time_first_before(Unix/Epoch 시간)
|
time_first_before | number |
DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다. |
|
|
time_first_after(Unix/Epoch 시간)
|
time_first_after | number |
DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다. |
|
|
time_last_before(Unix/Epoch 시간)
|
time_last_before | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다. |
|
|
time_last_after(Unix/Epoch 시간)
|
time_last_after | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다. |
|
|
limit
|
limit | number |
이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다. |
|
|
aggr
|
aggr | boolean |
집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다. |
|
|
humantime
|
humantime | boolean |
시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다. |
|
|
offset
|
offset | number |
결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다. |
반환
- response
- array of RData_Results
RRSet 조회
RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
쿼리 유형(이름, 원시) 이름: VALUE는 아래 설명된 대로 프레젠테이션 형식 또는 와일드카드의 DNS 소유자 이름입니다. 때때로 이것을 단지 rrset 검색, 원시라고 부릅니다. VALUE는 원시 옥텟 문자열을 지정하는 짝수의 16진수 숫자입니다. |
|
value
|
value | True | string |
쿼리 값 |
|
time_first_before(Unix/Epoch 시간)
|
time_first_before | number |
DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다. |
|
|
time_first_after(Unix/Epoch 시간)
|
time_first_after | number |
DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다. |
|
|
time_last_before(Unix/Epoch 시간)
|
time_last_before | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다. |
|
|
time_last_after(Unix/Epoch 시간)
|
time_last_after | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다. |
|
|
limit
|
limit | number |
이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다. |
|
|
aggr
|
aggr | boolean |
집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다. |
|
|
humantime
|
humantime | boolean |
시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다. |
|
|
offset
|
offset | number |
결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다. |
반환
- response
- array of RRSet_Results
RRType 및 Bailiwick을 사용하여 RRSet 조회
RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
쿼리 유형(이름, 원시) 이름: VALUE는 아래 설명된 대로 프레젠테이션 형식 또는 와일드카드의 DNS 소유자 이름입니다. 때때로 이것을 단지 rrset 검색, 원시라고 부릅니다. VALUE는 원시 옥텟 문자열을 지정하는 짝수의 16진수 숫자입니다. |
|
value
|
value | True | string |
쿼리 값 |
|
rrtype
|
rrtype | True | string |
쿼리 rrtype |
|
바이리윅 주
|
bailiwick | True | string |
쿼리 bailiwick |
|
time_first_before(Unix/Epoch 시간)
|
time_first_before | number |
DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다. |
|
|
time_first_after(Unix/Epoch 시간)
|
time_first_after | number |
DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다. |
|
|
time_last_before(Unix/Epoch 시간)
|
time_last_before | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다. |
|
|
time_last_after(Unix/Epoch 시간)
|
time_last_after | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다. |
|
|
limit
|
limit | number |
이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다. |
|
|
aggr
|
aggr | boolean |
집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다. |
|
|
humantime
|
humantime | boolean |
시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다. |
|
|
offset
|
offset | number |
결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다. |
반환
- response
- array of RRSet_Results
RRType을 사용하여 RData 조회
RData 조회는 RData 레코드 값에 따라 역 조회를 지원하는 DNSDB의 Rdata 인덱스를 쿼리합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
쿼리 유형(이름, 원시) 이름: VALUE는 프레젠테이션 형식의 DNS 도메인 이름 또는 왼쪽('c.example.com') 또는 오른쪽('www.example.') 와일드카드 도메인 이름입니다. 왼쪽 와일드카드 쿼리는 오른쪽 와일드카드 쿼리보다 다소 비용이 많이 듭니다.,ip: VALUE는 접두사 길이 또는 주소 범위가 있는 IPv4 또는 IPv6 단일 주소 중 하나입니다. 접두사를 제공하는 경우 네트워크 주소와 접두사 길이 사이의 구분 기호는 HTTP URI 경로 이름 구분 기호와 충돌하지 않도록 일반적인 슬래시('/') 문자가 아닌 단일 쉼표(',') 문자입니다. raw: VALUE는 원시 8진수 문자열을 지정하는 짝수의 16진수 숫자입니다. |
|
value
|
value | True | string |
쿼리 값 |
|
rrtype
|
rrtype | True | string |
쿼리 rrtype |
|
time_first_before(Unix/Epoch 시간)
|
time_first_before | number |
DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다. |
|
|
time_first_after(Unix/Epoch 시간)
|
time_first_after | number |
DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다. |
|
|
time_last_before(Unix/Epoch 시간)
|
time_last_before | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다. |
|
|
time_last_after(Unix/Epoch 시간)
|
time_last_after | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다. |
|
|
limit
|
limit | number |
이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다. |
|
|
aggr
|
aggr | boolean |
집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다. |
|
|
humantime
|
humantime | boolean |
시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다. |
|
|
offset
|
offset | number |
결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다. |
반환
- response
- array of RData_Results
RRType을 사용하여 RRSet 조회
RRSet 조회는 RRset의 소유자 이름에 따라 앞으로 조회를 지원하는 DNSDB의 RRset 인덱스를 쿼리합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
type
|
type | True | string |
쿼리 유형(이름, 원시) 이름: VALUE는 아래 설명된 대로 프레젠테이션 형식 또는 와일드카드의 DNS 소유자 이름입니다. 때때로 이것을 단지 rrset 검색, 원시라고 부릅니다. VALUE는 원시 옥텟 문자열을 지정하는 짝수의 16진수 숫자입니다. |
|
value
|
value | True | string |
쿼리 값 |
|
rrtype
|
rrtype | True | string |
쿼리 rrtype |
|
time_first_before(Unix/Epoch 시간)
|
time_first_before | number |
DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다. |
|
|
time_first_after(Unix/Epoch 시간)
|
time_first_after | number |
DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다. |
|
|
time_last_before(Unix/Epoch 시간)
|
time_last_before | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다. |
|
|
time_last_after(Unix/Epoch 시간)
|
time_last_after | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다. |
|
|
limit
|
limit | number |
이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다. |
|
|
aggr
|
aggr | boolean |
집계된 결과 그룹은 모든 기간 동안 동일한 rrsets를 그룹화하며 DNSDB 쿼리의 클래식 동작입니다. 즉, rrset이 관찰된 총 횟수를 가져올 수 있지만 관찰된 횟수는 가져올 수 없습니다. 집계되지 않은 결과는 동일한 rrsets의 그룹을 해제하여 DNSDB에서 다루는 전체 시간 범위(시간 펜싱에 따라 다름)에서 도메인 이름이 어떻게 확인되었는지 확인할 수 있습니다. 이렇게 하면 값이 반복되는 레코드의 고유한 타임스탬프가 표시되므로 시간이 지남에 따라 레코드 요청 볼륨의 더 정확한 인상을 줄 수 있습니다. '도메인이 맬웨어를 제공하거나 스팸을 릴레이하기 위해 용도가 변경될 때까지 대부분 사용되지 않고 오랫동안 주차되었으나 다시 중단되었습니까?' 같은 질문에 대답할 수 있습니다. 지난 주에 기록과 수년 동안 지속적으로 관찰된 기록이 많이 관찰되었는지 확인할 수 있습니다. 부울 값입니다. 집계된 결과에는 기본값인 True를 사용하고 집계되지 않은 결과에는 False를 사용합니다. |
|
|
humantime
|
humantime | boolean |
시간 값(time_first, time_last, zone_time_first, zone_time_last)이 사람이 읽을 수 있는 형식(RFC3339 규격) 형식으로 반환되거나 Epoch가 반환된 후 Unix 스타일 시간 값이 초 단위인 경우 False인 경우 True인 부울 값입니다. False는 DNSDB 쿼리의 클래식 동작이며 이 옵션의 기본값입니다. |
|
|
offset
|
offset | number |
결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다. |
반환
- response
- array of RRSet_Results
서비스 제한
유연한 검색
유연한 검색은 DNSDB API에 정규식 및 Globbing 지원을 모두 추가하여 검색 쿼리 유형을 확장하고 검색에 더 많은 컨트롤을 추가합니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
method
|
method | True | string |
flex search 메서드(regex - 정규식 검색, glob - 전체 와일드카드) |
|
key
|
key | True | string |
검색 키 |
|
value
|
value | True | string |
쿼리 값 |
|
time_first_before(Unix/Epoch 시간)
|
time_first_before | number |
DNS 레코드가 처음 관찰된 시점의 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_before=1420070400'은 2015년 1월 1일 이전에 처음 관찰되었거나 이전보다 오래된 DNS 레코드만 제공합니다. |
|
|
time_first_after(Unix/Epoch 시간)
|
time_first_after | number |
DNS 레코드가 처음 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_first_after=-31536000'은 작년에 처음 관찰된 결과만 제공합니다. |
|
|
time_last_before(Unix/Epoch 시간)
|
time_last_before | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 앞에 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_before=1356998400'은 2013년 이전에 마지막으로 관찰된 DNS 레코드에 대한 결과만 제공합니다. |
|
|
time_last_after(Unix/Epoch 시간)
|
time_last_after | number |
DNS 레코드가 마지막으로 관찰된 시간에 대해 정의된 타임스탬프 이후의 결과를 제공합니다. 예를 들어 URL 매개 변수 'time_last_after=-2678400'은 31일 전에 마지막으로 관찰된 결과만 제공합니다. |
|
|
limit
|
limit | number |
이러한 조회 메서드를 통해 반환되는 결과 수에 대한 제한입니다. 이러한 조회 메서드를 통해 반환되는 결과 수에는 기본 제공 제한이 있습니다. 기본 제한은 10,000으로 설정됩니다. 이 제한은 'limit' 쿼리 매개 변수를 설정하여 늘리거나 낮출 수 있습니다. 최대 결과 수도 허용됩니다. 최대값보다 큰 제한을 요청하면 최대값만 반환됩니다. 해당 최대값에 대한 자세한 내용은 아래 results_max 참조하세요. '?limit=0'을 사용하는 경우 DNSDB는 허용되는 최대 결과 수를 반환합니다. 요청된 한도보다 쿼리에 대한 결과가 적으면 실제 크기만 반환할 수 있습니다. |
|
|
제외
|
exclude | string |
'exclude' 매개 변수는 일치하는 결과를 제외(예: 필터 아웃)하는 데 사용됩니다. 이 표 아래에 설명되어 있습니다. |
|
|
offset
|
offset | number |
결과에서 오프셋할 행 수(예: 건너뛰기)입니다. 이렇게 하면 증분 결과 전송 기능이 구현되므로 단일 쿼리에 사용 가능한 결과를 더 많이 볼 수 있습니다. 행은 제한 매개 변수가 적용되기 전에 오프셋되므로 최대 결과 수와 일치하는 제한을 초과하는 추가 결과를 볼 수 있습니다. DNSDB는 각 쿼리에 대한 결과를 다시 계산하며 결과 순서가 유지되지 않을 수 있습니다. 따라서 이 기능은 여러 쿼리를 통해 모든 결과를 안내하는 유효한 방법이 아닙니다. 일부 결과가 누락되고 일부는 중복될 수 있습니다. 사용할 수 있는 실제 오프셋은 제한되거나 특정 API 키의 경우 오프셋이 허용되지 않습니다. 아래 offset_max rate_limit 키를 참조하세요. 오프셋 값은 양의 정수여야 합니다. 기본값은 0입니다. 즉, 행을 오프셋하지 않습니다. |
반환
- response
- array of Flex_Results
정의
RRSet_Results
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | number |
수동 DNS 복제를 통해 RRset이 관찰된 횟수입니다. |
|
첫 번째 시간
|
time_first | number |
RRset이 처음으로 관찰된 시간입니다. |
|
마지막 시간
|
time_last | number |
RRset이 관찰된 가장 최근의 시간입니다. |
|
영역 시간 우선
|
zone_time_first | number |
영역 파일 가져오기를 통해 RRset이 처음으로 관찰된 경우입니다. |
|
영역 시간 마지막 시간
|
zone_time_last | number |
영역 파일 가져오기를 통해 RRset이 마지막으로 관찰된 시간입니다. |
|
RRName
|
rrname | string |
DNS 프레젠테이션 형식의 RRset 소유자 이름입니다. |
|
RRType
|
rrtype | string |
표준 DNS 형식 니모닉 또는 RFC 3597 제네릭 형식을 사용하는 RRset의 리소스 레코드 형식입니다. 즉, 문자열 TYPE 바로 뒤에 10진수 RRtype 번호가 잇습니다. |
|
바이리윅 주
|
bailiwick | string |
RRset을 제공한 이름 서버로 위임된 가장 가까운 바깥쪽 영역이거나 FromZoneFile이 True인 경우 RRset이 포함된 영역의 이름입니다. |
|
RData
|
rdata | array of string |
하나 이상의 Rdata 값 배열입니다. Rdata 값은 rrtype 값에 따라 표준 프레젠테이션 형식으로 변환됩니다. 인코더에 RRset의 rrtype에 대한 형식별 프레젠테이션 형식이 없는 경우 RFC 3597 제네릭 Rdata 인코딩이 사용됩니다. |
RData_Results
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
수량
|
count | number |
수동 DNS 복제를 통해 리소스 레코드가 관찰된 횟수입니다. |
|
첫 번째 시간
|
time_first | number |
리소스 레코드가 처음으로 관찰된 시간입니다. |
|
마지막 시간
|
time_last | number |
리소스 레코드가 관찰된 가장 최근 시간입니다. |
|
영역 시간 우선
|
zone_time_first | number |
영역 파일 가져오기를 통해 리소스 레코드가 처음으로 관찰된 경우입니다. |
|
영역 시간 마지막 시간
|
zone_time_last | number |
영역 파일 가져오기를 통해 리소스 레코드가 마지막으로 관찰된 시간입니다. |
|
RRName
|
rrname | string |
DNS 프레젠테이션 형식의 리소스 레코드 소유자 이름입니다. |
|
RRType
|
rrtype | string |
표준 DNS 형식 니모닉 또는 RFC 3597 제네릭 형식을 사용하는 리소스 레코드의 리소스 레코드 형식입니다. 즉, 문자열 TYPE 바로 뒤에 10진수 RRtype 번호가 잇습니다. |
|
RData
|
rdata | array of string |
레코드 데이터 값입니다. Rdata 값은 rrtype 값에 따라 표준 프레젠테이션 형식으로 변환됩니다. 인코더에 리소스 레코드의 형식에 대한 형식별 프레젠테이션 형식이 없는 경우 RFC 3597 일반 Rdata 인코딩이 사용됩니다. |
Flex_Results
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
RData
|
rdata | string |
레코드 데이터 값입니다. |
|
RRName
|
rrname | string |
DNS 프레젠테이션 형식의 RRset 소유자 이름입니다. |
|
RRType
|
rrtype | string |
표준 DNS 형식 니모닉 또는 RFC 3597 제네릭 형식을 사용하는 RRset/리소스 레코드의 리소스 레코드 형식입니다. 즉, 문자열 TYPE 바로 뒤에 10진수 RRtype 번호가 잇습니다. |
|
RAW_RDATA
|
raw_rdata | string |
레코드 데이터 값은 원시 8진수 문자열을 지정하는 16진수 숫자 쌍입니다. 이 값은 rdata에 대한 자세한 내용을 얻기 위해 유연한 검색에서 표준 검색으로 피벗하는 데 사용됩니다. |
RateLimit_Results
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
한계
|
limit | number |
수행할 수 있는 최대 API 조회 수입니다. 초기 할당량입니다. |
|
나머지
|
remaining | number |
시간 기반 할당량의 경우: 다시 설정 시간까지 수행할 수 있는 나머지 API 조회 수입니다. 블록 기반 할당량의 경우: 블록 할당량의 나머지 API 조회 수입니다. |
|
재설정
|
reset | number |
시간 기반 할당량의 경우: 할당량 한도가 다시 설정될 다음 시점을 나타내는 두 번째 세분성이 있는 UNIX epoch 타임스탬프입니다. 일반적으로 00:00(자정) UTC입니다. 블록 기반 할당량의 경우 값은 'n/a'입니다. |
|
만료
|
expires | number |
블록 기반 할당량에만 존재합니다. 할당량이 만료되는 시기를 나타내는 두 번째 세분성이 있는 UNIX epoch 타임스탬프입니다. |
|
ResultsMax
|
results_max | number |
이러한 조회 메서드에서 반환할 수 있는 최대 결과 수를 반환합니다. 제공된 경우 'limit' 쿼리 매개 변수를 재정의합니다. 예를 들어 URL 경로에 '?limit=20000'이 추가되지만 results_max=1000이면 최대 1000개의 결과만 반환됩니다. |
|
OffsetMax
|
offset_max | number |
오프셋 쿼리 매개 변수가 될 수 있는 최대값입니다. 이 값이 더 높으면 HTTP 416 '요청된 범위가 만족할 수 없음' 응답 코드가 '오류: 허용되는 최대값보다 큰 오프셋 값'과 함께 반환됩니다. 값이 'n/a'이면 이 API 키에 대해 오프셋 매개 변수가 허용되지 않으며 유사한 416 오류가 생성됩니다. |
|
버스트 크기 조정
|
burst_size | number |
이 burst_window 초 내에 수행할 수 있는 최대 API 조회 수입니다. |
|
BurstWindow
|
burst_window | number |
쿼리 버스트가 측정되는 시간(초)입니다. |