5.4. Red Hat Single Sign-On 및 Red Hat build of Keycloak을 통해 인증 활성화 및 비활성화

1. Red Hat Single Sign-On 설명서 또는 Keycloak 문서의 Red Hat 빌드 에서 설명된 대로 영역을 생성합니다.
2. 클라이언트로 이동하여 Create 를 클릭하여 클라이언트를 추가합니다.

3. 다음 필드 및 값을 고려한 양식을 작성합니다.

   • Client ID: 클라이언트에 원하는 이름을 입력합니다.
   • enabled: ON 으로 전환합니다.
   • 동의 필요: OFF 로 전환합니다.
   • 클라이언트 프로토콜: openid-connect 를 선택합니다.
   • 액세스 유형: 기밀을 선택합니다.
   • 표준 흐름 사용: ON 으로 전환합니다.
   • Root URL: 3scale 관리 포털 URL을 입력합니다. 개발자 포털에 로그인하는 데 사용하는 URL 주소여야 합니다(예: https://yourdomain.3scale.net 또는 사용자 정의 URL).

   • 유효한 리디렉션 URL: 다음과 같이 /* 로 개발자 포털을 다시 입력합니다. https://yourdomain.3scale.net/*.

     다른 모든 매개 변수는 비워 두거나 OFF 로 전환해야 합니다.

4. 다음 단계를 사용하여 클라이언트 시크릿을 가져옵니다.

   • 방금 만든 고객으로 이동합니다.
   • 인증 정보 탭을 클릭합니다.

   • Client Authenticator 필드에서 Client Id 및 Secret 을 선택합니다.

     

     View larger image

     

5. email_verified mapper를 구성합니다. 3scale에서는 사용자 데이터의 email_verified 클레임을 true 로 설정해야 합니다. "Email Verified" 사용자 속성을 email_verified 클레임에 매핑하려면 다음을 수행합니다.

   • 클라이언트의 Mappers 탭으로 이동합니다.

   • 내장 추가를 클릭합니다.

     

     View larger image

     

   • 이메일 확인 옵션을 선택하고 선택한 추가 를 클릭하여 변경 사항을 저장합니다.

     

     View larger image

     

     Single Sign-On 로컬 데이터베이스에서 사용자를 관리하는 경우 사용자의 Email Verified 특성이 ON 으로 설정되어 있는지 확인합니다.

     3scale SSO 통합을 위해 이전에 생성된 클라이언트에서 사용자 페더레이션 을 사용하는 경우 토큰 이름을 email_verified 로 설정하고 claim 값을 true 로 설정하여 하드 코딩된 클레임을 구성할 수 있습니다.

6. 필요한 경우 org_name mapper를 구성합니다.
   사용자가 3scale에 등록할 때 사용자는 조직 이름 값으로 등록 양식을 작성하도록 요청됩니다. 개발자 포털의 등록 양식을 입력하지 않아도 사용자에게 Single Sign-On을 통해 등록하려면 추가 org_name 매퍼를 구성해야 합니다.

   • 클라이언트의 Mappers 탭으로 이동합니다.
   • 생성을 클릭합니다.

   • 다음과 같이 매퍼 매개변수를 작성합니다.

     • name: 원하는 이름을 입력합니다(예: org_name ).
     • 동의 필요: OFF 로 전환합니다.
     • 매퍼 유형: 사용자 속성을 선택합니다.
     • User Attribute: org_name 을 입력합니다.
     • 토큰 클레임 이름: org_name 을 입력합니다.
     • 클레임 JSON 유형: 문자열 을 선택합니다.
     • ID 토큰에 추가: ON 으로 전환합니다.
     • 추가 액세스 토큰: ON 으로 전환합니다.
     • Add to userinfo: switch to ON.
     • multivalued: OFF 로 전환합니다.

   • 저장을 클릭합니다.

     

     View larger image

     

     Single Sign-On의 사용자에게 org_name 속성이 있는 경우 3scale은 계정을 자동으로 생성할 수 있습니다. 그렇지 않은 경우 계정을 생성하기 전에 사용자에게 조직 이름을 표시하라는 메시지가 표시됩니다. 또는 하드 코딩된 클레임 유형의 매퍼를 생성하여 Single Sign-On 계정으로 로그인하는 모든 사용자의 하드 코딩된 값으로 설정할 수 있습니다.

7. 통합을 테스트하려면 사용자를 추가해야 합니다. 이 작업을 수행하려면 사용자로 이동하여 사용자 추가 를 클릭하고 필수 필드를 작성합니다. Red Hat Single Sign-On에서 사용자를 생성할 때 이메일 확인 속성(email_verified)을 ON 으로 설정해야 합니다. 그러지 않으면 사용자가 3scale에서 활성화되지 않습니다.

1. Single Sign-On에서 ID 공급자 에서 GitHub를 구성한 후 Mappers 라는 탭으로 이동하여 생성 을 클릭합니다.

   

   View larger image

   
2. 이름을 지정하여 식별할 수 있도록 합니다.
3. 매퍼 유형에서 특성 가져오기 를 선택합니다.
4. 소셜 프로필 JSON 필드 경로에서 GitHub의 속성 이름인 company를 추가합니다.

5. User Attribute Name 에서 org_name을 추가합니다. 이는 Red Hat Single Sign-On에서 특성을 호출하는 방법입니다.

   참고

   Red Hat Single Sign-On 및 Red Hat build of Keycloak 빌드에는 이름과 성 및 필수 필드가 필요합니다. 3scale에는 이메일 주소, 사용자 이름, 조직 이름이 필요합니다. 따라서 조직 이름에 대한 매퍼를 구성하고 사용자가 다음 양식을 모두 건너뛸 수 있도록 하려면 다음을 확인합니다.

   • IdP 계정에는 이름과 성이 설정되어 있습니다.
   • IdP 계정에서는 해당 이메일 주소에 액세스할 수 있습니다. 예를 들어 GitHub에서 이메일 주소를 개인용으로 설정하면 공유되지 않습니다.

프로세스

1. 3scale 관리 포털에서 Audience > Developer Portal > SSO 통합을 선택합니다.
2. Red Hat Single Sign-On 을 클릭합니다.
3. 개발자 포털 : 클라이언트, 클라이언트 시크릿 및 영역을 인증하기 위해 Red Hat Single Sign-On 구성에서 구성한 Red Hat Single Sign-On 클라이언트의 세부 정보를 지정합니다.
4. 변경 사항을 저장하려면 Red Hat Single Sign-On 만들기 를 클릭합니다.