Udostępnij przez


Farsight DNSDB

Farsight Security DNSDB to największa na świecie baza danych analizy DNS, która zapewnia oparty na faktach widok konfiguracji globalnej infrastruktury internetowej. Baza danych DNSDB korzysta z platformy udostępniania danych programu Security Information Exchange (SIE) firmy Farsight i jest zaprojektowana i obsługiwana przez czołowych ekspertów ds. systemu DNS. Farsight zbiera, filtruje i weryfikuje pasywne dane DNS z globalnej tablicy czujników. DNSDB to najwyższej jakości i najbardziej kompleksowa usługa danych analizy DNS tego typu.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure Government
     — Regiony platformy Azure (Chiny)
     - Departament Obrony USA (DoD)
Power Apps Premium Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Power Automate Premium Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - Rząd USA (GCC)
     - Rząd USA (GCC High)
     - China Cloud obsługiwane przez firmę 21Vianet
     - Departament Obrony USA (DoD)
Kontakt
Name Pomoc techniczna dotycząca zabezpieczeń usługi Farsight
adres URL https://service.farsightsecurity.com/
Email support@farsightsecurity.com
Metadane łącznika
Publisher Zabezpieczenia usługi Farsight
Witryna internetowa https://www.farsightsecurity.com/
Zasady ochrony prywatności https://www.farsightsecurity.com/privacy-policy/
Kategorie Bezpieczeństwo; Dane

Pre-requisites

Aby kontynuować, musisz wykonać następujące czynności:

  • Plan usługi Microsoft Power Apps lub Power Automate z funkcją łącznika niestandardowego
  • Subskrypcja platformy Azure
  • Klucz interfejsu API bazy danych DNSDB usługi Farsight

Jak uzyskać poświadczenia

Zarejestruj się, aby uzyskać bezpłatny klucz interfejsu API na stronie https://www.farsightsecurity.com/solutions/dnsdb/ .

Wsparcie:

W przypadku wszystkich żądań pomocy technicznej i ogólnych zapytań możesz skontaktować się z support@farsightsecurity.comnami lub skontaktować się z nami

Tworzenie połączenia

Łącznik obsługuje następujące typy uwierzytelniania:

Wartość domyślna Parametry tworzenia połączenia. Wszystkie regiony Nie można udostępniać

Domyślny

Dotyczy: wszystkie regiony

Parametry tworzenia połączenia.

Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.

Name Typ Description Wymagane
Klucz interfejsu API bazy danych DNSDB usługi Farsight securestring Klucz interfejsu API USŁUGI DNSDB usługi Farsight dla tego interfejsu API Prawda

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Limity usług

Pobieranie limitów usług

Ping

To żądanie dotyczy zakończenia testów łączności z punktem końcowym interfejsu API usługi DNSDB, informując o tym, że nie ma żadnych blokad zapory. To żądanie nie wymaga klucza interfejsu API. Zwraca on tylko obiekt JSON {'ping': 'ok'}.

Wyszukiwanie danych RData

Wyszukiwanie RData wysyła zapytanie do indeksu Rdata bazy danych DNSDB, który obsługuje odwrotne wyszukiwania na podstawie wartości rekordów Rdata.

Wyszukiwanie danych RData za pomocą typu RRType

Wyszukiwanie RData wysyła zapytanie do indeksu Rdata bazy danych DNSDB, który obsługuje odwrotne wyszukiwania na podstawie wartości rekordów Rdata.

Wyszukiwanie elastyczne

Funkcja wyszukiwania elastycznego dodaje zarówno wyrażenia regularne, jak i obsługę globbingu do interfejsu API bazy danych DNSDB w celu rozszerzenia typów zapytań wyszukiwania i dodania większej kontroli do wyszukiwania.

Wyszukiwanie zestawu RRSet

Wyszukiwanie RRSet wysyła zapytanie do indeksu RRset bazy danych DNSDB, który obsługuje wyszukiwania do przodu na podstawie nazwy właściciela zestawu RRset.

Wyszukiwanie zestawu RRSet z użyciem typu RRType

Wyszukiwanie RRSet wysyła zapytanie do indeksu RRset bazy danych DNSDB, który obsługuje wyszukiwania do przodu na podstawie nazwy właściciela zestawu RRset.

Wyszukiwanie zestawu RRSet z użyciem typów RRType i bailiwick

Wyszukiwanie RRSet wysyła zapytanie do indeksu RRset bazy danych DNSDB, który obsługuje wyszukiwania do przodu na podstawie nazwy właściciela zestawu RRset.

Limity usług

Pobieranie limitów usług

Zwraca

Ping

To żądanie dotyczy zakończenia testów łączności z punktem końcowym interfejsu API usługi DNSDB, informując o tym, że nie ma żadnych blokad zapory. To żądanie nie wymaga klucza interfejsu API. Zwraca on tylko obiekt JSON {'ping': 'ok'}.

Zwraca

Nazwa Ścieżka Typ Opis
ping
ping string

ping

Wyszukiwanie danych RData

Wyszukiwanie RData wysyła zapytanie do indeksu Rdata bazy danych DNSDB, który obsługuje odwrotne wyszukiwania na podstawie wartości rekordów Rdata.

Parametry

Nazwa Klucz Wymagane Typ Opis
typ
type True string

Typ zapytania (nazwa, nieprzetworzona) nazwa: WARTOŚĆ to nazwa domeny DNS w formacie prezentacji lub lewa strona ('c.example.com') lub nazwa domeny z prawej strony ('www.example.'). Zwróć uwagę, że zapytania wieloznaczne po lewej stronie są nieco droższe niż zapytania z symbolami wieloznacznymi po prawej stronie.,ip: WARTOŚĆ jest jednym z pojedynczych adresów IPv4 lub IPv6 z długością prefiksu lub zakresem adresów. Jeśli jest podany prefiks, ogranicznik między adresem sieciowym a długością prefiksu jest pojedynczym przecinkiem (','), a nie zwykłym znakiem ukośnika ('/'), aby uniknąć starcia z separatorem nazwy ścieżki identyfikatora URI HTTP., nieprzetworzona: wartość jest parzystą liczbą cyfr szesnastkowych określających nieprzetworzone ciąg oktetu.

value
value True string

Wartość zapytania

time_first_before (czas unix/epoka)
time_first_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu, dla którego po raz pierwszy zaobserwowano rekord DNS. Na przykład parametr adresu URL "time_first_before=1420070400" będzie dostarczać tylko zgodne rekordy DNS, które zostały po raz pierwszy zaobserwowane przed (lub starszym) 1 stycznia 2015 r.

time_first_after (czas unix/epoka)
time_first_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla pierwszego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_first_after=-31536000" będzie dostarczać tylko wyniki, które zostały zaobserwowane po raz pierwszy w ciągu ostatniego roku.

time_last_before (czas unix/epoka)
time_last_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_before=1356998400" będzie dostarczać wyniki tylko dla rekordów DNS, które ostatnio zaobserwowano przed 2013 r.

time_last_after (czas unix/epoka)
time_last_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_after=-2678400" będzie dostarczać tylko wyniki, które zostały ostatnio zaobserwowane po 31 dniach temu.

limit
limit number

Limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Istnieje wbudowany limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Domyślny limit jest ustawiony na 10 000. Ten limit można podnieść lub obniżyć, ustawiając parametr zapytania "limit". Dozwolona jest również maksymalna liczba wyników; żądanie limitu większego niż maksimum zwróci tylko wartość maksymalną. Aby uzyskać informacje na temat tej maksymalnej wartości, zobacz results_max poniżej. Jeśli jest używany parametr "?limit=0", baza danych DNSDB zwróci maksymalną dozwoloną liczbę wyników. Jeśli dla zapytania jest mniej wyników niż żądany limit, można zwrócić tylko rzeczywistą kwotę.

aggr
aggr boolean

Zagregowane wyniki grupują identyczne zestawy rrsets we wszystkich okresach i jest klasycznym zachowaniem podczas wykonywania zapytań względem bazy danych DNSDB. Oznacza to, że można uzyskać całkowitą liczbę zaobserwowanych rrsetów, ale nie wtedy, gdy zaobserwowano. Niezagregowane wyniki niezgrupowane identyczne zestawy rrset, co pozwala zobaczyć, jak nazwa domeny została rozpoznana w systemie DNS w pełnym zakresie czasu objętego systemem DNSDB (pod warunkiem ogrodzenia czasu). Może to dać dokładniejsze wrażenie woluminu żądania rekordu w czasie, ponieważ spowoduje to wyświetlenie odrębnych sygnatur czasowych rekordów, których wartości są powtarzane. Możesz odpowiedzieć na takie pytania: "Czy domena została zaparkowana przez długi czas, głównie nieużywany, dopóki nie została ponownie wykorzystana do obsługi złośliwego oprogramowania lub przekazywania spamu, ale potem została porzucona ponownie?". Pozwala to sprawdzić, czy rekord zaobserwowano mocno w zeszłym tygodniu vs. zaobserwowano stale przez lata. Jest to wartość logiczna. Użyj wartości True, wartości domyślnej dla zagregowanych wyników lub wartości False dla wyników nieagregowanych.

humantime
humantime boolean

Wartość logiczna, która ma wartość True, jeśli wartości czasu (w time_first, time_last, zone_time_first, zone_time_last) powinny być zwracane w formacie czytelnym dla człowieka (RFC3339 zgodnym) lub Fałsz, jeśli wartości czasu w stylu systemu Unix w sekundach od momentu zwrócenia epoki. False to klasyczne zachowanie podczas wykonywania zapytań względem bazy danych DNSDB i jest wartością domyślną dla tej opcji.

przesunąć
offset number

Ile wierszy do przesunięcia (np. pomiń) w wynikach. Implementuje to funkcję przyrostowego transferu wyników, umożliwiając wyświetlanie większej liczby dostępnych wyników dla pojedynczego zapytania. Wiersze są przesunięte przed zastosowaniem parametru limitu, dlatego przesunięcie umożliwia wyświetlanie dodatkowych wyników przeszłości limitu, który odpowiada maksymalnej liczbie wyników. Należy pamiętać, że baza danych DNSDB ponownie oblicza wyniki dla każdego zapytania, a kolejność wyników może nie zostać zachowana. W związku z tym ta funkcja nie jest prawidłowym sposobem na przejście wszystkich wyników w wielu zapytaniach — niektóre wyniki mogą być brakujące i niektóre mogą być zduplikowane. Rzeczywiste przesunięcie, którego można użyć, jest ograniczone lub w przypadku niektórych kluczy interfejsu API, przesunięcie jest niedozwolone — zobacz klucz offset_max rate_limit poniżej. Wartość przesunięcia musi być dodatnią liczbą całkowitą. Wartość domyślna to 0, co oznacza, że wiersze nie są przesunięte.

Zwraca

Wyszukiwanie danych RData za pomocą typu RRType

Wyszukiwanie RData wysyła zapytanie do indeksu Rdata bazy danych DNSDB, który obsługuje odwrotne wyszukiwania na podstawie wartości rekordów Rdata.

Parametry

Nazwa Klucz Wymagane Typ Opis
typ
type True string

Typ zapytania (nazwa, nieprzetworzona) nazwa: WARTOŚĆ to nazwa domeny DNS w formacie prezentacji lub lewa strona ('c.example.com') lub nazwa domeny z prawej strony ('www.example.'). Zwróć uwagę, że zapytania wieloznaczne po lewej stronie są nieco droższe niż zapytania z symbolami wieloznacznymi po prawej stronie.,ip: WARTOŚĆ jest jednym z pojedynczych adresów IPv4 lub IPv6 z długością prefiksu lub zakresem adresów. Jeśli jest podany prefiks, ogranicznik między adresem sieciowym a długością prefiksu jest pojedynczym przecinkiem (','), a nie zwykłym znakiem ukośnika ('/'), aby uniknąć starcia z separatorem nazwy ścieżki identyfikatora URI HTTP., nieprzetworzona: wartość jest parzystą liczbą cyfr szesnastkowych określających nieprzetworzone ciąg oktetu.

value
value True string

Wartość zapytania

rrtype
rrtype True string

Typ zapytania

time_first_before (czas unix/epoka)
time_first_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu, dla którego po raz pierwszy zaobserwowano rekord DNS. Na przykład parametr adresu URL "time_first_before=1420070400" będzie dostarczać tylko zgodne rekordy DNS, które zostały po raz pierwszy zaobserwowane przed (lub starszym) 1 stycznia 2015 r.

time_first_after (czas unix/epoka)
time_first_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla pierwszego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_first_after=-31536000" będzie dostarczać tylko wyniki, które zostały zaobserwowane po raz pierwszy w ciągu ostatniego roku.

time_last_before (czas unix/epoka)
time_last_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_before=1356998400" będzie dostarczać wyniki tylko dla rekordów DNS, które ostatnio zaobserwowano przed 2013 r.

time_last_after (czas unix/epoka)
time_last_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_after=-2678400" będzie dostarczać tylko wyniki, które zostały ostatnio zaobserwowane po 31 dniach temu.

limit
limit number

Limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Istnieje wbudowany limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Domyślny limit jest ustawiony na 10 000. Ten limit można podnieść lub obniżyć, ustawiając parametr zapytania "limit". Dozwolona jest również maksymalna liczba wyników; żądanie limitu większego niż maksimum zwróci tylko wartość maksymalną. Aby uzyskać informacje na temat tej maksymalnej wartości, zobacz results_max poniżej. Jeśli jest używany parametr "?limit=0", baza danych DNSDB zwróci maksymalną dozwoloną liczbę wyników. Jeśli dla zapytania jest mniej wyników niż żądany limit, można zwrócić tylko rzeczywistą kwotę.

aggr
aggr boolean

Zagregowane wyniki grupują identyczne zestawy rrsets we wszystkich okresach i jest klasycznym zachowaniem podczas wykonywania zapytań względem bazy danych DNSDB. Oznacza to, że można uzyskać całkowitą liczbę zaobserwowanych rrsetów, ale nie wtedy, gdy zaobserwowano. Niezagregowane wyniki niezgrupowane identyczne zestawy rrset, co pozwala zobaczyć, jak nazwa domeny została rozpoznana w systemie DNS w pełnym zakresie czasu objętego systemem DNSDB (pod warunkiem ogrodzenia czasu). Może to dać dokładniejsze wrażenie woluminu żądania rekordu w czasie, ponieważ spowoduje to wyświetlenie odrębnych sygnatur czasowych rekordów, których wartości są powtarzane. Możesz odpowiedzieć na takie pytania: "Czy domena została zaparkowana przez długi czas, głównie nieużywany, dopóki nie została ponownie wykorzystana do obsługi złośliwego oprogramowania lub przekazywania spamu, ale potem została porzucona ponownie?". Pozwala to sprawdzić, czy rekord zaobserwowano mocno w zeszłym tygodniu vs. zaobserwowano stale przez lata. Jest to wartość logiczna. Użyj wartości True, wartości domyślnej dla zagregowanych wyników lub wartości False dla wyników nieagregowanych.

humantime
humantime boolean

Wartość logiczna, która ma wartość True, jeśli wartości czasu (w time_first, time_last, zone_time_first, zone_time_last) powinny być zwracane w formacie czytelnym dla człowieka (RFC3339 zgodnym) lub Fałsz, jeśli wartości czasu w stylu systemu Unix w sekundach od momentu zwrócenia epoki. False to klasyczne zachowanie podczas wykonywania zapytań względem bazy danych DNSDB i jest wartością domyślną dla tej opcji.

przesunąć
offset number

Ile wierszy do przesunięcia (np. pomiń) w wynikach. Implementuje to funkcję przyrostowego transferu wyników, umożliwiając wyświetlanie większej liczby dostępnych wyników dla pojedynczego zapytania. Wiersze są przesunięte przed zastosowaniem parametru limitu, dlatego przesunięcie umożliwia wyświetlanie dodatkowych wyników przeszłości limitu, który odpowiada maksymalnej liczbie wyników. Należy pamiętać, że baza danych DNSDB ponownie oblicza wyniki dla każdego zapytania, a kolejność wyników może nie zostać zachowana. W związku z tym ta funkcja nie jest prawidłowym sposobem na przejście wszystkich wyników w wielu zapytaniach — niektóre wyniki mogą być brakujące i niektóre mogą być zduplikowane. Rzeczywiste przesunięcie, którego można użyć, jest ograniczone lub w przypadku niektórych kluczy interfejsu API, przesunięcie jest niedozwolone — zobacz klucz offset_max rate_limit poniżej. Wartość przesunięcia musi być dodatnią liczbą całkowitą. Wartość domyślna to 0, co oznacza, że wiersze nie są przesunięte.

Zwraca

Wyszukiwanie elastyczne

Funkcja wyszukiwania elastycznego dodaje zarówno wyrażenia regularne, jak i obsługę globbingu do interfejsu API bazy danych DNSDB w celu rozszerzenia typów zapytań wyszukiwania i dodania większej kontroli do wyszukiwania.

Parametry

Nazwa Klucz Wymagane Typ Opis
metoda
method True string

flex search method (regex — wyszukiwanie wyrażeń regularnych, glob — pełne symbole wieloznaczne)

klucz
key True string

klucz wyszukiwania

value
value True string

Wartość zapytania

time_first_before (czas unix/epoka)
time_first_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu, dla którego po raz pierwszy zaobserwowano rekord DNS. Na przykład parametr adresu URL "time_first_before=1420070400" będzie dostarczać tylko zgodne rekordy DNS, które zostały po raz pierwszy zaobserwowane przed (lub starszym) 1 stycznia 2015 r.

time_first_after (czas unix/epoka)
time_first_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla pierwszego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_first_after=-31536000" będzie dostarczać tylko wyniki, które zostały zaobserwowane po raz pierwszy w ciągu ostatniego roku.

time_last_before (czas unix/epoka)
time_last_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_before=1356998400" będzie dostarczać wyniki tylko dla rekordów DNS, które ostatnio zaobserwowano przed 2013 r.

time_last_after (czas unix/epoka)
time_last_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_after=-2678400" będzie dostarczać tylko wyniki, które zostały ostatnio zaobserwowane po 31 dniach temu.

limit
limit number

Limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Istnieje wbudowany limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Domyślny limit jest ustawiony na 10 000. Ten limit można podnieść lub obniżyć, ustawiając parametr zapytania "limit". Dozwolona jest również maksymalna liczba wyników; żądanie limitu większego niż maksimum zwróci tylko wartość maksymalną. Aby uzyskać informacje na temat tej maksymalnej wartości, zobacz results_max poniżej. Jeśli jest używany parametr "?limit=0", baza danych DNSDB zwróci maksymalną dozwoloną liczbę wyników. Jeśli dla zapytania jest mniej wyników niż żądany limit, można zwrócić tylko rzeczywistą kwotę.

exclude
exclude string

Parametr "exclude" służy do wykluczania (tj. filtrowania) wyników pasujących do niego. Poniżej opisano tę tabelę.

przesunąć
offset number

Ile wierszy do przesunięcia (np. pomiń) w wynikach. Implementuje to funkcję przyrostowego transferu wyników, umożliwiając wyświetlanie większej liczby dostępnych wyników dla pojedynczego zapytania. Wiersze są przesunięte przed zastosowaniem parametru limitu, dlatego przesunięcie umożliwia wyświetlanie dodatkowych wyników przeszłości limitu, który odpowiada maksymalnej liczbie wyników. Należy pamiętać, że baza danych DNSDB ponownie oblicza wyniki dla każdego zapytania, a kolejność wyników może nie zostać zachowana. W związku z tym ta funkcja nie jest prawidłowym sposobem na przejście wszystkich wyników w wielu zapytaniach — niektóre wyniki mogą być brakujące i niektóre mogą być zduplikowane. Rzeczywiste przesunięcie, którego można użyć, jest ograniczone lub w przypadku niektórych kluczy interfejsu API, przesunięcie jest niedozwolone — zobacz klucz offset_max rate_limit poniżej. Wartość przesunięcia musi być dodatnią liczbą całkowitą. Wartość domyślna to 0, co oznacza, że wiersze nie są przesunięte.

Zwraca

Wyszukiwanie zestawu RRSet

Wyszukiwanie RRSet wysyła zapytanie do indeksu RRset bazy danych DNSDB, który obsługuje wyszukiwania do przodu na podstawie nazwy właściciela zestawu RRset.

Parametry

Nazwa Klucz Wymagane Typ Opis
typ
type True string

Typ zapytania (nazwa, nieprzetworzona) nazwa: WARTOŚĆ jest nazwą właściciela DNS w formacie prezentacji lub symbolami wieloznacznymi, jak opisano poniżej. Czasami nazywamy to tylko wyszukiwaniem rrset, nieprzetworzone: WARTOŚĆ jest parzystą liczbą cyfr szesnastkowych określających nieprzetworzone ciąg oktetu.

value
value True string

Wartość zapytania

time_first_before (czas unix/epoka)
time_first_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu, dla którego po raz pierwszy zaobserwowano rekord DNS. Na przykład parametr adresu URL "time_first_before=1420070400" będzie dostarczać tylko zgodne rekordy DNS, które zostały po raz pierwszy zaobserwowane przed (lub starszym) 1 stycznia 2015 r.

time_first_after (czas unix/epoka)
time_first_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla pierwszego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_first_after=-31536000" będzie dostarczać tylko wyniki, które zostały zaobserwowane po raz pierwszy w ciągu ostatniego roku.

time_last_before (czas unix/epoka)
time_last_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_before=1356998400" będzie dostarczać wyniki tylko dla rekordów DNS, które ostatnio zaobserwowano przed 2013 r.

time_last_after (czas unix/epoka)
time_last_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_after=-2678400" będzie dostarczać tylko wyniki, które zostały ostatnio zaobserwowane po 31 dniach temu.

limit
limit number

Limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Istnieje wbudowany limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Domyślny limit jest ustawiony na 10 000. Ten limit można podnieść lub obniżyć, ustawiając parametr zapytania "limit". Dozwolona jest również maksymalna liczba wyników; żądanie limitu większego niż maksimum zwróci tylko wartość maksymalną. Aby uzyskać informacje na temat tej maksymalnej wartości, zobacz results_max poniżej. Jeśli jest używany parametr "?limit=0", baza danych DNSDB zwróci maksymalną dozwoloną liczbę wyników. Jeśli dla zapytania jest mniej wyników niż żądany limit, można zwrócić tylko rzeczywistą kwotę.

aggr
aggr boolean

Zagregowane wyniki grupują identyczne zestawy rrsets we wszystkich okresach i jest klasycznym zachowaniem podczas wykonywania zapytań względem bazy danych DNSDB. Oznacza to, że można uzyskać całkowitą liczbę zaobserwowanych rrsetów, ale nie wtedy, gdy zaobserwowano. Niezagregowane wyniki niezgrupowane identyczne zestawy rrset, co pozwala zobaczyć, jak nazwa domeny została rozpoznana w systemie DNS w pełnym zakresie czasu objętego systemem DNSDB (pod warunkiem ogrodzenia czasu). Może to dać dokładniejsze wrażenie woluminu żądania rekordu w czasie, ponieważ spowoduje to wyświetlenie odrębnych sygnatur czasowych rekordów, których wartości są powtarzane. Możesz odpowiedzieć na takie pytania: "Czy domena została zaparkowana przez długi czas, głównie nieużywany, dopóki nie została ponownie wykorzystana do obsługi złośliwego oprogramowania lub przekazywania spamu, ale potem została porzucona ponownie?". Pozwala to sprawdzić, czy rekord zaobserwowano mocno w zeszłym tygodniu vs. zaobserwowano stale przez lata. Jest to wartość logiczna. Użyj wartości True, wartości domyślnej dla zagregowanych wyników lub wartości False dla wyników nieagregowanych.

humantime
humantime boolean

Wartość logiczna, która ma wartość True, jeśli wartości czasu (w time_first, time_last, zone_time_first, zone_time_last) powinny być zwracane w formacie czytelnym dla człowieka (RFC3339 zgodnym) lub Fałsz, jeśli wartości czasu w stylu systemu Unix w sekundach od momentu zwrócenia epoki. False to klasyczne zachowanie podczas wykonywania zapytań względem bazy danych DNSDB i jest wartością domyślną dla tej opcji.

przesunąć
offset number

Ile wierszy do przesunięcia (np. pomiń) w wynikach. Implementuje to funkcję przyrostowego transferu wyników, umożliwiając wyświetlanie większej liczby dostępnych wyników dla pojedynczego zapytania. Wiersze są przesunięte przed zastosowaniem parametru limitu, dlatego przesunięcie umożliwia wyświetlanie dodatkowych wyników przeszłości limitu, który odpowiada maksymalnej liczbie wyników. Należy pamiętać, że baza danych DNSDB ponownie oblicza wyniki dla każdego zapytania, a kolejność wyników może nie zostać zachowana. W związku z tym ta funkcja nie jest prawidłowym sposobem na przejście wszystkich wyników w wielu zapytaniach — niektóre wyniki mogą być brakujące i niektóre mogą być zduplikowane. Rzeczywiste przesunięcie, którego można użyć, jest ograniczone lub w przypadku niektórych kluczy interfejsu API, przesunięcie jest niedozwolone — zobacz klucz offset_max rate_limit poniżej. Wartość przesunięcia musi być dodatnią liczbą całkowitą. Wartość domyślna to 0, co oznacza, że wiersze nie są przesunięte.

Zwraca

Wyszukiwanie zestawu RRSet z użyciem typu RRType

Wyszukiwanie RRSet wysyła zapytanie do indeksu RRset bazy danych DNSDB, który obsługuje wyszukiwania do przodu na podstawie nazwy właściciela zestawu RRset.

Parametry

Nazwa Klucz Wymagane Typ Opis
typ
type True string

Typ zapytania (nazwa, nieprzetworzona) nazwa: WARTOŚĆ jest nazwą właściciela DNS w formacie prezentacji lub symbolami wieloznacznymi, jak opisano poniżej. Czasami nazywamy to tylko wyszukiwaniem rrset, nieprzetworzone: WARTOŚĆ jest parzystą liczbą cyfr szesnastkowych określających nieprzetworzone ciąg oktetu.

value
value True string

Wartość zapytania

rrtype
rrtype True string

Typ zapytania

time_first_before (czas unix/epoka)
time_first_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu, dla którego po raz pierwszy zaobserwowano rekord DNS. Na przykład parametr adresu URL "time_first_before=1420070400" będzie dostarczać tylko zgodne rekordy DNS, które zostały po raz pierwszy zaobserwowane przed (lub starszym) 1 stycznia 2015 r.

time_first_after (czas unix/epoka)
time_first_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla pierwszego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_first_after=-31536000" będzie dostarczać tylko wyniki, które zostały zaobserwowane po raz pierwszy w ciągu ostatniego roku.

time_last_before (czas unix/epoka)
time_last_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_before=1356998400" będzie dostarczać wyniki tylko dla rekordów DNS, które ostatnio zaobserwowano przed 2013 r.

time_last_after (czas unix/epoka)
time_last_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_after=-2678400" będzie dostarczać tylko wyniki, które zostały ostatnio zaobserwowane po 31 dniach temu.

limit
limit number

Limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Istnieje wbudowany limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Domyślny limit jest ustawiony na 10 000. Ten limit można podnieść lub obniżyć, ustawiając parametr zapytania "limit". Dozwolona jest również maksymalna liczba wyników; żądanie limitu większego niż maksimum zwróci tylko wartość maksymalną. Aby uzyskać informacje na temat tej maksymalnej wartości, zobacz results_max poniżej. Jeśli jest używany parametr "?limit=0", baza danych DNSDB zwróci maksymalną dozwoloną liczbę wyników. Jeśli dla zapytania jest mniej wyników niż żądany limit, można zwrócić tylko rzeczywistą kwotę.

aggr
aggr boolean

Zagregowane wyniki grupują identyczne zestawy rrsets we wszystkich okresach i jest klasycznym zachowaniem podczas wykonywania zapytań względem bazy danych DNSDB. Oznacza to, że można uzyskać całkowitą liczbę zaobserwowanych rrsetów, ale nie wtedy, gdy zaobserwowano. Niezagregowane wyniki niezgrupowane identyczne zestawy rrset, co pozwala zobaczyć, jak nazwa domeny została rozpoznana w systemie DNS w pełnym zakresie czasu objętego systemem DNSDB (pod warunkiem ogrodzenia czasu). Może to dać dokładniejsze wrażenie woluminu żądania rekordu w czasie, ponieważ spowoduje to wyświetlenie odrębnych sygnatur czasowych rekordów, których wartości są powtarzane. Możesz odpowiedzieć na takie pytania: "Czy domena została zaparkowana przez długi czas, głównie nieużywany, dopóki nie została ponownie wykorzystana do obsługi złośliwego oprogramowania lub przekazywania spamu, ale potem została porzucona ponownie?". Pozwala to sprawdzić, czy rekord zaobserwowano mocno w zeszłym tygodniu vs. zaobserwowano stale przez lata. Jest to wartość logiczna. Użyj wartości True, wartości domyślnej dla zagregowanych wyników lub wartości False dla wyników nieagregowanych.

humantime
humantime boolean

Wartość logiczna, która ma wartość True, jeśli wartości czasu (w time_first, time_last, zone_time_first, zone_time_last) powinny być zwracane w formacie czytelnym dla człowieka (RFC3339 zgodnym) lub Fałsz, jeśli wartości czasu w stylu systemu Unix w sekundach od momentu zwrócenia epoki. False to klasyczne zachowanie podczas wykonywania zapytań względem bazy danych DNSDB i jest wartością domyślną dla tej opcji.

przesunąć
offset number

Ile wierszy do przesunięcia (np. pomiń) w wynikach. Implementuje to funkcję przyrostowego transferu wyników, umożliwiając wyświetlanie większej liczby dostępnych wyników dla pojedynczego zapytania. Wiersze są przesunięte przed zastosowaniem parametru limitu, dlatego przesunięcie umożliwia wyświetlanie dodatkowych wyników przeszłości limitu, który odpowiada maksymalnej liczbie wyników. Należy pamiętać, że baza danych DNSDB ponownie oblicza wyniki dla każdego zapytania, a kolejność wyników może nie zostać zachowana. W związku z tym ta funkcja nie jest prawidłowym sposobem na przejście wszystkich wyników w wielu zapytaniach — niektóre wyniki mogą być brakujące i niektóre mogą być zduplikowane. Rzeczywiste przesunięcie, którego można użyć, jest ograniczone lub w przypadku niektórych kluczy interfejsu API, przesunięcie jest niedozwolone — zobacz klucz offset_max rate_limit poniżej. Wartość przesunięcia musi być dodatnią liczbą całkowitą. Wartość domyślna to 0, co oznacza, że wiersze nie są przesunięte.

Zwraca

Wyszukiwanie zestawu RRSet z użyciem typów RRType i bailiwick

Wyszukiwanie RRSet wysyła zapytanie do indeksu RRset bazy danych DNSDB, który obsługuje wyszukiwania do przodu na podstawie nazwy właściciela zestawu RRset.

Parametry

Nazwa Klucz Wymagane Typ Opis
typ
type True string

Typ zapytania (nazwa, nieprzetworzona) nazwa: WARTOŚĆ jest nazwą właściciela DNS w formacie prezentacji lub symbolami wieloznacznymi, jak opisano poniżej. Czasami nazywamy to tylko wyszukiwaniem rrset, nieprzetworzone: WARTOŚĆ jest parzystą liczbą cyfr szesnastkowych określających nieprzetworzone ciąg oktetu.

value
value True string

Wartość zapytania

rrtype
rrtype True string

Typ zapytania

Bailiwick
bailiwick True string

Zapytanie o kaucję

time_first_before (czas unix/epoka)
time_first_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu, dla którego po raz pierwszy zaobserwowano rekord DNS. Na przykład parametr adresu URL "time_first_before=1420070400" będzie dostarczać tylko zgodne rekordy DNS, które zostały po raz pierwszy zaobserwowane przed (lub starszym) 1 stycznia 2015 r.

time_first_after (czas unix/epoka)
time_first_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla pierwszego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_first_after=-31536000" będzie dostarczać tylko wyniki, które zostały zaobserwowane po raz pierwszy w ciągu ostatniego roku.

time_last_before (czas unix/epoka)
time_last_before number

Podaj wyniki przed zdefiniowanym znacznikem czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_before=1356998400" będzie dostarczać wyniki tylko dla rekordów DNS, które ostatnio zaobserwowano przed 2013 r.

time_last_after (czas unix/epoka)
time_last_after number

Podaj wyniki po zdefiniowanym znaczniku czasu dla ostatniego zaobserwowanego rekordu DNS. Na przykład parametr adresu URL "time_last_after=-2678400" będzie dostarczać tylko wyniki, które zostały ostatnio zaobserwowane po 31 dniach temu.

limit
limit number

Limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Istnieje wbudowany limit liczby wyników zwracanych za pośrednictwem tych metod wyszukiwania. Domyślny limit jest ustawiony na 10 000. Ten limit można podnieść lub obniżyć, ustawiając parametr zapytania "limit". Dozwolona jest również maksymalna liczba wyników; żądanie limitu większego niż maksimum zwróci tylko wartość maksymalną. Aby uzyskać informacje na temat tej maksymalnej wartości, zobacz results_max poniżej. Jeśli jest używany parametr "?limit=0", baza danych DNSDB zwróci maksymalną dozwoloną liczbę wyników. Jeśli dla zapytania jest mniej wyników niż żądany limit, można zwrócić tylko rzeczywistą kwotę.

aggr
aggr boolean

Zagregowane wyniki grupują identyczne zestawy rrsets we wszystkich okresach i jest klasycznym zachowaniem podczas wykonywania zapytań względem bazy danych DNSDB. Oznacza to, że można uzyskać całkowitą liczbę zaobserwowanych rrsetów, ale nie wtedy, gdy zaobserwowano. Niezagregowane wyniki niezgrupowane identyczne zestawy rrset, co pozwala zobaczyć, jak nazwa domeny została rozpoznana w systemie DNS w pełnym zakresie czasu objętego systemem DNSDB (pod warunkiem ogrodzenia czasu). Może to dać dokładniejsze wrażenie woluminu żądania rekordu w czasie, ponieważ spowoduje to wyświetlenie odrębnych sygnatur czasowych rekordów, których wartości są powtarzane. Możesz odpowiedzieć na takie pytania: "Czy domena została zaparkowana przez długi czas, głównie nieużywany, dopóki nie została ponownie wykorzystana do obsługi złośliwego oprogramowania lub przekazywania spamu, ale potem została porzucona ponownie?". Pozwala to sprawdzić, czy rekord zaobserwowano mocno w zeszłym tygodniu vs. zaobserwowano stale przez lata. Jest to wartość logiczna. Użyj wartości True, wartości domyślnej dla zagregowanych wyników lub wartości False dla wyników nieagregowanych.

humantime
humantime boolean

Wartość logiczna, która ma wartość True, jeśli wartości czasu (w time_first, time_last, zone_time_first, zone_time_last) powinny być zwracane w formacie czytelnym dla człowieka (RFC3339 zgodnym) lub Fałsz, jeśli wartości czasu w stylu systemu Unix w sekundach od momentu zwrócenia epoki. False to klasyczne zachowanie podczas wykonywania zapytań względem bazy danych DNSDB i jest wartością domyślną dla tej opcji.

przesunąć
offset number

Ile wierszy do przesunięcia (np. pomiń) w wynikach. Implementuje to funkcję przyrostowego transferu wyników, umożliwiając wyświetlanie większej liczby dostępnych wyników dla pojedynczego zapytania. Wiersze są przesunięte przed zastosowaniem parametru limitu, dlatego przesunięcie umożliwia wyświetlanie dodatkowych wyników przeszłości limitu, który odpowiada maksymalnej liczbie wyników. Należy pamiętać, że baza danych DNSDB ponownie oblicza wyniki dla każdego zapytania, a kolejność wyników może nie zostać zachowana. W związku z tym ta funkcja nie jest prawidłowym sposobem na przejście wszystkich wyników w wielu zapytaniach — niektóre wyniki mogą być brakujące i niektóre mogą być zduplikowane. Rzeczywiste przesunięcie, którego można użyć, jest ograniczone lub w przypadku niektórych kluczy interfejsu API, przesunięcie jest niedozwolone — zobacz klucz offset_max rate_limit poniżej. Wartość przesunięcia musi być dodatnią liczbą całkowitą. Wartość domyślna to 0, co oznacza, że wiersze nie są przesunięte.

Zwraca

Definicje

RRSet_Results

Nazwa Ścieżka Typ Opis
Liczba
count number

Liczba zaobserwowanych wystąpień zestawu RRset za pośrednictwem pasywnej replikacji DNS.

Czas pierwszy
time_first number

Po raz pierwszy zaobserwowano RRset.

Czas ostatni
time_last number

Ostatni raz zaobserwowano RRset.

Czas strefy pierwszy
zone_time_first number

Przy pierwszym obserwowaniu zestawu RRset za pośrednictwem importu pliku strefy.

Czas strefy ostatniej
zone_time_last number

Ostatni raz, kiedy zestaw RRset był obserwowany za pośrednictwem importu pliku strefy.

RRName
rrname string

Nazwa właściciela zestawu RRset w formacie prezentacji DNS.

Typ RR
rrtype string

Typ rekordu zasobu zestawu RRset, używając standardowego typu DNS mnemonic lub typ ogólny RFC 3597, tj. typ ciągu natychmiast po numerze dziesiętnym RRtype.

Bailiwick
bailiwick string

Najbliżej otaczającej strefy delegowanej do serwera nazw, który obsługiwał zestaw RRset, lub nazwę strefy zawierającej RRset, jeśli FromZoneFile ma wartość True.

RData
rdata array of string

Tablica co najmniej jednej wartości Rdata. Wartości Rdata są konwertowane na standardowy format prezentacji na podstawie wartości rrtype. Jeśli koder nie ma formatu prezentacji specyficznego dla typu dla typu rrtype zestawu RRset, zostanie użyte ogólne kodowanie RFC 3597.

RData_Results

Nazwa Ścieżka Typ Opis
Liczba
count number

Liczba obserwowanych rekordów zasobów za pośrednictwem pasywnej replikacji DNS.

Czas pierwszy
time_first number

Przy pierwszym zaobserwowaniu rekordu zasobu.

Czas ostatni
time_last number

Ostatni raz zaobserwowano rekord zasobu.

Czas strefy pierwszy
zone_time_first number

Przy pierwszym obserwowaniu rekordu zasobu za pośrednictwem importu pliku strefy.

Czas strefy ostatniej
zone_time_last number

Ostatni raz rekord zasobu zaobserwowano za pośrednictwem importu pliku strefy.

RRName
rrname string

Nazwa właściciela rekordu zasobu w formacie prezentacji DNS.

Typ RR
rrtype string

Typ rekordu zasobu rekordu zasobu przy użyciu standardowego typu DNS mnemonic lub typ ogólny RFC 3597, tj. typ ciągu natychmiast po numerze dziesiętnym RRtype.

RData
rdata array of string

Wartość danych rekordu. Wartość Rdata jest konwertowana na standardowy format prezentacji na podstawie wartości rrtype. Jeśli koder nie ma formatu prezentacji specyficznego dla typu dla typu rekordu zasobu, zostanie użyte ogólne kodowanie RDATA RFC 3597.

Flex_Results

Nazwa Ścieżka Typ Opis
RData
rdata string

Wartość danych rekordu.

RRName
rrname string

Nazwa właściciela zestawu RRset w formacie prezentacji DNS.

Typ RR
rrtype string

Typ rekordu zasobu rekordu RRset/zasobu przy użyciu standardowego typu DNS mnemonic lub typ ogólny RFC 3597, tj. typ ciągu natychmiast po numerze dziesiętnym RRtype.

RAW_RDATA
raw_rdata string

Wartość danych rekordu jako pary cyfr szesnastkowych określające nieprzetworzone ciąg oktetu. Ta wartość służy do przestawiania z elastycznego wyszukiwania do wyszukiwania w warstwie Standardowa, aby uzyskać więcej szczegółów na temat danych rdata.

RateLimit_Results

Nazwa Ścieżka Typ Opis
Ograniczenie
limit number

Maksymalna liczba wyszukiwań interfejsu API, które mogą być wykonywane. Jest to początkowy limit przydziału.

Pozostały
remaining number

W przypadku limitów przydziałów opartych na czasie: pozostała liczba odnośników interfejsu API, które mogą być wykonywane do czasu zresetowania. W przypadku przydziałów opartych na blokach: pozostała liczba odnośników interfejsu API w przydziałie blokowym.

Zresetuj
reset number

W przypadku limitów przydziałów opartych na czasie: sygnatura czasowa epoki SYSTEMU UNIX z drugim szczegółowością wskazująca następny punkt w czasie, gdy limit przydziału zostanie zresetowany. Zazwyczaj jest to o 00:00 (północ) czasu UTC. W przypadku przydziałów opartych na blokach: wartość będzie wynosić "n/a"

Wygasa
expires number

Obecny tylko dla limitu przydziału opartego na blokach: sygnatura czasowa epoki SYSTEMU UNIX z drugim szczegółowością wskazującą, kiedy przydział wygaśnie.

Wynikmax
results_max number

Zwraca maksymalną liczbę wyników, które mogą być zwracane przez te metody wyszukiwania. Spowoduje to zastąpienie parametru zapytania "limit", jeśli zostanie podany. Jeśli na przykład parametr "?limit=20000" zostanie dołączony do ścieżki adresu URL, ale results_max=1000, zostanie zwróconych tylko do 1000 wyników.

OffsetMax
offset_max number

Maksymalna wartość parametru zapytania przesunięcia może być. Jeśli jest on wyższy, zostanie zwrócony kod odpowiedzi HTTP 416 "Żądany zakres nie satyfikowalny" z komunikatem "Błąd: wartość przesunięcia większa niż dozwolona maksymalna". Jeśli wartość to "n/a", parametr przesunięcia nie jest dozwolony dla tego klucza interfejsu API, a podobny błąd 416 zostanie wygenerowany.

BurstSize
burst_size number

Maksymalna liczba wyszukiwań interfejsu API, które mogą być wykonywane w ciągu tej burst_window liczby sekund.

BurstWindow
burst_window number

Liczba sekund, w których mierzona jest liczba zapytań.