Censys is a platform that helps information security practitioners discover, monitor, and analyze devices that are accessible from the Internet.
Enterprises use Censys to understand their network attack surfaces. CERTs and security researchers use it to discover new threats and assess their global impact. Censys was founded by computer scientists at the University of Michigan, and the data collected has been used in hundreds of scientific papers by researchers worldwide.
First, get a Censys API key
Login to your Censys account at https://censys.io/login
Click on the user menu and select "My Account"
Click on the API tab and copy your "API ID" and "Secret" to a text editor
Lastly, create a Censys resource and credential in Tines
Login to your Tines tenant
Navigate to the team that will be using the API and click "Resource"
Click "+ New Resource"
Input the values for the Censys resource
Name: Censys API ID
Description: Optional
Builder: Your API ID
Optional
Access: What other teams can also use the resource
Click "Save resource"
Navigate to the team that will be using the API and click "Credential"
Click "+ New Credential" and select "Text"
Input the values for the Censys credential
Name: Censys
Description: Optional
Value: Your Secret
Optional
Domains: Ensure this credential can only be used when making HTTP requests to specific domains.
Access: What other teams can also use the API
Click "Save"
For more on creating credentials in Tines, click here.
You can find a selection of Censys stories in the story library
Using the credential in an action
Here is an example Censys action you can copy and paste onto your storyboard in Tines:
{"standardLibVersion":"36","actionRuntimeVersion":"4","agents":[{"disabled":false,"name":"Search for IP in Censys","description":"Returns host information for the specified IP address","options":"{\"url\":\"https://search.censys.io/api/v2/hosts/<<ip_address>>\",\"method\":\"get\",\"content_type\":\"json\",\"basic_auth\":[\"<<RESOURCE.censys_api_id>>\",\"<<CREDENTIAL.censys>>\"]}","position":{"x":1080,"y":4440},"type":"httpRequest","timeSavedUnit":"minutes","timeSavedValue":0,"monitorAllEvents":false,"monitorFailures":false,"monitorNoEventsEmitted":null,"recordType":null,"recordWriters":[],"form":null,"cardIconName":"httpRequest","createdFromTemplateGuid":"37a200c25896125243268646d02f8dab9ed013982d19e734fbd96cfced31d9e9","createdFromTemplateVersion":1,"originStoryIdentifier":"cloud:aa47f8215c6f30a0dcdb2a36a9f4168e:d4c15df0f02ba4789095426607003199"}],"links":[],"diagramNotes":[]}