Remote API call config - Revision history

Pavel.lobko at 11:28, 9 July 2020

2020-07-09T11:28:04Z

2020-07-09T11:27:16Z

2020-07-09T11:15:43Z

2020-07-09T06:38:23Z

2020-07-09T06:14:51Z

2020-07-08T13:04:15Z

2020-07-08T08:21:38Z

2020-07-07T08:35:06Z

2020-07-06T12:38:24Z

2020-07-06T12:23:24Z

@@ Line 84: / Line 84: @@
+  }
 Both "run program" and "system_<system_name>" scopes must be specified obtaining OAuth2 token to perform authorized remote API call.<br>
-Anonymous remote sessions, that allows API call without OAuth2 token obtained, are also possible. SBMRMTCMD command must be defined under <code>*ANONYMOUS</code> session system to provide this feature.<br>
+Anonymous remote sessions, that allows API call without OAuth2 token obtained, are also possible. SBMRMTCMD command must be defined under <code>*ANONYMOUS</code> session system to provide this feature (as it shown above).<br>
 Now you are ready to [[I2Rest_Start|start]] serving remote API call.<br/>

@@ Line 25: / Line 25: @@
 ;Step 5
-:Contact your system administrator for your i2Rest Server IBM i server host name (or IP) and ''two'' available ports for "main" and "management" gates of your first i2Rest Server instance. Create file config.json (you can name it with any name and put it into any available IFS folder).Сopy and paste the snippet bellow. Replace with appropriate values highlighted with <b>bold</b> parts: host_name, ports, pcml_file, system name, user (resource owner) and client.
+:Contact your system administrator for your i2Rest Server IBM i server host name (or IP) and ''two'' available ports for "main" and "management" gates of your first i2Rest Server instance. Create file config.json (you can name it with any name and put it into any available IFS folder). Сopy and paste the snippet bellow. Replace with appropriate values highlighted with <b>bold</b> parts: host_name, ports, pcml_file, system name, user (resource owner) and client.
 [[I2Rest_quick_config|Basic configuration]] remote API call variant (differences are highlighted in <span style="background:#D3D3D3;">gray</span>):

@@ Line 25: / Line 25: @@
 ;Step 5
-:Contact your system administrator for your i2Rest Server IBM i server host name (or IP) and ''two'' available ports for "main" and "management" gates of your first i2Rest Server instance. Create file config.json (you can name it with any name and put it into any available IFS folder). Enter following text, replace host_name, ports, pcml_file, system name, user (must be a regestered IBM i user) and client (must be a regestered IBM i user) with appropriate values.
+:Contact your system administrator for your i2Rest Server IBM i server host name (or IP) and ''two'' available ports for "main" and "management" gates of your first i2Rest Server instance. Create file config.json (you can name it with any name and put it into any available IFS folder).Сopy and paste the snippet bellow. Replace with appropriate values highlighted with <b>bold</b> parts: host_name, ports, pcml_file, system name, user (resource owner) and client.
 [[I2Rest_quick_config|Basic configuration]] remote API call variant (differences are highlighted in <span style="background:#D3D3D3;">gray</span>):

@@ Line 83: / Line 83: @@
      }</span>
+  }
-"system_<system_name>" scopes must be specified obtaining OAuth2 token to perform request.<br>
+Both "run program" and "system_<system_name>" scopes must be specified obtaining OAuth2 token to perform authorized remote API call.<br>
-Please, take a look on <code>*ANONYMOUS</code> session system. Anonymous sessions are possible only for the * ANONYMOUS system. If the SBMRMTCMD command will be registered on this system, then you do not need to get run_program
+Anonymous remote sessions, that allows API call without OAuth2 token obtained, are also possible. SBMRMTCMD command must be defined under <code>*ANONYMOUS</code> session system to provide this feature.<br>

@@ Line 11: / Line 11: @@
 ;Step 3
 :Create text file named I2RESTECHO.PCML anywhere on target IBM i IFS, for example "/tmp/PCML/i2restecho.pcml". Copy and paste following code. It represents a description for the sample program I2RESTECHO, that is included into i2Rest Server installation for demonstration purposes:
 <pre>

@@ Line 23: / Line 23: @@
 </pre>
 ;Step 4
-:Register two users on IBM i. One will be used as a demonstrative OAuth2 resource owner, and the second one as an OAuth2 client.
+:Register two users on IBM i. The first will be used as a demonstrative OAuth2 resource owner, and the second one as an OAuth2 client.
 ;Step 5

@@ Line 59: / Line 59: @@
            "pcml_mount"         : "echo",
            "pcml_file"          : "'''<complete name of i2restecho.pcml on IFS (for example /tmp/PCML/i2restecho.pcml)>'''"б
-           "valid_in_anonymous" : false
+           "valid_in_anonymous" : true
      ],
      <span style="background:#D3D3D3;">"OAuth2":

@@ Line 43: / Line 43: @@
                                                     ''-url'' ''${surl}''
                                                     ''-uid'' ''${uid}''
-                                                    ''-init' ''ADDLIBLE I2REST''</nowiki>))')",
+                                                    ''-init' ''ADDLIBLE I2REST''</nowiki>))')"
-        }</span>
+        },</span>
         <span style="background:#D3D3D3;">{  "name"   : '''<system name> (for example REMOTE)'''",
            "submit" : "SBMRMTCMD DDMFILE(QGPL/RMTSYS)
@@ Line 58: / Line 58: @@
+        {
            "pcml_mount"         : "echo",
-           "pcml_file"          : "'''<complete name of i2restecho.pcml on IFS (for example /tmp/PCML/i2restecho.pcml)>'''",
+           "pcml_file"          : "'''<complete name of i2restecho.pcml on IFS (for example /tmp/PCML/i2restecho.pcml)>'''"б
            "valid_in_anonymous" : false
      ],
@@ Line 83: / Line 83: @@
+  }
 "system_<system_name>" scopes must be specified obtaining OAuth2 token to perform request.<br>
-Please, take a look on [[Remote_anonymous_API_call_config|confiuration that allows anonymous remote API call.]]
+Please, take a look on <code>*ANONYMOUS</code> session system. Unlike