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
- response
- array of RData_Results
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
- response
- array of RData_Results
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
- response
- array of Flex_Results
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
- response
- array of RRSet_Results
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
- response
- array of RRSet_Results
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
- response
- array of RRSet_Results
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'}.
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. |