创建和管理用户认证

新建用户认证方式

1. 在应用列表页面，单击目标轻应用名称。

2. 在目标轻应用导航栏中，选择配置中心 > 用户认证。

3. 在用户认证页面，单击新建用户认证方式。
4. 可选：在新建用户认证方式面板，选中钉钉认证方式，单击下一步。
   1. 在设置基本信息配置向导页面，设置认证方式名称和描述（选填），完成后，单击下一步。
   2. 在连接配置的向导页面，分别在AppKey、AppSecret和CorpId（企业钉钉ID）的下拉列表中选择目标信息。
      说明

      • AppKey和AppSecret可通过环境静态变量完成针对不同环境的相关配置。关于如何新增静态变量，请参见新增静态变量。
      • 为了确保轻应用对用户信息的获取，请在钉钉应用的权限管理页面中选中：通讯录个人信息读权限、个人手机号信息（如果轻应用侧不需要使用手机号码信息，您可以不选中）。
      • 设置的钉钉应用回调地址需包含：{线上应用域名}/{applicationCode}/user/auth/unifiedCallback。

      AppKey、AppSecret和CorpId（企业钉钉ID）的获取方式，请参见实现登录第三方网站使用教程。
5. 可选：在新建用户认证方式面板，选中RAM认证方式，单击下一步。
   1. 在设置基本信息配置向导页面，设置认证方式名称和描述（选填），完成后，单击下一步。
   2. 在连接配置的向导页面，分别在Client ID和Client Secret的下拉列表中选择目标ID和Secret。如果您选择打开限制仅主账号可以访问应用开关，则仅RAM主账号能够进入应用。
      说明

      • Client ID及Client Secret可通过环境静态变量完成针对不同环境的相关配置。关于如何新增静态变量，请参见新增静态变量。
      • 设置的RAM OAuth应用范围必须包含：openid，aliuid，profile。
      • 设置的RAM OAuth应用回调地址需包含：{线上应用域名}/{applicationCode}/user/auth/unifiedCallback。

      Client ID和Client Secret请参见以下操作步骤获取。

      1. 在RAM访制台中创建应用，具体操作，请参见创建应用。应用类型选择WebApp，设置访问令牌有效期、刷新令牌有效期及回调地址等。
         应用创建完成后，即可获得RAM工作台内注册完成的应用ID，即为连接配置的Client ID配置项。
      2. 创建应用密钥，具体陈操作，请参见创建应用密钥。

         在创建应用密钥对话框中，查看并复制创建成功的应用密钥，即为连接配置的Client Secret配置项。

6. 完成相关配置后，单击保存。
   成功新建用户认证方式后，您可以在用户认证页面查看所新建的用户认证方式。

平台自动生成的系统结构对象和服务方法说明

存在生效的用户方式时，应用会默认实现登录、注销逻辑，请保留页面框架中用户信息下拉菜单中的注销菜单，删除该菜单会导致默认注销逻辑不可用。

配置如何使用用户信息的内容

如果您需要使用用户信息里的内容，例如将用户名称在框架中进行显示，请您参考以下步骤配置。

1. 在页面框架设计器中新建一个类型为用户信息的变量。
2. 为页面框架动作加载框架完成时绑定逻辑流，逻辑流中增加服务调用节点，调用获取用户信息的服务方法，并将方法的出参赋值给用户信息类型的变量。
3. 配置框架属性中的用户名称信息。

编辑用户认证连接配置

1. 在用户认证页面，单击用户认证方式右侧操作列下的连接配置。
2. 在编辑用户认证连接配置面板，按需修改相关RAM服务连接配置项后，单击保存。

编辑用户认证属性

1. 在用户认证页面，单击用户认证方式右侧操作列下的编辑属性。
2. 在编辑用户认证属性面板，按需修改相关配置项后，单击保存。

删除用户认证方式

1. 在用户认证页面，单击用户认证方式右侧操作列下的删除。
2. 在二次确认框中，单击删除。

配置无需登录即可访问的页面

1. 在用户认证页面，单击页面访问限制。
2. 在页面访问限制面板，单击新增无需登录即可访问的页面，在新增可访问页面对话框中，选中目标页面（支持多选），完成后单击确定。
3. 如果您想恢复页面访问限制，单击目标页面右侧操作列下的增加调用限制。

配置无需登录即可调用的服务方法

1. 在用户认证页面，单击服务方法调用限制。
2. 在服务方法调用限制面板，单击新增无需登录即可调用的服务方法，在新增服务方法对话框中，选中目标服务方法（支持多选），完成后单击确定。
3. 如果您想恢复服务方法调用限制，单击目标页面右侧操作列下的增加调用限制。

使用示例

在完成用户认证相关的配置并部署应用后，线上的运行情况如下：

1. 当您未登录时，能够访问无需登录即可访问的应用首页。
2. 如果您需要访问需登录后才能访问的页面，应用检测到您当前并未登录，即会跳转至RAM用户登录页。
3. 完成登录后您即可访问需要登录才能访问的页面数据。
4. 您可以单击用户信息下拉菜单中的用户登出按钮，即可实现登录态的消除，应用重新跳转至RAM登录页。