i2Rest Server quickstart

From i2Rest
Revision as of 11:39, 8 June 2020 by Pavel.lobko (talk | contribs)
Jump to: navigation, search

Our done-in-three-steps i2Rest Server configuration template will help you to set up you server in a minutes. With this minimal configuration your server instance will be able to process request to test echo program.

step1
Contact to your System administrator for available host and port for "main" and "management" gates of the server, and set up appropriate settings.
step2
step3
{
   "gates":
   {
      "main"       : {"url":"http://<host_name>[:port]"},
      "management" : {"url":"http://<host_name>[:port]"}
   },
   "session_systems":
   [
         {"name": "*LOCAL",     "submit":"SBMJOB JOB(I2RESTS) USER(${user}) CMD(CALL JPCML/I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}' 
             '-user' '${user}' '-init' 'ADDLIBLE JPCML' )) INLLIBL(KAPBASELIB QGPL)"},
         {"name": "*ANONYMOUS", "submit":"SBMJOB JOB(I2RESTA) USER(${user}) CMD(CALL JPCML/I2REST PARM('-session' '-url' '${surl}' '-uid' '${uid}'
             '-user' '${user}' '-init' 'ADDLIBLE JPCML' )) INLLIBL(KAPBASELIB QGPL)"}
   ],

   "pcmls":
   [
      {"pcml_mount":"echo",     "pcml_file":"/i2rest/Server1/echo.pcml", "valid_in_anonymous":true},
   ],

   "OAuth2":
   {
      "scopes": {"run_program"          : {"description":"Run *PGM and *SRVPGM"}, 
                 "management_functions" : {"description":"Invoke i2Rest manager APIs"}},
      "clients":
      {
         "OAUTH21":{"redirect_uri":<main gate>/oauth2/redirect", 
                    "description":"Test client", 
                    "valid_scopes":["run_program", "management_functions"],
                    "valid_grant_types":["authorization_code", "urn:ietf:params:oauth:grant-type:device_code", "refresh_token", "client_credentials"]}
      },

      "tokens": {"type":"token"},"refresh_tokens":{"type":"refresh_token"},"codes":{"type":"code"},"device_codes":{"type":"user_code"},

      "login_page"            : "/pages/Login/index.html",
      "decision_page"         : "/pages/user_decide.html",
      "bad_auth_page"         : "/pages/bad_auth.html",
      "enter_code_page"       : "/pages/enter_code.html",
      "device_connected_page" : "/pages/device_connected.html"
   }
   
}

Now save your config.json on IFS and you are ready to start your i2Rest Server instance.
Please explore more details how to configure your i2Rest server.