9.8 KiB
title, source_type, url, archive_url, related_branches, related_projects, tags, created
| title | source_type | url | archive_url | related_branches | related_projects | tags | created | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| official-doc / Keycloak — Default Identity Provider (Identity Provider Redirector, realm-level IdP force) | official-doc | https://github.com/keycloak/keycloak/blob/main/docs/documentation/server_admin/topics/identity-broker/default-provider.adoc | https://raw.githubusercontent.com/keycloak/keycloak/main/docs/documentation/server_admin/topics/identity-broker/default-provider.adoc |
|
|
|
2026-07-16 |
official-doc / Keycloak — Default Identity Provider (Identity Provider Redirector, realm-level IdP force)
Layer:
raw/— 외부 자료(공식 문서)의 원문 발췌·출처 기록. 검증된 요약은/ingest후wiki/concepts/에source-summary-template형식으로 별도 작성. 원본은 raw에 영구 보관.
source_type 허용값
official-doc— 공식 레퍼런스 / 표준 / 사양 (Keycloak upstream 문서,keycloak/keycloakGitHub repodocs/documentation/server_admin/)
Parent / 활용 branch (필수, 최소 1개+)
| Branch | 이 자료가 정당화하는 결정 |
|---|---|
| raw/branch-notes/feature-keycloak-federation-spa-zero-change | D1의 선택 조건 대비 근거 — SPA 코드 변경 없이 특정 IdP를 강제하는 realm-level 대안(Identity Provider Redirector authenticator의 Default Identity Provider 설정). 이 branch(P2B)는 "사용자가 로그인 화면에서 IdP를 선택하는 흐름"(Alt 1)을 검증하므로 이 대안은 채택하지 않지만, 왜 Alt 1을 택했는지의 대비(이 대안은 선택 화면 자체를 제거)를 보여주는 근거. |
출처 / Source
- 원본 URL: https://github.com/keycloak/keycloak/blob/main/docs/documentation/server_admin/topics/identity-broker/default-provider.adoc
- 아카이브 URL (raw mirror, 실제 fetch 소스): https://raw.githubusercontent.com/keycloak/keycloak/main/docs/documentation/server_admin/topics/identity-broker/default-provider.adoc
- 저자 / 조직: Keycloak (Red Hat) — upstream 오픈소스 문서,
keycloak/keycloak리포지토리 - 발행일: 불명 (git blame 미조회 — 현재
main브랜치 스냅샷) - 마지막 확인일: 2026-07-16
왜 저장했는지 / Why archived
feature-keycloak-federation-spa-zero-change(P2B)는 "SPA가 Keycloak 기본 로그인 화면에서 사용자가 직접 IdP를 선택하는 흐름"(zero-change, idpHint 미사용)을 검증한다. 이 문서는 그 대안 — realm(브라우저 flow) 레벨에서 Default Identity Provider를 강제해 로그인 폼 자체를 건너뛰는 방식 — 을 공식 문서로 확인해, P2B가 "왜 이 대안을 택하지 않았는지"의 대비 근거로 보관한다.
핵심 인용 / Key quotes (verbatim, 5문장)
[문단 1] "{project_name} can redirect to an identity provider rather than displaying the login form. To enable this redirection:"
[.Procedure, 4단계] ". Click Authentication in the menu." ". Click the Browser flow." ". Click the gear icon ⚙️ on the Identity Provider Redirector row." ". Set Default Identity Provider to the identity provider you want to redirect users to."
[문단 2] "If {project_name} does not find the configured default identity provider, the login form is displayed."
[문단 3] "This authenticator is responsible for processing the
kc_idp_hintquery parameter. See the <<_client_suggested_idp, client suggested identity provider>> section for more information."
[NOTE] "The authenticator will redirect to the identity provider and authentication is delegated to the identity provider. The
browserauthentication flow will not continue after the login with the identity provider is successfully finished. If you want to perform additional steps after the identity provider login (for example 2-factor authentication), it may be needed to configure <<_identity_broker_post_login_flow, Post login flow>>."
Claims Extracted / 추출된 주장
| Claim ID | Claim (이 자료가 직접 말하는 것) | Evidence quote | Strength | Applies to | Does not prove |
|---|---|---|---|---|---|
| KC-IDPREDIR-C1 | Keycloak은 로그인 폼을 보여주는 대신 특정 identity provider로 사용자를 redirect할 수 있다 | "{project_name} can redirect to an identity provider rather than displaying the login form." | official-vendor-doc |
realm-level Identity Provider Redirector authenticator를 통한 강제 redirect 가능성 자체 |
이 redirect가 기본값으로 켜져 있다는 것도, 이 설정을 안 하면 발생하지 않는다는 것도 별도로 증명하지 않음 — 활성화는 아래 C2 절차가 전제 |
| KC-IDPREDIR-C2 | 설정 절차: Authentication 메뉴 → Browser flow → Identity Provider Redirector 행의 gear 아이콘 → Default Identity Provider 값을 원하는 IdP로 설정 | ". Click Authentication in the menu." / ". Click the Browser flow." / ". Click the gear icon ⚙️ on the Identity Provider Redirector row." / ". Set Default Identity Provider to the identity provider you want to redirect users to." | official-vendor-doc |
이 realm(브라우저 flow) 레벨 강제 설정의 정확한 admin console UI 경로 | 메뉴 라벨·UI 구조가 모든 Keycloak 버전에서 100% 동일하다는 것은 보장하지 않음 ({project_name} placeholder는 문서 템플릿 변수) |
| KC-IDPREDIR-C3 | 설정된 default identity provider를 Keycloak이 찾지 못하면 로그인 폼이 표시된다 (fallback) | "If {project_name} does not find the configured default identity provider, the login form is displayed." | official-vendor-doc |
default IdP alias 오설정/부재 시의 fallback 동작 | "찾지 못함"의 구체적 원인(오타·비활성화·삭제 등) 구분이나 사용자에게 노출되는 에러 메시지 내용은 증명하지 않음 |
| KC-IDPREDIR-C4 | 이 authenticator(Identity Provider Redirector)는 kc_idp_hint query parameter 처리를 담당한다 — client가 제안한 IdP 선택을 가능하게 함 |
"This authenticator is responsible for processing the kc_idp_hint query parameter." |
official-vendor-doc |
kc_idp_hint를 처리하는 컴포넌트가 Default Identity Provider와 동일한 authenticator라는 사실 |
kc_idp_hint와 Default Identity Provider가 동시에 설정됐을 때의 우선순위(precedence)는 이 인용만으로 증명 안 됨 |
| KC-IDPREDIR-C5 | IdP 로그인이 성공적으로 끝난 후 browser authentication flow는 계속되지 않는다 (추가 단계가 필요하면 별도 post-login flow 구성 필요) | "The browser authentication flow will not continue after the login with the identity provider is successfully finished. If you want to perform additional steps after the identity provider login (for example 2-factor authentication), it may be needed to configure <<_identity_broker_post_login_flow, Post login flow>>." |
official-vendor-doc |
Identity Provider Redirector 단계 이후 browser flow의 나머지 Required/Alternative 단계가 실행되지 않는다는 흐름 종료 시맨틱 | Post login flow를 구성했을 때의 정확한 실행 순서·조건은 이 인용만으로는 증명 안 됨 (별도 섹션 _identity_broker_post_login_flow 참조 필요) |
Strength 허용값
official-vendor-doc— Keycloak 공식 upstream 문서 (본 자료 전체가 이 등급)
Usage Boundaries / 적용 경계
- 이 자료가 직접 증명하는 것:
KC-IDPREDIR-C1: Keycloak이 로그인 폼 대신 IdP로 redirect할 수 있는 realm-level 메커니즘 존재KC-IDPREDIR-C2: 그 메커니즘의 admin console 설정 절차KC-IDPREDIR-C3: default IdP 미발견 시 로그인 폼으로 fallbackKC-IDPREDIR-C4: 동일 authenticator가kc_idp_hint도 처리KC-IDPREDIR-C5: IdP 로그인 성공 후 browser flow가 이어지지 않음(post-login flow 필요)
- 이 자료가 증명하지 않는 것:
- P2B(
feature-keycloak-federation-spa-zero-change)가 검증하는 "사용자가 로그인 화면에서 IdP를 선택"하는 기본(Alt 1) 흐름의 UI 노출 여부 — 이 문서는 오히려 그 선택 화면을 건너뛰는 대안(realm-level force)을 설명함 kc_idp_hint와Default Identity Provider를 동시 설정했을 때의 정확한 우선순위- post-login flow 구성 시 2FA 등 추가 단계의 정확한 실행 시맨틱 (별도 섹션 참조 필요)
- P2B(
- 내 프로젝트에 적용하려면 추가 확인이 필요한 것:
- P2B에서 이 대안(Default Identity Provider 강제)을 채택하지 않는다는 결정 자체는 이 문서가 정당화하지 않음 — 이는 branch D1의 "선택 조건" 서술(zero-change 검증 목표)에서 나온 결정이며, 이 문서는 단지 "이런 대안이 공식적으로 존재한다"는 대비(contrast) 근거만 제공
메모 / Notes
- 이 authenticator(Identity Provider Redirector)와 P2B가 검증하려는 "기본 로그인 화면에서 IdP 선택 버튼 노출" 흐름은 서로 다른 realm 설정 경로로 보임 — Default Identity Provider를 설정하지 않은 상태(unset)가 P2B의 전제일 가능성이 높으나, 이 문서만으로는 "Default Identity Provider 미설정 시 등록된 모든 IdP 버튼이 로그인 폼에 노출된다"는 것까지는 증명 안 됨 (미검증 추론 — 별도 확인 필요).
- 추가로 봐야 할 동일 출처 페이지:
_client_suggested_idp(client suggested identity provider) 섹션,_identity_broker_post_login_flow(Post login flow) 섹션 — 둘 다 본 문서 내 cross-reference로만 언급되고 원문 미확보.
Related / 관련
- raw/official-docs/keycloak-identity-brokering-overview-official — Keycloak identity brokering 개념 전반 (KC-IDP-BROKER-C1, C2)
- raw/official-docs/keycloak-google-idp-setup — Google IdP 등록 절차 (KC-GIDP-C1~C5)