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

절차

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

2. 서비스 레지스트리 API에 사용할 Red Hat Single Sign-On 클라이언트를 생성합니다. 기본적으로 서비스 레지스트리에는 다음 설정이 필요합니다.

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

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

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

     참고

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

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

   • 클라이언트 ID:apicurio-registry
   • 클라이언트 프로토콜:openid-connect
   • 액세스 유형:public
   • 유효한 리디렉션 URL:http://my-registry-url:8080/*

   • 웹 출처:+

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

4. OpenShift의 서비스 레지스트리 배포에서 Red Hat Single Sign-On을 사용하여 인증을 구성하려면 다음 서비스 레지스트리 환경 변수를 설정합니다.

   Expand

   표 5.2. 서비스 레지스트리 인증 구성

   환경 변수	설명	유형	Default
   AUTH_ENABLED	true 로 설정하면 이어지는 환경 변수가 필요합니다.	문자열	false
   KEYCLOAK_URL	사용할 Red Hat Single Sign-On 인증 서버의 URL입니다. /auth 로 끝나야 합니다.	문자열	없음
   KEYCLOAK_REALM	인증에 사용되는 Red Hat Single Sign-On 영역입니다.	문자열	레지스트리
   KEYCLOAK_API_CLIENT_ID	서비스 레지스트리 REST API의 클라이언트 ID입니다.	문자열	registry-api
   KEYCLOAK_UI_CLIENT_ID	서비스 레지스트리 웹 콘솔의 클라이언트 ID입니다.	문자열	apicurio-registry

   Show more
   작은 정보

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

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

   Expand

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

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

   Show more

6. Service Registry 사용자 역할이 활성화된 경우 서비스 레지스트리 사용자를 Red Hat Single Sign-On 영역에서 다음 기본 사용자 역할 중 하나에 할당해야 합니다.

   Expand

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

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

   Show more

7. 서비스 레지스트리의 스키마 및 API 아티팩트에 대한 업데이트에 대한 소유자 전용 권한 부여를 활성화하려면 다음을 true 로 설정합니다.

   Expand

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

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

   Show more