Difference between revisions of "Using secured connections"

From i2Rest
Jump to: navigation, search
(Created page with "=== https === To protect the connections, use the https protocol. i2Rest Server uses standard [https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_71/apis/unix9a.htm IBM i G...")
 
Line 1: Line 1:
=== https ===
+
i2Rest Server uses standard [https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_71/apis/unix9a.htm IBM i GSK API] to protect connections. All required parameters are configured using DCM, see [[I2Rest_secured_gate|detailed guide]].<br>
To protect the connections, use the https protocol. i2Rest Server uses standard [https://www.ibm.com/support/knowledgecenter/ssw_ibm_i_71/apis/unix9a.htm IBM i GSK API] to protect connections. All required parameters are configured using DCM, see [[I2Rest_secured_gate|detailed guide]]. Example:
+
[[I2Rest_quick_config|Basic configuration]] SSL secured variant(differences are highlighted in <span style="color:blue;">blue</span>):
  "gates":
+
  {
 +
    "gates":
 
     {
 
     {
      ...
+
       "main"       : {"url":"https://<span style="background:blue;"><host_name>[:port](for example api.i2rest.com:1234), "dcm_server_id":"MYSERVER" </span>"},
       "main": {"url":"<nowiki>https://192.168.1.123:5678</nowiki>", "dcm_server_id":"MYSERVER", ...},
+
       "management" : {"url":"http://<span style="color:red;"><host_name>[:port] (for example api.i2rest.com:4321)</span>"}
       ...
 
 
     },
 
     },
 +
    "session_systems":
 +
    [
 +
      {  "name"  : "*ANONYMOUS",
 +
          "submit" : "SBMJOB JOB(I2RESTA)                \
 +
                            USER(${user})              \
 +
                            CMD(CALL I2REST            \
 +
                                PARM('-session'          \
 +
                                    '-url' '${surl}'    \
 +
                                    '-uid' '${uid}'    \
 +
          <span style="color:blue;">'-dcm_client_id' 'MYCLIENT'</span> \                    \
 +
                                    '-user' '${user}')) \
 +
                            INLLIBL(I2REST)"
 +
      }
 +
    ],
 +
    "pcmls":
 +
    [
 +
      {
 +
          "pcml_mount"        : "echo",
 +
          "pcml_file"          : "<span style="color:red;"><complete name of i2restecho.pcml on IFS (for example /tmp/PCML/i2restecho.pcml)></span>",
 +
          "valid_in_anonymous" : true
 +
      }
 +
    ]
 +
}

Revision as of 13:05, 29 June 2020

i2Rest Server uses standard IBM i GSK API to protect connections. All required parameters are configured using DCM, see detailed guide.
Basic configuration SSL secured variant(differences are highlighted in blue):

{
   "gates":
   {
      "main"       : {"url":"https://<host_name>[:port](for example api.i2rest.com:1234), "dcm_server_id":"MYSERVER" "},
      "management" : {"url":"http://<host_name>[:port] (for example api.i2rest.com:4321)"}
   },
   "session_systems":
   [
      {  "name"   : "*ANONYMOUS", 
         "submit" : "SBMJOB JOB(I2RESTA)                \
                            USER(${user})               \
                            CMD(CALL I2REST             \
                               PARM('-session'          \
                                    '-url' '${surl}'    \
                                    '-uid' '${uid}'     \
          '-dcm_client_id' 'MYCLIENT' \                    \
                                    '-user' '${user}')) \
                            INLLIBL(I2REST)"
      }
   ],
   "pcmls":
   [
      {
         "pcml_mount"         : "echo",
         "pcml_file"          : "<complete name of i2restecho.pcml on IFS (for example /tmp/PCML/i2restecho.pcml)>", 
         "valid_in_anonymous" : true
      }
   ]
}