DocumentaciónAdobe PassAdobe Pass Authentication

Información general sobre Apple SSO apple-sso-overview

Last update: Wed Sep 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
El contenido de esta página se proporciona únicamente con fines informativos. El uso de esta API requiere una licencia actual de Adobe. No se permite el uso no autorizado.

Introducción Introduction

Apple proporciona una API que permite a las personas iniciar sesión en su cuenta de proveedor de TV en el nivel de sistema del dispositivo, lo que elimina la necesidad de autenticarse aplicación por aplicación.

Por lo tanto, Apple y Autenticación de Adobe Pass se asociaron para crear la experiencia de usuario de inicio de sesión único (SSO) de plataforma en el ecosistema de TV en todas partes para propietarios de iPhone, iPad y Apple TV.

Para beneficiarse de la experiencia de usuario de inicio de sesión único (SSO) en un dispositivo Apple, existe una lista de requisitos previos que deben completarse.

Requisitos previos Prerequisites

Los requisitos previos pueden aplicarse a una o varias entidades involucradas en el negocio de TVE, como programadores, MVPD, autenticación de Adobe Pass o Apple.

Programador Programmer

Para beneficiarse de la experiencia de usuario de inicio de sesión único (SSO), un programador debe:

  1. Utilice al menos la versión 8 de Xcode y la versión 10 de iOS/tvOS.

  2. Tener el Derecho de inicio de sesión único de suscriptor de vídeo configurado en su cuenta de desarrollador de Apple. Póngase en contacto con Apple para habilitar Marco de cuenta de suscriptor de vídeo para su ID de equipo de Apple.

  3. Habilite el inicio de sesión único (SÍ) para cada integración deseada (Canal x MVPD) y plataforma deseada (iOS/tvOS) a través del Tablero de Adobe Primetime TVE.

  4. Integre los flujos de trabajo de SSO de Apple con una de las dos soluciones siguientes que ofrece el equipo de autenticación de Adobe Pass:

    • La API de REST de autenticación de Adobe Pass puede admitir la autenticación de inicio de sesión único (SSO) de plataforma para los usuarios finales de aplicaciones cliente que se ejecuten en iOS, iPadOS o tvOS. Consulte también Guía de Apple SSO (API de REST).

    • El SDK de Adobe Pass Authentication AccessEnabler de iOS/tvOS puede admitir la autenticación de inicio de sesión único (SSO) de la plataforma para los usuarios finales de aplicaciones cliente que se ejecuten en iOS, iPadOS o tvOS. Consulte también Guía de Apple SSO (SDK de iOS/tvOS).

    • Sugerencia profesional: Para tener acceso a la información de suscripción del usuario, el usuario debe dar permiso a la aplicación para continuar, de forma similar a proporcionar acceso a la cámara o al micrófono del dispositivo. Este permiso debe solicitarse por aplicación y el dispositivo guardará la selección del usuario. Tenga en cuenta que el usuario puede cambiar su decisión en la configuración de la aplicación (acceso al permiso del proveedor de TV) o en la sección de Settings -> TV Provider en iOS/iPadOS o Settings -> Accounts -> TV Provider en tvOS.

    • Sugerencia profesional: Se recomienda solicitar el permiso del usuario cuando la aplicación entre en el estado en primer plano, pero es solo una sugerencia, ya que la aplicación puede buscar permiso para acceder a la información de suscripción del usuario en cualquier momento antes de requerir la autenticación del usuario. Además, las API del SDK de iOS/tvOS de AccessEnabler solicitarán automáticamente el permiso del usuario cuando lo necesite.

    • Sugerencia profesional: Recomendamos incentivar a los usuarios que se nieguen a dar permiso para acceder a la información de suscripción explicando las ventajas de la experiencia del usuario de inicio de sesión único (SSO). Tenga en cuenta que el usuario puede cambiar su decisión en la configuración de la aplicación (acceso al permiso del proveedor de TV) o en la sección de Settings -> TV Provider en iOS/iPadOS o Settings -> Accounts -> TV Provider en tvOS.

El resultado debe crear una experiencia en línea con los siguientes flujos de usuarios, que le sugerimos consultar antes de comenzar a desarrollar su aplicación o aplicaciones:

IMPORTANT
Cuando la característica de inicio de sesión único es activado para iOS/tvOS y en el caso de Apple incorporado (compatible) o selector MVPD: los flujos de autenticación/cierre de sesión de los flujos de trabajo de SSO de Apple implicarán soluciones de autenticación de Apple y Adobe Pass, mientras que el resto de flujos (autorización, preautorización, metadatos, etc.) será atendido únicamente por Autenticación de Adobe Pass.
IMPORTANT
Cuando la característica de inicio de sesión único es inhabilitado para iOS/tvOS o en el caso de Apple no incorporado (no compatible) MVPD: los flujos de autenticación/cierre de sesión se revertirán de los flujos de trabajo de SSO de Apple a los regulares a los que solo sirve la autenticación de Adobe Pass.
IMPORTANT
Una ganancia principal del flujo de trabajo de SSO de Apple se representa mediante el flujo de usuario de autenticación en una pantalla, que también se puede entregar en Apple TV cuando la función de inicio de sesión único está activado para tvOS y en el caso de Apple Integrado (compatible) MVPD.

MVPD MVPD

Para beneficiarse de la experiencia del usuario de inicio de sesión único (SSO), una MVPD debe:

  1. Incorpórese al flujo de trabajo de SSO de Apple del lado de Apple. Póngase en contacto con Apple para facilitar el proceso de incorporación.
  2. Proporcionar una aplicación TVML de JavaScript capaz de gestionar el formulario de inicio de sesión del usuario. Póngase en contacto con Apple para recibir la documentación adecuada.
  3. Proporcione un valor de cadena que represente el identificador de proveedor asignado por Apple durante el proceso de incorporación. Póngase en contacto con Autenticación de Adobe Pass para realizar cambios en la configuración.

FAQ FAQ

  1. En caso de que algo salga mal con el flujo de trabajo de SSO de Apple, ¿puede la aplicación que utiliza el SDK de AccessEnabler para iOS/tvOS tener la capacidad de volver al flujo de autenticación normal?

    • Esto es posible, pero requiere que se realice un cambio de configuración en Tablero de Adobe Primetime TVE. El Habilitar inicio de sesión único debe estar configurado en NO para la integración deseada (Canal x MVPD) y la plataforma deseada (iOS/tvOS).
    • La aplicación reconocería el cambio de configuración solo después de llamar a setRequestor API en caso de que utilice el SDK de AccessEnabler para iOS/tvOS.

  2. ¿Sabrá la aplicación cuándo se ha producido una autenticación como resultado de un inicio de sesión a través del SSO de la plataforma en otro dispositivo u otra aplicación?

    • Esta información no estará disponible.

  3. ¿Sabrá la aplicación cuándo se ha producido una autenticación como resultado de un inicio de sesión a través del SSO de plataforma en el mismo dispositivo?

    • Esta información está disponible como parte de la clave de metadatos del usuario: tokenSource, que debería devolver el valor de cadena: "Apple" en este caso.

  4. Qué sucede si un usuario inicia sesión en yendo a Settings -> TV Provider en iOS/iPadOS o Settings -> Accounts -> TV Provider en la sección tvOS que utiliza una MVPD que no está integrada con la aplicación?

    • Cuando el usuario inicia la aplicación, no se autentica mediante el flujo de trabajo de SSO de Apple. Por lo tanto, la aplicación tendría que volver al flujo de autenticación normal y presentar su propio selector de MVPD.

  5. Qué sucede si un usuario inicia sesión en yendo a Settings -> TV Provider en iOS/iPadOS o Settings -> Accounts -> TV Provider en la sección de tvOS que utiliza una MVPD que tiene el Habilitar inicio de sesión único establecer en NO en el Tablero de Adobe Primetime TVE para la plataforma iOS/tvOS?

    • Cuando el usuario inicia la aplicación, no se autentica mediante el flujo de trabajo de SSO de Apple. Por lo tanto, la aplicación tendría que volver al flujo de autenticación normal y presentar su propio selector de MVPD.

  6. ¿Qué sucede si un usuario tiene una MVPD que no está integrada (no es compatible) en Apple, pero está presente en el selector de Apple?

    • Cuando el usuario inicia la aplicación, solo selecciona la MVPD mediante el flujo de trabajo de SSO de Apple sin completar el flujo de autenticación. Por lo tanto, la aplicación tendría que volver al flujo de autenticación normal, pero podría utilizar la MVPD ya seleccionada.

  7. ¿Qué sucede si un usuario tiene una MVPD que no está integrada (no es compatible) en Apple?

    • Cuando el usuario inicia la aplicación, selecciona la opción de selector "Otros proveedores de TV" mediante el flujo de trabajo de SSO de Apple. Por lo tanto, la aplicación tendría que volver al flujo de autenticación normal y presentar su propio selector de MVPD.

  8. Qué sucede si un usuario tiene una MVPD que se degrada a través del medio de Tablero de Adobe Primetime TVE?

    • Cuando el usuario inicia la aplicación, se autentica mediante el mecanismo de degradación y no mediante el flujo de trabajo de SSO de Apple.
    • La experiencia debe ser perfecta para el usuario, mientras que la aplicación será informada a través de la N010 código de advertencia en caso de que utilice el SDK de AccessEnabler para iOS/tvOS.

  9. ¿Cambiará el ID de usuario de MVPD entre el SSO de Apple y el flujo de autenticación SSO que no es de Apple?

    • Se espera que el ID de usuario no cambie, pero debe verificarse para cada proveedor seleccionado.

  10. ¿Habrá algún cambio en los TTL de autenticación?

    • La autenticación de Adobe Pass seguirá respetando los TTL requeridos por los programadores para su integración con cada MVPD.
    • Al navegar de una aplicación de Programador a otra aplicación de Programador a través de Apple SSO, la segunda aplicación tendrá el TTL de su integración correspondiente de Programador x MVPD (no compartirá el TTL de la primera aplicación que se autentica)
TTL de autenticación de Adobe Pass caducado
TTL de autenticación de Adobe Pass válido
TTL de token de dispositivo de Apple caducado
el usuario NO está autenticado (debería aparecer el selector de MVPD)
El usuario se autentica y el TTL es el tiempo restante de su token de autenticación de Adobe Pass
TTL de token de dispositivo de Apple válido
El usuario de se autentica de forma silenciosa y obtiene otro token de autenticación de Adobe Pass con el TTL especificado en el Tablero de TVE
El usuario se autentica y el TTL es el tiempo restante de su token de autenticación de Adobe Pass
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b