토큰 교환 처리기에 대한 앱 활성화
토큰 교환 처리기에 대해 연결된 앱 또는 외부 클라이언트 앱을 활성화하려면 설정에서 토큰 교환 처리기 페이지를 사용하거나 메타데이터 정의를 편집합니다.
필수 Edition
| 지원 제품: Enterprise, Performance, Unlimited 및 Developer Edition |
시작하기 전에 토큰 교환 플로에 대해 구성된 연결된 앱 또는 외부 클라이언트 앱이 있는지 확인하십시오. 토큰 교환 플로의 앱 통합을 참조하십시오.
여러 연결된 앱 또는 외부 클라이언트 앱의 토큰 교환 처리기를 활성화할 수 있습니다. 하나의 연결된 앱 또는 외부 클라이언트 앱을 여러 처리기에 연결할 수 있습니다.
- 옵션 1: 설정에서 앱 활성화
토큰 교환 처리기로 외부 클라이언트 앱 또는 연결된 앱을 사용하려면 설정의 토큰 교환 처리기 페이지에서 앱을 활성화합니다. - 옵션 2: 메타데이터 API를 통한 앱 활성화
메타데이터 API를 사용하여 토큰 교환 처리기의 연결된 앱 외부 클라이언트 앱을 활성화합니다.
옵션 1: 설정에서 앱 활성화
토큰 교환 처리기로 외부 클라이언트 앱 또는 연결된 앱을 사용하려면 설정의 토큰 교환 처리기 페이지에서 앱을 활성화합니다.
시작하기 전에 토큰 교환 플로에 대해 구성된 연결된 앱 또는 외부 클라이언트 앱이 있는지 확인하십시오. 토큰 교환 플로의 앱 통합을 참조하십시오.
- 설정의 토큰 교환 처리기 페이지에 없는 경우 해당 페이지를 탐색합니다. 설정에서 빠른 찾기 상자에 토큰을 입력한 다음, 토큰 교환 처리기를 선택합니다.
-
편집할 처리기를 찾고
를 클릭한 다음, 세부 사항 보기를 선택합니다.
- 활성화된 앱 아래에서 새 앱 활성화을 클릭합니다.
- 사용하려는 앱 유형을 선택하고 다음을 클릭합니다.
-
앱 선택에서 사용할 연결된 앱 또는 외부 클라이언트 앱을 검색하여 선택합니다.
노트 앱 검색은 토큰 교환 플로에 대해 올바르게 구성된 앱만 반환합니다. 앱을 찾을 수 없는 경우 설정 및 정책을 확인하십시오. -
다음으로 실행에서 처리기를 실행할 실행 사용자를 검색하여 선택합니다. 실제 사용자를 나타내지 않는 통합 사용자 계정을 사용하는 것이 좋습니다.
검색에서 최대 200개의 값을 반환합니다. 사용자를 필터링하려면 사용자의 이름(성 없이) 또는 성(姓)의 첫 문자를 입력합니다. 또는 이름에 지정된 문자열이 포함된 모든 사용자를 빠르게 찾으려면 *(별표) 문자 뒤에 문자열을 입력합니다. 예를 들어 문자열 통합이 있는 모든 사용자 계정을 검색하려면 *ion을 입력합니다.
-
이 처리기를 이 앱의 기본 처리기로 설정하려면 <처리기 이름>을 이 앱의 기본 처리기로 지정을 선택합니다. 앱에는 기본 처리기가 하나만 있을 수 있습니다.
처리기가 앱의 기본값으로 설정되면 다른 처리기를 지정하지 않는 한 Salesforce가 토큰 교환 플로 동안 자동으로 사용합니다. 자세한 내용은 토큰 교환 플로 구성을 참조하십시오.
-
Done(완료)을 클릭합니다.
새로 활성화된 앱이 처리기의 세부 사항 페이지에서 활성화된 앱 아래에 표시됩니다. 앱을 더 쉽게 찾으려면 앱 유형별로 보기를 필터링하거나 이름, 사용자로 실행 또는 활성화된 날짜별로 앱을 정렬합니다.
경고 정렬은 최대 100개의 앱이 활성화된 처리기에서만 지원됩니다. 100개가 넘는 앱이 있는 경우에는 작동하지 않습니다.
활성화된 앱을 편집하려면 앱 옆에 있는
를 클릭하고 편집을 선택하고 원하는 대로 설정을 변경합니다.
처리기에서 앱을 제거하려면 앱 옆에 있는
를 클릭한 다음, 제거를 선택합니다. 앱을 제거할지 확인합니다. 언제든지 처리기에 대한 앱을 다시 활성화할 수 있습니다.
앱 활성화가 완료되면 토큰 교환 흐름을 구성합니다.
옵션 2: 메타데이터 API를 통한 앱 활성화
메타데이터 API를 사용하여 토큰 교환 처리기의 연결된 앱 외부 클라이언트 앱을 활성화합니다.
메타데이터 API로 작업하기 위한 적절한 권한이 있는지 확인합니다. 메타데이터 API 개발자 가이드의 메타데이터 API 편집 액세스를 참조하십시오.
메타데이터 API로 작업하려면 Salesforce CLI에서 Visual Studio Code용 Salesforce 확장 프로그램을 사용하거나 선택한 개발자 도구를 사용합니다. 자세한 내용은 메타데이터 API 개발자 가이드의 메타데이터 API 개발자 도구를 참조하십시오.
메타데이터 API는 파일 기반 및 CRUD 기반 개발을 지원합니다. 다음 단계에서는 파일 기반 개발으로 처리기를 정의하는 방법을 설명합니다.
-
your_handler_name.oauthtokenexchangehandler파일에서 isEnabled 필드를true로 설정합니다. - 활성화라고 하는 필드를 추가합니다. 이 필드는 OauthTokenExchHandlerApp 메타데이터 유형을 참조합니다.
-
활성화 필드에 다음 필드를 추가합니다.
-
처리기를 실행하는 실행 사용자를 지정하려면
apexExecutionUser사용자 필드를 추가하고 사용자의 이름을 입력합니다. 실제 사용자를 나타내지 않는 통합 사용자 계정을 사용하는 것이 좋습니다. - 연결된 앱을 사용하는 경우 connectedApp 필드를 추가하고 연결된 앱의 API 이름을 지정합니다.
- 외부 클라이언트 앱을 사용하는 경우 externalClientApp 필드를 추가하고 외부 클라이언트 앱의 API 이름을 지정합니다.
- 처리기가 기본 처리기인지 정의하려면 isDefault 부울 필드를 설정합니다. 토큰 교환 플로 중 토큰 요청을 보내는 경우 선택적으로 사용할 처리기의 이름을 지정할 수 있습니다. 이름을 지정하지 않을 경우 Salesforce에서 기본 처리기를 사용합니다. 처리기가 여러 개 있는 경우 기본값을 하나만 지정합니다.
-
처리기를 실행하는 실행 사용자를 지정하려면
-
경우에 따라 처리기에 더 많은 앱을 추가하려면 앱에 활성화 필드를 추가합니다.
다음은 전체 토큰 교환 처리기 메타데이터 정의의 예제입니다. 이 처리기는 두 가지 연결된 앱에서 활성화되어 있습니다.
<?xml version="1.0" encoding="UTF-8"?> <OauthTokenExchangeHandler xmlns="http://soap.sforce.com/2006/04/metadata"> <developerName>MyTokenExchangeHandler</developerName> <description>My token exchange handler</description> <isAccessTokenSupported>true</isAccessTokenSupported> <isEnabled>true</isEnabled> <isIdTokenSupported>false</isIdTokenSupported> <isJwtSupported>true</isJwtSupported> <isProtected>false</isProtected> <isRefreshTokenSupported>false</isRefreshTokenSupported> <isSaml2Supported>false</isSaml2Supported> <isUserCreationAllowed>true</isUserCreationAllowed> <masterLabel>MyTokenExchangeHandler</masterLabel> <tokenHandlerApex>MyOauthTokenExchangeHandler</tokenHandlerApex> <enablements> <apexExecutionUser>integrationuser@mycompany.com</apexExecutionUser> <connectedApp>TokenExchangeApp1</conectedApp> <isDefault>true</isDefault> </enablements> <enablements> <apexExecutionUser>integrationuser@mycompany.com</apexExecutionUser> <connectedApp>TokenExchangeApp2</conectedApp> <isDefault>true</isDefault> </enablements> </OauthTokenExchangeHandler> -
메타데이터 개발 도구를 사용하는 경우
deploy()호출을 사용하여 조직에 변경 사항을 배포합니다. -
처리기를 보려면 설정에서 빠른 찾기 상자에 Token Exchange Handlers(토큰 교환 처리기)를 입력한 다음 Token Exchange Handlers(토큰 교환 처리기)를 선택합니다.
각 처리기의 이름, API 이름, 지원되는 토큰 유형, 상태를 확인할 수 있습니다. 마지막으로 수정된 날짜 및 수정한 사람을 확인할 수도 있습니다.
앱 활성화가 완료되면 토큰 교환 흐름을 구성합니다.

