Hyperledger Composer Rest Server OAuth登录后自动设置默认身份问询

没问题！完全可以实现这个自动绑定身份的需求，Composer REST Server本身就支持自定义认证逻辑，能把OAuth返回的用户邮箱直接关联到Fabric网络里的参与者，自动设为默认身份，不用再手动选择。下面是具体的实现步骤：

1. 确保OAuth提供者返回用户邮箱 #

首先要确认你的OAuth服务（比如Google Auth、Keycloak等）在认证成功后，会把用户的邮箱信息包含在返回的用户profile里。一般需要在OAuth授权请求的scope参数里包含email权限，这样REST Server才能拿到邮箱来匹配参与者。

2. 编写自定义身份映射脚本 #

你需要写一个Node.js模块，作为Composer REST Server的自定义认证逻辑，核心是从OAuth的用户profile中提取邮箱，然后查询对应参与者并设置为默认身份。

示例代码如下（保存为custom-identity-mapper.js）：

module.exports = function(profile, user, callback) {
    // 从OAuth返回的profile中获取用户邮箱（不同OAuth提供者的字段可能略有不同，按需调整）
    const userEmail = profile.emails?.[0]?.value;
    if (!userEmail) {
        return callback(new Error("Failed to retrieve user email from OAuth profile"), null);
    }

    // 假设你的参与者类型是`com.example.Trader`，邮箱是其唯一标识属性
    const participantId = `com.example.Trader#${userEmail}`;

    // 查询参与者注册表，确认该参与者存在
    user.connection.getParticipantRegistry('com.example.Trader')
        .then(registry => registry.exists(participantId))
        .then(exists => {
            if (exists) {
                // 将该参与者设置为当前用户的默认身份
                return user.setDefaultIdentity(participantId);
            } else {
                // 可选：如果参与者不存在，自动创建（需谨慎使用，注意安全）
                // const newParticipant = {
                //     $class: 'com.example.Trader',
                //     email: userEmail,
                //     // 其他参与者属性...
                // };
                // return registry.add(newParticipant).then(() => user.setDefaultIdentity(participantId));
                throw new Error(`Participant with email ${userEmail} not found in the network`);
            }
        })
        .then(() => {
            callback(null, user);
        })
        .catch(err => {
            callback(err, null);
        });
};

注意：不同OAuth提供者返回的profile结构可能不同，比如有些可能用profile.email而不是profile.emails[0].value，需要根据你的实际情况调整字段提取逻辑。

3. 启动Composer REST Server时加载自定义脚本 #

使用composer-rest-server命令启动时，通过-a参数指定你的自定义认证模块路径，同时确保启用用户认证（-u true）：

composer-rest-server -c admin@your-business-network -n never -u true -a ./custom-identity-mapper.js

参数说明：

• -c：指定业务网络的管理员连接配置
• -n never：禁用自动更新业务网络（可选，根据你的需求调整）
• -u true：启用用户级身份认证
• -a：指定自定义认证模块的文件路径

关键注意事项 #

• 参与者唯一性：确保你的业务网络定义中，参与者的邮箱属性是唯一的，这样才能准确匹配到对应的参与者。
• 权限配置：启动REST Server使用的管理员身份，必须拥有查询参与者注册表、设置用户身份的权限，否则会出现权限错误。
• 安全考量：如果选择自动创建参与者，一定要添加必要的校验逻辑，避免恶意用户通过OAuth注册未授权的参与者。

内容的提问来源于stack exchange，提问作者basum