Freigeben über


Farsight DNSDB

Farsight Security DNSDB ist die weltweit größte DNS-Intelligence-Datenbank, die eine faktenbasierte Ansicht der Konfiguration der globalen Internetinfrastruktur bietet. DNSDB nutzt farsights Data-Sharing-Plattform (Security Information Exchange, SIE) und wird von führenden DNS-Experten entwickelt und betrieben. Farsight sammelt, filtert und überprüft passive DNS-Daten aus seinem globalen Sensorarray. DNSDB ist der umfassendste und umfassendste DNS-Intelligence-Datendienst seiner Art.

Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:

Dienstleistung Class Regions
Copilot Studio Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Logik-Apps Norm Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche:
     – Azure Government-Regionen
     - Azure China-Regionen
     - US Department of Defense (DoD)
Power Apps Premium Alle Power Apps-Regionen mit Ausnahme der folgenden:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Power Automate Premium Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche:
     - US Government (GCC)
     - US Government (GCC High)
     - China Cloud betrieben von 21Vianet
     - US Department of Defense (DoD)
Kontakt
Name Technischer Support für Farsight Security
URL https://service.farsightsecurity.com/
Email support@farsightsecurity.com
Connectormetadaten
Herausgeber Farsight Security
Webseite https://www.farsightsecurity.com/
Datenschutzrichtlinie https://www.farsightsecurity.com/privacy-policy/
Kategorien Sicherheit; Daten

Voraussetzungen

Sie benötigen Folgendes, um fortzufahren:

  • Ein Microsoft Power Apps- oder Power Automate-Plan mit benutzerdefiniertem Connectorfeature
  • Ein Azure-Abonnement
  • Farsight DNSDB-API-Schlüssel

So erhalten Sie Anmeldeinformationen

Registrieren Sie sich für einen kostenlosen API-Schlüssel unter https://www.farsightsecurity.com/solutions/dnsdb/ .

Unterstützen:

Für alle Supportanfragen und allgemeine Anfragen können Sie sich an support@farsightsecurity.com oder kontaktieren

Eine Verbindung wird erstellt

Der Connector unterstützt die folgenden Authentifizierungstypen:

Vorgabe Parameter zum Erstellen einer Verbindung. Alle Regionen Nicht teilbar

Vorgabe

Anwendbar: Alle Regionen

Parameter zum Erstellen einer Verbindung.

Dies ist keine freigabefähige Verbindung. Wenn die Power-App für einen anderen Benutzer freigegeben wird, wird ein anderer Benutzer aufgefordert, eine neue Verbindung explizit zu erstellen.

Name Typ Description Erforderlich
Farsight DNSDB-API-Schlüssel securestring Der Farsight DNSDB-API-Schlüssel für diese API Richtig

Drosselungsgrenzwerte

Name Aufrufe Verlängerungszeitraum
API-Aufrufe pro Verbindung 100 60 Sekunden

Aktionen

Dienstbeschränkungen

Diensteinschränkung abrufen

Flexible Suche

Die flexible Suche fügt sowohl reguläre Ausdrücke als auch Globbing-Unterstützung zur DNSDB-API hinzu, um die Suchabfragetypen zu erweitern und Suchvorgängen mehr Kontrolle hinzuzufügen.

Ping

Diese Anforderung ist für End-to-End-Konnektivitätstests mit dem DNSDB-API-Endpunkt vorgesehen und informiert Sie, dass keine Firewallblockagen vorhanden sind. Für diese Anforderung ist kein API-Schlüssel erforderlich. Es gibt nur ein JSON-Objekt {'ping': 'ok'} zurück.

RData-Nachschlagevorgang

Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt.

RData-Nachschlagevorgang mit RRType

Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt.

RRSet Lookup mit RRType und Bailiwick

Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.

RRSet-Nachschlagevorgang

Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.

RRSet-Nachschlagevorgang mit RRType

Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.

Dienstbeschränkungen

Diensteinschränkung abrufen

Gibt zurück

Flexible Suche

Die flexible Suche fügt sowohl reguläre Ausdrücke als auch Globbing-Unterstützung zur DNSDB-API hinzu, um die Suchabfragetypen zu erweitern und Suchvorgängen mehr Kontrolle hinzuzufügen.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
method
method True string

flex search method (regex - regular expression search, glob - full wildcarding)

key
key True string

Suchschlüssel

value
value True string

Abfragewert

time_first_before (Unix/Epoche)
time_first_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden.

time_first_after (Unix/Epoche)
time_first_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden.

time_last_before (Unix/Epoche)
time_last_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden.

time_last_after (Unix/Epoche)
time_last_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden.

Begrenzung
limit number

Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden.

ausschließen
exclude string

Der Parameter "exclude" wird verwendet, um Ergebnisse auszuschließen (d. h. Filterout), die dem Parameter entsprechen. Es wird unten in dieser Tabelle beschrieben.

offset
offset number

Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden.

Gibt zurück

Ping

Diese Anforderung ist für End-to-End-Konnektivitätstests mit dem DNSDB-API-Endpunkt vorgesehen und informiert Sie, dass keine Firewallblockagen vorhanden sind. Für diese Anforderung ist kein API-Schlüssel erforderlich. Es gibt nur ein JSON-Objekt {'ping': 'ok'} zurück.

Gibt zurück

Name Pfad Typ Beschreibung
ping
ping string

ping

RData-Nachschlagevorgang

Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
type
type True string

Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Domänenname im Präsentationsformat oder ein linker ('c.example.com') oder ein rechtshändiger ('www.example.')-Wildcarddomänenname. Beachten Sie, dass linkshändige Wildcardabfragen etwas teurer sind als Rechts-Wildcard-Abfragen.,ip: Der WERT ist eine der einzelnen IPv4- oder IPv6-Adressen, mit Präfixlänge oder adressbereich. Wenn ein Präfix angegeben wird, ist das Trennzeichen zwischen der Netzwerkadresse und der Präfixlänge ein einzelnes Komma (',') anstelle des üblichen Schrägstrichs ('/'), um Konflikte mit dem HTTP-URI-Pfadnamentrennzeichen zu vermeiden., unformatiert: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben.

value
value True string

Abfragewert

time_first_before (Unix/Epoche)
time_first_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden.

time_first_after (Unix/Epoche)
time_first_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden.

time_last_before (Unix/Epoche)
time_last_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden.

time_last_after (Unix/Epoche)
time_last_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden.

Begrenzung
limit number

Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden.

aggr
aggr boolean

Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse.

Menschliche Zeit
humantime boolean

Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option.

offset
offset number

Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden.

Gibt zurück

RData-Nachschlagevorgang mit RRType

Die RData-Suche fragt den Rdata-Index von DNSDB ab, der umgekehrte Nachschlagevorgänge basierend auf Rdata-Eintragswerten unterstützt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
type
type True string

Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Domänenname im Präsentationsformat oder ein linker ('c.example.com') oder ein rechtshändiger ('www.example.')-Wildcarddomänenname. Beachten Sie, dass linkshändige Wildcardabfragen etwas teurer sind als Rechts-Wildcard-Abfragen.,ip: Der WERT ist eine der einzelnen IPv4- oder IPv6-Adressen, mit Präfixlänge oder adressbereich. Wenn ein Präfix angegeben wird, ist das Trennzeichen zwischen der Netzwerkadresse und der Präfixlänge ein einzelnes Komma (',') anstelle des üblichen Schrägstrichs ('/'), um Konflikte mit dem HTTP-URI-Pfadnamentrennzeichen zu vermeiden., unformatiert: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben.

value
value True string

Abfragewert

rrtype
rrtype True string

Abfrage-Rrtype

time_first_before (Unix/Epoche)
time_first_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden.

time_first_after (Unix/Epoche)
time_first_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden.

time_last_before (Unix/Epoche)
time_last_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden.

time_last_after (Unix/Epoche)
time_last_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden.

Begrenzung
limit number

Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden.

aggr
aggr boolean

Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse.

Menschliche Zeit
humantime boolean

Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option.

offset
offset number

Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden.

Gibt zurück

RRSet Lookup mit RRType und Bailiwick

Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
type
type True string

Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Besitzername im Präsentationsformat oder in Wildcards, wie unten beschrieben. Dies wird manchmal nur eine Rrset-Suche, unformatiert, aufgerufen: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben.

value
value True string

Abfragewert

rrtype
rrtype True string

Abfrage-Rrtype

Vogtei
bailiwick True string

Abfrage-Bailiwick

time_first_before (Unix/Epoche)
time_first_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden.

time_first_after (Unix/Epoche)
time_first_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden.

time_last_before (Unix/Epoche)
time_last_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden.

time_last_after (Unix/Epoche)
time_last_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden.

Begrenzung
limit number

Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden.

aggr
aggr boolean

Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse.

Menschliche Zeit
humantime boolean

Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option.

offset
offset number

Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden.

Gibt zurück

RRSet-Nachschlagevorgang

Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
type
type True string

Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Besitzername im Präsentationsformat oder in Wildcards, wie unten beschrieben. Dies wird manchmal nur eine Rrset-Suche, unformatiert, aufgerufen: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben.

value
value True string

Abfragewert

time_first_before (Unix/Epoche)
time_first_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden.

time_first_after (Unix/Epoche)
time_first_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden.

time_last_before (Unix/Epoche)
time_last_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden.

time_last_after (Unix/Epoche)
time_last_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden.

Begrenzung
limit number

Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden.

aggr
aggr boolean

Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse.

Menschliche Zeit
humantime boolean

Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option.

offset
offset number

Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden.

Gibt zurück

RRSet-Nachschlagevorgang mit RRType

Die RRSet-Suche fragt den RRset-Index von DNSDB ab, der Forward-Lookups basierend auf dem Besitzernamen eines RRsets unterstützt.

Parameter

Name Schlüssel Erforderlich Typ Beschreibung
type
type True string

Abfragetyp(Name, unformatierter) Name: Der WERT ist ein DNS-Besitzername im Präsentationsformat oder in Wildcards, wie unten beschrieben. Dies wird manchmal nur eine Rrset-Suche, unformatiert, aufgerufen: Der WERT ist eine gerade Anzahl hexadezimaler Ziffern, die eine unformatierte Oktettzeichenfolge angeben.

value
value True string

Abfragewert

rrtype
rrtype True string

Abfrage-Rrtype

time_first_before (Unix/Epoche)
time_first_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_before=1420070400" stellt beispielsweise nur übereinstimmende DNS-Einträge bereit, die zuerst vor dem 1. Januar 2015 (oder älter als) beobachtet wurden.

time_first_after (Unix/Epoche)
time_first_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den Zeitpunkt der ersten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_first_after=-31536000" liefert beispielsweise nur Ergebnisse, die im letzten Jahr zuerst beobachtet wurden.

time_last_before (Unix/Epoche)
time_last_before number

Geben Sie Ergebnisse vor dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Der URL-Parameter "time_last_before=1356998400" stellt beispielsweise nur Ergebnisse für DNS-Einträge bereit, die vor 2013 zuletzt beobachtet wurden.

time_last_after (Unix/Epoche)
time_last_after number

Geben Sie Ergebnisse nach dem definierten Zeitstempel für den zeitpunkt der letzten Beobachtung des DNS-Eintrags an. Beispielsweise stellt der URL-Parameter "time_last_after=-2678400" nur Ergebnisse bereit, die vor 31 Tagen zuletzt beobachtet wurden.

Begrenzung
limit number

Grenzwert für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Es gibt ein integriertes Limit für die Anzahl der Ergebnisse, die über diese Nachschlagemethoden zurückgegeben werden. Der Standardgrenzwert wird auf 10.000 festgelegt. Dieser Grenzwert kann durch Festlegen des Abfrageparameters "limit" ausgelöst oder herabgesetzt werden. Es gibt auch eine maximale Anzahl zulässiger Ergebnisse; Das Anfordern eines Grenzwerts, der größer als der Höchstwert ist, gibt nur das Maximum zurück. Weitere Informationen zu diesem Maximum finden Sie unter results_max weiter unten. Wenn "?limit=0" verwendet wird, gibt DNSDB die maximale Anzahl zulässiger Ergebnisse zurück. Wenn für die Abfrage weniger Ergebnisse als der angeforderte Grenzwert vorhanden sind, kann nur der tatsächliche Betrag zurückgegeben werden.

aggr
aggr boolean

Aggregierte Ergebnisse gruppieren identische rrsets über alle Zeiträume hinweg und ist das klassische Verhalten beim Abfragen der DNSDB. Dies bedeutet, dass Sie die Gesamtanzahl der Beobachteten eines Rrsets abrufen können, aber nicht, wenn es beobachtet wurde. Nicht aggregierte Ergebnisse heben die Gruppierung identischer Rrsets auf, sodass Sie sehen können, wie der Domänenname im DNS im vollständigen Bereich aufgelöst wurde, der in DNSDB behandelt wird (vorbehaltlich des Zeitfencings). Dies kann einen genaueren Eindruck des Datensatzanforderungsvolumens im Lauf der Zeit geben, da dadurch die unterschiedlichen Zeitstempel von Datensätzen angezeigt werden, deren Werte wiederholt werden. Sie können Fragen beantworten, z. B. "Wurde eine Domäne lange geparkt, meist nicht verwendet, bis sie für die Bereitstellung von Schadsoftware oder das Weiterleiten von Spam verwendet wurde, aber dann erneut abgebrochen wurde?". Es ermöglicht Ihnen zu sehen, ob ein Datensatz in der letzten Woche stark beobachtet wurde, vs. seit Jahren konstant beobachtet wurde. Dies ist ein boolescher Wert. Verwenden Sie "True", die Standardeinstellung für die aggregierten Ergebnisse oder "False" für nicht aggregierte Ergebnisse.

Menschliche Zeit
humantime boolean

Ein boolescher Wert, der True ist, wenn Zeitwerte (in time_first, time_last, zone_time_first, zone_time_last) im lesbaren (RFC3339 konformen) Format oder False zurückgegeben werden sollen, wenn Unix-Zeitwerte in Sekunden seit der Rückgabe der Epoche zurückgegeben werden sollen. False ist das klassische Verhalten beim Abfragen der DNSDB und ist der Standardwert für diese Option.

offset
offset number

Wie viele Zeilen in den Ergebnissen versetzt werden sollen (z. B. überspringen). Dadurch wird ein inkrementelles Ergebnisübertragungsfeature implementiert, mit dem Sie mehr der verfügbaren Ergebnisse für eine einzelne Abfrage anzeigen können. Die Zeilen werden vor dem angewendeten Limitparameter versetzt, sodass offset zusätzliche Ergebnisse über einen Grenzwert hinaus sehen kann, der der maximalen Anzahl von Ergebnissen entspricht. Beachten Sie, dass DNSDB die Ergebnisse für jede Abfrage neu berechnet und die Reihenfolge der Ergebnisse möglicherweise nicht beibehalten wird. Daher ist diese Funktion kein gültiger Weg, um alle Ergebnisse über mehrere Abfragen zu durchlaufen – einige Ergebnisse fehlen möglicherweise, und einige werden möglicherweise dupliziert. Der tatsächliche Offset, der verwendet werden kann, ist begrenzt oder für bestimmte API-Schlüssel, Offset ist nicht zulässig . Siehe den offset_max rate_limit Schlüssel unten. Der Offsetwert muss eine positive ganze Zahl sein. Der Standardwert ist 0, was bedeutet, dass die Zeilen nicht versetzt werden.

Gibt zurück

Definitionen

RRSet_Results

Name Pfad Typ Beschreibung
Anzahl
count number

Die Häufigkeit, mit der das RRset über die passive DNS-Replikation beobachtet wurde.

Erstmaliges Mal
time_first number

Das erste Mal, dass das RRset beobachtet wurde.

Uhrzeit zuletzt
time_last number

Die jüngste Zeit, zu der das RRset beobachtet wurde.

Zone Time First
zone_time_first number

Das erste Mal, dass das RRset über den Zonendateiimport beobachtet wurde.

Zone Time Last
zone_time_last number

Das letzte Mal, dass das RRset über den Zonendateiimport beobachtet wurde.

RRName
rrname string

Der Besitzername des RRset im DNS-Präsentationsformat.

RRType
rrtype string

Der Ressourceneintragstyp des RRsets, entweder unter Verwendung des standardmäßigen DNS-Typs Mnemonic oder eines generischen RFC 3597-Typs, d. h. der ZeichenfolgeNTYP unmittelbar gefolgt von der Dezimal-RRtype-Zahl.

Vogtei
bailiwick string

Die nächstgelegene umschließende Zone, die an einen Namenserver delegiert wird, der das RRset bedient hat, oder der Name der Zone, die das RRset enthält, wenn FromZoneFile "True" ist.

RData
rdata array of string

Ein Array mit mindestens einem Rdata-Wert. Die Rdata-Werte werden basierend auf dem Rrtype-Wert in das Standardpräsentationsformat konvertiert. Wenn der Encoder kein typspezifisches Präsentationsformat für den RRset-Rrtype aufweist, wird die generische Rdata-Codierung RFC 3597 verwendet.

RData_Results

Name Pfad Typ Beschreibung
Anzahl
count number

Die Häufigkeit, mit der der Ressourceneintrag über die passive DNS-Replikation beobachtet wurde.

Erstmaliges Mal
time_first number

Das erste Mal, dass der Ressourcendatensatz beobachtet wurde.

Uhrzeit zuletzt
time_last number

Die letzte Zeit, zu der der Ressourcendatensatz beobachtet wurde.

Zone Time First
zone_time_first number

Das erste Mal, dass der Ressourcendatensatz über den Zonendateiimport beobachtet wurde.

Zone Time Last
zone_time_last number

Das letzte Mal, dass der Ressourcendatensatz über den Zonendateiimport beobachtet wurde.

RRName
rrname string

Der Besitzername des Ressourceneintrags im DNS-Präsentationsformat.

RRType
rrtype string

Der Ressourceneintragstyp des Ressourceneintrags, entweder mit dem standardmäßigen DNS-Typ Mnemonic oder einem generischen RFC 3597-Typ, d. h. dem ZeichenfolgenTYP unmittelbar gefolgt von der dezimalen RRtype-Nummer.

RData
rdata array of string

Der Datensatzdatenwert. Der Rdata-Wert wird basierend auf dem Rrtype-Wert in das Standardpräsentationsformat konvertiert. Wenn der Encoder kein typspezifisches Präsentationsformat für den Ressourcendatensatztyp aufweist, wird die generische Rdata-Codierung RFC 3597 verwendet.

Flex_Results

Name Pfad Typ Beschreibung
RData
rdata string

Der Datensatzdatenwert.

RRName
rrname string

Der Besitzername des RRset im DNS-Präsentationsformat.

RRType
rrtype string

Der Ressourceneintragstyp des RRset/Resource-Eintrags, entweder unter Verwendung des standardmäßigen DNS-Typs Mnemonic oder eines generischen RFC 3597-Typs, d. h. der ZeichenfolgeNTYP unmittelbar gefolgt von der dezimalen RRtype-Zahl.

RAW_RDATA
raw_rdata string

Der Datensatzdatenwert als Paare von Hexadezimierungen, die eine unformatierte Oktettzeichenfolge angeben. Dieser Wert wird für das Pivoting von flexibler Suche in die Standardsuche verwendet, um weitere Details zu rdata zu erhalten.

RateLimit_Results

Name Pfad Typ Beschreibung
Limit
limit number

Die maximale Anzahl von API-Nachschlagevorgängen, die ausgeführt werden können. Dies ist das anfängliche Kontingent.

Verbleibend
remaining number

Für zeitbasierte Kontingente: die verbleibende Anzahl von API-Nachschlagevorgängen, die bis zur Zurücksetzungszeit ausgeführt werden können. Für blockbasierte Kontingente: die verbleibende Anzahl von API-Nachschlagevorgängen im Blockkontingent.

Zurücksetzen
reset number

Für zeitbasierte Kontingente: UNIX-Zeitstempel mit zweiter Granularität, der den nächsten Zeitpunkt angibt, an dem das Kontingentlimit zurückgesetzt wird. In der Regel ist dies um 00:00 (Mitternacht) UTC. Für blockbasierte Kontingente: Der Wert lautet "n/a"

Läuft ab
expires number

Nur für blockbasiertes Kontingent vorhanden: UNIX-Zeitstempel mit zweiter Granularität, der angibt, wann das Kontingent abläuft.

ResultsMax
results_max number

Gibt die maximale Anzahl von Ergebnissen zurück, die von diesen Nachschlagemethoden zurückgegeben werden können. Dadurch wird ein Abfrageparameter "limit" außer Kraft gesetzt, falls angegeben. Wenn beispielsweise "?limit=20000" an den URL-Pfad angefügt wird, aber results_max=1000 dann nur bis zu 1000 Ergebnisse zurückgegeben werden.

OffsetMax
offset_max number

Der Maximalwert, den der Offsetabfrageparameter sein kann. Wenn sie höher ist, wird der Antwortcode "Angeforderter Bereich nicht satisfiable" mit der Meldung "Fehler: Offsetwert größer als maximal zulässig" zurückgegeben. Wenn der Wert "n/a" lautet, ist der Offsetparameter für diesen API-Schlüssel nicht zulässig, und ein ähnlicher 416-Fehler wird generiert.

BurstSize
burst_size number

Die maximale Anzahl von API-Nachschlagevorgängen, die innerhalb dieses burst_window Anzahl von Sekunden ausgeführt werden können.

BurstWindow
burst_window number

Die Anzahl der Sekunden, über die ein Ausplatzen von Abfragen gemessen wird.