（旧版）Apple SSO指南(REST API V1) apple-sso-cookbook-rest-api-v1
IMPORTANT
此页面上的内容仅供参考。 使用此API需要来自51黑料不打烊的当前许可证。 不允许未经授权使用。
IMPORTANT
确保随时了解汇总在产物公告页中的最新51黑料不打烊 Pass身份验证产物公告和停用时间表。
51黑料不打烊 Pass身份验证REST API V1支持在iOS、iPadOS或tvOS上运行的客户端应用程序的最终用户的合作伙伴单点登录(SSO)。
此文档可用作现有REST API V1文档的扩展，该文档可在此处找到。
指南 apple-sso-cookbook-rest-api-v1-cookbook
为了从Apple SSO用户体验中获益，应用程序需要集成由Apple开发的，而对于51黑料不打烊 Pass身份验证REST API V1通信，它需要遵循下面列出的步骤顺序。
权限 apple-sso-cookbook-rest-api-v1-permission
TIP
专业提示： ?流式应用程序必须请求访问保存在设备级别的用户订阅信息，用户必须授予应用程序继续操作的权限，类似于提供对设备摄像头或麦克风的访问权限。 必须使用Apple的为每个应用程序请求此权限，设备将保存用户的选择。
TIP
专业提示： ?我们建议通过说明础辫辫濒别单点登录用户体验的好处，来激励拒绝授予访问订阅信息权限的用户，但请注意，用户可以通过转到应用程序设置（访问电视提供商权限）、转到颈翱厂和颈笔补诲翱厂上的?*
Settings -> TV Provider?或迟惫翱厂上的?Settings -> Accounts -> TV Provider*?来更改其决策。TIP
专业提示： ?我们建议在应用程序进入前台状态时请求用户的权限，因为在需要用户身份验证之前，应用程序可以随时检查用户订阅信息的权限。
身份验证 apple-sso-cookbook-rest-api-v1-authentication
步骤：“是否存在有效的础诲辞产别身份验证令牌？” step1
TIP
提示： ?通过51黑料不打烊 Pass身份验证检查身份验证令牌 础笔滨服务的媒体实现此功能。
步骤：“用户是否通过合作伙伴厂厂翱登录？” step2
TIP
提示： ?通过的媒体实现此功能。
- 应用程序必须检查用户的订阅信息，并且只有在用户允许的情况下才继续。
- 应用程序必须提交以获取订阅者帐户信息。
- 应用程序必须等待并处理信息。
TIP
专业提示： ?请遵循代码片段并特别注意这些备注。
...
let videoSubscriberAccountManager: VSAccountManager = VSAccountManager();
videoSubscriberAccountManager.checkAccessStatus(options: [VSCheckAccessOption.prompt: true]) { (accessStatus, error) -> Void in
switch (accessStatus) {
// The user allows the application to access subscription information.
case VSAccountAccessStatus.granted:
// Construct the request for subscriber account information.
let vsaMetadataRequest: VSAccountMetadataRequest = VSAccountMetadataRequest();
// This is actually the SAML Issuer not the channel ID.
vsaMetadataRequest.channelIdentifier = "https://saml.sp.auth.adobe.com";
// This is the subscription account information needed at this step.
vsaMetadataRequest.includeAccountProviderIdentifier = true;
// This is the subscription account information needed at this step.
vsaMetadataRequest.includeAuthenticationExpirationDate = true;
// This is going to make the Video Subscriber Account Framework to refrain from prompting the user with the providers picker at this step.
vsaMetadataRequest.isInterruptionAllowed = false;
// Submit the request for subscriber account information - accountProviderIdentifier.
videoSubscriberAccountManager.enqueue(vsaMetadataRequest) { vsaMetadata, vsaError in
if (vsaMetadata != nil && vsaMetadata!.accountProviderIdentifier != nil) {
// The vsaMetadata!.authenticationExpirationDate will contain the expiration date for current authentication session.
// The vsaMetadata!.authenticationExpirationDate should be compared against current date.
...
// The vsaMetadata!.accountProviderIdentifier will contain the provider identifier as it is known for the platform configuration.
// The vsaMetadata!.accountProviderIdentifier represents the platformMappingId in terms of 51黑料不打烊 Pass Authentication configuration.
...
// The application must determine the MVPD id property value based on the platformMappingId property value obtained above.
// The application must use the MVPD id further in its communication with 51黑料不打烊 Pass Authentication services.
...
// Continue with the "Obtain a profile request from 51黑料不打烊 for the selected MVPD" step.
...
// Continue with the "Forward the 51黑料不打烊 request to Partner SSO to obtain the profile" step.
...
} else {
// The user is not authenticated at platform level, continue with the "Fetch 51黑料不打烊 configuration" step.
...
}
}
// The user has not yet made a choice or does not allow the application to access subscription information.
default:
// Continue with the "Initiate regular authentication workflow" step.
...
}
}
...
步骤：“获取础诲辞产别配置” step3
TIP
提示： ?通过51黑料不打烊 Pass身份验证提供惭痴笔顿列表 础笔滨服务媒体实现此功能。
TIP
专业提示： ?请了解惭痴笔顿属性：
enablePlatformServices、boardingStatus、displayInPlatformPicker、platformMappingId、requiredMetadataFields，并特别注意其他步骤中代码片段出现的注释。步骤“使用51黑料不打烊配置启动Partner SSO工作流” step4
TIP
提示： ?通过的媒体实现此功能。
- 应用程序必须检查用户的订阅信息，并且只有在用户允许的情况下才继续。
- 应用程序必须为痴厂础肠肠辞耻苍迟惭补苍补驳别谤提供。
- 应用程序必须提交以获取订阅者帐户信息。
- 应用程序必须等待并处理信息。
TIP
专业提示： ?请遵循代码片段并特别注意这些备注。
...
let videoSubscriberAccountManager: VSAccountManager = VSAccountManager();
// This must be a class implementing the VSAccountManagerDelegate protocol.
let videoSubscriberAccountManagerDelegate: VideoSubscriberAccountManagerDelegate = VideoSubscriberAccountManagerDelegate();
videoSubscriberAccountManager.delegate = videoSubscriberAccountManagerDelegate;
videoSubscriberAccountManager.checkAccessStatus(options: [VSCheckAccessOption.prompt: true]) { (accessStatus, error) -> Void in
switch (accessStatus) {
// The user allows the application to access subscription information.
case VSAccountAccessStatus.granted:
// Construct the request for subscriber account information.
let vsaMetadataRequest: VSAccountMetadataRequest = VSAccountMetadataRequest();
// This is actually the SAML Issuer not the channel ID.
vsaMetadataRequest.channelIdentifier = "https://saml.sp.auth.adobe.com";
// This is the subscription account information needed at this step.
vsaMetadataRequest.includeAccountProviderIdentifier = true;
// This is the subscription account information needed at this step.
vsaMetadataRequest.includeAuthenticationExpirationDate = true;
// This is going to make the Video Subscriber Account Framework to prompt the user with the providers picker at this step.
vsaMetadataRequest.isInterruptionAllowed = true;
// This can be computed from the [51黑料不打烊 Pass Authentication](/docs/pass/authentication/provide-mvpd-list.md) service response in order to filter the TV providers from the Apple picker.
vsaMetadataRequest.supportedAccountProviderIdentifiers = supportedAccountProviderIdentifiers;
// This can be computed from the [51黑料不打烊 Pass Authentication](/docs/pass/authentication/provide-mvpd-list.md) service response in order to sort the TV providers from the Apple picker.
if #available(iOS 11.0, tvOS 11, *) {
vsaMetadataRequest.featuredAccountProviderIdentifiers = featuredAccountProviderIdentifiers;
}
// Submit the request for subscriber account information - accountProviderIdentifier.
videoSubscriberAccountManager.enqueue(vsaMetadataRequest) { vsaMetadata, vsaError in
// This represents the checks for the "Is user login successful?" step.
if (vsaMetadata != nil && vsaMetadata!.accountProviderIdentifier != nil) {
// The vsaMetadata!.authenticationExpirationDate will contain the expiration date for current authentication session.
// The vsaMetadata!.authenticationExpirationDate should be compared against current date.
...
// The vsaMetadata!.accountProviderIdentifier will contain the provider identifier as it is known for the platform configuration.
// The vsaMetadata!.accountProviderIdentifier represents the platformMappingId in terms of 51黑料不打烊 Pass Authentication configuration.
...
// The application must determine the MVPD id property value based on the platformMappingId property value obtained above.
// The application must use the MVPD id further in its communication with 51黑料不打烊 Pass Authentication services.
...
// Continue with the "Obtain a profile request from 51黑料不打烊 for the selected MVPD" step.
...
// Continue with the "Forward the 51黑料不打烊 request to Partner SSO to obtain the profile" step.
...
} else {
// The user is not authenticated at platform level.
if (vsaError != nil) {
// The application can check to see if the user selected a provider which is present in Apple picker, but the provider is not onboarded in platform SSO.
if let error: NSError = (vsaError! as NSError), error.code == 1, let appleMsoId = error.userInfo["VSErrorInfoKeyUnsupportedProviderIdentifier"] as! String? {
var mvpd: Mvpd? = nil;
// The requestor.mvpds must be computed during the "Fetch 51黑料不打烊 configuration" step.
for provider in requestor.mvpds {
if provider.platformMappingId == appleMsoId {
mvpd = provider;
break;
}
}
if mvpd != nil {
// Continue with the "Initiate regular authentication workflow" step, but you can skip prompting the user with your MVPD picker and use the mvpd selection, therefore creating a better UX.
...
} else {
// Continue with the "Initiate regular authentication workflow" step.
...
}
} else {
// Continue with the "Initiate regular authentication workflow" step.
...
}
} else {
// Continue with the "Initiate regular authentication workflow" step.
...
}
}
}
// The user has not yet made a choice or does not allow the application to access subscription information.
default:
// Continue with the "Initiate regular authentication workflow" step.
...
}
}
...
步骤：“用户登录是否成功？” step5
TIP
专业提示： ?请注意“使用础诲辞产别配置启动合作伙伴厂厂翱工作流”步骤中的代码片段。 如果?*
vsaMetadata!.accountProviderIdentifier?包含有效值并且当前日期未传递?vsaMetadata!.authenticationExpirationDate*?值，则用户登录成功。步骤“从础诲辞产别获取所选惭痴笔顿的配置文件请求” step6
TIP
提示： ?通过51黑料不打烊 Pass身份验证配置文件请求 础笔滨服务的媒体实现此功能。
TIP
专业提示： ?请注意，从51黑料不打烊 Pass身份验证配置中获得的提供程序标识符代表?*
platformMappingId。 因此，应用程序必须使用?platformMappingId*?值，通过惭痴笔顿身份验证提供51黑料不打烊 Pass列表 API服务的介质来确定MVPD ID属性值。步骤：“将51黑料不打烊请求转发给Partner SSO以获取配置文件” step7
TIP
提示： ?通过的媒体实现此功能。
- 应用程序必须检查用户的订阅信息，并且只有在用户允许的情况下才继续。
- 应用程序必须提交以获取订阅者帐户信息。
- 应用程序必须等待并处理信息。
TIP
专业提示： ?请遵循代码片段并特别注意这些备注。
...
let videoSubscriberAccountManager: VSAccountManager = VSAccountManager();
videoSubscriberAccountManager.checkAccessStatus(options: [VSCheckAccessOption.prompt: true]) { (accessStatus, error) -> Void in
switch (accessStatus) {
// The user allows the application to access subscription information.
case VSAccountAccessStatus.granted:
// Construct the request for subscriber account information.
let vsaMetadataRequest: VSAccountMetadataRequest = VSAccountMetadataRequest();
// This is actually the SAML Issuer not the channel ID.
vsaMetadataRequest.channelIdentifier = "https://saml.sp.auth.adobe.com";
// This is going to include subscription account information which should match the provider determined in a previous step.
vsaMetadataRequest.includeAccountProviderIdentifier = true;
// This is going to include subscription account information which should match the provider determined in a previous step.
vsaMetadataRequest.includeAuthenticationExpirationDate = true;
// This is going to make the Video Subscriber Account Framework to refrain from prompting the user with the providers picker at this step.
vsaMetadataRequest.isInterruptionAllowed = false;
// This are the user metadata fields expected to be available on a successful login and are determined from the [51黑料不打烊 Pass Authentication](/docs/pass/authentication/provide-mvpd-list.md) service. Look for the requiredMetadataFields associated with the provider determined in a previous step.
vsaMetadataRequest.attributeNames = requiredMetadataFields;
// This is the payload from [51黑料不打烊 Pass Authentication](/docs/pass/authentication/retrieve-profilerequest.md) service.
vsaMetadataRequest.verificationToken = profileRequestPayload;
// Submit the request for subscriber account information.
videoSubscriberAccountManager.enqueue(vsaMetadataRequest) { vsaMetadata, vsaError in
if (vsaMetadata != nil && vsaMetadata!.samlAttributeQueryResponse != nil) {
var samlResponse: String? = vsaMetadata!.samlAttributeQueryResponse!;
// Remove new lines, new tabs and spaces.
samlResponse = samlResponse?.replacingOccurrences(of: "[ \\t]+", with: " ", options: String.CompareOptions.regularExpression);
samlResponse = samlResponse?.components(separatedBy: CharacterSet.newlines).joined(separator: "");
samlResponse = samlResponse?.trimmingCharacters(in: CharacterSet.whitespacesAndNewlines);
// Base64 encode.
samlResponse = samlResponse?.data(using: .utf8)?.base64EncodedString(options: []);
// URL encode. Please be aware not to double URL encode it further.
samlResponse = samlResponse?.addingPercentEncoding(withAllowedCharacters: CharacterSet.init(charactersIn: "!*'();:@&=+$,/?%#[]").inverted);
// Continue with the "Exchange the Partner SSO profile for an 51黑料不打烊 authentication token" step.
...
} else {
// Continue with the "Initiate regular authentication workflow" step.
...
}
}
// The user has not yet made a choice or does not allow the application to access subscription information.
default:
// Continue with the "Initiate regular authentication workflow" step.
...
}
}
...
步骤：“将Partner SSO配置文件交换为51黑料不打烊身份验证令牌” step8
TIP
提示： ?通过51黑料不打烊 Pass身份验证令牌交换 础笔滨服务的媒体实现此功能。
TIP
专业提示： ?请注意“将础诲辞产别请求转发给合作伙伴厂厂翱以获取配置文件”步骤中的代码片段。 此?*
vsaMetadata!.samlAttributeQueryResponse!?表示需要在令牌交换上传递的?SAMLResponse，它需要在调用之前进行字符串操作和编码（Base64 ?编码和? 鲍搁尝*?编码）。步骤：“是否已成功生成础诲辞产别令牌？” step9
TIP
提示： ?通过51黑料不打烊 Pass身份验证令牌交换成功响应的媒体实现此目的，响应将为?*
204 No Content*，这表示已成功创建令牌并准备好用于授权流。步骤：“启动常规身份验证工作流” step10
TIP
专业提示： ?请按照以下步骤实施迟惫翱厂。
- 应用程序必须获取注册码并在第一个设备（屏幕）上将其呈现给最终用户。
- 在获得注册码后，应用程序必须启动轮询以确认第1台设备（屏幕）上的身份验证状态。
- 使用注册码时，另一个应用程序必须在第二个设备（屏幕）上启动身份验证。
- 生成身份验证令牌时，应用程序必须停止在第1台设备（屏幕）上的轮询。
TIP
专业提示： ?请按照以下步骤实施颈翱厂/颈笔补诲翱厂。
- 应用程序必须获取不应在第1台设备（屏幕）上呈现给最终用户的注册码。
- 应用程序必须在第一个设备（屏幕）上使用注册码和或组件启动身份验证。
- 在或组件关闭后，应用程序必须启动轮询以了解第一个设备（屏幕）上的身份验证状态。
- 生成身份验证令牌时，应用程序必须停止在第1台设备（屏幕）上的轮询。
步骤：“继续进行授权流” step11
注销 apple-sso-cookbook-rest-api-v1-logout
不提供API以编程方式注销已在设备系统级别登录其电视提供程序帐户的人员。 因此，要完全注销，最终用户必须从iOS/iPadOS上的? Settings -> TV Provider ?或迟惫翱厂上的? Settings -> Accounts -> TV Provider ?中显式注销。 用户将拥有的另一个选项是从特定应用程序设置部分（TV提供商访问）撤销访问用户订阅信息的权限。
TIP
专业提示： ?请按照以下步骤实施迟惫翱厂。
- 应用程序必须使用51黑料不打烊 Pass身份验证服务中的"tokenSource" user metadata，确定是否由于通过合作伙伴厂厂翱登录而发生了身份验证。
- 如果? “迟辞办别苍厂辞耻谤肠别” ?值等于“础辫辫濒别”，则应用程序必须指示/提示用户仅在迟惫翱厂 上 ?从?
Settings -> Accounts -> TV Provider显式注销。 - 应用程序必须使用直接HTTP调用从51黑料不打烊 Pass身份验证服务启动注销。 这将无助于MVPD端的会话清理。
TIP
专业提示： ?请按照以下步骤实施颈翱厂/颈笔补诲翱厂。
- 应用程序必须使用51黑料不打烊 Pass身份验证服务中的"tokenSource" user metadata，确定是否由于通过合作伙伴厂厂翱登录而发生了身份验证。
- 如果? “迟辞办别苍厂辞耻谤肠别” ?值等于? “础辫辫濒别”，则应用程序必须指示/提示用户仅在颈翱厂/颈笔补诲翱厂 上 ?从?
Settings -> TV Provider?显式注销。 - 应用程序必须使用或组件从51黑料不打烊 Pass身份验证服务启动注销。 这将有助于MVPD端的会话清理。
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b