[Tutorial] Write your engines with ease, skip the script-manual, use macros...

andrzejek

https://github.com/seospace/gsapi (I fixed readme and source code)

I think that i explained everything in the README file, it's a simple server that let's you integrate your script's / template's / macros into GSA SER.

Feel free to ask any questions.

Lord_Alfred

This is very interesting
But I dont understand: after run in GSA - requests are redirected to ZennoPoster and he do all work and return back some response with data, right?

andrzejek

I hope that will be better to understand, if not, please correct me:

There are 3 important variables:
- post data in engine.ini
- link_id (used to track linking task, once SER sends post data to gsapi, gsapi sends back link_id)
- engine_name

SER talks only to gsapi server. It will:
1. Send POST request with your link data (post_data) to gsapi server.
2. Receive JSON response with link_id in gsapi database.
3. Keep trying to verify http://gsapi.local/api/link/verify_redirect/link_id


Your script (Zennoposter) talks only to gsapi server. It will:
1. Send GET request to http://gsapi.local/api/link/consume/engine_name
2. If there is a pending linking task, receive JSON response with post_data.
3. Once it creates a link - send GET request to http://gsapi.local/api/link/set_redirect/link_id/url_encoded_location_where_SER_can_verify_your_link

Now when SER goes to http://gsapi.local/api/link/verify_redirect/link_id it will be redirected to url_encoded_location_where_SER_can_verify_your_link


SER -> gsapi server -><- your script

Its a proxy that is able to:

- receive data from SER about what you need to do
- send data to your script (Zennoposter) about what has to be done
- receive data from your script (Zennoposter) about what is done
- redirect SER to what is done


Take a look here this code is really simple to understand.

Sven

great addition and also free
I have also linked it on the docu page.

andrzejek

@sven thank you, can you make it sticky in the new engines section?

Sven

yes

andrzejek

thank you, i added example Zennoposter templates to use in the repo

azp

Hmm not quite getting it. How do i add link to SER?
1) I create link using ZP
2) Send GET to SER so it can create tiers but :
GET:
http://localhost:9090/api/link/set_redirect/1/http://dupa.com/1.html

{
  "results": "No task with id: 1", 
  "success": false
}

And how do i tell SER that link i am sending  belongs to specific engine ?
ATM i am interested mainly in sending links from ZP to specific SER project

andrzejek

@azp you have to url encode your link


http://gsapi.local/api/link/set_redirect/link_id/url_encoded_location_where_SER_can_verify_your_link

azp

Of course i urencoded it, this forum decoded it  http://prntscr.com/i0xrn0

andrzejek

@azp i just pushed an update to return all exceptions, but looks like there's no link with given ID really... i sent you my skype via pm

azp

i have  though i create custom id and push link into system.. talk 2u soon

myd80

Hi , It's for connecting gsa to a webserver ?