dns-filter-integration-setup.md

DNSFilter integration

{% hint style="info" %} If you’re new to integrations in Rewst, read through our introductory integration documentation here. {% endhint %}

What does the DNSFilter integration do?

Our DNSFilter integration enables the automation of DNS-based content filtering and web security tasks.

Set up the DNSFilter integration

Set up steps with DNSFilter

Please contact DNSFilter support and request for a JWT/API token.

Set up steps in Rewst

1. Navigate to Marketplace > Integrations in the left side menu of your Rewst platform.
2. Search for DNSFilter in the integrations page.
   
   
3. Click on the integration tile to launch the configuration setup page.
4. Enter the value given to you by DNSFilter into the API Token field.
5. Click Save Configuration.
6. Rewst will do a quick validation of your input. Once completed, you'll see a new section beneath the configuration form for organization mapping. Complete your mapping as desired.

{% hint style="success" %} Got an idea for a new Integration? Rewst is constantly adding new integrations to our integrations page. Submit your idea or upvote existing ideas here in our Canny feedback collector. {% endhint %}

Actions and endpoints

{% hint style="info" %} For more on how actions work in Rewst, check out our introductory actions documentation here. {% endhint %}

Category	Action	Description
Agent Local User	List Agent Local Users	Gets the agent local users associated to an organization with basic information
Agent Local User	List All Agent Local Users	Gets ALL agent local users associated to an user organization with basic information
Agent Local User	Get Agent Local User	Gets basic information of the specified agent local user
Agent Local User	Update Agent Local User	Updates an agent local user with the specified data
Billings	List User Organization Billing	List basic billing information of the user organization registered in Stripe platform
Billings	Create Payment Method	Register a newly created payment method in database
Block Pages	List Block Pages	Gets the list of block pages associated with the current user
Block Pages	Create Block Page	Creates a new block page
Block Pages	List All Block Pages	Gets ALL block pages associated with the current user
Block Pages	Get Block Page	Gets the specified block page
Block Pages	Update Block Page	Updates a block_page in the database with the specified data
Block Pages	Delete Block Page	Removes a block page from the database
Categories	List Categories	List categories basic information
Categories	List All Categories	List all categories including internal categories
Categories	Get Category	Gets basic information of a specific category
Collection Users	Create Collection User With Filter And Sort	Add a new user to a specific collection with the specified id
Collection Users	Create Collection User	Add a new user to a specific collection with the specified id
Collection Users	Get User Permissions	Gets the user details and permissions for the specified organization
Collection Users	Delete User From Collection	Deletes a user from a collection
Collections	List Agent Local Users With Class Type	Gets the agent local users associated to a collection or group
Collections	List Agent Local Users In Organization	Gets the agent local users associated to a collection or group
Domains	List Domains By FQDN	Gets all the domains associated for a particular FQDN
Domains	List Domains And Categories For FQDNs	Gets the domains and categories associated for each FQDN of the specified list
Domains	Mark FQDN For Categorization Verification	Mark a FQDN to verify its categorization with suggested ones
Domains	Update FQDN Threat Categorization	Mark a FQDN to verify its threat categorization
Generic Request	DNS API Request	Generic action for making authenticated requests against the DNSFilter API
Invoices	Get User Estimated Invoice For Next Month	Gets user estimated invoice for next month. WARNING: almost all invoice data are null values, take that into consideration when using this endpoint
Invoices	List User Invoices	Gets user associated invoices, most recent first
Invoices	Get Invoice	Gets basic information of the specified invoice
Ip Addresses	Get User IP Addresses	Gets user associated IP addresses basic information
Ip Addresses	Create IP Address	Creates a new IP address with the specified data
Ip Addresses	List User IP Addresses	Gets ALL user associated IP addresses basic information
Ip Addresses	Get IP Address	Gets basic information of the specified IP address
Ip Addresses	Update IP Address	Updates an IP address with the specified data
Ip Addresses	Delete IP Address	Removes an IP address
Ip Addresses	Verify IP Address	Verification call to ensure IP address is not already in the system
Ip Addresses	Get Requester IP Address	Responds with the requester reported IP address
Mac Addresses	List MAC Addresses	Gets the MAC addresses associated to an organization with basic information
Mac Addresses	Create MAC Address	Creates a new MAC address with the specified data
Mac Addresses	List User MAC Addresses	Gets ALL MAC addresses associated to an user with basic information
Mac Addresses	Get MAC Address Info	Gets basic information of the specified MAC address
Mac Addresses	Update MAC Address	Updates a MAC address with the specified data
Mac Addresses	Delete MAC Address	Removes a MAC address
Network Lan Ips	List Network Lan IPs	Gets network associated LAN IPs with basic information
Network Lan Ips	Get Network Lan IP	Gets network associated LAN IP with basic information
Network Lan Ips	Update Network Lan IP	Updates a network LAN IP in the database with the specified data
Network Subnets	List Site Subnets	List site subnets with basic information
Network Subnets	List Network Subnets	Gets network associated subnets with basic information
Network Subnets	Create Network Subnet	Creates a network subnet in the database with the specified data
Network Subnets	Get Network Subnet	Gets network associated subnet with basic information
Network Subnets	Update Network Subnet	Updates a network subnet in the database with the specified data
Network Subnets	Delete Network Subnet	Deletes a network subnet in the database with the specified data
Networks	List User Associated Networks	Gets users associated networks with basic information
Networks	Create Network	Creates a new network with the specified data
Networks	List User Networks	Gets ALL networks associated to the user with its basic information
Networks	List Msp User Networks	Gets MSP user associated networks with basic information
Networks	List All Msp User Networks	Gets ALL networks associated to the MSP user with its basic information
Networks	Get Network Info By IP Addresses	Gets basic information of a network based on its associated IP addresses
Networks	Get Network	Gets basic information of the specified network
Networks	Update Network	Updates a network with the specified data
Networks	Delete Network	Deletes a network
Networks	Create Network Secret Key	Creates a new network secret key to be used by agents
Networks	Delete Network Secret Key	Revokes a network secret key
Networks	Update Network Secret Key	Rotates (renew) a network secret key to be used by agents
Organization Users	List Organization Users	Gets the users for the specified organization
Organization Users	Get Organization User	Gets the user details and permissions for the specified organization
Organization Users	Update User Or Permissions	Updates a user or permissions with the specified data
Organization Users	Delete Organization User	Removes a user from the organization. This will not actually delete the user account.
Organization Users	Create Organization User	Adds a new or existing user with the specified email to the specified organization.
Organizations	List User Organizations	Gets users associated organizations basic information
Organizations	Create Organization	Creates a new organization with the specified data
Organizations	List Organizations Basic	Gets all organizations basic information
Organizations	Get Organization Information	Gets basic information of the specified organization
Organizations	Update Organization	Updates an organization with the specified data
Organizations	Delete Msp Customer	Deletes an MSP customer
Organizations	Update Organization Status To Canceled	Sets an organization as 'Canceled'
Organizations	Promote Organization To Msp	Promote an organization to a MSP
Policies	Get User Associated Policies	Gets user associated policies basic information from database
Policies	Create Policy	Creates a new policy with the specified data
Policies	List User Policies	Gets ALL user associated policies basic information from database
Policies	Get Policy	Gets basic information of the specified policy
Policies	Update Policy	Updates a policy with the specified data
Policies	Delete Policy	Deletes a policy
Policies	Add Blacklist Domain to Policy	Adds a domain to the blacklist of the specified policy
Policies	Remove Domain from Blacklist of Policy	Removes a domain from the blacklist of the specified policy
Policies	Add Whitelist Domain to Policy	Adds a domain to the whitelist of the specified policy
Policies	Remove Domain from Whitelist of Policy	Removes a domain from the whitelist of the specified policy
Policies	Add Blacklist Category to Policy	Adds a category to the blacklist of the specified policy
Policies	Remove Category from Blacklist of Policy	Removes a category from the blacklist of the specified policy
Policies	Add Allowed Application to Policy	Adds an application to the allowed list of the specified policy
Policies	Remove Allowed Application from Policy	Removes an application from the allowed list of the specified policy
Policies	Add Blocked Application to Policy	Adds an application to the blocked list of the specified policy
Policies	Remove Blocked Application from Policy	Removes an application from the blocked list of the specified policy
Policy Ips	Get User Policies Ips	Gets user associated policies IPs basic information from database
Policy Ips	Get Policy IP	Gets basic information of the specified Policy IP
Scheduled Policies	List Scheduled Policies	Gets the list of scheduled policies associated with the current user
Scheduled Policies	Create Scheduled Policy	Creates a new scheduled policy
Scheduled Policies	List All Scheduled Policies	Gets ALL scheduled policies associated with the current user
Scheduled Policies	Get Scheduled Policy	Gets the specified scheduled policy
Scheduled Policies	Update Scheduled Policy	Updates a scheduled policy in the database with the specified data
Scheduled Policies	Delete Scheduled Policy	Removes a scheduled policy from the database
Traffic Reports	Get Total Requests	Gets the total number of requests for sites in a period of time
Traffic Reports	Get Total Requests For Organizations In Time Period	Gets the total number of requests for organizations in a period of time
Traffic Reports	Get Total Requests For Roaming Clients	Gets the total number of requests for roaming clients in a period of time
Traffic Reports	Get Total Requests For Users	Gets the total number of requests for users in a period of time
Traffic Reports	Get Total Requests For Collections	Gets the total number of requests for collections in a period of time
Traffic Reports	Get Total Threats For Sites In Time Period	Gets the total number of threats for sites in a period of time
Traffic Reports	Get Total Threats For Organizations	Gets the total number of threats for organizations in a period of time
Traffic Reports	Get Total Threats For Roaming Clients	Gets the total number of threats for roaming clients in a period of time
Traffic Reports	Get Total Threats For Users In Time Period	Gets the total number of threats for users in a period of time
Traffic Reports	List Total Threats For Collections	Gets the total number of threats for collections in a period of time
Traffic Reports	List Total Requests By Category	Gets the total number of requests by category for sites in a period of time
Traffic Reports	List Total Requests By Category For Organizations	Gets the total number of requests by category for organizations in a period of time
Traffic Reports	List Requests By Category For Roaming Clients	Gets the total number of requests by category for roaming clients in a period of time
Traffic Reports	List Requests By Category	Gets the total number of requests by category for users in a period of time
Traffic Reports	List Requests By Category For Collections	Gets the total number of requests by category for collections in a period of time
Traffic Reports	Get Total Requests By Domain	Gets the total number of requests by domain for sites in a period of time
Traffic Reports	Get Total Requests By Domain For Organizations	Gets the total number of requests by domain for organizations in a period of time
Traffic Reports	Get Total Requests By Domain For Roaming Clients	Gets the total number of requests by domain for roaming clients in a period of time
Traffic Reports	List Domain Requests	Gets the total number of requests by domain for users in a period of time
Traffic Reports	List Total Requests By Domain For Collections	Gets the total number of requests by domain for collections in a period of time
Traffic Reports	Get Total Requests By Collection	Gets the total number of requests by collection for sites in a period of time
Traffic Reports	Get Total Requests By Collection For Organizations	Gets the total number of requests by collection for organizations in a period of time
Traffic Reports	List Total Requests By Collection For Roaming Clients In Time Period	Gets the total number of requests by collection for roaming clients in a period of time
Traffic Reports	Gets The Total Number Of Requests By Collection For Users In A Period Of Time	Gets the total number of requests by collection for users in a period of time
Traffic Reports	List Qps For Sites	Gets the total number of queries per second in a period of time for sites
Traffic Reports	Get Total Qps For Organizations	Gets the total number of queries per second in a period of time (maximum 20 minutes) for organizations
Traffic Reports	Get Roaming Clients Qps	Gets the total number of queries per second in a period of time (maximum 20 minutes) for roaming clients
Traffic Reports	Get Qps For Users	Gets the total number of queries per second in a period of time (maximum 20 minutes) for users
Traffic Reports	Get Total Qps For Collections	Gets the total number of queries per second in a period of time (maximum 20 minutes) for collections
Traffic Reports	Gets The Top Requested Domains In A Period Of Time	Gets the top requested domains in a period of time
Traffic Reports	List Top Categories Domains	Gets the top categories domains in a period of time
Traffic Reports	List Top Organizations	Gets the top organizations in a period of time
Traffic Reports	List Top Networks	Gets the top networks in a period of time
Traffic Reports	List Top Agents	Gets the top agents in a period of time
Traffic Reports	List Top Users	Gets the top users in a period of time
Traffic Reports	List Top Collections	Gets the top collections in a period of time
Traffic Reports	List Query Raw Logs	Gets the query raw logs in a period of time - NOTE: maximum time range is 72 hours |
User Agents	List User Agents	Gets a list of user agents with basic information
User Agents	List All User Agents	Gets a list of ALL user agents with basic information
User Agents	Get User Agent	Gets the specified user agent with basic information
User Agents	Update User Agent	Updates an user agent with the specified data
User Agents	Delete User Agent	Soft deletes an user agent
User Agents	List User Agent Tags	Gets ALL tags used by user agents on a network or organization
Users	List Users Basic Information	Gets users basic information
Users	List All Users Basic Information	Gets ALL users basic information
Users	Get Information of User	Gets basic information of the specified user