인증 제공자 메타데이터

OIDC 디스커버리선언과 변경 사항 확인

검색 문서의 JSON을 붙여 넣으세요. 비교를 켜면 두 번째 설정의 진단과 차이를 볼 수 있습니다.

OIDC 디스커버리

검색 문서 JSON A

이 탭에서만 처리합니다. 입력을 전송하거나 저장하지 않고 외부 문서도 가져오지 않습니다.

필드 보고서

문서를 붙여 넣거나 예제를 불러오세요.

옵션

입력한 문자열을 두 문서에 그대로 적용합니다. 비워 두면 예상 값 비교를 생략합니다.

문서를 붙여 넣거나 예제를 불러오세요.

메타데이터만 검사합니다. 서버 신뢰성, 주소 접근 가능 여부와 토큰 서명은 확인하지 않습니다.

인증 연동 중 발급자 불일치가 나오면 클라이언트가 기대한 값과 실제 선언을 함께 봐야 합니다. OIDC 디스커버리 도구는 필드 값 옆에 진단을 표시해 주소의 문제인지, 필수 항목이 빠진 것인지 구분할 수 있게 합니다.

OIDC 구성은 제공자가 지원한다고 알리는 내용입니다. JSON이 읽힌다는 사실만으로 공개키가 신뢰할 수 있다거나 로그인 처리가 올바르다고 판단할 수는 없습니다. 먼저 문서에서 확인할 수 있는 문제를 좁혀 보세요.

OIDC 디스커버리 문서를 확인하는 이유

확인한 항목과 모르는 항목을 구분

OIDC 디스커버리 보고서는 발급자 URL, 엔드포인트, 알고리즘과 기능을 나눕니다. 빠진 필수 항목은 오류로 남기고 범위 밖 확장은 미검사로 표시합니다. 행 위치를 눌러 입력으로 돌아가면 어떤 선언에 문제가 있는지 문맥 속에서 확인할 수 있습니다.

설정 문서가 발급자, 엔드포인트, 알고리즘 및 키 주소 카드로 분류되는 그림

배포 변경을 구체적인 값으로 비교

이전 설정을 A에, 새 설정을 B에 넣으면 각각의 보고서와 A에서 B로 바뀐 내용을 볼 수 있습니다. 중첩 경로도 JSON Pointer로 표시하므로 토큰 주소 변경과 서명 목록 삭제를 다른 설정 변화와 구별할 수 있습니다.

두 설정에서 추가, 삭제 및 변경된 행을 연결한 그림

보고서를 읽는 순서

01

예상 발급자는 독립적으로 입력

예상 issuer는 두 문서에 모두 적용합니다. 끝의 슬래시나 대소문자도 그대로 비교하므로 클라이언트 설정의 정확한 값을 쓰세요. 의도적으로 다른 환경을 비교할 때는 비워 두고 차이 보기를 사용하세요.

02

자동 실행을 잠시 끌 수 있음

자동 분석은 수정 후 350ms가 지나면 실행됩니다. 끄면 분석 버튼이나 Ctrl/Cmd + Enter로 실행할 수 있습니다. 문서나 옵션을 바꾸는 즉시 이전 보고서의 복사와 다운로드가 비활성화됩니다.

03

진단과 차이를 각각 확인

문서 A/B 탭은 각 설정의 필드를, 차이 탭은 변경 방향을 보여 줍니다. 화면에는 50개씩 표시하지만 보고서에는 전체 항목이 포함됩니다. 필드의 행·열 위치는 해당 편집기로 연결됩니다.

설정 선언에서 확인할 수 있는 것

필수 항목과 조건부 엔드포인트

issuer, 인증 엔드포인트, JWKS 주소, 응답 유형, subject 유형과 ID Token 서명 목록을 확인합니다. 응답 유형과 명시된 grant가 모두 implicit만 사용함을 나타내야 토큰 엔드포인트 생략을 허용합니다.

정확한 주소와 발급자 비교

프로토콜 주소는 절대 HTTPS URL이어야 하며 자격 증명이나 fragment를 포함할 수 없습니다. issuer에는 query도 허용하지 않습니다. 주소를 정규화해 비교하지 않고 서로 다른 호스트의 엔드포인트는 허용합니다.

알고리즘은 선언으로 해석

ID Token 서명 목록에는 RS256이 필요합니다. none은 해당 목록에서 주의로 표시하지만 클라이언트 인증 서명에서는 오류입니다. scope와 grant, 불리언 필드도 검사하며, 새로운 알고리즘 이름을 실제 지원의 증거로 취급하지 않습니다.

정밀한 수치와 중첩 경로

큰 정수와 긴 소수를 부동소수점으로 먼저 바꾸지 않습니다. 객체 키 순서는 무시하고 배열은 위치로 비교하며 경로의 슬래시와 물결표도 정확히 이스케이프합니다. 값이 비슷한 확장 항목도 반올림 때문에 같아지지 않습니다.

검사 범위와 처리 한도

온라인 요청과 로그인은 제외
문서 다운로드, 토큰 교환, 사용자 정보 요청과 클라이언트 등록을 실행하지 않습니다. 붙여 넣은 텍스트만으로 인증서, CORS 정책이나 실제 서비스 장애를 확인할 수 없습니다.
키 주소와 서명 검증은 별개
JWKS 주소는 복사만 할 수 있고 키 자체를 가져오지 않습니다. 토큰을 다룰 때는 신뢰하는 공개키와 올바른 issuer, audience 등 별도의 검증 조건이 필요합니다. 이 결과를 인증 성공으로 해석하지 마세요.
전체 프로토콜 적합성은 판단하지 않음
알려진 필드의 타입과 명시한 조건만 확인합니다. 설명·정책 URL 필드는 비어 있지 않은 문자열인지까지만 검사하고 다른 확장은 미검사로 남깁니다. scope 목록에서 openid가 없어도 미지원이라고 단정하지 않습니다.
엄격한 JSON과 제한
문서당 100,000자, 최상위 필드 500개, 깊이 100, 노드 50,000개까지 처리합니다. 중복 키, 주석, 마지막 쉼표는 거부합니다. 차이는 5,000개, 예상 issuer는 4,096자까지이며 빈 표준 배열은 필드를 생략해야 합니다.
자동 보정과 병합은 없음
배열 순서 변경도 차이이고 누락과 null도 다릅니다. 100과 1e2는 같은 숫자로 비교합니다. 기본값을 추가하거나 입력을 합치지 않습니다. 기존 입력의 예제 교체와 비우기는 미리 확인한 뒤 적용하고 실행 취소할 수 있습니다.

OIDC 디스커버리 관련 질문

검색 문서는 어디에 있나요?

일반적으로 issuer 경로 아래의 /.well-known/openid-configuration에서 제공합니다. 제공자 문서로 정확한 주소를 확인한 다음 기존 방식으로 얻은 JSON을 여기에 붙여 넣으세요. 이 페이지는 주소로 문서를 가져오지 않습니다.

디스커버리 도구에서 CORS 오류가 나는 이유는 무엇인가요?

브라우저가 다른 출처의 문서를 요청할 때 서버의 CORS 응답 설정이 필요할 수 있습니다. 여기서는 원격 요청을 하지 않으므로 그 설정을 시험하지 않습니다. 실제 클라이언트의 네트워크 응답을 별도로 확인하세요.

issuer가 예상 값과 다르면 무엇을 확인하나요?

HTTP와 HTTPS, 공개 주소와 내부 주소, 테넌트 경로, 끝 슬래시를 확인하세요. 도구는 원문을 정확히 비교합니다. 진단을 없애려고 예상 값을 문서에 맞추기 전에 클라이언트와 제공자 중 어느 설정이 잘못됐는지 확인해야 합니다.

JWKS는 항상 /.well-known/jwks.json에 있나요?

아닙니다. 검색 문서의 jwks_uri를 읽어야 합니다. 제공자마다 경로나 호스트가 다를 수 있으며 이 도구는 주소의 문법과 선언만 보여 줍니다. 키의 실제 내용은 별도 확인 대상입니다.

nonce, aud, exp, iss를 확인하면 서명 검증을 생략해도 되나요?

그 검사만으로 토큰의 출처와 무결성을 확인할 수는 없습니다. 클라이언트의 프로토콜과 신뢰 모델에 맞는 서명 검증이 필요합니다. 이 페이지는 클레임이나 서명을 검사하지 않으며, 메타데이터 보고서도 로그인 허용 여부를 결정하는 근거가 아닙니다.

계산 또는 검증 오류를 발견했나요?

선언에서 찾은 문제를 정리하세요

OIDC 디스커버리 보고서를 검사한 설정 버전과 함께 보관하세요. 문서에서 확인한 문제와 실제 요청으로 확인해야 하는 문제를 나누면 다음 배포를 비교하기 쉬워집니다.