기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Salesforce 통합
<a name="salesforce-integration"></a>

Amazon Quick의 Salesforce 작업 커넥터를 사용하면 레코드 관리, 데이터 쿼리, Salesforce APIs. Amazon Quick 구독 요구 사항은 섹션을 참조하세요[콘솔에서 통합 설정](integration-console-setup-process.md).

**참고**  
Salesforce Spring 26 릴리스(2026년 2월)부터 모든 Salesforce 조직에서 새 Connected Apps 생성이 기본적으로 비활성화됩니다. 이 가이드에서는 Amazon Quick Salesforce 커넥터와 완벽하게 호환되는 Salesforce의 외부 클라이언트 앱(ECAs)을 사용합니다.

## 사전 조건
<a name="salesforce-integration-prerequisites"></a>

Salesforce 통합을 설정하기 전에 다음이 있는지 확인합니다.
+ 시스템 관리자 액세스 권한이 있는 Salesforce 조직입니다.
+ Amazon Quick Author 역할 이상.
+ Amazon Quick 인스턴스 URL(예: `https://us-east-1.quicksight.aws.amazon.com`).

## 1단계: Salesforce에서 외부 클라이언트 앱 생성
<a name="salesforce-eca-setup"></a>

Salesforce에서 외부 클라이언트 앱(ECA)을 생성하여 Amazon Quick에서 OAuth 인증을 활성화합니다.

### 외부 클라이언트 앱 관리자로 이동
<a name="salesforce-eca-navigate"></a>

1. Salesforce 조직에 로그인하고 **설정**(오른쪽 상단의 톱니 모양 아이콘)을 선택합니다.

1. 탐색 창에서 **플랫폼 도구** > **앱** > **외부 클라이언트 앱** > **외부 클라이언트 앱 관리자**를 확장합니다.

1. **새 외부 클라이언트 앱을** 선택합니다.

### 기본 정보 입력
<a name="salesforce-eca-basic-info"></a>

외부 클라이언트 앱에 대한 다음 기본 정보를 입력합니다.


**외부 클라이언트 앱 기본 정보**  

| Field | 값 | 
| --- | --- | 
| 외부 클라이언트 앱 이름 | 설명이 포함된 이름(예: "Amazon Quick Integration") | 
| API 이름 | 앱 이름에서 자동 생성됨 | 
| 연락처 이메일 | 관리자 이메일 주소 | 
| 배포 상태 | 로컬(기본값) | 

## 2단계: OAuth 설정 구성
<a name="salesforce-oauth-setup"></a>

### OAuth 활성화
<a name="salesforce-enable-oauth"></a>

**API(OAuth 설정 활성화)** 섹션에서 ** OAuth 활성화**를 선택하여 OAuth 구성 패널을 확장합니다.

### 콜백 URL 설정
<a name="salesforce-callback-url"></a>

콜백 URL 필드에 Amazon Quick OAuth **콜백 URL**을 입력합니다.

`{{<your-quick-instance-url>}}/sn/oauthcallback`

예: `https://us-east-1.quicksight.aws.amazon.com/sn/oauthcallback`

### OAuth 범위 추가
<a name="salesforce-oauth-scopes"></a>

사용 **가능한 OAuth 범위에서** **선택한 OAuth 범위로 다음 범위를 이동합니다.**
+ 자격 증명 URL 서비스 액세스(id, profile, email, address, phone)
+ API로 사용자 데이터 관리(api)
+ 웹 브라우저(웹)를 통해 사용자 데이터 관리
+ 전체 액세스(전체)
+ Visualforce 애플리케이션 액세스(visualforce)
+ 언제든지 요청 수행(refresh\_token, offline\_access)
+ 고유한 사용자 식별자 액세스(openid)
+ 사용자 지정 권한 액세스(custom\_permissions)
+ Connect REST API 리소스 액세스(chatter\_api)
+ Analytics REST API 리소스(wave\_api)에 액세스
+ Analytics REST API 차트 Geodata 리소스(eclair\_api)에 액세스
+ Pardot 서비스 관리(pardot\_api)

### OAuth 흐름 활성화
<a name="salesforce-oauth-flows"></a>

다음 흐름 옵션을 선택합니다.
+ **클라이언트 자격 증명 흐름 활성화**
+ **권한 부여 코드 및 자격 증명 흐름 활성화**
+ **토큰 교환 흐름 활성화**

### 보안 설정 활성화
<a name="salesforce-security-settings"></a>

다음 보안 옵션을 선택합니다.
+ **코드 교환을 위한 증명 키 필요(PKCE)**
+ **웹 서버 흐름에 보안 암호 필요**(기본적으로 선택됨)
+ **토큰 새로 고침 흐름에 보안 암호 필요**(기본적으로 선택됨)

**생성을** 선택하여 외부 클라이언트 앱을 저장합니다.

## 3단계: 소비자 자격 증명 가져오기
<a name="salesforce-consumer-details"></a>

1. 생성 후 ECA 세부 정보 페이지에 표시됩니다.

1. **설정** 탭으로 이동하거나 **소비자 세부 정보 관리를** 선택합니다.

1. 자격 증명을 확인해야 할 수 있습니다(이메일 확인 코드).

1. **소비자 키**(클라이언트 ID) 및 **소비자 보안** 암호(클라이언트 보안 암호)를 복사합니다.

**중요**  
이러한 자격 증명을 안전하게 저장합니다. Amazon Quick에서 커넥터를 구성할 때 필요합니다.

## 4단계: Amazon Quick에서 Salesforce 커넥터 구성
<a name="salesforce-integration-setup"></a>

### 커넥터로 이동
<a name="salesforce-navigate-connectors"></a>

1. Amazon Quick**을 열고 커넥터를** 선택합니다.

1. **팀에 대해 생성** 탭을 선택합니다.

1. **Salesforce**를 찾아 선택합니다.

1. 커넥터가 이미 존재한다는 메시지가 표시되면 **아니요, 새로 생성을** 선택합니다.

### 연결 세부 정보 입력
<a name="salesforce-connection-details"></a>

다음 연결 세부 정보를 입력합니다.


**Salesforce 커넥터 연결 세부 정보**  

| Field | 값 | 
| --- | --- | 
| 이름 | 설명이 포함된 이름(예: "Salesforce ECA") | 
| 네트워크 | 퍼블릭 네트워크 | 
| 인증 유형 | 사용자 지정 OAuth 앱 | 
| 기본 URL | https://{{<your-domain>}}.my.salesforce.com/services/data/v60.0 | 
| 클라이언트 ID | 3단계의 소비자 키 | 
| 클라이언트 보안 암호 | 3단계의 소비자 보안 암호 | 
| 토큰 URL | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/token | 
| 권한 부여 URL | https://{{<your-domain>}}.my.salesforce.com/services/oauth2/authorize | 
| 리디렉션 URL | 미리 채워짐(변경하지 않음) | 

**다음**을 선택하여 계속 진행합니다.

## 5단계: 확인 및 게시
<a name="salesforce-verify-publish"></a>

1. **검토** 페이지에서 사용 가능한 Salesforce 작업(최대 42개의 작업)을 확인합니다.

1. **다음을** 선택하여 사용자 공유로 진행합니다.

1. 이 커넥터에 액세스할 수 있어야 하는 사용자 또는 그룹을 선택합니다.

1. **게시**를 선택하여 커넥터를 게시합니다.

커넥터를 게시한 후 Amazon Quick Chat, 흐름 및 자동화에서 Salesforce 작업을 사용할 수 있습니다.

## 사용 가능한 작업
<a name="salesforce-integration-actions"></a>

커넥터를 설정한 후 다음 Salesforce 작업을 사용할 수 있습니다.
+ 표준 및 사용자 지정 객체에 대한 CRUD(CRUD) 작업을 생성, 읽기, 업데이트 및 삭제합니다.
+ SOQL(Salesforce 객체 쿼리 언어)을 사용하여 Salesforce 데이터를 쿼리합니다.
+ 리드, 계정, 연락처 및 기회를 관리합니다.
+ Apex 메서드 및 사용자 지정 로직을 실행합니다.
+ 사례, 작업 및 활동을 관리합니다.
+ 보고서 및 대시보드에 액세스합니다.

**참고**  
Salesforce 통합은 작업 실행만 지원합니다. Salesforce 시스템에서는 데이터 액세스 및 지식 기반 생성을 사용할 수 없습니다.

## 문제 해결
<a name="salesforce-integration-troubleshooting"></a>

커넥터를 편집, 공유 또는 삭제하려면 섹션을 참조하세요[기존 통합 관리](integration-workflows.md#managing-existing-integrations).
+ “**URL이 더 이상 존재하지 않음” 오류** - 토큰 URL 및 권한 부여 URL에서 올바른 Salesforce 도메인을 사용하고 있는지 확인합니다. 레거시 엔드포인트를 사용하지 마십시오.
+ **OAuth 검증 실패** - ECA에서 PKCE가 활성화되어 있고 콜백 URL이 Amazon Quick 인스턴스 URL과 정확히 일치하는지 확인합니다`/sn/oauthcallback`.
+ **범위 누락 오류** - Salesforce의 ECA 구성으로 돌아가서 필요한 모든 OAuth 범위가 아직 **사용 가능** 상태가 아닌 **선택된** 목록에 있는지 확인합니다.
+ “**연결된 앱” 옵션이 회색으로 표시됨** - 이는 Salesforce 2026년 봄 이후에 예상됩니다. 대신 외부 클라이언트 앱을 사용합니다. ECAs는 지원되는 대체 버전입니다.