인증 참조 authentication-reference

마지막 업데이트: 2026년 10월 19일

IMPORTANT

Adobe LLM Apps이(가) 현재 Beta에 있습니다.

여기에 표시된 기능, 워크플로우 및 UI가 반드시 제품의 최종 상태를 나타내지는 않습니다. Beta에 참여하려면 llm-apps-beta@adobe.com으로 이메일을 보내십시오.

이 페이지를 사용하여 인증 필드 및 계약을 조회합니다. 설치 지침은 자체 ID 공급자를 통해 최종 사용자 인증을 참조하십시오.

인증 설정 authentication-settings

설정 > 인증을 엽니다. 각 환경은 자체 설정을 저장합니다. Workspace 선택기를 사용하여 편집할 환경을 선택합니다. 설정을 저장해도 다른 환경에는 영향을 주지 않습니다.

필드

필수

설명

Workspace

—

인증 설정에 대한 환경: 단계 또는 프로덕션

인증 사용

—

기본 스위치입니다. 해제 시 모든 작업은 인증 모드에 관계없이 공개됩니다.

발급자

예

ID 공급자의 발급자 URL 및 예상 iss 클레임입니다. HTTPS여야 합니다. 또한 이 앱의 인증 서버로 게시됩니다. 앱당 ID 공급자 1명

지원되는 범위

아니요

이 앱 작업에 필요할 수 있는 전체 범위 세트입니다. 앱에서 지원되는 범위로 LLM 플랫폼에 게시됩니다.

JWKS URI

아니요

고급. 서명 키 집합의 HTTPS URL입니다. 인증 서버의 메타데이터가 알리는 내용과 다른 경우에만 필요합니다.

유효성 검사 규칙

규칙

효과

인증 사용을 사용하는 동안 발급자이(가) 비어 있습니다.

저장이 차단됨

발급자 또는 JWKS URI이(가) HTTPS URL이 아닙니다.

저장이 차단됨

액션에는 지원되는 범위에서 누락된 범위가 필요합니다.

범위를 추가하거나 작업에서 제거할 때까지 저장이 차단됩니다.

지원되는 범위에서 범위가 제거되었습니다.

저장을 기다리지 않고 필요한 모든 작업에서 즉시 제거됩니다

지원되는 범위이(가) 비어 있습니다

범위를 부여할 수 없으므로 작업에 이미 있는 범위는 제거됩니다. 이 경우에는 경고가 표시되지 않습니다

offline_access이(가) 지원되는 범위 또는 작업에 나열됩니다.

설정 페이지에 배포된 앱에 없는 범위가 표시될 수 있도록 대소문자나 주변 공백에 관계없이 앱이 배포될 때 제거됩니다. offline_access이(가) 이 앱에 대한 액세스 권한을 부여하지 않고 인증 서버에서 새로 고침 토큰을 요청하므로 이 앱이 광고하는 범위가 아닙니다. 나열할 필요가 없습니다. LLM 플랫폼은 인증 서버에서 직접 요청합니다

Issuer의 후행 슬래시가 표준화되었습니다. iss 비교는 차이를 허용하므로 항상 뒤쪽 슬래시를 포함하는 공급자의 토큰이 여전히 유효합니다.

인증 모드 auth-modes

작업별 구성에서 작업별로 설정합니다.

모드

토큰 필요

핸들러가 ID를 수신함

를 플랫폼에 광고합니다.

없음

아니요

호출자가 유효한 토큰을 제공할 때만

noauth

필수

예. 나열된 모든 범위가 있음

항상

oauth2

선택 사항

아니요

유효한 토큰이 있는 경우

noauth 및 oauth2

Required 작업의 처리기는 올바른 범위의 올바른 토큰이 없으면 실행되지 않습니다. Optional 작업의 처리기는 항상 실행되며 extra.challengeAuth()(으)로 로그인을 요청할 수 있습니다.

필수은(는) 인증되지 않은 호출자를 거부하는 유일한 모드입니다. 모든 동작이 필수인 경우에만 앱에서 모든 익명 호출을 거부합니다. 작업이 없음 또는 선택 사항인 경우 하나 이상의 작업이 익명 호출을 허용하므로 앱에서 혼합 인증을 사용합니다.

인증 모드는 인증 사용이 설정된 경우에만 적용됩니다. 변경 사항은 앱의 다음 배포에 적용됩니다.

인증 스위치를 변경하면 작업별 모드도 재작성됩니다.

전환 변경

작업별 모드에 대한 효과

켜기/끄기

없음 작업마다 필수이 됩니다. 이미 필수 또는 선택적 작업이 해당 모드를 유지합니다.

켜기/끄기

모든 작업의 모드와 범위가 해당 환경에 대해 지워집니다. 스위치를 다시 켜면 구성이 복원되지 않습니다

Workspace을(를) 전환하면 모드가 다시 작성되지 않습니다. 선택기는 다른 환경의 저장된 구성을 변경하지 않고 로드합니다.

인증 사용을 설정하고 모든 작업을 없음(으)로 설정하면 앱에 인증이 필요하지 않지만 검색을 위해 인증 서버를 게시합니다. 앱을 완전히 공개하려면 스위치를 끕니다.

앱은 개별 작업에 대해 서로 다른 인증 모드를 사용할 수 있습니다. 각 플랫폼이 적용되는 방법은 LLM 플랫폼 동작을 참조하세요.

토큰 요구 사항 token-requirements

ID 공급자는 다음 요구 사항을 모두 충족하는 액세스 토큰을 발급해야 합니다. 런타임에서는 검사에 실패한 토큰을 없는 것으로 처리합니다. 호출자는 인증되지 않았으며 Required 작업이 호출자에게 로그인을 요구합니다.

요구 사항

세부 사항

포맷

서명된 JWT. 불투명 토큰은 지원되지 않습니다.

서명 알고리즘

RS256, RS384, RS512, ES256, ES384, ES512, PS256, PS384 또는 PS512. HS256 같은 HMAC 알고리즘이 거부되었습니다.

iss

발급자와(과) 일치해야 함

aud

앱의 리소스 식별자(해당 환경의 MCP 서버 URL)가 포함되어야 합니다.

exp

은(는) 미래여야 합니다

scope 또는 scp

런타임에서 공백으로 구분된 scope 문자열을 읽거나 scp의 문자열 배열로 돌아갑니다. 각 작업의 요구 사항에 따라 확인된 범위에 대해 이러한 모양 중 하나를 사용합니다.

sub

처리기가 getAuthenticatedUser을(를) 통해 읽는 사용자 식별자

전송

Authorization: Bearer <token> 요청 헤더

공급자에 포함된 추가 플랫 클레임(예: tenant 또는 email)이 처리기에 전달됩니다. 중첩된 오브젝트가 삭제되고 긴 문자열 값이 잘립니다.

ID 공급자 검색 discovery

LLM 플랫폼에서 인증 서버를 찾을 수 있도록 앱에서 자체 RFC 9728 보호된 리소스 메타데이터를 게시합니다. 보호된 리소스 메타데이터를 만들거나, 호스팅하거나, 구성할 필요가 없습니다.

ID 공급자는 다음 검색 정보를 제공해야 합니다.

요구 사항

세부 사항

인증 서버 메타데이터

인증 서버는 LLM 클라이언트에 대한 검색 메타데이터를 게시해야 합니다. JWKS URI이(가) 설정되지 않은 경우 이 앱의 런타임은 특히 jwks_uri을(를) 찾기 위해 RFC 8414 OAuth 인증 서버 메타데이터를 찾습니다. OIDC 검색 경로로 대체되지 않습니다

경로가 있는 발급자

잘 알려진 세그먼트는 경로 다음에 가는 것이 아니라 경로 앞에 갑니다. https://auth.example.com/oauth2/default의 발급자가 https://auth.example.com/.well-known/oauth-authorization-server/oauth2/default에서 해당 메타데이터를 제공합니다.

직접 서명 키 URL

키가 다른 곳에서 호스팅되거나 공급자가 OIDC 검색만 노출하는 경우 JWKS URI을(를) 설정합니다. 따라서 LLM 클라이언트가 필요로 하는 검색은 아니지만 키의 런타임 검색을 사용하지 않습니다

핸들러 인증 API handler-auth-api

패키지 @adobe/llm-apps-runtime에서 다음 도우미를 내보냅니다. 각 도우미는 핸들러에 수신되는 두 번째 인수인 extra을(를) 수락합니다.

도우미

반환

getAuthenticatedUser(extra)

로그인한 사용자의 sub 클레임 또는 호출이 인증되지 않은 경우 undefined

hasScope(extra, scope)

호출자의 토큰에 scope이(가) 포함된 경우 true

확인된 토큰 정보는 인증되지 않은 호출에 대해 undefined인 extra.authInfo에서 사용할 수 있습니다.

속성

설명

authInfo.token

원시 전달자 토큰. 기록하지 않거나 클라이언트에 반환하지 않음

authInfo.clientId

client_id 또는 azp 클레임 또는 unknown

authInfo.scopes

부여된 범위 배열

authInfo.expiresAt

exp 클레임과 같은 토큰 만료

authInfo.resource

토큰의 유효성을 검사한 앱의 리소스 식별자

authInfo.extra

sub에 ID 공급자가 포함한 기타 일반 클레임이 포함되어 있습니다.

extra.challengeAuth(options)은(는) 선택적 작업에서만 사용할 수 있습니다. 핸들러의 결과를 반환하여 사용자에게 컨텐츠를 반환하는 대신 로그인하도록 요청합니다.

도우미가 ChatGPT에 대한 도구 결과 챌린지를 반환합니다. Claude에는 전송 수준 HTTP 챌린지가 필요합니다. 런타임에서는 필수 작업에 대해 이 문제를 제공하지만 선택적 처리기 도우미를 통해서는 안 됩니다.

옵션

설명

error

RFC 6750 전달자 오류 코드: invalid_token, insufficient_scope 또는 invalid_request. 기본값은 insufficient_scope입니다.

errorDescription

사용자에게 표시되는 메시지. 기본값은 일반 로그인 프롬프트입니다.

scope

요청할 공백으로 구분된 범위입니다. 생략하여 플랫폼이 앱의 지원되는 범위로 대체되도록 합니다.

IMPORTANT

항상 error을(를) 명시적으로 설정하십시오. 올바른 세션이 없는 호출자의 경우 invalid_token을(를) 사용하고, 토큰은 유효하지만 필수 범위가 없는 호출자의 경우에만 insufficient_scope을(를) 사용하십시오. 런타임에서는 값을 LLM 플랫폼에 전달하여 로그인 프롬프트의 문구를 선택합니다. 선호하는 프롬프트가 있는 코드가 아니라 조건을 정확하게 설명하는 코드를 전송하십시오.

LLM 플랫폼 동작 platform-behavior

두 플랫폼 모두 동일한 앱에서 공개 작업과 보호된 작업을 지원하지만 로그인 트리거는 다릅니다.

비헤이비어

ChatGPT

Claude

혼합 인증

공개 작업은 익명으로 작동합니다. 필수 작업이 로그인을 요청합니다.

필요한 경우 로그인을 사용하면 공개 작업이 익명으로 작동하며 보호된 호출이 로그인을 시작합니다

모든 동작이 포함된 앱 필수

OAuth 인증 구성

사용하기 전에 인증 필요

커넥터 설정

공용 앱에 대해 인증 없음, 모든 작업이 필수인 경우 OAuth, 그렇지 않은 경우 혼합을 사용합니다. 여기서 이러한 선택 사항이 제공됩니다

검색된 설정을 검토합니다. 혼합 앱의 경우 필요한 경우 로그인을 선택하고, 최신 로그인의 경우 지금 로그인을 선택합니다.

ID 또는 필수 범위 누락

런타임에서 플랫폼의 인증 문제를 반환합니다.

런타임에서 누락되거나 잘못된 ID에 대한 HTTP 401 반환 또는 필요한 범위가 없는 유효한 토큰에 대한 범위 챌린지가 부족한 HTTP 403 반환

선택적 처리기 extra.challengeAuth()

재인증을 시작할 수 있음

성공적인 HTTP 도구-결과 응답이 로그인을 시작하지 않습니다. 이식 가능한 로그인 게이트에 필수 동작 사용

현재 클라이언트 동작은 레이지 인증 중단 및 ChatGPT 인증을 참조하십시오. 커넥터 UI 및 정책은 계정 및 조직에 따라 다를 수 있습니다.