Authorization code usecase 1 - Revision history

Alexei.baranov at 08:52, 17 July 2020

2020-07-17T08:52:43Z

2020-07-09T09:10:32Z

‎i2Rest Client command composing

2020-07-09T09:01:28Z

2020-07-09T08:14:41Z

‎i2Rest Client command composing

2020-07-09T08:10:58Z

‎Preparations

2020-07-09T08:10:38Z

‎i2Rest Client command composing

2020-07-09T08:09:57Z

‎i2Rest Client command composing

2020-07-09T08:04:20Z

‎i2Rest Client command composing

2020-07-09T07:58:27Z

‎i2Rest Client command composing

2020-07-09T07:57:35Z

‎i2Rest Client command composing

@@ Line 1: / Line 1: @@
-{{DISPLAYTITLE:Dealing with Google Drive}}
+{{DISPLAYTITLE:Dealing with Google Drive via i2Rest bridge}}
 The use case shows how to use I2Rest Client request with [[Authorization_Code_flow_description|Oauth2 Authorization code flow]], the same result can be also achevied using [[Device_flow_description|Oauth2 Device flow]]. We will call [https://developers.google.com/drive/api/v3/reference/files/list Google Drive Api] in order to get the list of existing files on "i2restexample" user Google Drive.
 == Preparations ==

@@ Line 8: / Line 8: @@
 == i2Rest Client command composing ==
-So what we need composing i2Rest Client command is:<br>
+Composing i2Rest Client we need:<br>
 :to set request method and API endpoint to values that are specified in the API method description;
 <pre>

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:Dealing with Google Drive}}
-The usecase shows how to use I2Rest Client request with [[Authorization_Code_flow_description|Oauth2 Authorization code flow]], the same result can be also achevied using [[Device_flow_description|Oauth2 Device flow]]. We will call [https://developers.google.com/drive/api/v3/reference/files/list Google Drive Api] in order to get the list of existing files on "i2restexample" user Google Drive.
+The use case shows how to use I2Rest Client request with [[Authorization_Code_flow_description|Oauth2 Authorization code flow]], the same result can be also achevied using [[Device_flow_description|Oauth2 Device flow]]. We will call [https://developers.google.com/drive/api/v3/reference/files/list Google Drive Api] in order to get the list of existing files on "i2restexample" user Google Drive.
 == Preparations ==
 The next steps are to be performed before we can compose and execute i2Rest Client command.<br>

@@ Line 45: / Line 45: @@
         TOKENS('/qsys.lib/qtemp.lib/tokens.usrspc')
         AUTHID('Device ID')
-        AUTHPW('Device Password')
+        AUTHPW('Device password')
         AUTHURL('https://accounts.google.com/o/oauth2/v2/auth
                 ')

@@ Line 3: / Line 3: @@
 == Preparations ==
 The next steps are to be performed before we can compose and execute i2Rest Client command.<br>
-:a) Your application should be registered as a client (obtaining Device ID and Device Password) on [https://console.developers.google.com/apis/credentials Google] (see [https://developers.google.com/identity/protocols/oauth2 details]). Make sure your specify Redirection URI that matches i2Rest Bridge endpoint.<br>
+:a) Your application should be registered as a client (obtaining Device ID and Device password) on [https://console.developers.google.com/apis/credentials Google] (see [https://developers.google.com/identity/protocols/oauth2 details]). Make sure your specify Redirection URI that matches i2Rest Bridge endpoint.<br>
 :b) Insure that you have Google SSL CA installed. [[Add_external_CA_to_trust_list  |Install it if needed]].<br>
 :c) Register your i2Rest Client on your i2Rest Server as a client to enable "bridge mode" by setting up your i2Rest Server [[OAuth2_object|OAuth2 object]].

@@ Line 21: / Line 21: @@
 <pre>
         AUTHID('Device ID')
-        AUTHPW('Device Password)
+        AUTHPW('Device password)
         AUTHURL('https://accounts.google.com/o/oauth2/v2/auth
                 ')

@@ Line 27: / Line 27: @@
         SCOPE('https://www.googleapis.com/auth/drive.file')
 </pre>
-:to specify <code>*BRIDGE</code> Authorization method and Bridge mode parameters obtained on Preparations step (c).
+:to specify <code>*BRIDGE</code> Authorization method and Bridge mode parameters obtained on Preparations step (c). <code>BRIDGEPW</code> is an IBM i user (which is defined as i2Rest Server client) password.
 <pre>
         AUTHMETHOD(*BRIDGE)
         BRIDGEURL('<Bridge endpoint>')
-        BRIDGEID(<Client name>)
+        BRIDGEID('<Client name>')
-        BRIDGEPW(<Client password>)
+        BRIDGEPW('<Client password>')
 </pre>
 All the necessary parameters are specified, it's time to execute the complete command.
@@ Line 45: / Line 45: @@
         TOKENS('/qsys.lib/qtemp.lib/tokens.usrspc')
         AUTHID('Device ID')
-        AUTHPW('Device Password)
+        AUTHPW('Device Password')
         AUTHURL('https://accounts.google.com/o/oauth2/v2/auth
                 ')
@@ Line 51: / Line 51: @@
         SCOPE('https://www.googleapis.com/auth/drive.file')
         BRIDGEURL('<Bridge endpoint>')
-        BRIDGEID(<Client name>)
+        BRIDGEID('<Client name>')
-        BRIDGEPW(<Client password>)
+        BRIDGEPW('<Client password>')
 </pre>

@@ Line 30: / Line 30: @@
 <pre>
         AUTHMETHOD(*BRIDGE)
-        BRIDGEURL('<i2Rest Server Main Gate URL>/a2d')
+        BRIDGEURL('<Bridge endpoint>')
-        BRIDGEID(OAUTH21)
+        BRIDGEID(<Client name>)
-        BRIDGEPW(oauth21)
+        BRIDGEPW(<Client password>)
 </pre>
 All the necessary parameters are specified, it's time to execute the complete command.
@@ Line 40: / Line 40: @@
         OUTPUT(*BOTH)
         DCMCLIENT(MYCLIENT)
-        RECVLOG('/home/btpl/recv.log')
+        RECVLOG('/home/USRX/recieved.log')
-        SENTLOG('/home/btpl/sent.log')
+        SENTLOG('/home/USRX/sent.log')
         AUTHMETHOD(*BRIDGE)
         TOKENS('/qsys.lib/qtemp.lib/tokens.usrspc')
-        AUTHID('1052056765075-qv2u4rgmhs6rgoijpribg64ffvtgdhi
+        AUTHID('Device ID')
-.apps.googleusercontent.com')
+        AUTHPW('Device Password)
         AUTHURL('https://accounts.google.com/o/oauth2/v2/auth
                 ')
         TOKENURL('https://oauth2.googleapis.com/token')
         SCOPE('https://www.googleapis.com/auth/drive.file')
-        BRIDGEURL('https://api.i2rest.com:22089/a2d')
+        BRIDGEURL('<Bridge endpoint>')
-        BRIDGEID(OAUTH21)
+        BRIDGEID(<Client name>)
-        BRIDGEPW(oauth21)
+        BRIDGEPW(<Client password>)
 </pre>

@@ Line 16: / Line 16: @@
 :to specify properly configured on Preparations step (b) Certificate_Store to be able to work with SSL secured resource;
 <pre>
-        DCMCLIENT(<DCM_client_name>)
+        DCMCLIENT(<DCM client name>)
 </pre>
 :to specify obtained on Preparations step (a) requisites;