2.3. OIDC를 사용하여 애플리케이션 보안

프로세스

1. Red Hat build of Keycloak Admin Console으로 이동합니다.

2. 클라이언트를 생성합니다.

   1. 클라이언트 를 클릭한 다음 클라이언트 생성을 클릭합니다.
   2. Client 유형이 OpenID Connect 로 설정되어 있는지 확인합니다.
   3. 클라이언트 ID를 입력합니다. 예를 들면 jbeap-oidc 입니다.
   4. 다음을 클릭합니다.
   5. 기능 구성 탭에서 인증 흐름이 표준 흐름 및 직접 액세스 권한 부여 로 설정되어 있는지 확인합니다.
   6. 다음을 클릭합니다.
   7. 로그인 설정 탭에서 Valid redirect URI 값을 입력합니다. 인증이 성공한 후 페이지를 리디렉션해야 하는 URL을 입력합니다(예: http://localhost:8080/simple-webapp-example/secured/* ).
   8. 저장을 클릭합니다.

3. 어댑터 구성을 확인합니다.

   1. 작업을 클릭한 다음 어댑터 구성 다운로드를 클릭합니다.

   2. 연결 매개 변수를 보려면 Format Option 으로 Keycloak OIDC JSON 을 선택합니다.

      {
        "realm": "example_realm",
        "auth-server-url": "http://localhost:8180/",
        "ssl-required": "external",
        "resource": "jbeap-oidc",
        "public-client": true,
        "confidential-port": 0
      }

      Red Hat build of Keycloak을 ID 공급자로 사용하도록 JBoss EAP 애플리케이션을 구성할 때 다음과 같이 매개변수를 사용합니다.

      "provider-url" : "http://localhost:8180/realms/example_realm",
      "ssl-required": "external",
      "client-id": "jbeap-oidc",
      "public-client": true,
      "confidential-port": 0

프로세스

1. 애플리케이션 리소스를 보호하도록 애플리케이션의 web.xml 을 구성합니다.

   <?xml version="1.0" encoding="UTF-8"?>
   
   <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
       metadata-complete="false">
   
       <security-constraint>
           <web-resource-collection>
               <web-resource-name>secured</web-resource-name>
               <url-pattern>/secured</url-pattern>
           </web-resource-collection>
   
           <auth-constraint>
               <role-name>Admin</role-name>    

   1

   
           </auth-constraint>
       </security-constraint>
   
       <security-role>
           <role-name>*</role-name>
       </security-role>
   </web-app>

   1

   Admin 역할이 있는 사용자만 애플리케이션에 액세스할 수 있습니다. 역할이 있는 사용자가 애플리케이션에 액세스할 수 있도록 허용하려면 와일드카드 ** 를 role-name 의 값으로 사용합니다.

2. OpenID Connect로 애플리케이션을 보호하려면 배포 구성을 업데이트하거나 elytron-oidc-client 하위 시스템을 구성합니다.

   참고

   배포 구성 및 elytron-oidc-client 하위 시스템에서 OpenID Connect를 구성하는 경우 elytron-oidc-client 하위 시스템의 구성이 애플리케이션 배포 설명자의 구성보다 우선합니다.

   • 배포 구성 업데이트.

     1. 인증 방법을 OIDC로 지정하는 애플리케이션의 web.xml 에 로그인 구성을 추가합니다.

        <web-app>
        ...
            <login-config>
                <auth-method>OIDC</auth-method>     

        1

        
            </login-config>
        ...
        </web-app>

        1

        OIDC를 사용하여 애플리케이션을 보호합니다.

     2. 다음과 같이 WEB-INF 디렉토리에 파일 oidc.json 을 생성하십시오.

        {
          "provider-url" : "http://localhost:8180/realms/example_realm",
          "ssl-required": "external",
          "client-id": "jbeap-oidc",
          "public-client": true,
          "confidential-port": 0
        }

   • elytron-oidc-client 하위 시스템 구성:

     • 애플리케이션을 보호하려면 다음 관리 CLI 명령을 사용하십시오.

       /subsystem=elytron-oidc-client/secure-deployment=simple-webapp-example.war/:add(client-id=jbeap-oidc,provider-url=http://localhost:8180/realms/example_realm,public-client=true,ssl-required=external)

3. 애플리케이션 루트 디렉터리에서 다음 명령을 사용하여 애플리케이션을 컴파일합니다.

   $ mvn package

4. 애플리케이션을 배포합니다.

   $ mvn wildfly:deploy

검증

1. 브라우저에서 http://localhost:8080/simple-webapp-example/secured 로 이동합니다.

   Red Hat build of Keycloak 로그인 페이지로 리디렉션됩니다.

2. Red Hat build of Keycloak에 정의된 사용자의 인증 정보로 로그인할 수 있습니다.