시작하기 가이드

절차

1. Red Hat 고객 포털 로 이동하십시오.
2. Red Hat Single Sign-On Server 다운로드: rh-sso-7.6.zip
3. 파일을 선택한 디렉터리에 배치합니다.

4. unzip, tar 또는 Expand-Archive와 같은 적절한 unzip 유틸리티를 사용하여 ZIP 파일의 압축을 풉니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ unzip rhsso-7.6.zip
   
   or
   
   $ tar -xvzf rh-sso-7.6.tar.gz

   Windows

   Copy to Clipboard Toggle word wrap

   > Expand-Archive -Path 'C:Downloads\rhsso-7.6.zip' -DestinationPath 'C:\Downloads'

5. Red Hat 고객 포털 로 돌아가기
6. 패치 탭을 클릭합니다.

7. Red Hat Single Sign-On 7.6.11 서버 패치를 다운로드합니다.

   다운로드한 ZIP 파일을 선택한 디렉터리에 배치합니다.

8. Red Hat Single Sign-On 서버의 루트 디렉터리로 이동합니다.

9. JBoss EAP 명령줄 인터페이스를 시작합니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ ./bin/jboss-cli.sh

   Windows

   Copy to Clipboard Toggle word wrap

   > .\bin\jboss-cli.bat

10. 패치를 적용합니다.

    Copy to Clipboard Toggle word wrap

    $ patch apply <path-to-zip>/rh-sso-7.6.11-patch.zip

절차

1. Red Hat Single Sign-On 서버의 루트 디렉터리로 이동합니다.

2. jboss-cli 명령을 실행하여 enable-elytron-se17.cli 스크립트를 전달합니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ ./bin/jboss-cli.sh --file=docs/examples/enable-elytron-se17.cli

   Windows

   Copy to Clipboard Toggle word wrap

   > .\bin\jboss-cli.bat --file=docs\examples\enable-elytron-se17.cli

절차

1. 서버 배포의 bin 디렉터리로 이동합니다.

2. 독립 실행형 부팅 스크립트를 실행합니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ cd bin
   $ ./standalone.sh

   Windows

   Copy to Clipboard Toggle word wrap

   > ...\bin\standalone.bat

절차

1. 웹 브라우저에서 http://localhost:8080/auth 을 엽니다.

   시작 페이지가 열리고 서버가 실행 중인지 확인합니다.

   시작 페이지

   

2. 사용자 이름과 암호를 입력하여 초기 admin 사용자를 만듭니다.

절차

1. welcome 페이지에서 Administration Console (관리 콘솔) 링크를 클릭하거나 http://localhost:8080/auth/admin/ ( 콘솔 URL)으로 직접 이동합니다.

   참고

   관리 콘솔은 일반적으로 Red Hat Single Sign-On 설명서에서 간단한 관리 콘솔이라고 합니다.

2. admin 콘솔 을 열기 위해 welcome 페이지에서 만든 사용자 이름과 암호를 입력합니다.

   관리자 콘솔 로그인 화면

   

   관리 콘솔의 초기 화면이 표시됩니다.

   관리자 콘솔

   

절차

1. http://localhost:8080/auth/admin/ 으로 이동하여 admin 계정을 사용하여 Red Hat Single Sign-On 관리 콘솔에 로그인합니다.
2. 마스터 메뉴에서 Add CloudEvent를 클릭합니다. 마스터 영역에 로그인하면 이 메뉴에 다른 모든 영역이 나열됩니다.

3. Name 필드에 demo 를 입력합니다.

   새 영역

   

   참고

   영역 이름은 대소문자를 구분하지 않으므로 사용하는 사례를 기록해 두십시오.

4. 생성을 클릭합니다.

   기본 admin console 페이지가 와 realm이 demo 로 설정된 상태로 열립니다.

   데모 영역

   

5. Select realm 드롭다운 목록에서 마스터 영역과 방금 만든 영역을 관리하는 사이를 전환합니다.

절차

1. 메뉴에서 Users 를 클릭하여 사용자 목록 페이지를 엽니다.
2. 빈 사용자 목록 오른쪽에 있는 사용자 추가를 클릭하여 사용자 추가 페이지를 엽니다.

3. Username 필드에 이름을 입력합니다.

   이 필드는 유일한 필수 항목입니다.

   사용자 페이지 추가

   

4. 확인 이메일 의 On 으로 전환한 후 저장 을 클릭합니다.

   새 사용자의 관리 페이지가 열립니다.

5. 인증 정보 탭을 클릭하여 새 사용자의 임시 암호를 설정합니다.
6. 새 암호를 입력하고 확인합니다.

7. Set Password 를 클릭하여 사용자 암호를 사용자가 지정한 새 암호로 설정합니다.

   인증 정보 페이지 관리

   

   참고

   이 암호는 임시이며 사용자가 처음 로그인할 때 변경해야 합니다. 영속적인 암호를 만들려면 Temporary 스위치를 Off 로 바꾸고 Set Password 를 클릭합니다.

절차

1. 사용자 메뉴를 열고 Sign Out 을 선택하여 관리 콘솔에서 로그아웃합니다.
2. http://localhost:8080/auth/realms/demo/account 으로 이동하여 방금 생성한 사용자로 데모 영역에 로그인합니다.

3. 새 암호를 입력하라는 메시지가 표시되면 기억할 수 있는 암호를 입력합니다.

   암호 업데이트

   

   이 사용자에 대한 계정 콘솔이 열립니다.

   계정 콘솔

   

4. 이 페이지를 사용하여 테스트할 값을 사용하여 필수 필드를 작성합니다.

절차

1. Red Hat 고객 포털에서 JBoss EAP 7.3을 다운로드합니다.

2. 다운로드한 JBoss EAP의 압축을 풉니다.

   Copy to Clipboard Toggle word wrap

   $ unzip <filename>.zip

3. Red Hat Single Sign-On 루트 디렉터리로 변경합니다.

4. jboss.socket.binding.port-offset 시스템 속성의 값을 제공하여 Red Hat Single Sign-On 서버를 시작합니다. 이 값은 Red Hat Single Sign-On 서버에서 연 모든 포트의 기본 값에 추가됩니다. 이 예에서 100 은 값입니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ cd bin
   $ ./standalone.sh -Djboss.socket.binding.port-offset=100

   Windows

   Copy to Clipboard Toggle word wrap

   > ...\bin\standalone.bat -Djboss.socket.binding.port-offset=100

   Windows Powershell

   Copy to Clipboard Toggle word wrap

   > ...\bin\standalone.bat -D"jboss.socket.binding.port-offset=100"

5. Red Hat Single Sign-On 서버가 실행 중인지 확인합니다. http://localhost:8180/auth/admin/ 으로 이동합니다.

   관리 콘솔이 열리면 JBoss EAP가 Red Hat Single Sign-On과 함께 작동할 수 있는 클라이언트 어댑터를 설치할 준비가 된 것입니다.

절차

1. Red Hat 고객 포털에서 EAP 7용 클라이언트 어댑터 를 다운로드합니다.
2. JBoss EAP의 루트 디렉터리로 변경합니다.

3. 이 디렉터리에서 다운로드한 클라이언트 어댑터의 압축을 풉니다. 예를 들면 다음과 같습니다.

   Copy to Clipboard Toggle word wrap

   $ unzip <filename>.zip

4. bin 디렉토리로 변경합니다.

   Copy to Clipboard Toggle word wrap

   $ cd bin

5. 플랫폼에 적합한 스크립트를 실행합니다.

   참고

   파일을 찾을 수 없는 경우 이전 단계에서 unzip 을 사용했는지 확인합니다. 이 추출 방법을 사용하면 파일을 올바른 위치에 설치합니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ ./jboss-cli.sh --file=adapter-elytron-install-offline.cli

   Windows

   Copy to Clipboard Toggle word wrap

   > jboss-cli.bat --file=adapter-elytron-install-offline.cli

   참고

   이 스크립트는 필요한 …​/standalone/configuration/standalone.xml 파일을 편집합니다.

6. 애플리케이션 서버를 시작합니다.

   Linux/Unix

   Copy to Clipboard Toggle word wrap

   $ ./standalone.sh

   Windows

   Copy to Clipboard Toggle word wrap

   > ...\standalone.bat

절차

1. 관리자 계정으로 관리자 콘솔에 로그인합니다. http://localhost:8180/auth/admin/
2. 왼쪽 상단 드롭다운 목록에서demo 영역을 선택합니다.

3. 왼쪽 메뉴에서 Clients 를 클릭하여 클라이언트 페이지를 엽니다.

   클라이언트

   

4. 오른쪽에서 Create 를 클릭합니다.

5. Add Client 대화 상자에서 아래와 같이 필드 를 완료하여 vanora라는 클라이언트를 생성합니다.

   클라이언트 추가

   

6. 저장을 클릭합니다.
7. 표시되는 Van ill client 페이지에서 Installation 탭을 클릭합니다.

8. Keycloak OIDC JSON 을 선택하여 이후 프로세스에서 필요한 파일을 생성합니다.

   keycloak.json 파일

   

9. 나중에 찾을 수 있는 위치에 Keycloak.json 을 저장하려면 다운로드를 클릭합니다.

10. Keycloak OIDC JBossECDHE XML 을 선택하여 XML 템플릿을 생성합니다.

    템플릿 XML

    

11. 다운로드를 클릭하여 JBoss EAP 구성과 관련된 다음 절차에서 사용할 사본을 저장합니다.

절차

1. JBoss EAP 루트 디렉터리의 독립 실행형/구성 디렉터리로 이동합니다.

2. standalone.xml 파일을 열고 다음 텍스트를 검색합니다.

   Copy to Clipboard Toggle word wrap

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1"/>

3. 다음과 같이 XML 항목을 self-closing에서 한 쌍의 열기 및 닫기 태그로 변경합니다.

   Copy to Clipboard Toggle word wrap

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
   </subsystem>

4. 다음 예제와 같이 < subsystem> 요소 내에 XML 템플릿의 내용을 붙여넣습니다.

   Copy to Clipboard Toggle word wrap

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
     <secure-deployment name="WAR MODULE NAME.war">
       <realm>demo</realm>
       <auth-server-url>http://localhost:8180/auth</auth-server-url>
       <public-client>true</public-client>
       <ssl-required>EXTERNAL</ssl-required>
       <resource>vanilla</resource>
     </secure-deployment>
   </subsystem>

5. WAR MODULE NAME.war 를 vanill .war 로 변경합니다.

   Copy to Clipboard Toggle word wrap

   <subsystem xmlns="urn:jboss:domain:keycloak:1.1">
     <secure-deployment name="vanilla.war">
     ...
   </subsystem>

6. 애플리케이션 서버를 재부팅합니다.

절차

1. JBoss EAP 애플리케이션 서버가 시작되었는지 확인합니다.

2. 다음 명령을 사용하여 코드를 다운로드하고 디렉토리를 변경합니다.

   Copy to Clipboard Toggle word wrap

   $ git clone https://github.com/redhat-developer/redhat-sso-quickstarts
   $ cd redhat-sso-quickstarts/app-profile-jee-vanilla/config

3. keycloak.json 파일을 현재 디렉터리에 복사합니다.
4. 한 레벨을 app-profile-jee-vancatalog 디렉토리로 이동합니다.

5. 다음 명령을 사용하여 코드를 설치합니다.

   Copy to Clipboard Toggle word wrap

   $ mvn clean wildfly:deploy

6. 애플리케이션 설치에 성공했는지 확인합니다. 로그인 페이지가 표시되는 http://localhost:8080/vanilla 로 이동합니다.

   성공 확인 로그인 페이지

   

7. 데모 영역에서 만든 계정을 사용하여 로그인합니다.

   데모 영역으로 로그인 페이지

   

   샘플 JBoss EAP 애플리케이션을 보호하기 위해 Red Hat Single Sign-On 사용을 성공적으로 완료했음을 나타내는 메시지가 표시됩니다. 축하합니다!

   완료 성공