2.3. 创建自定义转换器，将来自 Red Hat Single-Sign On (RHSSO)的用户置备到软件目录

流程

1. 使用 yarn 新命令 创建一个新的 backend 模块。

2. 将自定义用户和组转换器添加到 keycloakTransformerExtensionPoint 中。

   以下是如何定义 backend 模块的示例：

   plugins/<module-name>/src/module.ts

   import {
     GroupTransformer,
     keycloakTransformerExtensionPoint,
     UserTransformer,
   } from '@janus-idp/backstage-plugin-keycloak-backend';
   
   const customGroupTransformer: GroupTransformer = async (
     entity, // entity output from default parser
     realm, // Keycloak realm name
     groups, // Keycloak group representation
   ) => {
     /* apply transformations */
     return entity;
   };
   const customUserTransformer: UserTransformer = async (
     entity, // entity output from default parser
     user, // Keycloak user representation
     realm, // Keycloak realm name
     groups, // Keycloak group representation
   ) => {
     /* apply transformations */
     return entity;
   };
   
   export const keycloakBackendModuleTransformer = createBackendModule({
     pluginId: 'catalog',
     moduleId: 'keycloak-transformer',
     register(reg) {
       reg.registerInit({
         deps: {
           keycloak: keycloakTransformerExtensionPoint,
         },
         async init({ keycloak }) {
           keycloak.setUserTransformer(customUserTransformer);
           keycloak.setGroupTransformer(customGroupTransformer);
           /* highlight-add-end */
         },
       });
     },
   });

   重要

   模块的 pluginId 必须设置为 catalog 以匹配 keycloak-backend 的 pluginId ；否则，模块无法初始化。

3. 将此新后端模块安装到 Developer Hub 后端中。

   backend.add(import(backstage-plugin-catalog-backend-module-keycloak-transformer))