기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 타사 서비스에 연결
**Topics**
+ [OpenAPI 커넥터와 API 커넥터 비교](#add-connector-third-party-openapi-vs-api)
+ [타사 서비스 및 APIs에 연결(일반)](connectors-api.md)
+ [OpenAPI를 사용하여 서비스에 연결](connectors-openapi.md)
+ [Salesforce에 연결](connectors-salesforce.md)
## OpenAPI 커넥터와 API 커넥터 비교
App Studio 애플리케이션에서 타사 서비스로 API 요청을 보내려면 애플리케이션이 서비스로 인증하고 API 호출을 구성하는 데 사용하는 커넥터를 생성하고 구성해야 합니다. App Studio는 이를 위해 `API Connector` 및 `OpenAPI Connector` 커넥터 유형을 모두 제공하며, 이에 대한 설명은 다음과 같습니다.
+ **API 커넥터: **모든 유형의 REST API에 대한 인증 및 요청 정보를 구성하는 데 사용됩니다.
+ **OpenAPI 커넥터: ** OpenAPI 사양(OAS)을 채택한 APIs에 대한 인증 및 요청 정보를 구성하는 데 사용됩니다. OAS를 준수하는 APIs 표준화, 보안, 거버넌스, 설명서 등 여러 가지 이점을 제공합니다.
App Studio는 OAS를 준수하고 OpenAPI 사양 파일을 제공하는 모든 APIs에 `OpenAPI Connector` 대해를 사용할 것을 권장합니다. OpenAPI에 대한 자세한 내용은 [ OpenAPI란 무엇입니까?](https://swagger.io/docs/specification/v3_0/about/)를 참조하세요. Swagger 설명서의 .
# 타사 서비스 및 APIs에 연결(일반)
다음 절차에 따라 App Studio에서 일반 **API 커넥터를** 생성합니다. **API Connector**는 App Studio 앱에 타사 서비스, 리소스 또는 작업에 대한 액세스 권한을 제공하는 데 사용됩니다.
****API Connector**를 사용하여 타사 서비스에 연결하려면**
1. 왼쪽 탐색 창의 **관리** 섹션에서 **커넥터를** 선택합니다. 기존 커넥터 목록과 각 커넥터에 대한 몇 가지 세부 정보가 표시된 페이지로 이동합니다.
1. **\$1 커넥터 생성을** 선택합니다.
1. **API 커넥터를** 선택합니다. 이제 다음 필드를 작성하여 커넥터를 구성합니다.
1. **커넥터 이름: **커넥터의 이름을 입력합니다.
1. **커넥터 설명: **커넥터에 대한 설명을 제공합니다.
1. **기본 URL: ** 타사 연결의 웹 사이트 또는 호스트입니다. 예를 들어 `www.slack.com`입니다.
1. **인증 방법:** 대상 서비스로 인증할 방법을 선택합니다.
+ **없음:** 인증 없이 대상 서비스에 액세스합니다.
+ **기본:** 연결 중인 서비스에서 가져온 **사용자 이름과** **암호를** 사용하여 대상 서비스에 액세스합니다.
+ **베어러 토큰:** 서비스의 사용자 계정 또는 API 설정에서 가져온 인증 토큰의 **토큰 값을** 사용하여 대상 서비스에 액세스합니다.
+ **OAuth 2.0:** 자격 증명이나 자격 증명을 공유하지 않고 App Studio에 서비스 및 리소스에 대한 액세스 권한을 부여하는 OAuth 2.0 프로토콜을 사용하여 대상 서비스에 액세스합니다. OAuth 2.0 인증 방법을 사용하려면 먼저 App Studio를 나타내는에 연결된 서비스에서 애플리케이션을 생성하여 필요한 정보를 얻어야 합니다. 해당 정보를 사용하여 다음 필드를 작성합니다.
1. **클라이언트 자격 증명 흐름:** 애플리케이션이 사용자 상호 작용 없이 자체적으로 작동하는 system-to-system 상호 작용에 적합합니다. 예를 들어 사용자가 추가한 새 레코드를 기반으로 Salesforce 레코드를 자동으로 업데이트하는 CRM 앱 또는 트랜잭션 데이터를 검색하여 보고서에 표시하는 앱이 있습니다.
1. **클라이언트 ID**에 대상 서비스에서 생성된 OAuth 앱에서 가져온 ID를 입력합니다.
1. **클라이언트 보안 암호**에 대상 서비스에서 생성된 OAuth 앱에서 가져온 보안 암호를 입력합니다.
1. **액세스 토큰 URL**에 대상 서비스에서 생성된 OAuth 앱에서 가져온 토큰 URL을 입력합니다.
1. 필요에 따라 **범위에** 애플리케이션의 범위를 입력합니다. 범위는 애플리케이션에 필요한 권한 또는 액세스 수준입니다. 대상 서비스의 API 설명서를 참조하여 범위를 이해하고 App Studio 앱에 필요한 범위만 구성합니다.
**연결 확인을** 선택하여 인증 및 연결을 테스트합니다.
1. **권한 부여 코드 흐름:** 사용자를 대신하여 작업해야 하는 애플리케이션에 적합합니다. 예를 들어, 사용자가 로그인하여 지원 티켓을 보고 업데이트하는 고객 지원 앱 또는 각 팀원이 자신의 판매 데이터를 보고 관리하기 위해 로그인하는 판매 앱입니다.
1. **클라이언트 ID**에 대상 서비스에서 생성된 OAuth 앱에서 가져온 ID를 입력합니다.
1. **클라이언트 보안 암호**에 대상 서비스에서 생성된 OAuth 앱에서 가져온 보안 암호를 입력합니다.
1. **권한 부여 URL**에 대상 서비스의 권한 부여 URL을 입력합니다.
1. **액세스 토큰 URL**에 대상 서비스에서 생성된 OAuth 앱에서 가져온 토큰 URL을 입력합니다.
1. 필요에 따라 **범위에** 애플리케이션의 범위를 입력합니다. 범위는 애플리케이션에 필요한 권한 또는 액세스 수준입니다. 대상 서비스의 API 설명서를 참조하여 범위를 이해하고 App Studio 앱에 필요한 범위만 구성합니다.
1. **헤더:** 요청 또는 응답에 대한 메타데이터를 제공하는 데 사용되는 HTTP 헤더를 추가합니다. 키와 값을 모두 추가하거나 빌더가 애플리케이션에 값을 제공할 수 있는 키만 제공할 수 있습니다.
1. **쿼리 파라미터:** 요청 URL의 일부로 옵션, 필터 또는 데이터를 전달하는 데 사용되는 쿼리 파라미터를 추가합니다. 헤더와 마찬가지로 키와 값을 모두 제공하거나 빌더가 애플리케이션에 값을 제공할 수 있는 키만 제공할 수 있습니다.
1. **생성(Create)**을 선택합니다. 새로 생성된 커넥터가 **커넥터** 목록에 나타납니다.
이제 커넥터가 생성되었으므로 빌더는 앱에서 커넥터를 사용할 수 있습니다.
# OpenAPI를 사용하여 서비스에 연결
빌더가 요청을 보내고 서비스로부터 응답을 받는 애플리케이션을 빌드할 수 있도록 OpenAPI를 사용하여 App Studio를 서비스와 연결하려면 다음 단계를 수행합니다.
1. [OpenAPI 사양 파일 가져오기 및 서비스 정보 수집](#connectors-openapi-create-resources)
1. [OpenAPI 커넥터 생성](#connectors-openapi-create-connector)
## OpenAPI 사양 파일 가져오기 및 서비스 정보 수집
OpenAPI를 사용하여 App Studio에 서비스를 연결하려면 다음 단계를 수행합니다.
1. App Studio에 연결하려는 서비스로 이동하여 OpenAPI 사양 JSON 파일을 찾습니다.
**참고**
App Studio는 OpenAPI 사양 버전 3.0.0 이상을 준수하는 OpenAPI 사양 파일을 지원합니다.
1. 다음을 포함하여 OpenAPI 커넥터를 구성하는 데 필요한 데이터를 수집합니다.
+ 서비스에 연결하기 위한 기본 URL입니다.
+ 토큰 또는 사용자 이름/암호와 같은 인증 자격 증명.
+ 해당하는 경우 모든 헤더입니다.
+ 해당하는 경우 모든 쿼리 파라미터입니다.
## OpenAPI 커넥터 생성
**OpenAPI용 커넥터를 생성하려면**
1. App Studio로 이동합니다.
1. 왼쪽 탐색 창의 **관리** 섹션에서 **커넥터를** 선택합니다. 기존 커넥터 목록과 각 커넥터에 대한 몇 가지 세부 정보가 표시된 페이지로 이동합니다.
1. **\$1 커넥터 생성을** 선택합니다.
1. **커넥터 유형 목록에서 OpenAPI ** 커넥터를 선택합니다. 이제 다음 필드를 작성하여 커넥터를 구성합니다.
1. **이름:** OpenAPI 커넥터의 이름을 입력합니다.
1. **설명:** OpenAPI 커넥터에 대한 설명을 입력합니다.
1. **기본 URL:** 서비스에 연결하기 위한 기본 URL을 입력합니다.
1. **인증 방법:** 대상 서비스로 인증할 방법을 선택합니다.
+ **없음:** 인증 없이 대상 서비스에 액세스합니다.
+ **기본:** 연결 중인 서비스에서 가져온 **사용자 이름** 및 **암호를** 사용하여 대상 서비스에 액세스합니다.
+ **베어러 토큰:** 서비스의 사용자 계정 또는 API 설정에서 가져온 인증 토큰의 **토큰 값을** 사용하여 대상 서비스에 액세스합니다.
+ **OAuth 2.0:** 자격 증명이나 자격 증명을 공유하지 않고 App Studio에 서비스 및 리소스에 대한 액세스 권한을 부여하는 OAuth 2.0 프로토콜을 사용하여 대상 서비스에 액세스합니다. OAuth 2.0 인증 방법을 사용하려면 먼저 App Studio를 나타내는에 연결된 서비스에서 애플리케이션을 생성하여 필요한 정보를 얻어야 합니다. 해당 정보를 사용하여 다음 필드를 작성합니다.
1. **클라이언트 자격 증명 흐름:**
1. **클라이언트 ID**에 대상 서비스의 ID를 입력합니다.
1. **클라이언트 보안 암호**에 대상 서비스의 보안 암호를 입력합니다.
1. **액세스 토큰 URL**에 대상 서비스의 토큰 URL을 입력합니다.
1. 필요에 따라 **범위에** 애플리케이션의 범위를 입력합니다. 범위는 애플리케이션에 필요한 권한 또는 액세스 수준입니다. 대상 서비스의 API 설명서를 참조하여 범위를 이해하고 App Studio 앱에 필요한 범위만 구성합니다.
호출할 때마다 서비스와 함께 전송할 **변수를** 추가하고 **연결 확인을** 선택하여 인증 및 연결을 테스트합니다.
1. **권한 부여 코드 흐름:**
1. **클라이언트 ID**에 대상 서비스의 ID를 입력합니다.
1. **클라이언트 보안 암호**에 대상 서비스의 보안 암호를 입력합니다.
1. **권한 부여 URL**에 대상 서비스의 권한 부여 URL을 입력합니다.
1. **액세스 토큰 URL**에 대상 서비스의 토큰 URL을 입력합니다.
1. 필요에 따라 **범위에** 애플리케이션의 범위를 입력합니다. 범위는 애플리케이션에 필요한 권한 또는 액세스 수준입니다. 대상 서비스의 API 설명서를 참조하여 범위를 이해하고 App Studio 앱에 필요한 범위만 구성합니다.
1. **변수:** 호출할 때마다 서비스에 전송할 변수를 추가합니다. 구성 중에 추가된 변수는 안전하게 저장되며 연결을 사용하는 애플리케이션의 런타임 중에만 액세스됩니다.
1. **헤더:** 요청 또는 응답에 대한 메타데이터를 제공하는 데 사용되는 HTTP 헤더를 추가합니다. 키와 값을 모두 추가하거나 빌더가 애플리케이션에 값을 제공할 수 있는 키만 제공할 수 있습니다.
1. **쿼리 파라미터:** 요청 URL의 일부로 옵션, 필터 또는 데이터를 전달하는 데 사용되는 쿼리 파라미터를 추가합니다. 헤더와 마찬가지로 키와 값을 모두 제공하거나 빌더가 애플리케이션에 값을 제공할 수 있는 키만 제공할 수 있습니다.
1. **OpenAPI 사양 파일:** 끌어서 놓거나 **파일 선택을** 선택하여 로컬 파일 시스템을 탐색하고 업로드할 파일을 선택하여 OpenAPI 사양 JSON 파일을 업로드합니다.
추가되면 파일이 처리되고 사용 가능한 옵션 목록이 표시됩니다. 커넥터에 필요한 작업을 선택합니다.
1. **생성(Create)**을 선택합니다. 새로 생성된 커넥터가 **커넥터** 목록에 나타납니다.
이제 커넥터가 생성되었으므로 빌더는 앱에서 커넥터를 사용할 수 있습니다.
# Salesforce에 연결
빌더가 애플리케이션에서 Salesforce 리소스에 액세스하고 사용할 수 있도록 App Studio를 Salesforce와 연결하려면 Salesforce에서 연결된 앱을 생성 및 구성하고 App Studio에서 Salesforce 커넥터를 생성해야 합니다.
**Salesforce를 App Studio에 연결하려면**
1. App Studio의 탐색 창에서 **관리** 섹션에서 **커넥터를** 선택합니다. 기존 커넥터 목록과 각 커넥터에 대한 몇 가지 세부 정보가 표시된 페이지로 이동합니다.
1. **\$1 커넥터 생성을** 선택합니다.
1. 커넥터 유형 목록에서 **Salesforce**를 선택하여 커넥터 생성 페이지를 엽니다.
1. 다음 단계에서 Salesforce를 구성하는 데 사용할 **리디렉션 URL**을 기록해 둡니다.
1. 다음 단계는 Salesforce에서 연결된 앱을 생성하는 것입니다. 다른 탭 또는 창에서 Salesforce 인스턴스로 이동합니다.
1. 빠른 찾기 상자에서 **App Manager**를 검색**App Manager**한 다음 선택합니다.
1. **새 연결된 앱을** 선택합니다.
1. **연결된 앱 이름** 및 **API 이름**에 앱 이름을 입력합니다. App Studio 앱 이름과 일치할 필요는 없습니다.
1. 필요에 따라 연락처 정보를 제공합니다.
1. **API(OAuth 설정 활성화)** 섹션에서 ** OAuth 설정 활성화**를 활성화합니다.
1. **콜백 URL**에 App Studio에서 앞서 기록한 **리디렉션 URL**을 입력합니다.
1. **선택한 OAuth 범위의** 목록에서 필요한 권한 범위를 추가합니다. App Studio는 Salesforce REST APIs와 상호 작용하여 계정, 사례, 연락처, 리드 및 기회의 5가지 객체에 대해 CRUD 작업을 수행할 수 있습니다. App Studio 앱에 모든 관련 권한 또는 범위가 있는지 확인하려면 **전체 액세스(전체)**를 추가하는 것이 좋습니다.
1. **지원되는 권한 부여 흐름에 대해 코드 교환을 위한 증명 키(PKCE) 확장 필요 옵션을 비활성화합니다**. PKCE는 App Studio에서 지원되지 않습니다.
1. **웹 서버 흐름에 보안 암호 필요** 및 **토큰 새로 고침 흐름에 보안 암호 필요**를 활성화하여 보안 모범 사례를 따릅니다.
1. App Studio는 다음 인증 흐름을 모두 지원합니다.
+ **클라이언트 자격 증명 흐름**: 애플리케이션이 사용자 상호 작용 없이 자체적으로 작동하는 server-to-server 상호 작용에 적합합니다. 예를 들어 Salesforce 액세스 권한이 없는 임시 직원 팀에 대한 모든 리드 정보를 나열합니다.
+ **권한 부여 코드 흐름**: 개인 데이터 액세스 또는 작업과 같이 사용자를 대신하여 작동하는 애플리케이션에 적합합니다. 예를 들어,이 앱을 통해 다른 작업을 수행하기 위해 자신이 소싱하거나 소유한 각 영업 관리자의 리드를 나열합니다.
+ 클라이언트 자격 증명 흐름의 경우:
1. **클라이언트 자격 증명 흐름 활성화를** 활성화합니다. 메시지를 검토하고 확인합니다.
1. 앱을 저장합니다.
1. 흐름에는 사용자 상호 작용이 없지만 실행 사용자를 선택해야 합니다. Salesforce는 실행 사용자를 선택하여 사용자를 대신하여 액세스 토큰을 반환합니다.
1. **App Manager**의 앱 목록에서 App Studio 앱의 화살표를 선택하고 **관리를** 선택합니다.
1. **정책 편집**을 선택합니다.
1. **클라이언트 자격 증명 흐름**에서 적절한 사용자를 추가합니다.
+ 권한 부여 코드 흐름의 경우 **권한 부여 코드 및 자격 증명 흐름 활성화를 활성화합니다.**
1. Salesforce는 다음 단계에서 App Studio에서 커넥터를 구성하는 데 사용해야 하는 클라이언트 ID와 클라이언트 보안 암호를 제공합니다.
1. **App Manager**에서 App Studio 앱의 화살표를 선택하고 **보기를** 선택합니다.
1. **API(OAuth 설정 활성화)** 섹션에서 **소비자 세부 정보 관리를** 선택합니다. 이렇게 하면 확인을 위해 입력해야 하는 확인 키에 대한 이메일이 전송될 수 있습니다.
1. **소비자 키**(클라이언트 ID)와 **소비자 보안** 암호(클라이언트 보안 암호)를 기록해 둡니다.
1. App Studio로 돌아가서 다음 필드를 채워 커넥터를 구성하고 생성합니다.
1. **이름**에 Salesforce 커넥터의 이름을 입력합니다.
1. **설명**에 Salesforce 커넥터에 대한 설명을 입력합니다.
1. **기본 URL**에 Salesforce 인스턴스의 기본 URL을 입력합니다. 호스트 *이름을* Salesforce 인스턴스 이름으로 `https://hostname.salesforce.com/services/data/v60.0`바꾸면 다음과 같습니다.
1. **인증 방법**에서 **OAuth 2.0**이 선택되어 있는지 확인합니다.
1. **OAuth 2.0 흐름**에서 OAuth 인증 방법을 선택하고 관련 필드를 작성합니다.
+ system-to-system 통합을 위해 자체적으로 작동하는 애플리케이션에서 사용할 **클라이언트 자격 증명 흐름을** 선택합니다.
1. **클라이언트 ID**에 Salesforce에서 이전에 얻은 **소비자 키를** 입력합니다.
1. **클라이언트 보안 암호**에 이전에 Salesforce에서 얻은 **소비자 보안** 암호를 입력합니다.
1. **액세스 토큰 URL**에 OAuth 2.0 토큰 엔드포인트를 입력합니다. 호스트 *이름을* Salesforce 인스턴스 이름으로 `https://hostname/services/oauth2/token`바꾸면 다음과 같습니다. 자세한 내용은 [Salesforce OAuth 엔드포인트 설명서를 참조하세요](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).
1. **연결 확인을** 선택하여 인증 및 연결을 테스트합니다.
+ 사용자를 대신하여 작동하는 애플리케이션에서 사용할 **권한 부여 코드 흐름을** 선택합니다.
1. **클라이언트 ID**에 Salesforce에서 이전에 얻은 **소비자 키를** 입력합니다.
1. **클라이언트 보안 암호**에 이전에 Salesforce에서 얻은 **소비자 보안** 암호를 입력합니다.
1. **권한 부여 URL**에 권한 부여 엔드포인트를 입력합니다. 호스트 *이름을* Salesforce 인스턴스 이름으로 `https://hostname/services/oauth2/authorize`바꾸면 다음과 같습니다. 자세한 내용은 [Salesforce OAuth 엔드포인트 설명서를 참조하세요](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).
1. **액세스 토큰 URL**에 OAuth 2.0 토큰 엔드포인트를 입력합니다. 호스트 *이름을* Salesforce 인스턴스 이름으로 `https://hostname/services/oauth2/token`바꾸면 다음과 같습니다. 자세한 내용은 [Salesforce OAuth 엔드포인트 설명서를 참조하세요](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_endpoints.htm&type=5).
1. **작업**에서 커넥터가 지원할 Salesforce 작업을 선택합니다. 이 목록의 작업은 미리 정의되어 있으며 공통 객체에서 레코드 생성, 검색, 업데이트 또는 삭제와 같은 Salesforce 내의 일반적인 작업을 나타냅니다.
1. **생성(Create)**을 선택합니다. 새로 생성된 커넥터가 **커넥터** 목록에 나타납니다.