URLvoid URL Reputation

4 min

Resumo

Essa API pode ajudar você a identificar URLs potencialmente inseguros e de phishing.
O URL é analisado com mais de 50 verificações de segurança e, em seguida, recebe uma pontuação de risco de URL.
Você precisa limitar as solicitações por segundo para no máximo 2-3 solicitações, antes de iniciar novas solicitações, espere até que as anteriores terminem. As regras acima garantirão que nossas APIs funcionem sem problemas para todos os usuários, no entanto, se você tiver pequenos picos ocasionais, não haverá problemas, mas pedimos que você limite as solicitações do seu lado.

Parâmetros

Parâmetro	Requerido	Tipo	Escolhas \| Valor Padrão	Comentários
url	Sim	string		URL para enviar, deve ser codificado, ou seja, https%3A%2F%2Fwww.google.com%2F

Utiliza parâmetros do módulo URL Void.

Exemplos

tasks:
- name:
  urlvoid_url_reputation:
    url: https%3A%2F%2Fwww.google.com%2F
    key: {{key}}

Valores retornados

Chave	Tipo	Retornado quando	Descrição
data-> report-> dns_records-> ns->records	array	Sempre	Lista de registros DNS NS (NameServers) encontrados.
data-> report-> dns_records-> mx->records	array	Sempre	Lista de registros DNS MX (Mail eXchanger) encontrados.
data-> report-> domain_blacklist->engines	array	Sempre	Lista de mecanismos de varredura com status de detecção e link de referência.
data-> report-> domain_blacklist->detections	integer	Sempre	Número de mecanismos de verificação que detectaram o domínio.
data-> report-> file_type->signature	string	Sempre	Retorna o tipo de arquivo analisando o conteúdo do arquivo.
data-> report-> file_type->extension	string	Sempre	Retorna o tipo de arquivo analisando a extensão do arquivo.
data-> report-> file_type->headers	string	Sempre	Retorna o tipo de arquivo analisando os cabeçalhos de resposta HTTP.
data-> report-> geo_location->countries	array	Sempre	Lista de potenciais países de origem.
data-> report-> html_forms->number_of_total_forms	integer	Sempre	Retorna o número total de formulários encontrados.
data-> report-> html_forms->number_of_total_input_fields	integer	Sempre	Retorna o número total de campos de entrada encontrados.
data-> report-> html_forms->two_text_inputs_in_a_form	boolean	Sempre	Retorna true se houver duas entradas de texto em um formulário.
data-> report-> html_forms->credit_card_field_present	boolean	Sempre	Retorna verdadeiro se houver formulários que solicitem detalhes de cartões de crédito.
data-> report-> html_forms->password_field_present	boolean	Sempre	Retorna true se houver formulários que solicitem uma senha.
data-> report-> html_forms->email_field_present	boolean	Sempre	Retorna verdadeiro se houver formulários que solicitem um endereço de e-mail.
data-> report-> redirection->found	boolean	Sempre	Retorna verdadeiro se um redirecionamento de URL for encontrado.
data-> report-> redirection->external	boolean	Sempre	Retorna verdadeiro se o URL de redirecionamento for externo.
data-> report-> redirection->url	string	Sempre	Retorna o URL de redirecionamento.
data-> report-> response_headers->code	integer	Sempre	Retorna o código de status da resposta HTTP.
data-> report-> response_headers->server	string	Sempre	Retorna a string do servidor, ou seja, Nginx ou Apache.
data-> report-> security_checks->is_host_an_ipv4	boolean	Sempre	Retorna verdadeiro se o host for um endereço IPv4.
data-> report-> security_checks->is_uncommon_host_length	boolean	Sempre	Retorna true se o comprimento do host for incomum (como um domínio muito longo).
data-> report-> security_checks->is_uncommon_dash_char_count	boolean	Sempre	Retorna verdadeiro se o host contiver muitos caracteres de traço "-".
data-> report-> security_checks->is_uncommon_dot_char_count	boolean	Sempre	Retorna verdadeiro se o host contiver muitos pontos "." personagens.
data-> report-> security_checks->is_suspicious_url_pattern	boolean	Sempre	Retorna verdadeiro se o padrão de URL for suspeito.
data-> report-> security_checks->is_suspicious_file_extension	boolean	Sempre	Retorna verdadeiro se a extensão do arquivo de URL for suspeita.
data-> report-> security_checks->is_robots_noindex	boolean	Sempre	Retorna verdadeiro se o URL "não deseja" ser indexado no Google.
data-> report-> security_checks->is_suspended_page	boolean	Sempre	Retorna verdadeiro se a página da Web for suspensa.
data-> report-> security_checks->is_most_abused_tld	boolean	Sempre	Retorna verdadeiro se o TLD do domínio for arriscado, ou seja, .top ou .tk
data-> report-> security_checks->is_uncommon_clickable_url	boolean	Sempre	Retorna verdadeiro se o URL NÃO deve ser clicável.
data-> report-> security_checks->is_phishing_heuristic	boolean	Sempre	Retorna verdadeiro se o conteúdo do URL corresponder às nossas regras de phishing.
data-> report-> security_checks->is_redirect_to_search_engine	boolean	Sempre	Retorna verdadeiro se o URL redirecionar para mecanismos de pesquisa, como google.com.
data-> report-> security_checks->is_http_status_error	boolean	Sempre	Retorna verdadeiro se houver um código de status HTTP diferente de 200.
data-> report-> security_checks->is_http_server_error	boolean	Sempre	Retorna verdadeiro se o código de status HTTP for 5xx.
data-> report-> security_checks->is_http_client_error	boolean	Sempre	Retorna verdadeiro se o código de status HTTP for 4xx.
data-> report-> security_checks->is_suspicious_content	boolean	Sempre	Retorna verdadeiro se o conteúdo do URL corresponder às nossas regras de conteúdo suspeito.
data-> report-> security_checks->is_url_accessible	boolean	Sempre	Retorna verdadeiro se o URL for acessível por nossos servidores.
data-> report-> security_checks->is_empty_page_title	boolean	Sempre	Retorna verdadeiro se o título da página do URL estiver vazio.
data-> report-> security_checks->is_empty_page_content	boolean	Sempre	Retorna verdadeiro se o conteúdo da URL estiver vazio.
data-> report-> security_checks->is_domain_blacklisted	boolean	Sempre	Retorna verdadeiro se o domínio estiver na lista negra de fontes confiáveis.
data-> report-> security_checks->is_suspicious_domain	boolean	Sempre	Retorna verdadeiro se o domínio corresponder às nossas regras de domínio suspeitas.	Retorna verdadeiro se o domínio corresponder às nossas regras de domínio suspeitas.
data-> report-> security_checks->is_sinkholed_domain	boolean	Sempre	Retorna true se o domínio estiver em um sinkhole (malicioso).
data-> report-> security_checks->is_defaced_heuristic	boolean	Sempre	Retorna true se a página de URL foi desfigurada (usamos nossas próprias regras).
data-> report-> security_checks->is_masked_file	boolean	Sempre	Retorna verdadeiro se o conteúdo do arquivo remoto não corresponder à sua extensão.
data-> report-> security_checks->is_risky_geo_location	boolean	Sempre	Retorna verdadeiro se a localização do site for considerada arriscada.
data-> report-> security_checks->is_china_country	boolean	Sempre	Retorna verdadeiro se o site estiver potencialmente localizado na China.
data-> report-> security_checks->is_nigeria_country	boolean	Sempre	Retorna verdadeiro se o site estiver potencialmente localizado na Nigéria.
data-> report-> security_checks->is_non_standard_port	boolean	Sempre	Retorna verdadeiro se a porta remota for uma porta não padrão.
data-> report-> security_checks->is_email_address_on_url_query	boolean	Sempre	Retorna verdadeiro se um endereço de e-mail for encontrado na string de consulta do URL.
data-> report-> security_checks->is_directory_listing	boolean	Sempre	Retorna verdadeiro se a página de URL for uma listagem de diretório.
data-> report-> security_checks->is_possible_emotet	boolean	Sempre	Retorna verdadeiro se o URL estiver potencialmente relacionado ao Emotet.
data-> report-> security_checks->is_exe_on_directory_listing	boolean	Sempre	Retorna verdadeiro se um arquivo EXE for encontrado na listagem de diretórios.
data-> report-> security_checks->is_linux_elf_file	boolean	Sempre	Retorna verdadeiro se o arquivo remoto for um arquivo linux ELF (executável).
data-> report-> security_checks->is_linux_elf_file_on_free_dynamic_dns	boolean	Sempre	Retorna verdadeiro se o arquivo ELF remoto estiver em um site DNS dinâmico gratuito.
data-> report-> security_checks->is_linux_elf_file_on_free_hosting	boolean	Sempre	Retorna verdadeiro se o arquivo ELF remoto estiver em um site de hospedagem gratuita.
data-> report-> security_checks->is_linux_elf_file_on_ipv4	boolean	Sempre	Retorna verdadeiro se o arquivo ELF remoto estiver em um host IPv4.
data-> report-> security_checks->is_masked_linux_elf_file	boolean	Sempre	Retorna verdadeiro se o arquivo ELF remoto estiver mascarado com a extensão de arquivo incorreta.
data-> report-> security_checks->is_masked_windows_exe_file	boolean	Sempre	Retorna verdadeiro se o arquivo EXE remoto estiver mascarado com a extensão de arquivo incorreta.
data-> report-> security_checks->is_windows_exe_file	boolean	Sempre	Retorna verdadeiro se o arquivo remoto for um arquivo EXE (executável) do Windows.
data-> report-> security_checks->is_android_apk_file	boolean	Sempre	Retorna verdadeiro se o arquivo remoto for um arquivo APK do Android.
data-> report-> security_checks->is_external_redirect	boolean	Sempre	Retorna verdadeiro se o URL redirecionar para um site externo.
data-> report-> security_checks->is_risky_category	boolean	Sempre	Retorna verdadeiro se o domínio for um provedor de DNS gratuito, um provedor de hospedagem gratuito ou um encurtador de URL.
data-> report-> security_checks->is_domain_recent	string	Sempre	Retorna "sim" se o domínio foi criado há menos de 6 meses, pode ser sim/não/desconhecido.
data-> report-> security_checks->is_domain_very_recent	string	Sempre	Retorna "sim" se o domínio foi criado há menos de 30 dias, pode ser sim/não/desconhecido.
data-> report-> security_checks->is_credit_card_field	boolean	Sempre	Retorna verdadeiro se a página da web contiver campos de entrada de cartão de crédito.
data-> report-> security_checks->is_password_field	boolean	Sempre	Retorna verdadeiro se a página da Web contiver campos de entrada de senha.
data-> report-> security_checks->is_valid_https	boolean	Sempre	Retorna verdadeiro se o URL HTTPS (SSL) for válido.
data-> report-> server_details->ip	string	Sempre	Retorna o endereço IPv4 do servidor.
data-> report-> server_details->hostname	string	Sempre	Retorna o nome do host (DNS reverso) do endereço IP do servidor.
data-> report-> server_details->isp	string	Sempre	Retorna o provedor de serviços de Internet do servidor.
data-> report-> server_details->asn	string	Sempre	Retorna o Número do Sistema Autônomo IP (ASN), como AS16509.
data-> report-> site_category->is_torrent	boolean	Sempre	Retorna verdadeiro se o site for um site de torrent.
data-> report-> site_category->is_vpn_provider	boolean	Sempre	Retorna verdadeiro se o site for um site de provedor de VPN.
data-> report-> site_category->is_free_hosting	boolean	Sempre	Retorna verdadeiro se o site for um site de provedor de hospedagem gratuito.
data-> report-> site_category->is_anonymizer	boolean	Sempre	Retorna verdadeiro se o site for um site de proxy da web.
data-> report-> site_category->is_url_shortener	boolean	Sempre	Retorna verdadeiro se o site for um site de encurtamento de URL.
data-> report-> site_category->is_free_dynamic_dns	boolean	Sempre	Retorna verdadeiro se o site for um site de provedor de DNS dinâmico gratuito.
data-> report-> site_category->is_code_sandbox	boolean	Sempre	Retorna true se o site for um serviço de sandbox de código como repl.co
data-> report-> site_category->is_form_builder	boolean	Sempre	Retorna verdadeiro se o site for um serviço de criação de formulários, como forms.gle
data-> report-> site_category->is_free_file_sharing	boolean	Sempre	Retorna true se o site for um serviço de hospedagem de arquivos gratuito como wetransfer.com
data-> report-> site_category->is_pastebin	boolean	Sempre	Retorna true se o site for um serviço pastebin como pastebin.com
data-> report-> web_page->title	string	Sempre	Retorna o título da página do site.
data-> report-> web_page->description	string	Sempre	Retorna a metatag de descrição da página do site.
data-> report-> web_page->keywords	string	Sempre	Retorna a metatag de palavras-chave da página do site.
data-> report-> risk_score->result	integer	Sempre	Retorna um número entre 0 (bom) e 100 (ruim).
credits_remained	string	Sempre	Mostra seus créditos APIVoid globais disponíveis.
estimated_queries	string	Sempre	Mostra as consultas estimadas para esta API.