Skip to content

On-Prem 인증과 OpenID Connect (OAuth 2.0)

이 문서는 OpenID Connect 서버를 사용하여 PKCE를 지원하는 OAuth 2.0 CODE 인증 흐름으로 App Builder 온-프레미스 인스턴스를 위한 사용자 정의 인증 제공자를 구성하는 방법에 대한 구성 지침을 제공합니다.

이 가이드에는 다음이 포함됩니다:

  • 필요한 OIDC 클라이언트 설정
  • App Builder에 특정한 구성 설정
  • oidc_scope 및 oidc_redirect_uri와 같은 추가 옵션

OIDC 클라이언트 설정

  • OAuth2 흐름: 인증 코드 + PKCE
  • 새로고침 토큰 활성화 (offline_access 범위),
  • 액세스 토큰 수명: (권장 600초)
  • 새로고침 토큰 수명: 최소 1시간(24시간 권장) 및 최대 수명이 조직에 의해 결정되거나 무제한인 슬라이딩 윈도우 권장)
  • ID 토큰에 사용자 클레임 포함 (필수 표준 클레임 두 개: “sub” & “email” 및 선택적 사용자 정의 클레임 두 개 “given_name” & “family_name”)
  • 필수 범위: openid email profile offline_access appbuilder.user
  • 대상: “appbuilder” (기본값)
  • 로그인 리디렉션 URI: <app builder host>/oidc/ig/callback
  • 로그아웃 후 URL: <app builder host>/oidc/ig/callback-postlogout

App Builder 설정

필수 구성 설정

  • AuthSettings__SkipAuth: false
  • AuthSettings__Authority: OpenId 서버 URL
  • AuthSettings__ClientId: OpenId 클라이언트 ID
  • AuthSettings__AccountIssuer: 서버 고유 별칭

기타 옵션

  • oidc_scope: ‘openid email offline_access profile appbuilder.user’ (기본값)
  • oidc_redirect_uri: ‘/oidc/ig/callback’, (기본값)
  • oidc_post_logout_redirect_uri: /oidc/ig/callback-postlogout’ (기본값)
  • AuthSettings:Audience: “appbuilder” (기본값)
Note

OIDC 인증을 사용하려면 FrontendOptions_SkipAuth 설정을 false로 설정해야 합니다.

OIDC 클라이언트를 설정한 후 3개의 필수 속성을 App Builder Docker 컨테이너에 환경 변수로 전달해야 합니다:

예:

docker run --restart always -p 80:5000 -e ConnectionStrings__Provider=SqlServer -e "ConnectionStrings:...." -e AuthSettings__SkipAuth=false -e AuthSettings__Authority="https://my-auth-server.example.com" -e AuthSettings__ClientId="1234-4657-00" -e AuthSettings__AccountIssuer="MyAuth" -v "C:\ProgramData\Infragistics\Appbuilder\logs:/appbuilder/logs" -v "C:\ProgramData\Infragistics\Appbuilder\storage:/appbuilder/storage" --name appbuilder appbuilder:1.0

추가 리소스