Looker 可以通过多种身份验证服务器类型之一(例如 LDAP、SAML 或 Google OAuth)对用户进行身份验证。启用上述任一身份验证方法将停用其他身份验证系统,例如电子邮件地址/密码。
如果用户拥有管理员角色或 login_special_email
权限,管理员可以为用户提供使用其电子邮件地址的备用登录选项。
第 1 步:在 Looker 实例上启用备用登录
首先,Looker 实例必须配置为接受电子邮件凭据。如需配置 Looker 以接受电子邮件凭据,请按以下步骤操作:
- 转到管理面板的身份验证标签页,然后选择当前已启用的身份验证类型。例如 LDAP、SAML 和 Google OAuth。
- 在迁移选项部分中,启用为管理员和指定用户启用备用登录方式开关。
第 2 步:向用户授予使用备用登录信息的权限
只有拥有“管理员”角色或“login_special_email
”权限的用户才能使用备用登录信息。向非管理员用户授予 login_special_email
权限的一种方法是,首先创建包含该权限的新角色,然后将该角色分配给用户,如下所示:
- 前往角色页面,该页面位于管理面板的用户标签页下。
- 点击页面顶部的新建权限集按钮。
- 输入新权限集的名称,例如“备用登录”。
- 勾选标有
login_special_email
的复选框。 - 点击页面底部的保存按钮。
- 点击页面顶部的新建角色按钮。
- 为新角色输入一个名称,例如“备用登录角色”。
- 在 Permission Set(权限集)部分下,从权限集列表中选择您的新权限集。
- 在模型集部分下,选择全部。
- 在用户部分下,选择应向其授予备用登录权限的用户。
- 点击页面底部的新角色按钮,以保存新角色。
- 点击弹出式对话框中的确认按钮。
第 3 步:为用户创建电子邮件凭据
既然该用户启用了使用电子邮件凭据,就必须创建这些电子邮件凭据。如需创建这些凭据,Looker 管理员可以使用 Looker API 发出 POST 请求,也可以使用管理员选择的编程语言使用 Looker API SDK。
方法 1:向 Looker API 发出 POST 请求
由于此方法是手动设置的,因此如果您要为的用户数量有限,则更适合使用此方法。
以下示例使用 curl 命令使用临时访问令牌向 create_user_credentials_email
API 端点发出 POST 请求:
-
如需生成临时令牌 (
ACCESS_TOKEN
),请按照 API 身份验证文档页面上不使用 SDK 进行身份验证部分中的步骤操作。 -
在授权标头中使用以下临时令牌,使用用户的
user_id
向 Looker API 发送 POST 请求,并在请求正文中包含用户电子邮件地址。curl -H "Authorization: token ACCESS_TOKEN" -H 'Content-Type: application/json' -X POST -d '{ "email": "example_name@example_email.com" }' https://<instance_name<.api.looker.com/api/3.1/users/{user_id}/credentials_email
- 在管理部分的用户页面上,找到相应用户账号,然后点击修改。
- 点击发送重置链接按钮。系统会向您在 POST 请求中指定的电子邮件地址发送一封电子邮件。
如需使用备用登录方法,当用户登录 Looker 时,需要点击备用登录链接,然后输入其姓名和电子邮件地址。他们仍然可以通过 Authenticate(身份验证)按钮使用 SAML、LDAP 或 OAuth 凭据进行身份验证。
方法 2:使用 Looker API SDK
您可以使用 Looker 提供的 SDK 以您选择的编程语言与 API 交互,而不必执行直接向 Looker API 发出请求的手动步骤。导入 Looker API SDK 并建立客户端连接后,请按以下步骤操作:
-
使用
create_user_credentials_email(user_id, body)
函数,按照 Looker API 文档中的说明插入user_id
和body
。您可以参考这篇关于使用 Looker API 自动配置用户的 Looker 社区帖子中的类似示例。 - 使用 SDK 方法更新用户账号后,在管理部分的用户页面上,找到相应用户账号,然后点击修改。
- 点击发送重置链接按钮。这样会向您在 POST 请求中指定的电子邮件地址发送一封电子邮件。
如需使用备选登录方法,用户在登录 Looker 时需要点击备选登录链接,然后输入其姓名和电子邮件地址。用户仍然可以通过点击身份验证按钮,使用 SAML、LDAP 或 OAuth 凭据进行身份验证。