設定 Salesforce 連線

若要設定 Salesforce 連線：

1. 在 AWS Secrets Manager 中，使用下列詳細資訊建立秘密：

   1. 對於 JWT_TOKEN 授予類型 - 秘密應該包含具有其值的 JWT_TOKEN 金鑰。

   2. 對於 AuthorizationCode 授予類型：

      1. 對於 AWS 受管連線應用程式，必須提供空白秘密或具有一些暫時值的秘密。

      2. 對於客戶受管的連線應用程式，秘密應包含Consumer Secret以 USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET做為金鑰的連線應用程式。

   3. 注意：您必須在 中建立連線的秘密 AWS Glue。

2. 在 AWS Glue Glue Studio 中，依照下列步驟在資料連線下建立連線：

   1. 選取連線類型時，請選取 Salesforce。

   2. 提供您要連線之 Salesforce 執行個體的 INSTANCE_URL。

   3. 提供 Salesforce 環境。

   4. 選取 AWS Glue 可以擔任並具有下列動作許可的 AWS IAM 角色：

      JSON

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

   5. 選取您要用於連線的 OAuth2 授權類型。授予類型決定 如何與 Salesforce AWS Glue 通訊，以請求存取您的資料。您的選擇會影響您在建立連線之前必須符合的要求。您可以選擇下列其中一種類型：

      • JWT_BEARER 授予類型：此授予類型適用於自動化案例，因為它允許預先建立具有 Salesforce 執行個體中特定使用者許可的 JSON Web Token (JWT)。建立者可以控制 JWT 的有效期。 AWS Glue 能夠使用 JWT 來取得用於呼叫 Salesforce APIs存取字符。

        此流程要求使用者在其 Salesforce 執行個體中建立連線的應用程式，以為使用者發出 JWT 型存取字符。

        如需為 JWT 承載 OAuth 流程建立連線應用程式的資訊，請參閱伺服器server-to-server整合的 OAuth 2.0 JWT 承載流程。若要使用 Salesforce 連線應用程式設定 JWT 承載流程，請參閱 設定 Salesforce 的 JWT 承載 OAuth 流程。

      • AUTHORIZATION_CODE 授予類型：此授予類型視為「三邊」OAuth，因為它依賴將使用者重新導向至第三方授權伺服器來驗證使用者。透過 AWS Glue 主控台建立連線時，會使用它。根據預設，建立連線的使用者可能需要連線 AWS Glue 的應用程式 (AWS Glue 受管用戶端應用程式），除了 Salesforce 執行個體 URL 之外，不需要提供任何 OAuth 相關資訊。 AWS Glue 主控台會將使用者重新導向至 Salesforce，使用者必須在其中登入 AWS Glue ，並允許請求的許可存取其 Salesforce 執行個體。

        使用者仍然可以選擇在 Salesforce 中建立自己的連線應用程式，並在透過 AWS Glue 主控台建立連線時提供自己的用戶端 ID 和用戶端秘密。在此案例中，它們仍會重新導向至 Salesforce 以登入並授權 AWS Glue 存取其資源。

        此授予類型會產生重新整理權杖和存取權杖。存取字符是短暫存在的，可以使用重新整理字符自動重新整理，而無需使用者互動。

        如需為授權碼 OAuth 流程建立連線應用程式的資訊，請參閱 設定 Salesforce 的授權碼流程。

   6. 選取secretName您要用於此連線的 AWS Glue ，以存放 OAuth 2.0 字符。

   7. 如果您想要使用網路，請選取網路選項。

3. 授予與您的 AWS Glue 任務相關聯的 IAM 角色讀取 的許可secretName。

4. 如果提供網路選項，請同時授予 IAM 角色下列許可：

   JSON

   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "ec2:CreateNetworkInterface",
                   "ec2:DescribeNetworkInterfaces",
                   "ec2:DeleteNetworkInterface"
               ],
               "Resource": "*"
           }
       ]
   }
   

使用 CLI 設定 Salesforce AWS 連線

您可以使用 CLI 建立 Salesforce AWS 連線：

aws glue create-connection --connection-input \
"{\"Name\": \"salesforce-conn1\",\"ConnectionType\": \"SALESFORCE\",\"ConnectionProperties\": {\"ROLE_ARN\": \"arn:aws:iam::123456789012:role/glue-role\",\"INSTANCE_URL\": \"https://example.my.salesforce.com\"},\"ValidateCredentials\": true,\"AuthenticationConfiguration\": {\"AuthenticationType\": \"OAUTH2\",\"SecretArn\": \"arn:aws:secretsmanager:us-east-1:123456789012:secret:salesforce-conn1-secret-IAmcdk\",\"OAuth2Properties\": {\"OAuth2GrantType\": \"JWT_BEARER\",\"TokenUrl\": \"https://login.salesforce.com/services/oauth2/token\"}}}" \
--endpoint-url https://glue.us-east-1.amazonaws.com \
--region us-east-1