Question

How do I configure FTK Central to collect from GMail?

 

Prerequisites

  • A Google Google Suite account for your organization
  • Administrator account credentials for your organization's Google Suite account

 

Answer

  1. Log in to the Google Cloud Platform API & Services Console at https://console.cloud.google.com/apis/ with your organization's Google Administrator account
  2. Click on the Project list at the top
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875548/original/2021-06-08_11_52_00-Window.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=f58bf2bfe0c2f8491d41dd7db2d3ac9017caf69c02c6a367a11d857c817bb394
  3. In the new dialog, select your domain and click NEW PROJECT
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875549/original/2021-06-08_11_54_17-Window__1_.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=f27206331cb773b28a86d6f2d1cb3aca2408275bc6d6ee3cbe81e4e2b890f826
  4. Give the project a name and click CREATE
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875550/original/2021-06-22_13_31_16-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=ff157fc959604b8686b7afaaa59864490172f282a670edf965932e419878da01
  5. Make sure you're viewing the new project, and click OAuth consent screen on the left
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875551/original/2021-06-22_14_10_40-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=0d834e75d8b852d3419b9e7b236c218a91ad7465d1c617435d4ec40cf05bc323
  6. Select Internal and click CREATE
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875552/original/2021-06-22_13_51_43-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=5dca30fde599f5b510ad0f3f5056372d19b7875ee5b3addcda1e20a50d482e3c
  7. Specify an App name and User support email
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875553/original/2021-06-22_13_55_29-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=f0d51ab7b853a4cb540a15f0360ec8d42b7661fd3c211d78d22fb85a90b4df69
  8. Specify Developer contact information and click SAVE AND CONTINUE
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875554/original/2021-06-22_13_59_00-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=01877fad215ca6eb49c05d8977148c752e1df172614ff03c135647c9b039b9d9
  9. On the Scopes and Optional Info pages, simply click SAVE AND CONTINUE at the bottom
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875555/original/2021-06-22_14_01_39-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=4d57efcbb9930bf74a4b4446803e1ab241a97a168e077fa4122e28af7752986d
  10. Make sure you're viewing the new project, and click Credentials on the left
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875556/original/2021-06-22_13_39_19-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=888976ddfbb25090e7f0716b26b7e35e25e92bd31d29d3d0a6ddc6a96eed8e80
  11. Click CREATE CREDENTIALS at the top
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875557/original/2021-06-22_13_41_07-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=98efcd8c3b45fb96f61aabfdc11807e7a9607a79e2c8cbd6a05064b139709844
  12. Select OAuth client ID
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875558/original/2021-06-22_13_48_29-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=57dab2af9b893c5cbf09487fb0cb6aa838074976ce7f85a242903ea0680db090
  13. In the Application type drop-down, select Web application
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875559/original/2021-06-22_14_15_39-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=158110fa19e5bc2d8cf196acf1eb0d321be16351fe928c7f0aa320c5176fc8dd
  14. In the Name field, enter FTK Central
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875560/original/2021-06-22_14_18_03-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=930dff5f36f90db2b927a12586069ceba08a429a1dcc64c34930d1e7fe497b26
  15. Under Authorized redirect URIs, click ADD URI and enter https://localhost:4443/api/GmailAdminAccessData then click CREATE
    Note: If FTK Central is using a custom port, change this URI to reflect that
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875561/original/2021-06-22_14_21_09-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=a84b35d0d6170c80ca2f5705010110d20537d74e7c51d22691c070fa43be08f0
  16. Copy the created Client ID and Client Secret
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875562/original/2021-06-22_14_23_28-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=0fee444f1c56ff5938bd4b5e73e8dc6da401022fa73578092bde7b000ed3f6db
  17. Navigate to the Admin SDK API page at https://console.cloud.google.com/apis/library/admin.googleapis.com
  18. Make sure you're viewing your new project, and click ENABLE
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875563/original/2021-06-22_14_54_04-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=e7cf6bead41dfb7b0947549c2a7434dd66670a48caa08e4c5edd14c527c98712
  19. From the FTK Central server, log in to FTK Central and click Data Sources
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875564/original/2021-06-08_12_59_14-Window__1_.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=afe50bcdff3dfd13e44aa20ea3f8ef9d34aec0b724895dfa44332c0e2861db18
  20. Click Gmail
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875565/original/2021-06-22_14_26_50-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=b3b56a18c69ef03006089e7f525c268c156e1e66d1db77567e575c5389493f10
  21. Click Add Gmail on the right
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875566/original/2021-06-22_14_27_34-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=3de6ed15ec9978e6353c81c23bba7d165f951763664a69499c83e2d717f3ba95
  22. In the new dialog, do the following:
      1. Provide a Name for the connector
      2. Enter your Gmail Domain
      3. Paste the previously copied Client ID and Client Secret
      4. In the Redirect Url field, enter https://localhost:4443/api/GmailAdminAccessData
      5. Click Save
        https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875567/original/2021-06-22_14_33_44-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=ce0189f8f17ec4b106b3ea41e365a63976e47ec79f30a929a4c9ae6670fc6149
  23. Under Actions click Edit
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875568/original/2021-06-22_14_36_26-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=b12800a01e52ac56b91eee9c2bb3fb6769ecf8b09f25cd964cb511429ecb994b
  24. Under Authorize click Google
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875569/original/2021-06-22_14_37_50-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=52eabcead12ac191281b263d741ed57ef215f61affbf9c428327b23f18872a34
  25. Follow the prompts to authorize your connector, then click Save
  26. Confirm the Refresh Token Status for your connector shows Active
    https://s3.amazonaws.com/cdn.freshdesk.com/data/helpdesk/attachments/production/69009875572/original/2021-06-25_10_11_54-mRemoteNG_-_confCons.xml_-_ftkc-app.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAS6FNSMY2XLZULJPI%2F20210926%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20210926T163828Z&X-Amz-Expires=300&X-Amz-SignedHeaders=host&X-Amz-Signature=ccaa201d35f1aff3c4bb9c8ab85378367655d9349d4ad32a3d87d2ea7d27bc05