4.2. 将用户从 Microsoft Azure 置备到软件目录

流程

1. 启用 backstage-plugin-catalog-backend-module-msgraph-dynamic 插件。

   dynamic-plugins.yaml 文件片段

   plugins:
     - package: './dynamic-plugins/dist/backstage-plugin-catalog-backend-module-msgraph-dynamic'
       disabled: false

2. 要启用 Microsoft Azure 成员发现，请编辑 app-config.yaml，自定义 Developer Hub 配置文件：

   带有强制 microsoftGraphOrg 字段的 app-config.yaml 片段

   catalog:
     providers:
       microsoftGraphOrg:
         providerId:
           target: https://graph.microsoft.com/v1.0
           tenantId: ${AUTH_AZURE_TENANT_ID}
           clientId: ${AUTH_AZURE_CLIENT_ID}
           clientSecret: ${AUTH_AZURE_CLIENT_SECRET}
           schedule:
             frequency: { hours: 1 }
             timeout: { minutes: 50 }
             initialDelay: { minutes: 50 }

   target: https://graph.microsoft.com/v1.0

   定义提供程序所连接的 MSGraph API 端点。您可以更改此参数，以使用不同的版本，如 beta 端点。

   tenandId,clientId 和 clientSecret

   使用您在 Microsoft Azure 中创建的 Developer Hub 应用程序信息，并在 OpenShift 中配置为 secret。

   调度

   频率

   输入调度频率为 cron、ISO 持续时间或代码中使用的人工持续时间。

   timeout

   输入调度超时作为 ISO 持续时间或代码中使用的人为持续时间。

   initialDelay

   输入调度初始延迟作为 ISO 持续时间或代码中使用的 human 持续时间。

   提示

   在大型组织中，此插件可能需要很长时间。因此，在第一次导入大量用户和组时，避免设置低频率或超时。

验证

1. 检查控制台日志，以验证同步是否已完成。

   成功同步示例：

   backend:start: {"class":"MicrosoftGraphOrgEntityProvider$1","level":"info","message":"Read 1 msgraph users and 1 msgraph groups in 2.2 seconds. Committing...","plugin":"catalog","service":"backstage","taskId":"MicrosoftGraphOrgEntityProvider:default:refresh","taskInstanceId":"88a67ce1-c466-41a4-9760-825e16b946be","timestamp":"2024-06-26 12:23:42"}
   backend:start: {"class":"MicrosoftGraphOrgEntityProvider$1","level":"info","message":"Committed 1 msgraph users and 1 msgraph groups in 0.0 seconds.","plugin":"catalog","service":"backstage","taskId":"MicrosoftGraphOrgEntityProvider:default:refresh","taskInstanceId":"88a67ce1-c466-41a4-9760-825e16b946be","timestamp":"2024-06-26 12:23:42"}

2. 使用 Microsoft Azure 帐户登录。