入门指南

流程

1. 访问红帽客户门户。
2. 下载 Red Hat Single Sign-On Server: rh-sso-7.5.zip
3. 将文件放在您选择的目录中。

4. 使用适当的 unzip 实用程序（如 unzip、tar 或 Expand-Archive）解包 ZIP 文件。

   Linux/Unix

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

   Copy to Clipboard Toggle word wrap

   Windows

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

   Copy to Clipboard Toggle word wrap

流程

1. 转到服务器分发的 bin 目录。

2. 运行 独立 引导脚本。

   Linux/Unix

   $ cd bin
   $ ./standalone.sh

   Copy to Clipboard Toggle word wrap

   Windows

   > ...\bin\standalone.bat

   Copy to Clipboard Toggle word wrap

流程

1. 在 Web 浏览器中打开 http://localhost:8080/auth。

   欢迎页面将打开，确认服务器正在运行。

   欢迎页面

   

2. 输入用户名和密码来创建初始 admin 用户。

流程

1. 点击 Welcome 页面上的 Administration Console 链接，或直接进入 http://localhost:8080/auth/admin/ （控制台 URL）。

   注意

   管理控制台通常被称为 Red Hat Single Sign-On 文档中的短期的管理控制台。

2. 输入您在 Welcome 页面上创建的用户名和密码，以打开 admin 控制台。

   管理控制台登录屏幕

   

   此时会出现管理控制台的初始屏幕。

   管理控制台

   

流程

1. 进入 http://localhost:8080/auth/admin/，再使用 admin 帐户登录 Red Hat Single Sign-On 管理控制台。
2. 在 Master 菜单中，单击 Add Realm。当您登录到 master 域时，此菜单将列出所有其他域。

3. 在 Name 字段中输入 demo。

   新域

   

   注意

   realm 名称是区分大小写的，因此请注意您使用的大小写。

4. 点 Create。

   此时会打开主管理控制台页面，域设为 demo。

   演示域

   

5. 在管理 master 域和您刚才创建的域之间的切换，方法是单击 Select realm 下拉列表中的条目。

流程

1. 从菜单中，单击 Users 以打开用户列表页面。
2. 在空用户列表的右侧，单击 Add User 以打开 Add user 页面。

3. 在 Username 字段中输入名称。

   这是唯一的必填字段。

   添加用户页面

   

4. 将 电子邮件验证 切换为 On，然后单击保存。

   新用户的管理页面将打开。

5. 点 Credentials 选项卡为新用户设置临时密码。
6. 键入新密码并确认。

7. 点 Set Password 将用户密码设置为您指定的新密码。

   管理凭证页面

   

   注意

   此密码是临时的，用户在第一次登录时需要更改密码。如果要创建永久的密码，请将 Temporary 开关设置为 Off，然后单击 Set Password。

流程

1. 打开用户菜单并选择 Sign Out，从管理控制台注销。
2. 进入 http://localhost:8080/auth/realms/demo/account 并以您刚刚创建的用户身份登录您的 demo 域。

3. 当要求您提供新密码时，请输入一个可以记住的密码。

   更新密码

   

   为此用户打开帐户控制台。

   帐户控制台

   

4. 使用任何值完成必填字段，以使用此页面进行测试。

流程

1. 从红帽客户门户下载 JBoss EAP 7.3。

2. 解压下载的 JBoss EAP。

   $ unzip <filename>.zip

   Copy to Clipboard Toggle word wrap
3. 更改到 Red Hat Single Sign-On root 目录。

4. 为 jboss.socket.binding.port-offset 系统属性提供值，启动 Red Hat Single Sign-On 服务器。这个值添加到 Red Hat Single Sign-On 服务器打开的每个端口的基本值中。在本例中，100 是值。

   Linux/Unix

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

   Copy to Clipboard Toggle word wrap

   Windows

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

   Copy to Clipboard Toggle word wrap

   Windows Powershell

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

   Copy to Clipboard Toggle word wrap

5. 确认 Red Hat Single Sign-On 服务器正在运行。前往 http://localhost:8180/auth/admin/。

   如果打开了管理控制台，您已准备好安装客户端适配器，使 JBoss EAP 能够与红帽 Sign-On 配合使用。

流程

1. 从红帽客户门户下载 EAP 7 的 客户端适配器。
2. 更改到 JBoss EAP 的根目录。

3. 在此目录中解压下载的客户端适配器。例如：

   $ unzip <filename>.zip

   Copy to Clipboard Toggle word wrap

4. 更改到 bin 目录。

   $ cd bin

   Copy to Clipboard Toggle word wrap

5. 为您的平台运行适当的脚本。

   注意

   如果您收到 未找到的文件，请确保在上一步中使用了 unzip。这种提取方法会在正确的位置安装文件。

   Linux/Unix

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

   Copy to Clipboard Toggle word wrap

   Windows

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

   Copy to Clipboard Toggle word wrap

   注意

   此脚本对 …​/standalone/configuration/standalone.xml 文件进行必要的编辑。

6. 启动应用服务器。

   Linux/Unix

   $ ./standalone.sh

   Copy to Clipboard Toggle word wrap

   Windows

   > ...\standalone.bat

   Copy to Clipboard Toggle word wrap

流程

1. 使用 admin 帐户登录到 admin 控制台 ：http://localhost:8180/auth/admin/
2. 在左侧下拉列表中，选择 Demo realm。

3. 点左侧菜单中的 Clients 打开 Clients 页面。

   客户端

   

4. 在右侧，点 Create。

5. 在 Add Client 对话框中，通过完成字段来创建名为 vanilla 的客户端，如下所示：

   添加客户端

   

6. 点 Save。
7. 在显示的 Vanilla 客户端页面中，单击 Installation 选项卡。

8. 选择 Keycloak OIDC JSON 生成您稍后所需的文件。

   Keycloak.json 文件

   

9. 点 Download 将 Keycloak.json 保存到可在以后找到的位置。

10. 选择 Keycloak OIDC JBoss 子系统 XML 来生成 XML 模板。

    模板 XML

    

11. 单击 Download 以保存供下一流程使用的副本，该副本涉及 JBoss EAP 配置。

流程

1. 转到 JBoss EAP 根目录中的 独立/配置目录。

2. 打开 standalone.xml 文件并搜索以下文本：

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

   Copy to Clipboard Toggle word wrap

3. 将 XML 条目从 self-closing 改为使用对打开和关闭标签，如下所示：

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

   Copy to Clipboard Toggle word wrap

4. 将 XML 模板的内容粘贴到 < subsystem& gt; 元素中，如下例所示：

   <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>

   Copy to Clipboard Toggle word wrap

5. 将 WAR MODULE NAME.war 更改为 vanilla.war ：

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

   Copy to Clipboard Toggle word wrap
6. 重启应用服务器。

流程

1. 确保您的 JBoss EAP 应用服务器已经启动。

2. 使用以下命令下载代码并更改目录：

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

   Copy to Clipboard Toggle word wrap
3. 将 keycloak.json 文件复制到当前目录中。
4. 向上移到 app-profile-jee-vanilla 目录。

5. 使用以下命令安装代码。

   $ mvn clean wildfly:deploy

   Copy to Clipboard Toggle word wrap

6. 确认应用安装是否成功。进入 http://localhost:8080/vanilla，其中显示登录页面。

   登录页面确认成功

   

7. 使用您在 demo 域中创建的帐户登录。

   demo 域的登录页面

   

   这时将显示一条消息，表明您已成功完成了 Red Hat Single Sign-On 以保护示例 JBoss EAP 应用。祝贺您！

   完成成功