고급 인증 패턴: OAuth 2.1 클라이언트 자격 증명 플로

인증 없음 MCP 서버 등록

고급 인증 패턴을 구현하려면 먼저 Agentforce Registry에 MCP 서버를 등록하는 것입니다.

외부 인증 ID 공급자 만들기

외부 인증 ID 공급자는 외부 시스템으로의 아웃바운드 콜아웃을 위해 OAuth 토큰을 가져옵니다. OAuth 2.0 및 2.1 인증을 사용하는 명명된 자격 증명 및 외부 자격 증명을 만드는 첫 번째 단계입니다.

1. 설정에서 빠른 찾기 상자에 명명된 자격 증명을 입력한 다음, 명명된 자격 증명을 선택합니다.
2. 외부 인증 ID 공급자 탭을 클릭합니다.
3. 새로 만들기를 클릭하고 다음 필드를 작성합니다.

   레이블	외부 인증 ID 공급자의 사용자에게 친숙한 이름입니다. 등록 중인 MCP 서버와 관련되어 있으며 인증 스택 전체에서 사용할 수 있는 레이블을 사용하는 것이 좋습니다.
   이름	콜아웃 정의에서 API를 통해 이 외부 인증 ID 공급자를 참조하는 데 사용되는 고유한 식별자입니다. 이름에는 밑줄과 영숫자만 포함할 수 있습니다. 이러한 이름은 고유하고 문자로 시작하고 공백을 포함하지 않으며 밑줄로 끝나지 않고 밑줄을 두 개 연속으로 포함하지 않아야 합니다.
   설명	외부 인증 ID 공급자에 대한 설명입니다.
   인증 프로토콜	OAuth 2.0
   인증 플로 유형	클라이언트 자격 증명
   클라이언트 ID	인가 서버를 통해 액세스를 요청하는 데 사용되는 MCP 서버의 고유 ID입니다.
   고객 암호	액세스 토큰을 요청할 때 MCP 서버를 인증하는 데 사용되는 MCP 서버 및 인가 서버에만 알려진 암호입니다. 안전하게 유지해야 합니다.
   토큰 끝점 URL	권한 부여 서버의 OAuth 토큰 URL입니다. 예: https://auth.partner.com/token

4. 변경 사항을 저장합니다.

외부 인증 ID 공급자에 자원 매개 변수 추가

자원 매개 변수를 사용자 정의 인가 요청 매개 변수 및 사용자 정의 토큰 요청 매개 변수로 추가합니다. 이는 이 매개 변수가 옵션인 OAuth 2.0과 이 매개 변수가 필수인 OAuth 2.1의 주요 차이입니다.자원 값은 인가 서버에 이 토큰을 수락할 MCP 서버를 알려줍니다. MCP 서버는 일치하지 않는 토큰을 거부합니다.

노트 일부 권한 부여 서버에는 자원 대신 대상 그룹과 같은 다른 매개 변수가 필요합니다. 다른 고객 매개 변수에도 다음 단계를 수행할 수 있습니다.

1. 사용자 정의 요청 매개 변수 섹션에서 새로 만들기를 클릭합니다.
2. 다음 필드를 지정합니다.

   이름	자원
   값	호출하는 API의 URL 예: https://api.partner.com 이 값은 호출하는 API를 나타내므로 연결된 명명된 자격 증명 URL과 동일합니다. resource 매개 변수는 권한 부여 서버에 토큰이 대상을 지정합니다. 명명된 자격 증명은 플랫폼에 요청을 보낼 위치를 지시합니다.
   요청 유형	요청 권한 부여
   매개 변수 위치	쿼리 매개 변수

3. 변경 사항을 저장합니다.
4. 다음 필드를 사용하여 해당 단계를 반복합니다.

   이름	자원
   값	호출하는 API의 URL 예: https://api.partner.com 이 값은 호출하는 API를 나타내므로 연결된 명명된 자격 증명 URL과 동일합니다. resource 매개 변수는 권한 부여 서버에 토큰이 대상을 지정합니다. 명명된 자격 증명은 플랫폼에 요청을 보낼 위치를 지시합니다.
   요청 유형	토큰 요청
   매개 변수 위치	본문 매개 변수

5. 변경 사항을 저장합니다.

https://auth.partner.com/authorize?
 response_type=code
 &client_id=YOUR_CLIENT_ID
 &redirect_uri=https://login.salesforce.com/services/authcallback/...
 &scope=read+write
 &code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM
 &code_challenge_method=S256
 &resource=https%3A%2F%2Fapi.partner.com    ← added by the custom parameter

POST /token HTTP/1.1
Host: auth.partner.com
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code=AUTHORIZATION_CODE
&redirect_uri=https://login.salesforce.com/services/authcallback/...
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&code_verifier=dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk
&resource=https%3A%2F%2Fapi.partner.com    ← added by the custom parameter

연결된 외부 자격 증명 편집

외부 인증 ID 공급자가 관리하는 클라이언트 자격 증명 플로를 사용하는 OAuth 2.0 또는 OAuth 2.1 외부 자격 증명은 연결된 외부 인증 ID 공급자에 구성된 클라이언트 ID를 사용합니다.

1. 설정에서 빠른 찾기 상자에 명명된 자격 증명을 입력한 다음, 명명된 자격 증명을 선택합니다.
2. 외부 자격 증명 탭을 클릭합니다.
3. 등록한 MCP 서버와 연결된 외부 자격 증명을 찾습니다. 그런 다음 드롭다운 메뉴에서 편집을 선택합니다.
4. 다음 필드를 지정합니다.

   레이블	외부 인증 ID 공급자의 사용자에게 친숙한 이름입니다. 등록 중인 MCP 서버와 관련되어 있으며 인증 스택 전체에서 사용할 수 있는 레이블을 사용하는 것이 좋습니다.
   이름	콜아웃 정의에서 API 를 통해 이 외부 자격 증명을 참조하는 데 사용되는 고유한 식별자입니다. 이름에는 밑줄과 영숫자만 포함할 수 있습니다. 이러한 이름은 고유하고 문자로 시작하고 공백을 포함하지 않으며 밑줄로 끝나지 않고 밑줄을 두 개 연속으로 포함하지 않아야 합니다.
   인증 프로토콜	OAuth 2.0
   인증 플로 유형	외부 인증 ID 공급자에 구성됨
   범위	(옵션) 쉼표로 구분된 목록으로 서식화된 MCP 서버가 클라이언트가 서버 도구 및 API에 액세스하기 위해 필요한 권한 목록입니다.
   외부 인증 ID 공급자	이전 단계에서 만든 외부 인증 ID 공급자를 선택합니다.

5. 변경 사항을 저장합니다.

(옵션) 연결된 명명된 자격 증명 편집

명명된 자격 증명은 콜아웃 끝점의 URL을 지정합니다.

1. 설정에서 빠른 찾기 상자에 명명된 자격 증명을 입력한 다음, 명명된 자격 증명을 선택합니다.
2. 명명된 자격 증명 탭을 클릭합니다.
3. 등록한 MCP 서버와 연결된 명명된 자격 증명을 찾습니다. 그런 다음 드롭다운 메뉴에서 편집을 선택합니다.
4. 레이블, 이름, 설명을 편집합니다.
5. 변경 사항을 저장합니다.

사후 요구 사항

이제 서버에 대한 인증 스택을 설정했으므로 에이전트와 함께 사용할 서버 도구를 허용 목록으로 지정하고 경우에 따라 정책을 적용합니다.