A token-based authentication system allows users to enter their username and password in order to obtain a token, which allows them to fetch a specific resource, without using their username and password. Once their token has been obtained, the user can offer the token, which offers access to a specific resource for a time period, to the remote site.

This article explains how to generate a Google Services token, step by step, with the needed permissions for the COZYROC REST Connection Manager component. And it explains how to generate a token for the different Google Services.

In order to use the generated token, you need to create a specific XML file, which then needs to be entered into the REST Connection Manager Configuration. To simplify this article, the process has been separated into 4 steps:

1) Generate authorization code and give permission to COZYROC to access your Google Service

2) Create a custom POST request to be sent to the Google server

3) Receive the authorization and refresh token in JSON format so that you can examine the result from the response

4) Create an XML file for the token that complies to the COZYROC token XML format

1. Based on what Google Service token you want to create, Click the URL above for the particular Google Service and then the following screen will open:
   

           

1. Then enter your credentials and you will get the following screen:
   

           

1. Click the "Allow" button in the above screen to grant permissions to COZYROC to access your Google Service, in our case Google Drive. As a result, a link will be generated, that includes the authorization code that we are going to need in Step 2.
   

http://localhost/?code=4/zgFa2OjKFvuYkxqHDBvGZ9xlp2TEVRJhsA_Kp6s2chwV3fhiImh6o8iUzfyuVlVInWiLJEcEGjAwUcoh7gEL5-0&scope=https://www.googleapis.com/auth/drive%20https://www.googleapis.com/auth/drive.readonly%20https://www.googleapis.com/auth/drive.appdata%20https://www.googleapis.com/auth/drive.file%20https://www.googleapis.com/auth/drive.install%20https://www.googleapis.com/auth/drive.metadata%20https://www.googleapis.com/auth/drive.metadata.readonly%20https://www.googleapis.com/auth/drive.photos.readonly%20https://www.googleapis.com/auth/drive.scripts

code=4/zgFa2OjKFvuYkxqHDBvGZ9xlp2TEVRJhsA_Kp6s2chwV3fhiImh6o8iUzfyuVlVInWiLJEcEGjAwUcoh7gEL5-0

You can use this code for only a single request and it will expire in 5 minutes or less.

1. Login to POSTMAN
   
2. Click the button "New" and select "Request" from the dropdown menu. Please look at the screenshot below:
   
3. 
   
4. Enter request name and save your request.
   
5. Open your request, select POST for the Request and enter for URL: "https://oauth2.googleapis.com/token". This is the URL where we are going to send the Post Request. Please look at the screenshot below:
   
6. 
   
7. Click "Body" 
   
8. Select "x-www-form-urlencoded
   
9. Enter for Key and Value all the Post request parameters and their values we showed you in the table above. Please look at the screenshot above
   
10. You will also need to set up the Headers as Content-Type = application/x-www-form-urlencoded. Please look at the POSTMAN screenshot below:
    
11. 
    
12. Then click "Send" to send the POST Request
    

{

  "access_token": "ya29.a0Ae4lvC1ZqXVJXpwFHVY7-dWu9a1_6HuJQovLf16docSDIU0PThJQ1NgIufBAY2dVqzeYuruc4QVwHpMwY1tuspj4qo2JAQ_8xibmmHTdiDxlk0bNkl2EaJH1l7UcKZUOMdvH8pC9gPKBQU0mahLrHHGsah3VvL7PN3M",

  "expires_in": 3599,

  "refresh_token": "1//0dFnlTD2PccEjCgYIARAAGA0SNwF-L9IrdAiKWj7zFCGXBNRYywpv_LYL48JTsWCWDGioq216Ao9mCKM36p8anjdtzbnXw0EBde4",

  "scope": "https://www.googleapis.com/auth/drive.metadata https://www.googleapis.com/auth/drive https://www.googleapis.com/auth/drive.metadata.readonly https://www.googleapis.com/auth/drive.install https://www.googleapis.com/auth/drive.appdata https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/drive.photos.readonly https://www.googleapis.com/auth/drive.file https://www.googleapis.com/auth/drive.scripts",

  "token_type": "Bearer"

}

1. Go to your REST Connection Manager and click on it twice; the REST Connection Manager configuration screen will open.
   
2. Select  your Google Service for Configuration, in our case this is "Google Drive" . Please look at the screenshot below:
   
3. 
   
4. Click the button "New" to create a new token file.
   
5. Complete all the steps until you get to the third page of the Wizard. Please look at the screenshot below:
   
6. 
   
7. 
   
8. For "Access Token", enter the access_token value from the JSON Response you received above.
   
9. For "Refresh Token", enter the refresh_token value from the JSON Response you received above.
   
10. For "Expiration(UTC):", keep the default Expiration date and time value that was automatically calculated(Current UTC date and time + 50 minutes ) 
    
11. For "Save Files:", enter the file token name and the file path where you want to save the newly generated Token XML File.   
    
12. For "Password:", enter a token password. Please look at the screenshot below:
    
13.   
    
14. Click the "OK" button. Your token XML file will be generated. Please look at the screenshot below:
    
15. 
    
16. Click the "Test Connection" button and you should get the message "Test connection succeeded".