9.8. 映射声明和断言
您可以将由您进行身份验证的外部 IDP 提供的 SAML 和 OpenID Connect 元数据导入到域中。导入后,您可以提取用户配置文件元数据和其他信息,以便您可以将其提供给应用程序。
每个用户使用外部身份提供程序登录到您的域的用户在本地红帽构建的 Keycloak 数据库中有一个条目,具体取决于 SAML 或 OIDC 断言和声明的元数据。
流程
- 单击菜单中的 Identity Providers。
- 从列表中选择一个身份提供程序。
点 Mappers 选项卡。
身份提供程序映射器
点 Add mapper。
身份提供程序映射器
为 Sync Mode Override 选择一个值。当用户根据此设置重复登录时,映射程序会更新用户信息。
- 选择 legacy 来使用之前红帽构建的 Keycloak 版本的行为。
- 选择在首次登录到带有特定身份提供程序的 Keycloak 的红帽构建时,从导入数据。
- 选择 force 在每个用户登录时更新用户数据。
- 选择 inherit 来使用身份提供程序中配置的同步模式。所有其他选项将覆盖此同步模式。
- 从 Mapper Type 列表中选择一个映射程序。对于 映射程序的描述,将鼠标悬停在映射程序类型上,以输入映射程序。
- 点 Save。
对于基于 JSON 的声明,您可以使用点表示法进行嵌套和方括号,以按索引访问数组字段。例如: contact.address[0].country
。
要调查社交提供者提供的用户配置文件 JSON 数据结构,您可以在启动服务器时启用 DEBUG
级别日志记录器 org.keycloak.social.user_profile_dump
。