SAML v2 概述

安全断言标记语言 (SAML) 是一种标准的单点登录 (SSO) 格式。其基于 XML 的框架可通过数字签名的 XML 文档进行信息交换，从而实现无缝身份验证。自 2005 年起，SAML v2（又称 SAML 2.0）便成为实现基于 web 的跨域 SSO 的标准协议。

授权流程

无论您选择了哪种功能，基本 SSO 的设置要求都是一样的。添加会员积分或信用卡集成功能将需要额外的信息。

要正确设置模板网站的 SAML SSO 访问权限，我们需要以下内容：

Expedia SAML SSO 的实施标准将使用我们的公钥进行加密，创建目的地端点，并复制您的 IP 白名单，以防范中断攻击。

技术要求：

客户通过您的身份提供商 (IdP) 登录后，它会将生成的响应（称为有效负载）发送到您的主站点进行身份验证。如果身份验证成功，客户将获准访问。我们提供的有效负载包括以下字段。我们并不需要所有这些字段，但我们会使用其中一些字段来实现用户体验（例如，在欢迎信息中显示客户姓名），另一些字段则用于部分验证。

字段	说明	是否必填？
`membershipId`	客户账户的唯一标识符	是
`relayState`	验证完成后，客户将被重定向到的 URL	是
`languageID`	网站可显示的语言	否
`channelType`	经过优化的网站平台（值：WEB、MOBILE、TABLET）	否
`firstName`	客户的名字	是
`middleName`	客户的中间名	否
`lastName`	客户的姓氏	否
`email`	客户的邮箱地址	否

作为模板网站的一部分，您可以添加让客户通过旅行消费赚取忠诚度积分的功能。您的模板还可以允许客户使用累积的积分兑换旅行产品。

设置要求与标准实施的设置要求无异。

除了标准实施中介绍的属性外，添加会员积分“累积和兑换”功能还需要以下账户 (ProgramAccount) 属性。

字段	说明	是否必填？
`programId`	会员积分计划的等级标识符	是
`programAccountNumber`	客户所属计划的帐号（也称为 `loyaltyAccountNumber`）	否
`lastFourDigitsOfCreditCard`	客户预订所用信用卡的最后 4 位数	否
`accountName`	计划的帐户名	否
`loyaltyConversionRatio`	消费金额转换为累积积分的比率（例如 $1 = 1 积分）	否
`loyaltyAccountBalance`	客户累积会员积分的当前余额	是

我们可以设置您的网站，让客户必须使用贵公司的信用卡才能预订。这是可选设置，因为所有模板解决方案都可以接受所有主流信用卡或借记卡以及 PayPal（美国境内）支付。

如果您选择要求使用贵组织自定义的信用卡预订，我们希望让您感到安心。我们通过以下方式确保安全。

添加信用卡功能意味着除了标准实施的设置要求外，还需要增加额外的一层安全保护。为此，我们需要：

我们将使用 Expedia 的私钥为 AuthnRequest 有效负载签名，并共用我们的公钥为您的终端提供签名验证。

当客户在您的网站上登录时，除了标准实施中介绍的属性外，我们将向安全的 Expedia SSO 端点发送带有签名和加密断言的编码 SAML 响应有效负载。

如果您的模板网站还设置了赚取会员积分功能，也应加上 ProgramAccount 信息。

有效负载还将包含以下详细信用卡信息：

字段	说明	是否必填？
`cardNumber`	要扣款的卡号	是
`cardType`	使用的卡类型（例如 Visa、万事达卡、美国运通卡）	是
`expirationDate`	所使用银行卡的有效期	是
`addressCategoryCode`	与所用银行卡相关联的账单地址类型（如家庭地址或办公室地址）	是
`firstAddressLine`	账单地址的第一行	是
`secondAddressLine`	账单地址的第二行	否
`thirdAddressLine`	账单地址的第三行	否
`cityName`	账单地址所在城市	是
`provinceName`	账单地址所在州或省	是
`postalCode`	账单地址的邮政编码	是
`countryCode`	账单地址的国家/地区代码	是

当未经身份验证的用户访问您的模板网站时，Expedia 将向您的端点发送 AuthnRequest 和RelayState 参数。这将提示用户登录，从而启动 SSO 流程。

AuthnRequest 要素包括：

字段	说明	是否必填？
`AssertionConsumerServiceURL`	用户登录后指向 Expedia 模板网站的 URL	是
`Destination`	将 AuthnRequest 发送到的端点 URL	是
`Issuer`	数据来源；值：Expedia-Test 或 Expedia-Prod	是
`Signature`	由主网站验证的 SSO 签名	是

如需了解更多详情，请查看有效负载示例。