Register Targets

One of the main goals for this project was to be able to create super simple oneliners that I could throw into various places like my i3blocks status bar.

To show you how this can be done, let's take a look at the following example, which will register all unregistered targets for you.

If you're unfamiliar with python3 -c, this is how you can execute a small amount of Python from your (bash, zsh, etc.) shell. We take that to import synack just as we would in a full script. We then have a longer command that creates the handler, then calls the targets.set_registered() function to get and register all unregistered targets.

python3 -c "import synack; synack.Handler().targets.set_registered()"

This could be thrown into a cronjob (crontab -e) as seen below to register any new targets once an hour:

0 * * * * python3 -c "import synack; synack.Handler(login=True).targets.set_registered()"

Do note that the login State variable is set to True here. This means that every time this function is called, it will confirm you are logged in and if not, it will log you in. This is not default behavior because it makes between 1 and 5 requests each time Handler is initiated. That said, you likely want to make sure you are having the SynackAPI log in often on one or two scripts.