Configuring Intercom connections - Amazon Glue
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Configuring Intercom connections

Intercom supports the AUTHORIZATION_CODE grant type for OAuth 2.

This grant type is considered “three-legged” OAuth as it relies on redirecting users to the third party authorization server to authenticate the user. It is used when creating connections via the Amazon Glue Console. The Amazon Glue Console will redirect the user to Google Ads where the user must login and allow Amazon Glue the requested permissions to access their Intercom instance.

Users should provide their own client id and client secret when creating connections through the Amazon Glue Console. In this scenario, they will still be redirected to Intercom to login and authorize Amazon Glue to access their resources.

This grant type results in a refresh token and access token. The access token is short lived, and may be refreshed automatically without user interaction using the refresh token.

For more information on creating a connected app for Authorization Code OAuth flow, see Ads API .

To configure an Intercom connection:

  1. In Amazon Secrets Manager, create a secret with the following details. It is required to create a secret for each connection in Amazon Glue.

    1. For customer managed connected app – Secret should contain the connected app access token, refresh token, client_id, and client_secret.

    2. For an Amazon Managed connected app – Empty secret or a secret with some temporary value.

  2. In the Amazon Glue Data Catalog, create a connection by following the steps below:

    1. When selecting a Connection type, select Intercom.

    2. Provide the Intercom environment.

    3. Select the IAM role which Amazon Glue can assume and has permissions for following actions: 

      {
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:DescribeSecret",
                "secretsmanager:GetSecretValue",
                "secretsmanager:PutSecretValue",
                "ec2:CreateNetworkInterface",
                "ec2:DescribeNetworkInterface",
                "ec2:DeleteNetworkInterface",
            ],
            "Resource": "*"
        }
    ]
}

    4. Select the secretName which you want to use for this connection in Amazon Glue to put the tokens.

    5. Select the network options if you want to use your network.

  3. Grant the IAM role associated with your Amazon Glue job permission to read secretName.

  4. In your Amazon Glue job configuration, provide connectionName as an Additional network connection.