本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
SAML身份提供者名称和标识符
当您命名SAML身份提供者 (IdPs) 并分配 IdP 标识符时,您可以自动将 SP 发起的登录和注销请求流向该提供商。有关提供商名称的字符串约束的信息,请参阅的ProviderName
属性CreateIdentityProvider。
您还可以为SAML提供商选择最多 50 个标识符。标识符是用户池中 IdP 的友好名称,在用户池中必须是唯一的。如果您的SAML标识符与用户的电子邮件域名匹配,Amazon Cognito 托管用户界面会请求每个用户的电子邮件地址,评估其电子邮件地址中的域名,然后将他们重定向到与其域名对应的 IdP。由于同一个组织可以拥有多个域,因此单个 IdP 可以有多个标识符。
无论您是否使用电子邮件域标识符,都可以在多租户应用程序中使用标识符将用户重定向到正确的 IdP。当你想完全绕过托管用户界面时,你可以自定义向用户提供的链接,这样他们就可以对端点授权直接重定向到他们的 IdP。要使用标识符登录您的用户并重定向到他们的 IdP,请在其初始授权请求的请求参数idp_identifier=
中加入该格式的标识符。myidp.example.com
将用户传递给您的 IdP 的另一种方法是identity_provider
使用您的 IdP 名称填充参数,格式如下。URL
https://
mydomain.us-east-1.amazoncognito.com
/oauth2/authorize? response_type=code
& identity_provider=MySAMLIdP
& client_id=1example23456789
& redirect_uri=https://www.example.com
用户使用您的 IdP 登录后,您的 SAML IdP 会将他们重定向,并在正文中显示对您的终端节点的SAMLHTTP POST
响应。/saml2/idpresponse
Amazon Cognito 会处理SAML断言,如果响应中的声明符合预期,则会重定向到您的应用程序客户端回调。URL在您的用户以这种方式完成身份验证后,他们只与您的 IdP 和您的应用程序的网页进行了交互。
使用域格式的 IdP 标识符,Amazon Cognito 托管的 UI 会在登录时请求电子邮件地址,然后,当电子邮件域与 IdP 标识符匹配时,会将用户重定向到其 IdP 的登录页面。例如,您构建的应用程序需要两家不同公司的员工登录。第一家公司 AnyCompany A 拥有exampleA.com
和exampleA.co.uk
。第二家公司 AnyCompany B 拥有exampleB.com
。在本示例中,您设置了两个 IdPs,每家公司一个,如下所示:
-
对于 IdP A,您定义标识符
exampleA.com
和exampleA.co.uk
。 -
对于 IdP B,您定义标识符
exampleB.com
。
在您的应用程序中,调用应用程序客户端的托管界面,以提示每位用户输入其电子邮件地址。Amazon Cognito 从电子邮件地址派生域,将该域与具有域标识符的 IdP 相关联,然后通过向包含请求参数的请求将您的用户重定向到正确的 IdP。对端点授权 idp_identifier
例如,如果用户进入bob@exampleA.co.uk
,则他们与之互动的下一个页面是 IdP 登录页面。https://auth.exampleA.co.uk/sso/saml
您也可以独立实现相同的逻辑。在您的应用程序中,您可以构建一个自定义表单,用于收集用户输入并根据自己的逻辑将其与正确的 IdP 关联起来。您可以为每个应用程序租户生成自定义应用程序门户,其中每个租户都链接到请求参数中包含租户标识符的授权端点。
要在托管界面中收集电子邮件地址并解析域名,请为分配给应用程序客户端的每个 Id SAML P 分配至少一个标识符。默认情况下,托管用户界面登录屏幕会为你分配给应用程序客户端 IdPs 的每个用户显示一个按钮。但是,如果您成功分配了标识符,则您的托管用户界面登录页面将如下图所示。
在托管 UI 中解析域名需要使用域名作为 IdP 标识符。如果您为应用程序客户端的每个分配了任何类型的标识符,则该应用程序的托管界面将不再显示 IDP 选择按钮。SAML IdPs 当您打算使用电子邮件解析或自定义逻辑生成重定向SAML时,请添加 IdP 标识符。如果您想生成静默重定向,并且希望您的托管界面显示列表 IdPs,请不要分配标识符,也不要在授权identity_provider
请求中使用请求参数。
-
如果您只为应用程序客户端分配一个 I SAML dP,则托管用户界面登录页面会显示一个使用该 IdP 登录的按钮。
-
如果您为应用程序客户端激活的每个 SAML IdP 分配一个标识符,则在托管 UI 登录页面中会出现用户输入电子邮件地址的提示。
-
如果您有多个 IdPs ,但没有为所有用户分配标识符,则托管用户界面登录页面会显示一个按钮,用于使用每个分配的 IdP 进行登录。
-
如果您为自己分配了标识符, IdPs 并且希望托管界面显示精选的 IdP 按钮,请向您的应用程序客户端添加一个没有标识符的新 IdP,或者创建一个新的应用程序客户端。您也可以删除现有 IdP,然后在没有标识符的情况下重新添加它。如果您创建新的 IdP,您的SAML用户将创建新的用户个人资料。活跃用户的重复可能会对您更改 IdP 配置的当月产生账单影响。
有关 IdP 设置的更多信息,请参阅为用户池配置身份提供商。