Difference between revisions of "I2Rest Advanced Setup"

From i2Rest
Jump to: navigation, search
 
(104 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:I2Rest Basic Setup}}
+
This section describes configuration options of i2Rest Server. [[I2Rest_quick_config|Basic configuration]] allows only demo server functionality, and must be extended to supply full functional server instancence. Combining examples bellow you can achieve server functionality that suits your requirements. <br>
Take a look on how the minimal i2Rest configuration might look like.
 
<pre>
 
{
 
  "gates":
 
  {
 
      "main"      : {"url":"http://i2rest.com:22088"},
 
      "management" : {"url":"http://192.168.0.233:8080"},
 
      "session"    : {"url":"http://192.168.0.233:8888/session_gate"}
 
  },
 
  "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' '-dcm_client_id' 'MYCLIENT')) 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' '-dcm_client_id' 'MYCLIENT')) INLLIBL(KAPBASELIB QGPL)"},
 
  ],
 
}
 
</pre>
 
According to [[I2Rest_Config|I2Rest Configuration Object description]] just two i2Rest Configuration Object fields are mandotary: [[gates object]] and [[i2Rest_Gates|main, manager and session gates object]]. With only this two configured fields we already can run a server instance, but still can't get much use of it. Most valuable i2Rest Server applications - the [[I2Rest_API#run_program_API|run_program API]] and the [[I2Rest_API#run_command_API|run_command API]] requires some more stuff:
 
  
::run_command_API requires [[OAuth2_object|Oauth2 object]];
+
* [[Using secured connections]]
::generaly run_program API requires [[Pcml_object|PCML object]] to be set up, but Oauth2 object also is mandotary for programs which has "valid_in_anonymous":false flag in PCML.
+
* [[i2Rest Gate URL definition using Unix socket|Serving incoming connections using Unix sockets]]
 +
* [[I2Rest_with_syslog|Using syslog with i2Rest Server]]
 +
* [[Configuring OAuth2 authorization]]
 +
* [[Run_command_Api_config|How to allow calls to run_command API]]
 +
* [[Management_API_config|How to allow calls to management API]]
 +
* [[Remote_API_call_config|How to call API located on remote IBM i server]]
 +
* [[I2Rest_Basic_PowerApps_Connector|How to create Microsoft Power Apps custom adapter to i2Rest Server]]
 +
i2Rest server should be [[I2Rest_Start|restarted]] to aplly your new configuration *.json.

Latest revision as of 20:25, 12 July 2020

This section describes configuration options of i2Rest Server. Basic configuration allows only demo server functionality, and must be extended to supply full functional server instancence. Combining examples bellow you can achieve server functionality that suits your requirements.

i2Rest server should be restarted to aplly your new configuration *.json.