@azure/msal-common package

MSAL.js 라이브러리에서 throw된 일반 오류 클래스입니다.

지원되는 HTTP 응답 인증 헤더를 구문 분석하여 기본 권한 부여 흐름 외부에서 사용할 수 있는 헤더 챌린지 값을 추출하고 반환하는 도우미 클래스입니다.

캐시에 오류가 있을 때 발생하는 오류

브라우저에서 실행되는 클라이언트 코드에 오류가 있을 때 오류가 발생합니다.

MSAL.js 라이브러리 구성에 오류가 있을 때 오류가 발생합니다.

사용자 상호 작용이 필요할 때 오류가 발생합니다.

특정 위치에 대한 메시지 로깅을 용이하게 하는 클래스입니다.

네트워크 관련 오류를 나타냅니다.

자세한 broker 정보를 유지하는 MSAL 런타임 오류에 대한 오류 클래스

OAuth 2.0 프로토콜별 값에 대한 도우미를 제공하는 클래스

ScopeSet 클래스는 범위 집합을 만듭니다. 범위는 대/소문자를 구분하지 않는 고유 값이므로 JS의 Set 개체는 이 클래스에 구현하는 것이 가장 적합합니다. 모든 범위는 문자열의 고유성을 보장하기 위해 교차 및 공용 구조체 함수에서 소문자 문자열로 잘리고 변환됩니다.

서버 코드에 오류가 있을 때 오류가 발생합니다(예: 사용할 수 없음).

URL 문자열에서 다양한 변환을 수행할 수 있는 URL 개체 클래스입니다.

이 클래스 인스턴스는 메모리 변경 내용을 추적하여 영구 캐시에서 읽고 쓰는 결정을 용이하게 하는 데 도움이 됩니다.

라이브러리에서 사용하는 암호화 함수에 대한 인터페이스

백 엔드 요청을 보내는 클라이언트 네트워크 인터페이스입니다.

URI 구성 요소를 설명하는 인터페이스입니다.

액세스 토큰 캐시 유형

계정: <home_account_id-environment-realm>><<*>

다음 서명이 있는 계정 개체:

• homeAccountId - 이 계정 개체의 홈 계정 식별자
• environment - 발급자의 도메인이 나타내는 토큰을 발급한 엔터티(예: login.microsoftonline.com)
• tenantId - 이 계정이 속한 전체 테넌트 또는 조직 ID
• 사용자 이름 - 이 계정을 나타내는 id_token preferred_username 클레임
• localAccountId - 이 계정 개체에 대한 로컬 테넌트별 계정 identifer(일반적으로 레거시 사례에 사용됨)
• name - 계정의 전체 이름(지정된 이름 및 가족 이름 포함)
• idToken - 원시 ID 토큰
• idTokenClaims - 개체에 ID 토큰의 클레임이 포함되어 있습니다.
• nativeAccountId - 사용자의 네이티브 계정 ID
• tenantProfiles - 계정이 브라우저에서 인증한 각 테넌트에 대한 테넌트 프로필 개체의 맵
• dataBoundary - clientInfo에서 추출된 데이터 경계

앱 메타데이터 캐시 유형

요청에 따라 전송된 원격 분석 정보

• appName: 애플리케이션의 고유 문자열 이름
• appVersion: MSAL을 사용하는 애플리케이션 버전

권한의 토큰 엔드포인트에서 반환된 결과입니다.

• uniqueId - oid 또는 sub ID 토큰에서 클레임
• tenantId - tid ID 토큰에서 클레임
• 범위 - 각 토큰에 대해 유효성이 검사되는 범위
• account - 현재 로그인한 사용자의 계정 개체 표현
• idToken - 응답의 일부로 수신된 ID 토큰
• idTokenClaims - MSAL 관련 ID 토큰 클레임
• accessToken - 응답의 일부로 수신된 액세스 토큰 또는 SSH 인증서
• fromCache - 토큰이 캐시에서 왔는지 여부를 나타내는 부울
• expiresOn - 액세스 토큰의 상대 만료를 나타내는 Javascript Date 개체
• extExpiresOn - 서버 중단 시 액세스 토큰의 확장 상대 만료를 나타내는 Javascript Date 개체
• refreshOn - 액세스 토큰을 새로 고쳐야 할 때까지의 상대 시간을 나타내는 Javascript Date 개체
• state - 요청 시 사용자가 전달한 값
• familyId - 일반적으로 새로 고침 토큰에만 사용되는 패밀리 ID 식별자
• requestId - 응답의 일부로 반환된 요청 ID

코드 응답 쿼리 문자열 또는 조각을 처리한 후 반환된 응답입니다.

/authorize 엔드포인트에서 반환할 수 있는 응답 속성

AzureCloudInstance 특정 옵션

• azureCloudInstance - soverign 및 퍼블릭 클라우드 기관에 짧은 표기법을 제공하는 문자열 열거형
• tenant - 테넌트 정보를 제공하도록 프로비전

BaseAuthRequest

• authority - MSAL이 토큰을 획득할 기관, STS(보안 토큰 서비스)의 URL입니다. 기본값은 https://login.microsoftonline.com/common입니다. 모든 요청에 동일한 권한을 사용하는 경우 권한 엔드포인트를 여러 번 해결하지 않으려면 요청이 아닌 클라이언트 애플리케이션 개체에 대해 권한을 설정해야 합니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• authenticationScheme - 검색된 토큰의 유형입니다. 기본값은 "Bearer"입니다. "pop" 또는 "SSH" 형식일 수도 있습니다.
• claims - 모든 /authorize 및 /token 호출에 추가될 문자열화된 클레임 요청
• shrClaims - 서명된 HTTP 요청에 추가될 문자열화된 클레임 개체입니다.
• shrNonce - 서명된 HTTP 요청에 추가될 암호화되고 base64URL로 인코딩된 서버 생성 타임스탬프입니다.
• shrOptions - 서명된 HTTP 요청에 대한 옵션을 포함하는 개체입니다.
• resourceRequestMethod - 리소스에서 데이터를 요청하는 데 사용되는 HTTP 요청 유형입니다(예: "GET", "POST" 등). 소유 증명 흐름에 사용됩니다.
• resourceRequestUri - 토큰이 사용될 URI입니다. 소유 증명 흐름에 사용됩니다.
• sshJwk - SSH 인증서로 서명할 수 있는 공개 키를 나타내는 문자열화된 JSON 웹 키입니다.
• sshKid - 위에서 언급한 SSH 공개 키를 고유하게 식별하는 키 ID입니다.
• azureCloudOptions - 사용자가 퍼블릭/소버린 클라우드 ID를 제공할 수 있는 편리한 문자열 열거형
• requestedClaimsHash - 요청된 클레임 문자열의 SHA 256 해시 문자열로, 요청된 클레임으로 토큰을 필터링할 수 있도록 액세스 토큰 캐시 키의 일부로 사용됩니다.
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵
• tokenBodyParameters - /token call의 본문에 추가된 사용자 지정 매개 변수의 문자열 맵에 문자열
• storeInCache - 캐시에 토큰을 저장할지 여부를 나타내는 부울 값을 포함하는 개체입니다(기본값은 true).
• scenarioId - 사용자 지정 사용자 프롬프트를 추적하는 시나리오 ID
• popKid - PoP 토큰 요청에 대한 공개 키를 식별하는 키 ID
• embeddedClientId - 포함된 클라이언트 ID입니다. 지정된 경우 broker 클라이언트 ID(brk_client_id) 및 리디렉션 URI(brk_redirect_uri) 매개 변수가 구성의 값으로 설정되고, 있는 경우 해당 추가 매개 변수를 재정의합니다.
• httpMethod - /authorize 요청에 사용할 HTTP 메서드입니다. 기본값은 GET이지만 요청에 본문 매개 변수가 필요한 경우 POST로 설정할 수 있습니다.
• authorizePostBodyParameters - httpMethod가 POST로 설정된 경우 /authorize 호출의 본문에 추가된 사용자 지정 매개 변수의 문자열 맵에 문자열
• skipBrokerClaims - true이고 조정된 흐름이 사용되는 경우(예: broker 매개 변수 또는 embeddedClientId가 있는 경우) 구성의 clientCapabilities는 클레임에서 제외됩니다. 는 조정되지 않은 흐름에 대해 무시됩니다.

ClientConfiguration 개체에서 자격 증명 캐시 기본 설정을 구성하는 데 사용합니다.

• claimsBasedCachingEnabled - 클레임 해시에 따라 토큰을 캐시해야 하는지 여부를 설정합니다. 기본값은 false입니다.

uid: 사용자 ID utid: 테넌트 ID xms_tdbr: 선택 사항으로 구성된 클라이언트 정보 개체이며, 미국 이외의 테넌트에 대해서만

유효한 권한 부여 코드를 교환하는 서버에서 토큰을 획득하기 위해 사용자가 전달한 요청 개체(OAuth2.0 권한 부여 코드 흐름의 두 번째 다리)

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• claims - 모든 /authorize 및 /token 호출에 추가될 문자열화된 클레임 요청
• authority: - MSAL이 토큰을 획득할 기관, STS(보안 토큰 서비스)의 URL입니다. 클라이언트 애플리케이션 개체에 권한이 설정되면 해당 값이 재정의됩니다. 값을 재정의하면 매번 기관 유효성 검사가 수행됩니다. 모든 요청에 동일한 권한을 사용하는 경우 요청 대신 애플리케이션 개체에 설정합니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• redirectUri - 사용자가 자격 증명을 입력하고 동의한 후 기관이 리디렉션하는 앱의 리디렉션 URI입니다. 포털에 등록한 리디렉션 URI 중 하나와 정확히 일치해야 합니다.
• code - 사용자가 흐름의 첫 번째 레그에서 획득한 authorization_code.
• codeVerifier - authorization_code 가져오는 데 사용된 것과 동일한 code_verifier. PKCE가 권한 부여 코드 부여 요청에 사용된 경우 필요합니다. 자세한 내용은 PKCE RFC를 참조하세요. https://tools.ietf.org/html/rfc7636
• resourceRequestMethod - 리소스에서 데이터를 요청하는 데 사용되는 HTTP 요청 유형입니다(예: "GET", "POST" 등). 소유 증명 흐름에 사용됩니다.
• resourceRequestUri - 토큰이 사용될 URI입니다. 소유 증명 흐름에 사용됩니다.
• enableSpaAuthCode - spa 권한 부여 코드의 묵인을 사용하도록 설정합니다(기밀 클라이언트만 해당).
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵

서버에서 코드를 검색하기 위해 사용자가 전달한 요청 개체(권한 부여 코드 부여 흐름의 첫 번째 다리)

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• claims - 모든 /authorize 및 /token 호출에 추가될 문자열화된 클레임 요청
• authority - 애플리케이션이 토큰을 획득하는 권한의 URL입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• redirectUri - 애플리케이션에서 인증 응답을 받을 수 있는 리디렉션 URI입니다. Azure 포털에 등록된 리디렉션 URI 중 하나와 정확히 일치해야 합니다.
• extraScopesToConsent - 사용자가 동의가 선행되어야 하는 경우 다른 리소스에 대한 범위입니다.
• responseMode - 앱에 인증 결과를 보내는 데 사용해야 하는 메서드를 지정합니다. 쿼리, form_post 또는 조각일 수 있습니다. 값이 전달되지 않으면 기본적으로 쿼리가 사용됩니다.
• codeChallenge - PKCE(코드 Exchange 키 증명)를 통해 권한 부여 코드 부여를 보호하는 데 사용됩니다. 자세한 내용은 PKCE RCF를 참조하세요.https://tools.ietf.org/html/rfc7636
• codeChallengeMethod - 코드 챌린지 매개 변수에 대한 코드 검증 도구를 인코딩하는 데 사용되는 메서드입니다. "일반" 또는 "S256"일 수 있습니다. 제외되는 경우 코드 챌린지는 일반 텍스트로 간주됩니다. 자세한 내용은 PKCE RCF를 참조하세요. https://tools.ietf.org/html/rfc7636
• state - 토큰 응답에도 반환되는 요청에 포함된 값입니다. 임의로 생성된 고유 값은 일반적으로 교차 사이트 요청 위조 공격을 방지하는 데 사용됩니다. 상태는 인증 요청이 발생하기 전에 앱에서 사용자의 상태에 대한 정보를 인코딩하는 데도 사용됩니다.
• prompt - 필요한 사용자 상호 작용 유형을 나타냅니다. 로그인: 사용자가 해당 요청에 자격 증명을 입력하도록 강제하여 Single Sign-On 없음을 부정합니다. 그러면 사용자에게 대화형 프롬프트가 표시되지 않습니다. Single Sign-On을 통해 요청을 완료할 수 없는 경우 엔드포인트는 interaction_required 오류 동의를 반환합니다. 사용자가 로그인한 후 OAuth 동의 대화 상자를 트리거하여 사용자에게 앱 select_account 권한을 부여하도록 요청합니다. 세션의 모든 계정 또는 기억된 계정 또는 다른 계정 만들기를 사용하도록 선택하는 옵션을 나열하는 계정 선택 환경을 제공하는 Single Sign-=On을 중단합니다. 는 사용자를 인증할 때 기존 세션 토큰을 읽지 않는 no_session 로그인 환경 대신 계정 만들기 환경으로 사용자를 안내합니다. 사용자가 성공적으로 인증되면 EVO는 사용자에 대한 새 세션을 만들지 않습니다. 내부 전용입니다.
• account - getAccount API에서 가져온 AccountInfo입니다. loginHint 및 sid 매개 변수가 모두 제공되지 않으면 특정 시나리오에서 login_hint 생성하는 데 사용됩니다.
• loginHint - 사용자 이름/전자 메일 주소를 미리 알고 있는 경우 사용자의 로그인 페이지의 사용자 이름/전자 메일 주소 필드를 미리 채우는 데 사용할 수 있습니다. 앱은 preferred_username 클레임을 사용하여 이전 로그인에서 사용자 이름을 이미 추출한 상태에서 다시 인증하는 동안 이 매개 변수를 사용하는 경우가 많습니다.
• sid - 세션 ID, 세션의 고유 식별자입니다. ID 토큰에 대한 선택적 클레임으로 사용할 수 있습니다.
• domainHint - 사용자가 로그인하는 데 사용해야 하는 테넌트 또는 도메인에 대한 힌트를 제공합니다. 도메인 힌트의 값은 테넌트에 등록된 도메인입니다.
• extraQueryParameters - /authorize 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵에 문자열
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵
• nonce - ID 토큰에 반환되는 요청에 포함된 값입니다. 임의로 생성된 고유 값은 일반적으로 재생 공격을 완화하는 데 사용됩니다.
• resourceRequestMethod - 리소스에서 데이터를 요청하는 데 사용되는 HTTP 요청 유형입니다(예: "GET", "POST" 등). 소유 증명 흐름에 사용됩니다.
• resourceRequestUri - 토큰이 사용될 URI입니다. 소유 증명 흐름에 사용됩니다.

CommonEndSessionRequest

• account - 로그아웃할 Account 개체입니다. 이 계정에 연결된 모든 토큰은 지워질 것입니다.
• postLogoutRedirectUri - 로그아웃 페이지 후로 이동할 URI입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• idTokenHint - 정책에 필요한 경우 B2C에서 로그아웃의 유효성을 검사하는 데 사용하는 ID 토큰
• 상태 - 로그아웃 후 리디렉션 시 쿼리 문자열에 반환되는 로그아웃 엔드포인트에 대한 요청에 포함된 값입니다.
• logoutHint - 로그아웃할 때 서버 계정 선택기를 건너뛰기 위해 로그아웃 중인 계정을 지정하는 문자열입니다.
• extraQueryParameters - /authorize 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵에 문자열

CommonRefreshTokenRequest

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• claims - 모든 /authorize 및 /token 호출에 추가될 문자열화된 클레임 요청
• authority - MSAL이 토큰을 획득할 기관, STS(보안 토큰 서비스)의 URL입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• refreshToken - 이전 요청에서 ID 공급자로 반환된 새로 고침 토큰입니다.
• resourceRequestMethod - 리소스에서 데이터를 요청하는 데 사용되는 HTTP 요청 유형입니다(예: "GET", "POST" 등). 소유 증명 흐름에 사용됩니다.
• resourceRequestUri - 토큰이 사용될 URI입니다. 소유 증명 흐름에 사용됩니다.
• forceCache - 캐시에 계정이 없는 경우 MSAL이 새로 고침 토큰 흐름 응답을 캐시하도록 합니다. 마이그레이션 시나리오에 사용됩니다.
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵

사용자가 자격 증명을 자동으로 검색하기 위해 전달한 SilentFlow 매개 변수

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• claims - 모든 /authorize 및 /token 호출에 추가될 문자열화된 클레임 요청입니다. 자동 요청에 포함되면 캐시 조회를 건너뛰고 토큰이 새로 고쳐집니다.
• authority - 애플리케이션이 토큰을 획득하는 권한의 URL입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• account - 자격 증명을 조회할 계정 엔터티입니다.
• forceRefresh - true인 경우 자동 요청이 네트워크 호출을 수행하도록 강제합니다.
• resourceRequestMethod - 리소스에서 데이터를 요청하는 데 사용되는 HTTP 요청 유형입니다(예: "GET", "POST" 등). 소유 증명 흐름에 사용됩니다.
• resourceRequestUri - 토큰이 사용될 URI입니다. 소유 증명 흐름에 사용됩니다.
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵

자격 증명 캐시 유형

자격 증명: home_account_id*<-environment-credential_type-client_id-realm><><><>*<->target*<->scheme* <>

캐시할 외부 토큰을 로드하는 데 사용되는 응답 개체입니다.

• token_type: 토큰 형식 값을 나타냅니다. Azure AD에서 지원하는 유일한 형식은 Bearer입니다.
• 범위: access_token 유효한 범위입니다.
• expires_in: 액세스 토큰이 유효한 기간(초)입니다.
• id_token: JWT(JSON 웹 토큰)입니다. 앱에서 이 토큰의 세그먼트를 디코딩하여 로그인한 사용자에 대한 정보를 요청할 수 있습니다.
• refresh_token: OAuth 2.0 새로 고침 토큰입니다. 앱은 현재 액세스 토큰이 만료된 후 이 토큰을 사용하여 추가 액세스 토큰을 획득할 수 있습니다.
• access_token: 요청된 액세스 토큰입니다. 앱에서 이 토큰을 사용하여 보안 리소스(예: 웹 API)를 인증할 수 있습니다.
• client_info: 클라이언트 정보 개체

ID 토큰 캐시 유형

상태 값으로 문자열화, 인코딩 및 전송되는 개체를 정의하는 형식입니다. 다음을 포함합니다.

• id - 이 요청에 대한 고유 식별자
• ts - 요청이 만들어진 시간에 대한 타임스탬프입니다. 토큰 만료가 잘못 계산되지 않도록 하는 데 사용됩니다.
• platformState - 플랫폼에서 전송된 문자열 값입니다.

Configuration 개체에서 로거 옵션을 구성하여 MSAL이 수행하는 로깅을 구성하는 데 사용합니다.

• loggerCallback - 로거에 대한 콜백
• piiLoggingEnabled - pii 로깅을 사용할 수 있는지 여부를 설정합니다.
• logLevel - 로깅이 발생하는 수준 설정
• correlationId - 로거가 인쇄한 correlationId를 설정합니다.

네트워크 요청 API에서 허용하는 옵션입니다.

OIDC 프로토콜 모드에 대한 옵션입니다.

요청 및 애플리케이션에 대한 메타데이터를 포함하여 라이브러리에서 수행한 성능 측정입니다.

PkceCodes 형식은 PKCE 코드 챌린지 및 검증 도구 쌍을 포함하는 개체의 구조를 설명합니다.

큐 측정 유형

새로 고침 토큰 캐시 유형

권한 부여 요청에서 서비스로 전송되는 문자열화되고 인코딩된 개체를 정의하는 형식입니다.

고유한 요청 지문을 나타내는 형식입니다.

서버 권한 부여 코드 요청에서 역직렬화된 응답 개체입니다.

• token_type: 토큰 형식 값을 나타냅니다. 전달자 또는 팝일 수 있습니다.
• 범위: access_token 유효한 범위입니다.
• expires_in: 액세스 토큰이 유효한 기간(초)입니다.
• refresh_in: 만료와 관계없이 토큰을 갱신해야 하는 기간을 유추합니다.
• ext_expires_in: 서버가 응답하지 않는 경우 액세스 토큰이 유효한 기간(초)입니다.
• access_token: 요청된 액세스 토큰입니다. 앱에서 이 토큰을 사용하여 보안 리소스(예: 웹 API)를 인증할 수 있습니다.
• refresh_token: OAuth 2.0 새로 고침 토큰입니다. 앱은 현재 액세스 토큰이 만료된 후 이 토큰을 사용하여 추가 액세스 토큰을 획득할 수 있습니다.
• id_token: JWT(JSON 웹 토큰)입니다. 앱에서 이 토큰의 세그먼트를 디코딩하여 로그인한 사용자에 대한 정보를 요청할 수 있습니다.
• key_id: 요청이 바인딩된 공개 키를 고유하게 식별하는 문자열입니다.

오류 발생 시:

• 오류: 발생하는 오류 유형을 분류하는 데 사용할 수 있고 오류에 대응하는 데 사용할 수 있는 오류 코드 문자열입니다.
• error_description: 개발자가 인증 오류의 근본 원인을 식별하는 데 도움이 되는 특정 오류 메시지입니다.
• error_codes: 진단에 도움이 될 수 있는 STS 관련 오류 코드 목록입니다.
• timestamp: 오류가 발생한 시간입니다.
• trace_id: 진단에 도움이 될 수 있는 요청에 대한 고유 식별자입니다.
• correlation_id: 구성 요소 간 진단에 도움이 될 수 있는 요청에 대한 고유 식별자입니다.
• 상태: 네트워크 요청의 응답 상태

토큰을 캐시에 저장할지 여부를 제어합니다. false로 설정하면 토큰을 계속 획득하고 반환할 수 있지만 나중에 검색하기 위해 캐시되지 않습니다.

queryParams, extraQueryParams 및 클레임을 지원하는 Key-Value 형식

Configuration 개체에서 토큰 갱신 정보를 구성하는 데 사용합니다.

• tokenRenewalOffsetSeconds - 만료 전에 토큰을 갱신하는 데 필요한 오프셋 창을 설정합니다.

동일한 사용자의 테넌트에 따라 달라지는 계정 세부 정보

MSAL에서 알려진 ID 토큰 클레임을 설명하는 형식입니다.

IAppTokenProvider 확장성에 대한 입력 개체입니다. MSAL은 AppTokenProviderResult를 만드는 데 사용할 수 있는 이 개체를 만듭니다.

• correlationId - 요청과 연결된 상관 관계 ID
• tenantId - 토큰을 제공해야 하는 테넌트 ID
• 범위 - 토큰을 제공해야 하는 범위
• 클레임 - 토큰이 충족해야 하는 추가 클레임

IAppTokenProvider 확장성에 대한 출력 개체입니다.

• accessToken - 요청 데이터 AppTokenProviderParameters를 충족하는 실제 액세스 토큰(일반적으로 JWT 형식)입니다.
• expiresInSeconds - 토큰이 만료되기 전까지의 기간(초)입니다. AAD 토큰 응답의 "expires_in" 필드와 유사합니다.
• refreshInSeconds - 토큰을 사전에 새로 고쳐야 하는 기간입니다. AAD 토큰 응답의 "refresh_in" 필드와 유사합니다.

기밀 클라이언트에 대한 클라이언트 어설션 자격 증명

CommonClientCredentialRequest

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• authority - MSAL이 토큰을 획득할 기관, STS(보안 토큰 서비스)의 URL입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• skipCache - 토큰 캐시 조회를 건너뛰고 권한을 강제로 요청하여 새 토큰을 가져옵니다. 기본값은 false입니다.
• preferredAzureRegionOptions - 사용자가 선호하는 Azure 지역의 옵션
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵

Oauth2 디바이스 코드 흐름에 대한 매개 변수입니다.

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• authority: - MSAL이 토큰을 획득할 기관, STS(보안 토큰 서비스)의 URL입니다. 클라이언트 애플리케이션 개체에 권한이 설정되면 해당 값이 재정의됩니다. 값을 재정의하면 매번 기관 유효성 검사가 수행됩니다. 모든 요청에 동일한 권한을 사용하는 경우 요청 대신 애플리케이션 개체에 설정합니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• deviceCodeCallback - 디바이스 코드 응답을 포함하는 콜백입니다. 최종 사용자에게 메시지가 표시되어야 합니다. 그런 다음 최종 사용자는 verification_uri 이동하여 user_code 입력하고 자격 증명을 입력할 수 있습니다.
• cancel - 디바이스 코드 엔드포인트의 폴링을 취소하려면 부울입니다. 사용자가 별도의 디바이스에서 인증하는 동안 MSAL은 디바이스 코드 응답에 지정된 간격(일반적으로 15분)에 대한 보안 토큰 서비스의 토큰 엔드포인트를 폴링합니다. 폴링을 중지하고 요청을 취소하려면 cancel=true를 설정합니다.
• resourceRequestMethod - 리소스에서 데이터를 요청하는 데 사용되는 HTTP 요청 유형입니다(예: "GET", "POST" 등). 소유 증명 흐름에 사용됩니다.
• resourceRequestUri - 토큰이 사용될 URI입니다. 소유 증명 흐름에 사용됩니다.
• timeout - 사용자가 디바이스 코드 엔드포인트 폴링에 대해 명시적으로 구성하는 시간 제한 기간(초)입니다. 이 기간이 끝나면 디바이스 코드가 아직 만료되지 않았다고 가정합니다. 디바이스 코드 폴링이 중지되고 요청이 취소됩니다. 디바이스 코드 만료 기간은 항상 이 설정 기간보다 우선합니다.
• extraQueryParameters - 쿼리 문자열에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵에 문자열

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• authority - MSAL이 토큰을 획득할 기관, STS(보안 토큰 서비스)의 URL입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• oboAssertion - 중간 계층 API로 전송된 액세스 토큰입니다. 이 토큰에는 이 OBO 요청을 만드는 앱의 대상이 있어야 합니다.
• skipCache - 토큰 캐시 조회를 건너뛰고 권한을 강제로 요청하여 새 토큰을 가져옵니다. 기본값은 false입니다.
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵

사용자가 자격 증명을 검색하기 위해 전달한 CommonUsernamePassword 매개 변수 참고: 최신 OAuth 2.0 보안 모범 사례는 암호 부여를 완전히 허용하지 않습니다. 이 흐름은 내부 테스트를 위해 추가됩니다.

• 범위 - 애플리케이션이 액세스를 요청하는 범위의 배열입니다.
• claims - 모든 /authorize 및 /token 호출에 추가될 문자열화된 클레임 요청입니다. 자동 요청에 포함되면 캐시 조회를 건너뛰고 토큰이 새로 고쳐집니다.
• authority - 애플리케이션이 토큰을 획득하는 권한의 URL입니다.
• correlationId - 원격 분석을 위해 종단 간 요청을 추적하기 위해 요청당 고유한 GUID 집합입니다.
• 사용자 이름 - 클라이언트의 사용자 이름
• password - 자격 증명
• tokenQueryParameters - 문자열에서 /token 호출에 추가된 사용자 지정 쿼리 매개 변수의 문자열 맵

디바이스 코드 흐름에 필요한 정보를 포함하는 보안 토큰 서비스 디바이스 코드 엔드포인트에서 반환된 DeviceCode입니다.

• userCode: 확인 URI에서 인증할 때 사용자가 제공해야 하는 코드
• deviceCode: 액세스 토큰에 대한 요청에 포함해야 하는 코드
• verificationUri: 사용자가 인증할 수 있는 URI
• expiresIn: 디바이스 코드의 만료 시간(초)
• interval: STS를 폴링해야 하는 간격
• message: 사용자에게 표시해야 하는 메시지

로그 메시지 수준입니다.

성능 이벤트의 상태입니다.

계측되는 작업의 열거형은 PerformanceClient에서 성능을 측정합니다.

server clientInfo 문자열에서 클라이언트 정보 개체를 빌드하는 함수

캐시된 homeAccountId 문자열에서 클라이언트 정보 개체를 빌드하는 함수

테넌트 프로필 빌드

CacheError 개체에서 브라우저 오류를 래핑하는 도우미 함수

InteractionRequiredAuthError를 만듭니다.

실패한 네트워크 요청에 대한 NetworkError 개체를 만듭니다.

다음 우선 순위를 사용하여 자격 증명 영역으로 설정할 사용 가능한 ID 토큰 클레임에서 tenantId를 가져옵니다.

1. tid - Azure AD 테넌트 tid에서 토큰을 획득하는 경우
2. tfp - 최신 B2C 테넌트 tfp에서 토큰을 획득하는 경우
3. acr - 레거시 B2C 테넌트 acr에서 토큰을 획득하는 경우 대/소문자를 구분하지 않는 비교 요구 사항과 일치하도록 다운케이스가 있어야 합니다.

tenantId가 homeAccountId의 utid 부분과 일치하는 경우 true를 반환합니다.

테넌트별 계정 정보로 전달된 ID 토큰 클레임에서 제공되는 테넌트 프로필에 따라 달라지는 계정 정보를 바꿉니다.

AAD 기관 관련 문자열 상수

인증 요청의 유형

MSAL에서 지원하는 기관 유형입니다.

캐시의 계정 유형

ID 공급자에서 액세스 토큰을 가져오는 이유를 지정합니다.

모든 캐시 형식 결합

클레임 요청 키

캐시에 저장된 자격 증명 형식

허용되는 grant_type

요청 헤더 이름

response_type 허용되는 값

암호 부여 매개 변수

사용자가 로그인하는 동안 유지되는 영구 캐시 키 MSAL입니다.

MSAL에서 지원하는 프로토콜 모드입니다.

response_mode 허용되는 값

서버 응답 유형에 허용되는 값

오류 코드 및 메시지에 사용되는 문자열 상수가 포함된 AuthErrorMessage 클래스입니다.

오류 코드 및 메시지에 사용되는 문자열 상수입니다.

오류 코드 및 메시지에 사용되는 문자열 상수가 포함된 ClientConfigurationErrorMessage 클래스입니다.

codeVerifier에 허용되는 값

SDK에서 정의한 상호 작용 필수 오류

문자열 대신 요청에서 이 "열거형"을 만드는 것을 고려했습니다. 그러나 허용된 프롬프트 값 목록이 지난 몇 년 동안 계속 변경된 것처럼 보입니다. 일부 내부 파트너도 문서화되지 않은 프롬프트 값이 있으므로 "열거형" 대신 제네릭 "문자열" 형식을 선택합니다.

제한과 관련된 상수