Compartir a través de


Farsight DNSDB

Farsight Security DNSDB es la base de datos de inteligencia DE DNS más grande del mundo que proporciona una vista basada en hechos de la configuración de la infraestructura global de Internet. DNSDB aprovecha la plataforma de intercambio de información de seguridad (SIE) de Farsight y está diseñada y operada por expertos líderes en DNS. Farsight recopila, filtra y comprueba los datos de DNS pasivo de su matriz global de sensores. DNSDB es el servicio de datos de inteligencia de DNS más completo y de alta calidad de su tipo.

Este conector está disponible en los siguientes productos y regiones:

Service Class Regions
Copilot Studio Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Aplicaciones lógicas Estándar Todas las regiones de Logic Apps excepto las siguientes:
     - Regiones de Azure Government
     - Regiones de Azure China
     - Departamento de Defensa de EE. UU. (DoD)
Power Apps Premium Todas las regiones de Power Apps excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Power Automate Premium Todas las regiones de Power Automate excepto las siguientes:
     - Gobierno de EE. UU. (GCC)
     - Gobierno de EE. UU. (GCC High)
     - China Cloud operado por 21Vianet
     - Departamento de Defensa de EE. UU. (DoD)
Contacto
Nombre Soporte técnico de seguridad de Farsight
URL https://service.farsightsecurity.com/
Correo Electrónico support@farsightsecurity.com
Metadatos del conector
Publicador Seguridad de Farsight
Sitio web https://www.farsightsecurity.com/
Directiva de privacidad https://www.farsightsecurity.com/privacy-policy/
Categorías Seguridad; Datos

Requisitos previos

Necesitará lo siguiente para continuar:

  • Un plan de Microsoft Power Apps o Power Automate con una característica de conector personalizada
  • Una suscripción de Azure
  • Clave de API de DNSDB de Farsight

Obtención de credenciales

Regístrese para obtener una clave de API gratuita en https://www.farsightsecurity.com/solutions/dnsdb/ .

Apoyo:

Para todas las solicitudes de soporte técnico y las consultas generales, puede ponerse en contacto con support@farsightsecurity.comnosotros o ponerse en contacto con nosotros

Creación de una conexión

El conector admite los siguientes tipos de autenticación:

Predeterminado Parámetros para crear una conexión. Todas las regiones No se puede compartir

Predeterminado

Aplicable: Todas las regiones

Parámetros para crear una conexión.

Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.

Nombre Tipo Description Obligatorio
Clave de API de DNSDB de Farsight securestring La clave de API de DNSDB de Farsight para esta API Cierto

Limitaciones

Nombre Llamadas Período de renovación
Llamadas API por conexión 100 60 segundos

Acciones

Búsqueda de RData

La búsqueda de RData consulta el índice de Rdata de DNSDB, que admite búsquedas inversas basadas en valores de registro de Rdata.

Búsqueda de RData con RRType

La búsqueda de RData consulta el índice de Rdata de DNSDB, que admite búsquedas inversas basadas en valores de registro de Rdata.

Búsqueda flexible

La búsqueda flexible agrega compatibilidad con expresiones regulares y Globbing a la API de DNSDB para expandir los tipos de consultas de búsqueda y agregar más control a las búsquedas.

Búsqueda rrset

La búsqueda RRSet consulta el índice RRset de DNSDB, que admite búsquedas directas basadas en el nombre de propietario de un RRset.

Búsqueda RRSet con RRType

La búsqueda RRSet consulta el índice RRset de DNSDB, que admite búsquedas directas basadas en el nombre de propietario de un RRset.

Búsqueda RRSet con RRType y Bailiwick

La búsqueda RRSet consulta el índice RRset de DNSDB, que admite búsquedas directas basadas en el nombre de propietario de un RRset.

Límites de servicio

Recuperación de límites de servicio

Ping

Esta solicitud es para pruebas de conectividad de un extremo a otro al punto de conexión de la API de DNSDB, lo que le indica que no hay bloqueos del firewall. Esta solicitud no requiere una clave de API. Devuelve solo un objeto JSON {'ping': 'ok'}.

Búsqueda de RData

La búsqueda de RData consulta el índice de Rdata de DNSDB, que admite búsquedas inversas basadas en valores de registro de Rdata.

Parámetros

Nombre Clave Requerido Tipo Description
type
type True string

Nombre de tipo de consulta(nombre, sin formato): VALUE es un nombre de dominio DNS en formato de presentación o un nombre de dominio con caracteres comodín a la izquierda ("c.example.com") o a la derecha ('www.example.'). Tenga en cuenta que las consultas con caracteres comodín izquierdo son algo más costosas que las consultas con caracteres comodín de derecha.ip: VALUE es una de una dirección única IPv4 o IPv6, con una longitud de prefijo o con un intervalo de direcciones. Si se proporciona un prefijo, el delimitador entre la dirección de red y la longitud del prefijo es un solo carácter de coma (',') en lugar del carácter de barra diagonal habitual ('/') para evitar conflictos con el separador de nombre de ruta de acceso de URI HTTP. Sin procesar: Value es un número par de dígitos hexadecimales que especifican una cadena de octeto sin formato.

value
value True string

Valor de consulta

time_first_before (hora unix/época)
time_first_before number

Proporcione resultados antes de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro de dirección URL "time_first_before=1420070400" solo proporcionará registros DNS coincidentes que se observaron por primera vez antes del 1 de enero de 2015 (o anteriores a).

time_first_after (hora unix/época)
time_first_after number

Proporcione resultados después de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro URL "time_first_after=-31536000" solo proporcionará resultados que se observaron por primera vez en el último año.

time_last_before (hora unix/época)
time_last_before number

Proporcione resultados antes de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro URL "time_last_before=1356998400" solo proporcionará resultados para los registros DNS que se observaron por última vez antes de 2013.

time_last_after (hora unix/época)
time_last_after number

Proporcione resultados después de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro de dirección URL "time_last_after=-2678400" solo proporcionará resultados que se observaron por última vez después de hace 31 días.

limit
limit number

Límite del número de resultados devueltos a través de estos métodos de búsqueda. Hay un límite integrado para el número de resultados que se devuelven a través de estos métodos de búsqueda. El límite predeterminado se establece en 10 000. Este límite se puede aumentar o reducir estableciendo el parámetro de consulta "limit". También se permite un número máximo de resultados; la solicitud de un límite mayor que el máximo solo devolverá el máximo. Consulte results_max siguiente para obtener información sobre ese máximo. Si se usa '?limit=0', DNSDB devolverá el número máximo de resultados permitidos. Si hay menos resultados para la consulta que el límite solicitado, solo se puede devolver la cantidad real.

aggr
aggr boolean

Los conjuntos de resultados agregados agrupan valores rrset idénticos en todos los períodos de tiempo y es el comportamiento clásico de la consulta de DNSDB. Esto significa que podría obtener el número total de veces que se ha observado un rrset, pero no cuando se observó. Los resultados no agregados desagrupan conjuntos rrset idénticos, lo que le permite ver cómo se resolvió el nombre de dominio en el DNS en el intervalo de tiempo completo cubierto en DNSDB (sujeto a barreras de tiempo). Esto puede dar una impresión más precisa del volumen de solicitudes de registro a lo largo del tiempo, ya que revelará las marcas de tiempo distintas de los registros cuyos valores se repiten. Puedes responder a preguntas como:"Era un dominio estacionado durante mucho tiempo, principalmente sin usar, hasta que se reasignaba para servir malware o retransmitir correo no deseado, pero luego se abandonó de nuevo?". Permite ver si se observó un registro en gran medida en la última semana frente a haber sido observado constantemente durante años. Se trata de un valor booleano. Use True, el valor predeterminado, para los resultados agregados o False para los resultados no agregados.

humantime
humantime boolean

Valor booleano que es True si los valores de hora (en time_first, time_last, zone_time_first, zone_time_last) deben devolverse en formato legible (RFC3339 compatible) o False si se deben devolver valores de tiempo de estilo Unix en segundos desde la época. False es el comportamiento clásico de la consulta de DNSDB y es el valor predeterminado de esta opción.

offset
offset number

Número de filas que se van a desplazar (por ejemplo, omitir) en los resultados. Esto implementa una característica de transferencia de resultados incremental, lo que le permite ver más de los resultados disponibles para una sola consulta. Las filas se desplazan antes del parámetro limit que se aplica, por lo que el desplazamiento permite ver resultados adicionales más allá de un límite que coincida con el número máximo de resultados. Tenga en cuenta que DNSDB recalcula los resultados de cada consulta y es posible que no se conserve el orden de los resultados. Por lo tanto, esta funcionalidad no es una manera válida de recorrer todos los resultados en varias consultas: es posible que falten algunos resultados y que algunos se dupliquen. El desplazamiento real que se puede usar es limitado o para determinadas claves de API, no se permite el desplazamiento; consulte la clave offset_max rate_limit siguiente. El valor de desplazamiento debe ser un entero positivo. El valor predeterminado es 0, lo que significa que no se desplazan las filas.

Devoluciones

Búsqueda de RData con RRType

La búsqueda de RData consulta el índice de Rdata de DNSDB, que admite búsquedas inversas basadas en valores de registro de Rdata.

Parámetros

Nombre Clave Requerido Tipo Description
type
type True string

Nombre de tipo de consulta(nombre, sin formato): VALUE es un nombre de dominio DNS en formato de presentación o un nombre de dominio con caracteres comodín a la izquierda ("c.example.com") o a la derecha ('www.example.'). Tenga en cuenta que las consultas con caracteres comodín izquierdo son algo más costosas que las consultas con caracteres comodín de derecha.ip: VALUE es una de una dirección única IPv4 o IPv6, con una longitud de prefijo o con un intervalo de direcciones. Si se proporciona un prefijo, el delimitador entre la dirección de red y la longitud del prefijo es un solo carácter de coma (',') en lugar del carácter de barra diagonal habitual ('/') para evitar conflictos con el separador de nombre de ruta de acceso de URI HTTP. Sin procesar: Value es un número par de dígitos hexadecimales que especifican una cadena de octeto sin formato.

value
value True string

Valor de consulta

rrtype
rrtype True string

Query rrtype

time_first_before (hora unix/época)
time_first_before number

Proporcione resultados antes de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro de dirección URL "time_first_before=1420070400" solo proporcionará registros DNS coincidentes que se observaron por primera vez antes del 1 de enero de 2015 (o anteriores a).

time_first_after (hora unix/época)
time_first_after number

Proporcione resultados después de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro URL "time_first_after=-31536000" solo proporcionará resultados que se observaron por primera vez en el último año.

time_last_before (hora unix/época)
time_last_before number

Proporcione resultados antes de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro URL "time_last_before=1356998400" solo proporcionará resultados para los registros DNS que se observaron por última vez antes de 2013.

time_last_after (hora unix/época)
time_last_after number

Proporcione resultados después de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro de dirección URL "time_last_after=-2678400" solo proporcionará resultados que se observaron por última vez después de hace 31 días.

limit
limit number

Límite del número de resultados devueltos a través de estos métodos de búsqueda. Hay un límite integrado para el número de resultados que se devuelven a través de estos métodos de búsqueda. El límite predeterminado se establece en 10 000. Este límite se puede aumentar o reducir estableciendo el parámetro de consulta "limit". También se permite un número máximo de resultados; la solicitud de un límite mayor que el máximo solo devolverá el máximo. Consulte results_max siguiente para obtener información sobre ese máximo. Si se usa '?limit=0', DNSDB devolverá el número máximo de resultados permitidos. Si hay menos resultados para la consulta que el límite solicitado, solo se puede devolver la cantidad real.

aggr
aggr boolean

Los conjuntos de resultados agregados agrupan valores rrset idénticos en todos los períodos de tiempo y es el comportamiento clásico de la consulta de DNSDB. Esto significa que podría obtener el número total de veces que se ha observado un rrset, pero no cuando se observó. Los resultados no agregados desagrupan conjuntos rrset idénticos, lo que le permite ver cómo se resolvió el nombre de dominio en el DNS en el intervalo de tiempo completo cubierto en DNSDB (sujeto a barreras de tiempo). Esto puede dar una impresión más precisa del volumen de solicitudes de registro a lo largo del tiempo, ya que revelará las marcas de tiempo distintas de los registros cuyos valores se repiten. Puedes responder a preguntas como:"Era un dominio estacionado durante mucho tiempo, principalmente sin usar, hasta que se reasignaba para servir malware o retransmitir correo no deseado, pero luego se abandonó de nuevo?". Permite ver si se observó un registro en gran medida en la última semana frente a haber sido observado constantemente durante años. Se trata de un valor booleano. Use True, el valor predeterminado, para los resultados agregados o False para los resultados no agregados.

humantime
humantime boolean

Valor booleano que es True si los valores de hora (en time_first, time_last, zone_time_first, zone_time_last) deben devolverse en formato legible (RFC3339 compatible) o False si se deben devolver valores de tiempo de estilo Unix en segundos desde la época. False es el comportamiento clásico de la consulta de DNSDB y es el valor predeterminado de esta opción.

offset
offset number

Número de filas que se van a desplazar (por ejemplo, omitir) en los resultados. Esto implementa una característica de transferencia de resultados incremental, lo que le permite ver más de los resultados disponibles para una sola consulta. Las filas se desplazan antes del parámetro limit que se aplica, por lo que el desplazamiento permite ver resultados adicionales más allá de un límite que coincida con el número máximo de resultados. Tenga en cuenta que DNSDB recalcula los resultados de cada consulta y es posible que no se conserve el orden de los resultados. Por lo tanto, esta funcionalidad no es una manera válida de recorrer todos los resultados en varias consultas: es posible que falten algunos resultados y que algunos se dupliquen. El desplazamiento real que se puede usar es limitado o para determinadas claves de API, no se permite el desplazamiento; consulte la clave offset_max rate_limit siguiente. El valor de desplazamiento debe ser un entero positivo. El valor predeterminado es 0, lo que significa que no se desplazan las filas.

Devoluciones

Búsqueda flexible

La búsqueda flexible agrega compatibilidad con expresiones regulares y Globbing a la API de DNSDB para expandir los tipos de consultas de búsqueda y agregar más control a las búsquedas.

Parámetros

Nombre Clave Requerido Tipo Description
method
method True string

Método de búsqueda flex (regex - búsqueda de expresiones regulares, glob - carácter comodín completo)

key
key True string

clave de búsqueda

value
value True string

Valor de consulta

time_first_before (hora unix/época)
time_first_before number

Proporcione resultados antes de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro de dirección URL "time_first_before=1420070400" solo proporcionará registros DNS coincidentes que se observaron por primera vez antes del 1 de enero de 2015 (o anteriores a).

time_first_after (hora unix/época)
time_first_after number

Proporcione resultados después de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro URL "time_first_after=-31536000" solo proporcionará resultados que se observaron por primera vez en el último año.

time_last_before (hora unix/época)
time_last_before number

Proporcione resultados antes de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro URL "time_last_before=1356998400" solo proporcionará resultados para los registros DNS que se observaron por última vez antes de 2013.

time_last_after (hora unix/época)
time_last_after number

Proporcione resultados después de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro de dirección URL "time_last_after=-2678400" solo proporcionará resultados que se observaron por última vez después de hace 31 días.

limit
limit number

Límite del número de resultados devueltos a través de estos métodos de búsqueda. Hay un límite integrado para el número de resultados que se devuelven a través de estos métodos de búsqueda. El límite predeterminado se establece en 10 000. Este límite se puede aumentar o reducir estableciendo el parámetro de consulta "limit". También se permite un número máximo de resultados; la solicitud de un límite mayor que el máximo solo devolverá el máximo. Consulte results_max siguiente para obtener información sobre ese máximo. Si se usa '?limit=0', DNSDB devolverá el número máximo de resultados permitidos. Si hay menos resultados para la consulta que el límite solicitado, solo se puede devolver la cantidad real.

excluir
exclude string

El parámetro 'exclude' se usa para excluir (es decir, filtrar) los resultados que coinciden con él. Se describe debajo de esta tabla.

offset
offset number

Número de filas que se van a desplazar (por ejemplo, omitir) en los resultados. Esto implementa una característica de transferencia de resultados incremental, lo que le permite ver más de los resultados disponibles para una sola consulta. Las filas se desplazan antes del parámetro limit que se aplica, por lo que el desplazamiento permite ver resultados adicionales más allá de un límite que coincida con el número máximo de resultados. Tenga en cuenta que DNSDB recalcula los resultados de cada consulta y es posible que no se conserve el orden de los resultados. Por lo tanto, esta funcionalidad no es una manera válida de recorrer todos los resultados en varias consultas: es posible que falten algunos resultados y que algunos se dupliquen. El desplazamiento real que se puede usar es limitado o para determinadas claves de API, no se permite el desplazamiento; consulte la clave offset_max rate_limit siguiente. El valor de desplazamiento debe ser un entero positivo. El valor predeterminado es 0, lo que significa que no se desplazan las filas.

Devoluciones

Búsqueda rrset

La búsqueda RRSet consulta el índice RRset de DNSDB, que admite búsquedas directas basadas en el nombre de propietario de un RRset.

Parámetros

Nombre Clave Requerido Tipo Description
type
type True string

Nombre de tipo de consulta(nombre, sin formato): VALUE es un nombre de propietario DNS en formato de presentación o caracteres comodín, tal como se describe a continuación. A veces, llamamos a esto solo una búsqueda rrset, sin formato: EL VALOR es un número par de dígitos hexadecimales que especifican una cadena de octeto sin formato.

value
value True string

Valor de consulta

time_first_before (hora unix/época)
time_first_before number

Proporcione resultados antes de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro de dirección URL "time_first_before=1420070400" solo proporcionará registros DNS coincidentes que se observaron por primera vez antes del 1 de enero de 2015 (o anteriores a).

time_first_after (hora unix/época)
time_first_after number

Proporcione resultados después de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro URL "time_first_after=-31536000" solo proporcionará resultados que se observaron por primera vez en el último año.

time_last_before (hora unix/época)
time_last_before number

Proporcione resultados antes de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro URL "time_last_before=1356998400" solo proporcionará resultados para los registros DNS que se observaron por última vez antes de 2013.

time_last_after (hora unix/época)
time_last_after number

Proporcione resultados después de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro de dirección URL "time_last_after=-2678400" solo proporcionará resultados que se observaron por última vez después de hace 31 días.

limit
limit number

Límite del número de resultados devueltos a través de estos métodos de búsqueda. Hay un límite integrado para el número de resultados que se devuelven a través de estos métodos de búsqueda. El límite predeterminado se establece en 10 000. Este límite se puede aumentar o reducir estableciendo el parámetro de consulta "limit". También se permite un número máximo de resultados; la solicitud de un límite mayor que el máximo solo devolverá el máximo. Consulte results_max siguiente para obtener información sobre ese máximo. Si se usa '?limit=0', DNSDB devolverá el número máximo de resultados permitidos. Si hay menos resultados para la consulta que el límite solicitado, solo se puede devolver la cantidad real.

aggr
aggr boolean

Los conjuntos de resultados agregados agrupan valores rrset idénticos en todos los períodos de tiempo y es el comportamiento clásico de la consulta de DNSDB. Esto significa que podría obtener el número total de veces que se ha observado un rrset, pero no cuando se observó. Los resultados no agregados desagrupan conjuntos rrset idénticos, lo que le permite ver cómo se resolvió el nombre de dominio en el DNS en el intervalo de tiempo completo cubierto en DNSDB (sujeto a barreras de tiempo). Esto puede dar una impresión más precisa del volumen de solicitudes de registro a lo largo del tiempo, ya que revelará las marcas de tiempo distintas de los registros cuyos valores se repiten. Puedes responder a preguntas como:"Era un dominio estacionado durante mucho tiempo, principalmente sin usar, hasta que se reasignaba para servir malware o retransmitir correo no deseado, pero luego se abandonó de nuevo?". Permite ver si se observó un registro en gran medida en la última semana frente a haber sido observado constantemente durante años. Se trata de un valor booleano. Use True, el valor predeterminado, para los resultados agregados o False para los resultados no agregados.

humantime
humantime boolean

Valor booleano que es True si los valores de hora (en time_first, time_last, zone_time_first, zone_time_last) deben devolverse en formato legible (RFC3339 compatible) o False si se deben devolver valores de tiempo de estilo Unix en segundos desde la época. False es el comportamiento clásico de la consulta de DNSDB y es el valor predeterminado de esta opción.

offset
offset number

Número de filas que se van a desplazar (por ejemplo, omitir) en los resultados. Esto implementa una característica de transferencia de resultados incremental, lo que le permite ver más de los resultados disponibles para una sola consulta. Las filas se desplazan antes del parámetro limit que se aplica, por lo que el desplazamiento permite ver resultados adicionales más allá de un límite que coincida con el número máximo de resultados. Tenga en cuenta que DNSDB recalcula los resultados de cada consulta y es posible que no se conserve el orden de los resultados. Por lo tanto, esta funcionalidad no es una manera válida de recorrer todos los resultados en varias consultas: es posible que falten algunos resultados y que algunos se dupliquen. El desplazamiento real que se puede usar es limitado o para determinadas claves de API, no se permite el desplazamiento; consulte la clave offset_max rate_limit siguiente. El valor de desplazamiento debe ser un entero positivo. El valor predeterminado es 0, lo que significa que no se desplazan las filas.

Devoluciones

Búsqueda RRSet con RRType

La búsqueda RRSet consulta el índice RRset de DNSDB, que admite búsquedas directas basadas en el nombre de propietario de un RRset.

Parámetros

Nombre Clave Requerido Tipo Description
type
type True string

Nombre de tipo de consulta(nombre, sin formato): VALUE es un nombre de propietario DNS en formato de presentación o caracteres comodín, tal como se describe a continuación. A veces, llamamos a esto solo una búsqueda rrset, sin formato: EL VALOR es un número par de dígitos hexadecimales que especifican una cadena de octeto sin formato.

value
value True string

Valor de consulta

rrtype
rrtype True string

Query rrtype

time_first_before (hora unix/época)
time_first_before number

Proporcione resultados antes de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro de dirección URL "time_first_before=1420070400" solo proporcionará registros DNS coincidentes que se observaron por primera vez antes del 1 de enero de 2015 (o anteriores a).

time_first_after (hora unix/época)
time_first_after number

Proporcione resultados después de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro URL "time_first_after=-31536000" solo proporcionará resultados que se observaron por primera vez en el último año.

time_last_before (hora unix/época)
time_last_before number

Proporcione resultados antes de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro URL "time_last_before=1356998400" solo proporcionará resultados para los registros DNS que se observaron por última vez antes de 2013.

time_last_after (hora unix/época)
time_last_after number

Proporcione resultados después de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro de dirección URL "time_last_after=-2678400" solo proporcionará resultados que se observaron por última vez después de hace 31 días.

limit
limit number

Límite del número de resultados devueltos a través de estos métodos de búsqueda. Hay un límite integrado para el número de resultados que se devuelven a través de estos métodos de búsqueda. El límite predeterminado se establece en 10 000. Este límite se puede aumentar o reducir estableciendo el parámetro de consulta "limit". También se permite un número máximo de resultados; la solicitud de un límite mayor que el máximo solo devolverá el máximo. Consulte results_max siguiente para obtener información sobre ese máximo. Si se usa '?limit=0', DNSDB devolverá el número máximo de resultados permitidos. Si hay menos resultados para la consulta que el límite solicitado, solo se puede devolver la cantidad real.

aggr
aggr boolean

Los conjuntos de resultados agregados agrupan valores rrset idénticos en todos los períodos de tiempo y es el comportamiento clásico de la consulta de DNSDB. Esto significa que podría obtener el número total de veces que se ha observado un rrset, pero no cuando se observó. Los resultados no agregados desagrupan conjuntos rrset idénticos, lo que le permite ver cómo se resolvió el nombre de dominio en el DNS en el intervalo de tiempo completo cubierto en DNSDB (sujeto a barreras de tiempo). Esto puede dar una impresión más precisa del volumen de solicitudes de registro a lo largo del tiempo, ya que revelará las marcas de tiempo distintas de los registros cuyos valores se repiten. Puedes responder a preguntas como:"Era un dominio estacionado durante mucho tiempo, principalmente sin usar, hasta que se reasignaba para servir malware o retransmitir correo no deseado, pero luego se abandonó de nuevo?". Permite ver si se observó un registro en gran medida en la última semana frente a haber sido observado constantemente durante años. Se trata de un valor booleano. Use True, el valor predeterminado, para los resultados agregados o False para los resultados no agregados.

humantime
humantime boolean

Valor booleano que es True si los valores de hora (en time_first, time_last, zone_time_first, zone_time_last) deben devolverse en formato legible (RFC3339 compatible) o False si se deben devolver valores de tiempo de estilo Unix en segundos desde la época. False es el comportamiento clásico de la consulta de DNSDB y es el valor predeterminado de esta opción.

offset
offset number

Número de filas que se van a desplazar (por ejemplo, omitir) en los resultados. Esto implementa una característica de transferencia de resultados incremental, lo que le permite ver más de los resultados disponibles para una sola consulta. Las filas se desplazan antes del parámetro limit que se aplica, por lo que el desplazamiento permite ver resultados adicionales más allá de un límite que coincida con el número máximo de resultados. Tenga en cuenta que DNSDB recalcula los resultados de cada consulta y es posible que no se conserve el orden de los resultados. Por lo tanto, esta funcionalidad no es una manera válida de recorrer todos los resultados en varias consultas: es posible que falten algunos resultados y que algunos se dupliquen. El desplazamiento real que se puede usar es limitado o para determinadas claves de API, no se permite el desplazamiento; consulte la clave offset_max rate_limit siguiente. El valor de desplazamiento debe ser un entero positivo. El valor predeterminado es 0, lo que significa que no se desplazan las filas.

Devoluciones

Búsqueda RRSet con RRType y Bailiwick

La búsqueda RRSet consulta el índice RRset de DNSDB, que admite búsquedas directas basadas en el nombre de propietario de un RRset.

Parámetros

Nombre Clave Requerido Tipo Description
type
type True string

Nombre de tipo de consulta(nombre, sin formato): VALUE es un nombre de propietario DNS en formato de presentación o caracteres comodín, tal como se describe a continuación. A veces, llamamos a esto solo una búsqueda rrset, sin formato: EL VALOR es un número par de dígitos hexadecimales que especifican una cadena de octeto sin formato.

value
value True string

Valor de consulta

rrtype
rrtype True string

Query rrtype

bailía
bailiwick True string

Consulta de bailiwick

time_first_before (hora unix/época)
time_first_before number

Proporcione resultados antes de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro de dirección URL "time_first_before=1420070400" solo proporcionará registros DNS coincidentes que se observaron por primera vez antes del 1 de enero de 2015 (o anteriores a).

time_first_after (hora unix/época)
time_first_after number

Proporcione resultados después de la marca de tiempo definida para la primera vez que se observó el registro DNS. Por ejemplo, el parámetro URL "time_first_after=-31536000" solo proporcionará resultados que se observaron por primera vez en el último año.

time_last_before (hora unix/época)
time_last_before number

Proporcione resultados antes de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro URL "time_last_before=1356998400" solo proporcionará resultados para los registros DNS que se observaron por última vez antes de 2013.

time_last_after (hora unix/época)
time_last_after number

Proporcione resultados después de la marca de tiempo definida para cuando se observó por última vez el registro DNS. Por ejemplo, el parámetro de dirección URL "time_last_after=-2678400" solo proporcionará resultados que se observaron por última vez después de hace 31 días.

limit
limit number

Límite del número de resultados devueltos a través de estos métodos de búsqueda. Hay un límite integrado para el número de resultados que se devuelven a través de estos métodos de búsqueda. El límite predeterminado se establece en 10 000. Este límite se puede aumentar o reducir estableciendo el parámetro de consulta "limit". También se permite un número máximo de resultados; la solicitud de un límite mayor que el máximo solo devolverá el máximo. Consulte results_max siguiente para obtener información sobre ese máximo. Si se usa '?limit=0', DNSDB devolverá el número máximo de resultados permitidos. Si hay menos resultados para la consulta que el límite solicitado, solo se puede devolver la cantidad real.

aggr
aggr boolean

Los conjuntos de resultados agregados agrupan valores rrset idénticos en todos los períodos de tiempo y es el comportamiento clásico de la consulta de DNSDB. Esto significa que podría obtener el número total de veces que se ha observado un rrset, pero no cuando se observó. Los resultados no agregados desagrupan conjuntos rrset idénticos, lo que le permite ver cómo se resolvió el nombre de dominio en el DNS en el intervalo de tiempo completo cubierto en DNSDB (sujeto a barreras de tiempo). Esto puede dar una impresión más precisa del volumen de solicitudes de registro a lo largo del tiempo, ya que revelará las marcas de tiempo distintas de los registros cuyos valores se repiten. Puedes responder a preguntas como:"Era un dominio estacionado durante mucho tiempo, principalmente sin usar, hasta que se reasignaba para servir malware o retransmitir correo no deseado, pero luego se abandonó de nuevo?". Permite ver si se observó un registro en gran medida en la última semana frente a haber sido observado constantemente durante años. Se trata de un valor booleano. Use True, el valor predeterminado, para los resultados agregados o False para los resultados no agregados.

humantime
humantime boolean

Valor booleano que es True si los valores de hora (en time_first, time_last, zone_time_first, zone_time_last) deben devolverse en formato legible (RFC3339 compatible) o False si se deben devolver valores de tiempo de estilo Unix en segundos desde la época. False es el comportamiento clásico de la consulta de DNSDB y es el valor predeterminado de esta opción.

offset
offset number

Número de filas que se van a desplazar (por ejemplo, omitir) en los resultados. Esto implementa una característica de transferencia de resultados incremental, lo que le permite ver más de los resultados disponibles para una sola consulta. Las filas se desplazan antes del parámetro limit que se aplica, por lo que el desplazamiento permite ver resultados adicionales más allá de un límite que coincida con el número máximo de resultados. Tenga en cuenta que DNSDB recalcula los resultados de cada consulta y es posible que no se conserve el orden de los resultados. Por lo tanto, esta funcionalidad no es una manera válida de recorrer todos los resultados en varias consultas: es posible que falten algunos resultados y que algunos se dupliquen. El desplazamiento real que se puede usar es limitado o para determinadas claves de API, no se permite el desplazamiento; consulte la clave offset_max rate_limit siguiente. El valor de desplazamiento debe ser un entero positivo. El valor predeterminado es 0, lo que significa que no se desplazan las filas.

Devoluciones

Límites de servicio

Recuperación de límites de servicio

Devoluciones

Ping

Esta solicitud es para pruebas de conectividad de un extremo a otro al punto de conexión de la API de DNSDB, lo que le indica que no hay bloqueos del firewall. Esta solicitud no requiere una clave de API. Devuelve solo un objeto JSON {'ping': 'ok'}.

Devoluciones

Nombre Ruta de acceso Tipo Description
ping
ping string

ping

Definiciones

RRSet_Results

Nombre Ruta de acceso Tipo Description
Contar
count number

Número de veces que RRset se observó a través de la replicación DE DNS pasiva.

Primera vez
time_first number

La primera vez que se observó el RRset.

Hora última
time_last number

La hora más reciente en que se observó el RRset.

Primera hora de zona
zone_time_first number

La primera vez que se observó el RRset a través de la importación de archivos de zona.

Última hora de zona
zone_time_last number

La última vez que se observó el RRset a través de la importación de archivos de zona.

RRName
rrname string

Nombre de propietario del RRset en formato de presentación DNS.

RRType
rrtype string

El tipo de registro de recursos del RRset, ya sea mediante el tipo DNS estándar mnemonic o un tipo genérico RFC 3597, es decir, la cadena TYPE inmediatamente seguida del número decimal RRtype.

Bailía
bailiwick string

La zona de inclusión más cercana delegada a un servidor de nombres que sirvió al RRset o el nombre de la zona que contiene el RRset si FromZoneFile es True.

RData
rdata array of string

Matriz de uno o varios valores de Rdata. Los valores de Rdata se convierten en el formato de presentación estándar basado en el valor rrtype. Si el codificador carece de un formato de presentación específico del tipo para el rrtype de RRset, se usará la codificación Rdata genérica RFC 3597.

RData_Results

Nombre Ruta de acceso Tipo Description
Contar
count number

Número de veces que se observó el registro de recursos a través de la replicación DE DNS pasiva.

Primera vez
time_first number

La primera vez que se observó el registro de recursos.

Hora última
time_last number

La hora más reciente en que se observó el registro de recursos.

Primera hora de zona
zone_time_first number

La primera vez que se observó el registro de recursos a través de la importación de archivos de zona.

Última hora de zona
zone_time_last number

La última vez que se observó el registro de recursos a través de la importación de archivos de zona.

RRName
rrname string

Nombre de propietario del registro de recursos en formato de presentación DNS.

RRType
rrtype string

El tipo de registro de recursos del registro de recursos, ya sea mediante el tipo DNS estándar mnemonic o un tipo genérico RFC 3597, es decir, la cadena TYPE inmediatamente seguida del número decimal RRtype.

RData
rdata array of string

Valor de datos de registro. El valor de Rdata se convierte en el formato de presentación estándar basado en el valor rrtype. Si el codificador carece de un formato de presentación específico del tipo del registro de recursos, se usará la codificación Rdata genérica RFC 3597.

Flex_Results

Nombre Ruta de acceso Tipo Description
RData
rdata string

Valor de datos de registro.

RRName
rrname string

Nombre de propietario del RRset en formato de presentación DNS.

RRType
rrtype string

El tipo de registro de recursos del registro RRset/resource, ya sea mediante el tipo DNS estándar mnemonic o un tipo genérico RFC 3597, es decir, la cadena TYPE seguida inmediatamente del número decimal RRtype.

RAW_RDATA
raw_rdata string

Valor de datos de registro como pares de dígitos hexadecimales que especifican una cadena de octeto sin formato. Este valor se usa para dinamizar desde la búsqueda flexible en la búsqueda estándar para obtener más detalles sobre rdata.

RateLimit_Results

Nombre Ruta de acceso Tipo Description
Limit
limit number

Número máximo de búsquedas de API que se pueden realizar. Esta es la cuota inicial.

Restante
remaining number

Para las cuotas basadas en el tiempo: el número restante de búsquedas de API que se pueden realizar hasta el tiempo de restablecimiento. Para las cuotas basadas en bloques: el número restante de búsquedas de API en la cuota de bloques.

Reiniciar
reset number

Para las cuotas basadas en tiempo: marca de tiempo de época de UNIX con la segunda granularidad que indica el siguiente punto en el tiempo en el que se restablecerá el límite de cuota. Normalmente, esto es a las 00:00 (medianoche) UTC. Para las cuotas basadas en bloques: el valor será "n/a"

Caduca
expires number

Solo está presente para la cuota basada en bloques: marca de tiempo de época de UNIX con la segunda granularidad que indica cuándo expirará la cuota.

ResultsMax
results_max number

Devuelve el número máximo de resultados que estos métodos de búsqueda pueden devolver. Esto invalida un parámetro de consulta "limit" si se proporciona. Por ejemplo, si "?limit=20000" se anexa a la ruta de acceso de dirección URL, pero results_max=1000, solo se devolverán hasta 1000 resultados.

OffsetMax
offset_max number

Valor máximo que puede ser el parámetro de consulta de desplazamiento. Si es superior, se devolverá un código de respuesta HTTP 416 "Requested Range Not Satisfiable" con el mensaje "Error: offset value greater than maximum allowed". Si el valor es "n/a", no se permite el parámetro offset para esta clave de API y se generará un error similar 416.

Ráfagas de tamaño
burst_size number

Número máximo de búsquedas de API que se pueden realizar en este burst_window número de segundos.

BurstWindow
burst_window number

Número de segundos durante los que se mide una ráfaga de consultas.