5장. reference
5.1. Elytron-oidc-client 하위 시스템 속성 링크 복사링크가 클립보드에 복사되었습니다!
elytron-oidc-client 하위 시스템은 동작을 구성하는 속성을 제공합니다.
| 속성 | 설명 |
|---|---|
| provider | OpenID Connect 공급자에 대한 구성입니다. |
| secure-deployment | OpenID Connect 공급자가 보호하는 배포입니다. |
| realm |
Red Hat build of Keycloak 영역에 대한 구성입니다. 이는 편의를 위해 제공됩니다. keycloak 클라이언트 어댑터에서 구성을 복사하여 여기에서 사용할 수 있습니다. 대신 |
다음 목적을 위해 세 가지 elytron-oidc-client 속성을 사용합니다.
-
provider: OpenID Connect 공급자를 구성하는 데 사용됩니다. 자세한 내용은공급자특성을 참조하십시오. -
secure-deployment: OpenID Connect에 의해 보안된 배포를 구성하는 데 사용됩니다. 자세한 내용은secure-deployment특성을참조하십시오. -
realm: Red Hat build of Keycloak을 구성하는 데 사용됩니다. 자세한 내용은영역특성을 참조하십시오.영역사용은 권장되지 않습니다. 편의를 위해 제공됩니다. keycloak 클라이언트 어댑터에서 구성을 복사하여 여기에서 사용할 수 있습니다. 대신provider특성을 사용하는 것이 좋습니다.
| 속성 | 기본값 | 설명 |
|---|---|---|
| allow-any-hostname |
|
값을 |
| always-refresh-token |
|
|
| auth-server-url |
|
Keycloak 영역 권한 부여 서버의 Red Hat 빌드의 기본 URL입니다. 이 속성을 사용하는 경우
또는 |
| autodetect-bearer-only |
| 베어러 전용 요청을 자동으로 감지할지 여부를 설정합니다.
전달자 전용 요청이 수신되고
이 속성을 사용하여 |
| client-id |
| OpenID 공급자에 등록된 JBoss EAP의 클라이언트 ID입니다. |
| client-key-password |
|
|
| client-keystore |
| 애플리케이션이 HTTPS를 통해 OpenID 공급자와 통신하는 경우 이 속성의 클라이언트 키 저장소 경로를 설정합니다. |
| client-keystore-password |
|
|
| confidential-port |
| OpenID 공급자가 사용하는 기밀 포트(SSL/TLS)를 지정합니다. |
| connection-pool-size |
| OpenID 공급자와 통신할 때 사용할 연결 풀 크기를 지정합니다. |
| connection-timeout-millis |
|
원격 호스트와의 연결을 밀리초 단위로 설정하기 위한 시간 제한을 지정합니다. 최소값은 |
| connection-ttl-millis |
|
연결을 활성 상태로 유지하는 데 걸리는 시간(밀리초)을 지정합니다. 최소는 |
| cors-allowed-headers |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| CORS-allowed-methods |
| CORS(Cross-Origin Resource Sharing)가 활성화된 경우 Access-Control-Allow-Methods 헤더 값을 설정합니다. 쉼표로 구분된 문자열이어야 합니다. 이는 선택 사항입니다. 설정되지 않은 경우 이 헤더는 CORS 응답에서 반환되지 않습니다. |
| cors-exposed-headers |
| CORS가 활성화된 경우 Access-Control-Expose-Headers 헤더 값을 설정합니다. 쉼표로 구분된 문자열이어야 합니다. 이는 옵트인입니다. 설정되지 않은 경우 이 헤더는 CORS 응답에서 반환되지 않습니다. |
| cors-max-age |
|
CORS(Cross-Origin Resource Sharing) Max-Age 헤더 값을 설정합니다. 값은 |
| disable-trust-manager |
| HTTPS를 통해 OpenID 공급자와 통신할 때 신뢰 관리자를 사용할지 여부를 지정합니다. |
| enable-cors |
| Red Hat build of Keycloak CORS(Cross-Origin Resource Sharing) 지원을 활성화합니다. |
| expose-token |
|
|
| ignore-oauth-query-parameter |
|
|
| principal-attribute |
| ID 토큰에서 주체로 사용할 클레임 값을 지정합니다. |
| provider-url |
| OpenID 공급자 URL을 지정합니다. |
| proxy-url |
| HTTP 프록시를 사용하는 경우 HTTP 프록시의 URL을 지정합니다. |
| realm-public-key |
| 영역의 공개 키를 지정합니다. |
| register-node-at-startup |
|
|
| register-node-period |
| 노드를 다시 등록할 빈도를 지정합니다. |
| socket-timeout-millis |
| 데이터를 기다리는 소켓 시간 제한을 밀리초 단위로 지정합니다. |
| ssl-required |
| OpenID 공급자와의 통신이 HTTPS를 사용해야 하는지 여부를 지정합니다. 값은 다음 중 하나일 수 있습니다.
|
| token-signature-algorithm |
| OpenID 공급자가 사용하는 토큰 서명 알고리즘을 지정합니다. 지원되는 알고리즘은 다음과 같습니다.
|
| token-store |
| 인증 세션 데이터의 쿠키 또는 세션 스토리지를 지정합니다. |
| truststore |
| 클라이언트 HTTPS 요청에 사용되는 truststore를 지정합니다. |
| truststore-password |
| truststore 암호를 지정합니다. |
| verify-token-audience |
|
|
| 속성 | 기본값 | 설명 |
|---|---|---|
| allow-any-hostname |
|
값을 |
| always-refresh-token |
|
|
| auth-server-url |
|
Keycloak 영역 권한 부여 서버의 Red Hat 빌드의 기본 URL입니다. 또는 |
| autodetect-bearer-only |
|
베어러 전용 요청을 자동으로 감지할지 여부를 설정합니다. 전달자 전용 요청이 수신되고 |
| bearer-only |
|
Bearer 토큰 인증으로 애플리케이션을 보호하려면 이 값을 |
| client-id |
| OpenID 공급자에 등록된 클라이언트의 고유 식별자입니다. |
| client-key-password |
|
|
| client-keystore |
| 애플리케이션이 HTTPS를 통해 OpenID 공급자와 통신하는 경우 이 속성의 클라이언트 키 저장소 경로를 설정합니다. |
| client-keystore-password |
|
|
| confidential-port |
| OpenID 공급자가 사용하는 기밀 포트(SSL/TLS)를 지정합니다. |
| connection-pool-size |
| OpenID 공급자와 통신할 때 사용할 연결 풀 크기를 지정합니다. |
| connection-timeout-millis |
|
원격 호스트와의 연결을 밀리초 단위로 설정하기 위한 시간 제한을 지정합니다. 최소는 |
| connection-ttl-millis |
|
연결을 활성 상태로 유지하는 데 걸리는 시간(밀리초)을 지정합니다. 최소값은 |
| cors-allowed-headers |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| CORS-allowed-methods |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| cors-exposed-headers |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| cors-max-age |
|
CORS(Cross-Origin Resource Sharing) Max-Age 헤더 값을 설정합니다. 값은 |
| 인증 정보 |
| OpenID 공급자와 통신하는 데 사용할 인증 정보를 지정합니다. |
| disable-trust-manager |
| HTTPS를 통해 OpenID 공급자와 통신할 때 신뢰 관리자를 사용할지 여부를 지정합니다. |
| enable-cors |
| Red Hat build of Keycloak CORS(Cross-Origin Resource Sharing) 지원을 활성화합니다. |
| enable-basic-auth |
| 기본 인증을 활성화하여 전달자 토큰을 가져오는 데 사용할 자격 증명을 지정합니다. |
| expose-token |
|
|
| ignore-oauth-query-parameter |
|
|
| min-time-between-jwks-requests |
|
하위 시스템에서 알 수 없는 공개 키로 서명된 토큰을 감지하면 JBoss EAP는 |
| principal-attribute |
| ID 토큰에서 주체로 사용할 클레임 값을 지정합니다. |
| provider |
| OpenID 공급자를 지정합니다. |
| provider-url |
| OpenID 공급자 URL을 지정합니다. |
| proxy-url |
| HTTP 프록시를 사용하는 경우 HTTP 프록시의 URL을 지정합니다. |
| public-client |
|
|
| realm |
| Red Hat build of Keycloak에서 연결할 영역입니다. |
| realm-public-key |
| OpenID 공급자의 공개 키를 PEM 형식으로 지정합니다. |
| redirect-rewrite-rule |
| 리디렉션 URI에 적용할 재작성 규칙을 지정합니다. |
| register-node-at-startup |
|
|
| register-node-period |
| 노드를 초 단위로 다시 등록하는 빈도를 지정합니다. |
| resource |
|
OIDC를 사용하여 보안하는 애플리케이션의 이름을 지정합니다. 또는 |
| socket-timeout-millis |
| 데이터를 기다리는 소켓 시간 제한을 밀리초 단위로 지정합니다. |
| ssl-required |
| OpenID 공급자와의 통신이 HTTPS를 사용해야 하는지 여부를 지정합니다. 값은 다음 중 하나일 수 있습니다.
|
| token-minimum-time-to-live |
| 어댑터는 현재 토큰이 만료되거나 초 단위로 설정된 시간 내에 만료되는 경우 토큰을 새로 고칩니다. |
| token-signature-algorithm |
| OpenID 공급자가 사용하는 토큰 서명 알고리즘을 지정합니다. 지원되는 알고리즘은 다음과 같습니다.
|
| token-store |
| 인증 세션 데이터의 쿠키 또는 세션 스토리지를 지정합니다. |
| truststore |
| 어댑터 클라이언트 HTTPS 요청에 사용되는 truststore를 지정합니다. |
| truststore-password |
| truststore 암호를 지정합니다. |
| turn-off-change-session-id-on-login |
|
세션 ID는 로그인 성공 시 기본적으로 변경됩니다. 이 기능을 비활성화하려면 값을 |
| use-resource-role-mappings |
| 토큰에서 가져온 리소스 수준 권한을 사용합니다. |
| verify-token-audience |
|
|
| 속성 | 기본값 | 설명 |
|---|---|---|
| adapter-state-cookie-path |
|
설정된 경우 하위 시스템에서 설정한 쿠키에서 사용하는 경로를 정의합니다. 설정하지 않으면 |
| allow-any-hostname |
|
값을 |
| always-refresh-token |
|
|
| auth-server-url-for-backend-requests |
| 로드 밸런서 또는 역방향 프록시를 통과하지 않고도 백엔드 요청에서만 OpenID 공급자를 호출할 URL을 지정합니다. |
| auth-server-url |
|
Keycloak 영역 권한 부여 서버의 Red Hat 빌드의 기본 URL입니다. 또는 |
| autodetect-bearer-only |
| 베어러 전용 요청을 자동으로 감지할지 여부를 설정합니다.
전달자 전용 요청이 수신되고
이 속성을 사용하여 |
| bearer-only |
|
Bearer 토큰 인증으로 애플리케이션을 보호하려면 이 값을
전달자 토큰 인증이 활성화되면 사용자는 로그인할 OpenID 공급자로 리디렉션되지 않습니다. 대신 |
| client-id |
| OpenID 공급자에 등록된 클라이언트의 고유 식별자입니다. |
| client-key-password |
|
|
| client-keystore-password |
|
|
| client-keystore |
| HTTPS를 통해 OpenID 공급자와 통신할 때 이 속성의 클라이언트 키 저장소 경로를 설정합니다. |
| confidential-port |
| OpenID 공급자가 사용하는 기밀 포트(SSL/TLS)를 지정합니다. |
| connection-pool-size |
| OpenID 공급자와 통신할 때 사용할 연결 풀 크기를 지정합니다. |
| connection-timeout-millis |
|
원격 호스트와의 연결을 밀리초 단위로 설정하기 위한 시간 제한을 지정합니다. 최소는 |
| connection-ttl-millis |
|
연결을 활성 상태로 유지하는 데 걸리는 시간(밀리초)을 지정합니다. 최소값은 |
| cors-allowed-headers |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| CORS-allowed-methods |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| cors-exposed-headers |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| cors-max-age |
|
CORS(Cross-Origin Resource Sharing) Max-Age 헤더 값을 설정합니다. 값은 |
| 인증 정보 |
| OpenID 공급자와 통신하는 데 사용할 인증 정보를 지정합니다. |
| disable-trust-manager |
| HTTPS를 통해 OpenID 공급자와 통신할 때 신뢰 관리자를 사용할지 여부를 지정합니다. |
| enable-basic-auth |
| 기본 인증을 활성화하여 전달자 토큰을 가져오는 데 사용할 자격 증명을 지정합니다. |
| enable-cors |
| Red Hat build of Keycloak CORS(Cross-Origin Resource Sharing) 지원을 활성화합니다. |
| expose-token |
|
|
| ignore-oauth-query-parameter |
|
|
| min-time-between-jwks-requests |
|
하위 시스템에서 알 수 없는 공개 키로 서명된 토큰을 감지하면 JBoss EAP는 |
| principal-attribute |
| ID 토큰에서 주체로 사용할 클레임 값을 지정합니다. |
| principal-attribute |
| ID 토큰의 클레임 값을 ID의 주체로 사용할지 지정합니다. |
| provider |
| OpenID 공급자를 지정합니다. |
| provider-url |
| OpenID 공급자 URL을 지정합니다. |
| proxy-url |
| HTTP 프록시를 사용하는 경우 HTTP 프록시의 URL을 지정합니다. |
| public-client |
|
|
| public-key-cache-ttl |
| 새 공개 키를 검색하기 위한 두 요청 사이의 최대 간격(초)입니다. |
| realm-public-key |
| OpenID 공급자의 공개 키를 PEM 형식으로 지정합니다. |
| realm |
| Red Hat build of Keycloak에서 연결할 영역입니다. |
| redirect-rewrite-rule |
| 리디렉션 URI에 적용할 재작성 규칙을 지정합니다. |
| register-node-at-startup |
|
|
| register-node-period |
| 노드를 초 단위로 다시 등록하는 빈도를 지정합니다. |
| resource |
|
OIDC를 사용하여 보안하는 애플리케이션의 이름을 지정합니다. 또는 |
| socket-timeout-millis |
| 데이터를 기다리는 소켓 시간 제한을 밀리초 단위로 지정합니다. |
| ssl-required |
| OpenID 공급자와의 통신이 HTTPS를 사용해야 하는지 여부를 지정합니다. 값은 다음 중 하나일 수 있습니다.
|
| token-minimum-time-to-live |
| 어댑터는 현재 토큰이 만료되거나 초 단위로 설정된 시간 내에 만료되는 경우 토큰을 새로 고칩니다. |
| token-signature-algorithm |
| OpenID 공급자가 사용하는 토큰 서명 알고리즘을 지정합니다. 지원되는 알고리즘은 다음과 같습니다.
|
| token-store |
| 인증 세션 데이터의 쿠키 또는 세션 스토리지를 지정합니다. |
| truststore-password |
| truststore 암호를 지정합니다. |
| truststore |
| 어댑터 클라이언트 HTTPS 요청에 사용되는 truststore를 지정합니다. |
| turn-off-change-session-id-on-login |
|
세션 ID는 로그인 성공 시 기본적으로 변경됩니다. 이 기능을 비활성화하려면 값을 |
| use-resource-role-mappings |
| 토큰에서 가져온 리소스 수준 권한을 사용합니다. |
| verify-token-audience |
|
|
| 속성 | 기본값 | 설명 |
|---|---|---|
| allow-any-hostname |
|
값을 |
| always-refresh-token |
|
|
| auth-server-url |
|
Keycloak 영역 권한 부여 서버의 Red Hat 빌드의 기본 URL입니다. 또는 |
| autodetect-bearer-only |
|
베어러 전용 요청을 자동으로 감지할지 여부를 설정합니다. 전달자 전용 요청이 수신되고 |
| client-key-password |
|
|
| client-keystore |
| 애플리케이션이 HTTPS를 통해 OpenID 공급자와 통신하는 경우 이 속성의 클라이언트 키 저장소 경로를 설정합니다. |
| client-keystore-password |
|
|
| confidential-port |
| Red Hat build of Keycloak에서 사용하는 기밀 포트(SSL/TLS)를 지정합니다. |
| connection-pool-size |
| Red Hat build of Keycloak과 통신할 때 사용할 연결 풀 크기를 지정합니다. |
| connection-timeout-millis |
|
원격 호스트와의 연결을 밀리초 단위로 설정하기 위한 시간 제한을 지정합니다. 최소는 |
| connection-ttl-millis |
|
연결을 활성 상태로 유지하는 데 걸리는 시간(밀리초)을 지정합니다. 최소는 |
| cors-allowed-headers |
| CORS(Cross-Origin Resource Sharing)가 활성화된 경우 Access-Control-Allow-Headers 헤더 값을 설정합니다. 쉼표로 구분된 문자열이어야 합니다. 이는 선택 사항입니다. 설정되지 않은 경우 이 헤더는 CORS 응답에서 반환되지 않습니다. |
| CORS-allowed-methods |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| cors-exposed-headers |
|
CORS(Cross-Origin Resource Sharing)가 활성화된 경우 |
| cors-max-age |
|
CORS(Cross-Origin Resource Sharing) Max-Age 헤더 값을 설정합니다. 값은 |
| disable-trust-manager |
| HTTPS를 통해 OpenID 공급자와 통신할 때 신뢰 관리자를 사용할지 여부를 지정합니다. |
| enable-cors |
| Red Hat build of Keycloak CORS(Cross-Origin Resource Sharing) 지원을 활성화합니다. |
| expose-token |
|
|
| ignore-oauth-query-parameter |
|
|
| principal-attribute |
| ID 토큰에서 주체로 사용할 클레임 값을 지정합니다. |
| provider-url |
| OpenID 공급자 URL을 지정합니다. |
| proxy-url |
| HTTP 프록시를 사용하는 경우 HTTP 프록시의 URL을 지정합니다. |
| realm-public-key |
| 영역의 공개 키를 지정합니다. |
| register-node-at-startup |
|
|
| register-node-period |
| 노드를 다시 등록할 빈도를 지정합니다. |
| socket-timeout-millis |
| 데이터를 기다리는 소켓 시간 제한을 밀리초 단위로 지정합니다. |
| ssl-required |
| OpenID 공급자와의 통신이 HTTPS를 사용해야 하는지 여부를 지정합니다. 값은 다음 중 하나일 수 있습니다.
|
| token-signature-algorithm |
| OpenID 공급자가 사용하는 토큰 서명 알고리즘을 지정합니다. 지원되는 알고리즘은 다음과 같습니다.
|
| token-store |
| 인증 세션 데이터의 쿠키 또는 세션 스토리지를 지정합니다. |
| truststore |
| 클라이언트 HTTPS 요청에 사용되는 truststore를 지정합니다. |
| truststore-password |
| truststore 암호를 지정합니다. |
| verify-token-audience |
|
|