5.2. Red Hat Single Sign-On을 사용하여 Apicurio 레지스트리 인증 및 권한 부여 구성

프로세스

1. Red Hat Single Sign-On 관리 콘솔에서 Apicurio Registry를 위한 Red Hat Single Sign-On 영역을 생성합니다. 기본적으로 Apicurio Registry에는 레지스트리 의 영역 이름이 필요합니다. 영역 생성에 대한 자세한 내용은 Red Hat Single Sign-On 사용자 설명서를 참조하십시오.

2. Apicurio 레지스트리 API에 대한 Red Hat Single Sign-On 클라이언트를 생성합니다. 기본적으로 Apicurio Registry에는 다음과 같은 설정이 필요합니다.

   • Client ID: registry-api
   • 클라이언트 프로토콜:openid-connect

   • 액세스 유형:베어러 전용

     다른 클라이언트 설정에 기본값을 사용할 수 있습니다.

     참고

     Red Hat Single Sign-On 서비스 계정을 사용하는 경우 전달자 전용 대신 클라이언트 액세스 유형을 기밀로 유지해야 합니다.

3. Apicurio 레지스트리 웹 콘솔용 Red Hat Single Sign-On 클라이언트를 생성합니다. 기본적으로 Apicurio Registry에는 다음과 같은 설정이 필요합니다.

   • 클라이언트 ID:apicurio-registry
   • 클라이언트 프로토콜:openid-connect
   • 액세스 유형:public
   • Valid Redirect URLs: http://my-registry-url:8080/*

   • 웹 출처:+

     다른 클라이언트 설정에 기본값을 사용할 수 있습니다.

4. OpenShift의 Apicurio Registry 배포에서 다음 Apicurio Registry 환경 변수를 설정하여 Red Hat Single Sign-On을 사용하여 인증을 구성합니다.

   Expand

   표 5.2. Red Hat Single Sign-On을 사용한 Apicurio 레지스트리 인증 구성

   환경 변수	설명	유형	Default
   AUTH_ENABLED	Apicurio 레지스트리에 대한 인증을 활성화합니다. true 로 설정하면 Red Hat Single Sign-On을 사용한 인증에 적용되는 환경 변수가 필요합니다.	문자열	false
   KEYCLOAK_URL	Red Hat Single Sign-On 인증 서버의 URL입니다. 예: http://localhost:8080.	문자열	-
   KEYCLOAK_REALM	인증을 위한 Red Hat Single Sign-On 영역. 예: registry.	문자열	-
   KEYCLOAK_API_CLIENT_ID	Apicurio 레지스트리 REST API의 클라이언트 ID입니다.	문자열	registry-api
   KEYCLOAK_UI_CLIENT_ID	Apicurio 레지스트리 웹 콘솔의 클라이언트 ID입니다.	문자열	apicurio-registry

   Show more
   작은 정보

   OpenShift에서 환경 변수를 설정하는 예는 6.1절. “OpenShift에서 Apicurio 레지스트리 상태 점검 구성” 을 참조하십시오.

5. Red Hat Single Sign-On에서 Apicurio Registry 사용자 역할을 활성화하려면 다음 옵션을 true 로 설정합니다.

   Expand

   표 5.3. Apicurio 레지스트리 역할 기반 권한 부여 구성

   환경 변수	Java 시스템 속성	유형	기본값
   ROLE_BASED_AUTHZ_ENABLED	registry.auth.role-based-authorization	부울	false

   Show more

6. Apicurio Registry 사용자 역할이 활성화되면 Red Hat Single Sign-On 영역에서 다음 기본 사용자 역할 중 하나 이상에 Apicurio Registry 사용자를 할당해야 합니다.

   Expand

   표 5.4. 레지스트리 인증 및 권한 부여를 위한 기본 사용자 역할

   Role	아티팩트 읽기	아티팩트 작성	글로벌 규칙	요약
   sr-admin	제공됨	제공됨	제공됨	모든 생성, 읽기, 업데이트 및 삭제 작업에 대한 전체 액세스 권한
   sr-developer	제공됨	제공됨	없음	글로벌 규칙 구성을 제외하고 생성, 읽기, 업데이트 및 삭제 작업에 대한 액세스 권한이 있어야 합니다. 이 역할은 아티팩트별 규칙을 구성할 수 있습니다.
   sr-readonly	제공됨	없음	없음	읽기 및 검색 작업만 액세스할 수 있습니다. 이 역할은 규칙을 구성할 수 없습니다.

   Show more

7. Apicurio Registry의 스키마 및 API 아티팩트 업데이트에 대한 소유자 전용 권한을 활성화하려면 다음을 true 로 설정합니다.

   Expand

   표 5.5. 소유자 전용 권한 부여 구성

   환경 변수	Java 시스템 속성	유형	기본값
   REGISTRY_AUTH_OBAC_ENABLED	registry.auth.owner-only-authorization	부울	false

   Show more