Dnsfilter
dnsfilterDNSFilter provides cloud-based DNS security and content filtering solutions to protect networks from online threats and manage internet usage.
Acciones disponibles (19)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Create IP AddressDNSFILTER_CREATE_IP_ADDRESSAcciónTool to create a new ip address in dnsfilter. use after confirming the target network id exists.
DNSFILTER_CREATE_IP_ADDRESSAcciónTool to create a new ip address in dnsfilter. use after confirming the target network id exists.
Parámetros de entrada
addressstringObligatorioIPv4 or IPv6 address to add
network_idintegerObligatorioID of the network where this IP belongs
descriptionstringOptional description for the IP address
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Application CategoryDNSFILTER_GET_APPLICATION_CATEGORYAcciónTool to get basic information of a specific application category. use when you need details for a given application category id.
DNSFILTER_GET_APPLICATION_CATEGORYAcciónTool to get basic information of a specific application category. use when you need details for a given application category id.
Parámetros de entrada
application_category_idstringObligatorioUnique ID of the application category
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Billing InformationDNSFILTER_GET_BILLING_INFORMATIONAcciónTool to retrieve basic billing information for an organization. use when you need to obtain billing details for reporting or automation tasks.
DNSFILTER_GET_BILLING_INFORMATIONAcciónTool to retrieve basic billing information for an organization. use when you need to obtain billing details for reporting or automation tasks.
Parámetros de entrada
organization_idstringObligatorioUnique identifier of the organization.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get CategoryDNSFILTER_GET_CATEGORYAcciónTool to get basic information of a specific category. use when you need to retrieve details for a category by its id.
DNSFILTER_GET_CATEGORYAcciónTool to get basic information of a specific category. use when you need to retrieve details for a category by its id.
Parámetros de entrada
idintegerObligatorioUnique identifier of the category to retrieve
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get IP AddressDNSFILTER_GET_IP_ADDRESSAcciónTool to get basic information of the specified ip address. use when you need to fetch metadata for a particular ip after authentication.
DNSFILTER_GET_IP_ADDRESSAcciónTool to get basic information of the specified ip address. use when you need to fetch metadata for a particular ip after authentication.
Parámetros de entrada
ip_addressstringObligatorioThe IP address to retrieve details for.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List All CategoriesDNSFILTER_LIST_ALL_CATEGORIESAcciónTool to list all categories including internal categories. use when you need the complete set of filtering categories.
DNSFILTER_LIST_ALL_CATEGORIESAcciónTool to list all categories including internal categories. use when you need the complete set of filtering categories.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List All IP AddressesDNSFILTER_LIST_ALL_IP_ADDRESSESAcciónTool to list all user-associated ip addresses. use when you need a comprehensive list of all ip address entries in your organization.
DNSFILTER_LIST_ALL_IP_ADDRESSESAcciónTool to list all user-associated ip addresses. use when you need a comprehensive list of all ip address entries in your organization.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List All MAC AddressesDNSFILTER_LIST_ALL_MAC_ADDRESSESAcciónTool to list all mac addresses with basic information. use when you need to retrieve all mac address entries in your organization.
DNSFILTER_LIST_ALL_MAC_ADDRESSESAcciónTool to list all mac addresses with basic information. use when you need to retrieve all mac address entries in your organization.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Application CategoriesDNSFILTER_LIST_APPLICATION_CATEGORIESAcciónTool to list application categories with basic information. use after authentication to retrieve all categories.
DNSFILTER_LIST_APPLICATION_CATEGORIESAcciónTool to list application categories with basic information. use after authentication to retrieve all categories.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List ApplicationsDNSFILTER_LIST_APPLICATIONSAcciónTool to list applications with basic information. use when you need to retrieve all applications for your dnsfilter organization.
DNSFILTER_LIST_APPLICATIONSAcciónTool to list applications with basic information. use when you need to retrieve all applications for your dnsfilter organization.
Parámetros de entrada
pageintegerPage number to retrieve
sizeintegerNumber of records per page
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List Block PagesDNSFILTER_LIST_BLOCK_PAGESAcciónTool to list block pages associated with the current user. use when you need to retrieve all block pages for review or update.
DNSFILTER_LIST_BLOCK_PAGESAcciónTool to list block pages associated with the current user. use when you need to retrieve all block pages for review or update.
Parámetros de entrada
pageintegerPage number for pagination, must be >= 1
per_pageintegerNumber of results per page, must be between 1 and 100
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List CategoriesDNSFILTER_LIST_CATEGORIESAcciónTool to list categories with basic information. use when retrieving all dnsfilter categories for policy configuration.
DNSFILTER_LIST_CATEGORIESAcciónTool to list categories with basic information. use when retrieving all dnsfilter categories for policy configuration.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List InvoicesDNSFILTER_LIST_INVOICESAcciónTool to list invoices for an organization, most recent first. use after obtaining the organization id when needing paginated invoice data.
DNSFILTER_LIST_INVOICESAcciónTool to list invoices for an organization, most recent first. use after obtaining the organization id when needing paginated invoice data.
Parámetros de entrada
pageintegerPage number for pagination. Must be >= 1.
sortstringField to sort by. Defaults to 'created_at'.
per_pageintegerNumber of results per page. Must be >=1.
directionstringenumSort direction: 'asc' or 'desc'. Default is 'desc' (most recent first).
ascdescorganization_idstringObligatorioOrganization's unique identifier.
Parámetros de salida
dataobject[]ObligatorioList of invoices.
pageintegerObligatorioCurrent page number.
errorstringError if any occurred during the execution of the action
totalintegerObligatorioTotal number of invoices.
per_pageintegerObligatorioNumber of results per page.
successfulbooleanObligatorioWhether or not the action execution was successful or not
List IP AddressesDNSFILTER_LIST_IP_ADDRESSESAcciónTool to list user-associated ip addresses basic information. use when you need to retrieve paginated ip address records filtered by location or device after authentication.
DNSFILTER_LIST_IP_ADDRESSESAcciónTool to list user-associated ip addresses basic information. use when you need to retrieve paginated ip address records filtered by location or device after authentication.
Parámetros de entrada
pageintegerPagination page number, must be >= 1
per_pageintegerNumber of items per page, must be between 1 and 200
device_idintegerFilter results to this device ID
location_idintegerFilter results to this location ID
Parámetros de salida
dataobject[]ObligatorioList of IP address records
pageintegerObligatorioCurrent page number returned by the API
errorstringError if any occurred during the execution of the action
totalintegerObligatorioTotal number of records across all pages
per_pageintegerObligatorioNumber of records per page returned
successfulbooleanObligatorioWhether or not the action execution was successful or not
List MAC AddressesDNSFILTER_LIST_MAC_ADDRESSESAcciónTool to list mac addresses associated with an organization. use when you need to retrieve basic mac address information, optionally filtered by organization or paginated.
DNSFILTER_LIST_MAC_ADDRESSESAcciónTool to list mac addresses associated with an organization. use when you need to retrieve basic mac address information, optionally filtered by organization or paginated.
Parámetros de entrada
pageintegerPage number for pagination (1-based)
per_pageintegerNumber of items per page
organization_idstringFilter MAC addresses by organization ID
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List NetworksDNSFILTER_LIST_NETWORKSAcciónTool to list all networks. use when you need to retrieve all network configurations for your organization.
DNSFILTER_LIST_NETWORKSAcciónTool to list all networks. use when you need to retrieve all network configurations for your organization.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List OrganizationsDNSFILTER_LIST_ORGANIZATIONSAcciónTool to list all organizations. use when you need to retrieve all organizations tied to the authenticated dnsfilter account.
DNSFILTER_LIST_ORGANIZATIONSAcciónTool to list all organizations. use when you need to retrieve all organizations tied to the authenticated dnsfilter account.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobject[]ObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Suggest Domain ThreatDNSFILTER_SUGGEST_DOMAIN_THREATAcciónTool to suggest a fqdn as a potential threat. use after identifying a suspicious domain to verify its threat categorization.
DNSFILTER_SUGGEST_DOMAIN_THREATAcciónTool to suggest a fqdn as a potential threat. use after identifying a suspicious domain to verify its threat categorization.
Parámetros de entrada
fqdnstringObligatorioFully qualified domain name to suggest as a potential threat.
notesstringObligatorioDetailed notes or reason for the threat suggestion.
categoriesinteger[]Category IDs for classifying the threat type.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Validate Auth0 JWTDNSFILTER_VALIDATE_AUTH0_JWTAcciónTool to validate a jwt with auth0. use when you need to confirm token validity before making dnsfilter api calls.
DNSFILTER_VALIDATE_AUTH0_JWTAcciónTool to validate a jwt with auth0. use when you need to confirm token validity before making dnsfilter api calls.
Parámetros de entrada
jwtstringObligatorioAuth0 JSON Web Token (JWT) string to validate.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not