DocumentaciónAdobe PassAdobe Pass Authentication

Flujo de autenticación básico realizado en la aplicación secundaria basic-authentication-flow-performed-within-secondary-application

Last update: Wed Mar 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
IMPORTANT
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.
IMPORTANT
La implementación de la API REST V2 está limitada por la documentación de Mecanismo de limitación.
Related Articles
Asegúrese de visitar también las Preguntas frecuentes sobre la API REST V2.

El flujo de autenticación dentro del derecho de autenticación de Adobe Pass permite que la aplicación de transmisión verifique que un usuario tenga una cuenta de MVPD válida. Este proceso requiere que el usuario tenga una cuenta de MVPD activa e introduzca credenciales de inicio de sesión válidas en la página de inicio de sesión de MVPD.

El flujo de autenticación es necesario en los siguientes casos:

  • Cuando el usuario abre una aplicación por primera vez.
  • Cuando la autenticación anterior del usuario ha caducado.
  • Cuando el usuario cierra la sesión de la cuenta de MVPD.
  • Cuando el usuario desea autenticarse con un MVPD diferente.

En todos estos casos, la aplicación que llama a cualquiera de los extremos de Profiles recibe una respuesta vacía para uno o más perfiles, pero para diferentes MVPD.

El flujo de autenticación requiere que un agente de usuario (explorador) complete una serie de llamadas desde la aplicación al servidor de Adobe Pass, luego a la página de inicio de sesión de MVPD y, finalmente, de nuevo a la aplicación. Este flujo puede incluir varias redirecciones a sistemas de MVPD y la administración de cookies o sesiones almacenadas para cada dominio, lo que puede resultar difícil de lograr y proteger sin un agente de usuario.

En función de las funciones de la aplicación principal (aplicación de streaming) para admitir la interacción del usuario con el fin de seleccionar un MVPD y autenticarse con el MVPD seleccionado en un agente de usuario, los escenarios de autenticación son los siguientes:

Realizar autenticación en la aplicación secundaria con mvpd preseleccionado perform-authentication-within-secondary-application-with-preselected-mvpd

Requisitos previos prerequisites-perform-authentication-within-secondary-application-with-preselected-mvpd

Antes de iniciar el flujo de autenticación dentro de una aplicación principal y finalizarlo mediante la interacción del usuario dentro de una aplicación secundaria, asegúrese de que se cumplan los siguientes requisitos previos:

  • La aplicación de streaming debe seleccionar un MVPD.
  • La aplicación de streaming debe iniciar una sesión de autenticación para iniciar sesión con el MVPD seleccionado.
  • La aplicación secundaria debe autenticarse con el MVPD seleccionado en un agente de usuario.
IMPORTANT
Suposiciones
  • La aplicación de streaming admite la interacción del usuario para seleccionar un MVPD.
  • La aplicación secundaria (normalmente en un dispositivo secundario) admite la interacción del usuario para autenticarse con el MVPD seleccionado en un agente de usuario.

Flujo de trabajo workflow-perform-authentication-within-secondary-application-with-preselected-mvpd

Siga los pasos dados para implementar el flujo de autenticación básico realizado dentro de una aplicación secundaria con una MVPD preseleccionada como se muestra en el diagrama siguiente.

Realizar autenticación en la aplicación secundaria con mvpd preseleccionado

Realizar autenticación en la aplicación secundaria con mvpd preseleccionado

  1. Crear sesión de autenticación: La aplicación de flujo continuo recopila todos los datos necesarios para iniciar una sesión de autenticación llamando al extremo de sesiones.

    note important
    IMPORTANT
    Consulte la documentación de la API Crear sesión de autenticación para obtener detalles sobre:
    • Todos los parámetros requeridos, como serviceProvider, mvpd, domainName y redirectUrl
    • Todos los encabezados necesarios, como Authorization, AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales
    La aplicación de streaming debe proporcionar todos los parámetros necesarios en una sola llamada al crear la sesión de autenticación.

  2. Indique la siguiente acción: La respuesta del extremo de sesiones contiene los datos necesarios para guiar a la aplicación de flujo continuo con respecto a la siguiente acción.

    note important
    IMPORTANT
    Consulte la documentación de la API Crear sesión de autenticación para obtener más información sobre la información proporcionada en una respuesta de sesión.
    El punto final de sesiones valida los datos de solicitud para garantizar que se cumplan las condiciones básicas:
    • Los parámetros y encabezados required deben ser válidos.
    • La integración entre serviceProvider y mvpd proporcionados debe estar activa.
    Si la validación falla, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados.

  3. Continuar con flujos de decisiones: La respuesta del extremo de sesiones contiene los siguientes datos:

    • El atributo actionName está establecido en "authorize".
    • El atributo actionType está establecido en "direct".

    Si el backend de Adobe Pass identifica un perfil válido, la aplicación de streaming no necesita volver a autenticarse con el MVPD seleccionado, ya que ya hay un perfil que se puede utilizar para flujos de decisiones posteriores.

  4. Mostrar código de autenticación: La respuesta del extremo de sesiones contiene los siguientes datos:

    • code que se puede usar para reanudar la sesión de autenticación en una aplicación secundaria.
    • El atributo actionName está establecido en "autenticar".
    • El atributo actionType está establecido en "interactivo".

    Si el servidor de Adobe Pass no identifica un perfil válido, la aplicación de flujo continuo muestra code que se puede usar para reanudar la sesión de autenticación en una aplicación secundaria.

  5. Validar código de autenticación: La aplicación secundaria valida el usuario proporcionado code para asegurarse de que puede continuar con la autenticación de MVPD en el agente de usuario.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar información de sesión de autenticación para obtener detalles sobre:
    • Todos los parámetros necesarios, como serviceProvider y code
    • Todos los encabezados requeridos, como Authorization
    • Todos los parámetros y encabezados opcionales

  6. Devolver información sobre la sesión de autenticación: La respuesta del extremo de sesiones contiene los siguientes datos:

    • El atributo existing contiene los parámetros existentes que ya se proporcionaron.
    • El atributo missing contiene los parámetros que faltan y que deben proporcionarse para completar el flujo de autenticación.
    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar información de sesión de autenticación para obtener más información sobre la información proporcionada en una respuesta de validación de sesión.
    El punto final de sesiones valida los datos de solicitud para garantizar que se cumplan las condiciones básicas:
    • Los parámetros y encabezados required deben ser válidos.
    Si la validación falla, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados.
    note tip
    TIP
    Sugerencia: la aplicación secundaria puede informar a los usuarios de que el code utilizado no es válido en caso de una respuesta de error que indique que falta una sesión de autenticación y aconsejarles que lo reintenten usando uno nuevo.

  7. Abrir URL en el agente de usuario: La aplicación secundaria abre un agente de usuario para cargar el elemento autocalculado url, realizando una solicitud al extremo Authenticate. Este flujo puede incluir varias redirecciones, lo que finalmente lleva al usuario a la página de inicio de sesión de MVPD y proporciona credenciales válidas.

    note important
    IMPORTANT
    Consulte la documentación de la API Realizar autenticación en el agente de usuario para obtener más información sobre:
    • Todos los parámetros necesarios, como serviceProvider y code
    • Todos los parámetros y encabezados opcionales

  8. Autenticación de MVPD completa: Si el flujo de autenticación es correcto, la interacción del agente de usuario guarda un perfil normal en el servidor de Adobe Pass y alcanza el valor de redirectUrl proporcionado.

  9. Recuperar perfil para código específico: La aplicación de flujo continuo recopila todos los datos necesarios para recuperar información de perfil enviando una solicitud al extremo de perfiles.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar perfil para código específico para obtener detalles sobre:
    • Todos los parámetros necesarios, como serviceProvider y code
    • Todos los encabezados necesarios, como Authorization, AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales
    note tip
    TIP
    Sugerencia: la aplicación de streaming puede implementar un mecanismo de sondeo usando code para comprobar si el perfil regular se generó y guardó correctamente.

  10. Devuelve información sobre el perfil normal: La respuesta del extremo de perfiles contiene información sobre el perfil normal asociado a los parámetros y encabezados recibidos.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar perfil para código específico para obtener detalles sobre la información proporcionada en una respuesta de perfil.
    El extremo de perfiles valida los datos de solicitud para garantizar que se cumplan las condiciones básicas:
    • Los parámetros y encabezados required deben ser válidos.
    Si la validación falla, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados.

Realizar autenticación en la aplicación secundaria sin mvpd preseleccionado perform-authentication-within-secondary-application-without-preselected-mvpd

Requisitos previos prerequisites-perform-authentication-within-secondary-application-without-preselected-mvpd

Antes de iniciar el flujo de autenticación dentro de una aplicación principal y finalizarlo mediante la interacción del usuario dentro de una aplicación secundaria, asegúrese de que se cumplan los siguientes requisitos previos:

  • La aplicación de streaming debe iniciar una sesión de autenticación cuando necesite iniciar sesión.
  • La aplicación secundaria debe seleccionar un MVPD.
  • La aplicación secundaria debe autenticarse con el MVPD seleccionado en un agente de usuario.
IMPORTANT
Suposiciones
  • La aplicación secundaria (normalmente en un dispositivo secundario) admite la interacción del usuario para seleccionar una MVPD.
  • La aplicación secundaria (normalmente en un dispositivo secundario) admite la interacción del usuario para autenticarse con el MVPD seleccionado en un agente de usuario.

Flujo de trabajo workflow-perform-authentication-within-secondary-application-without-preselected-mvpd

Siga los pasos dados para implementar el flujo de autenticación básico realizado dentro de una aplicación secundaria sin un MVPD preseleccionado, como se muestra en el diagrama siguiente.

Realizar autenticación en la aplicación secundaria sin mvpd preseleccionado

Realizar autenticación en la aplicación secundaria sin mvpd preseleccionado

  1. Crear sesión de autenticación: La aplicación de flujo continuo recopila algunos de los datos necesarios para iniciar una sesión de autenticación llamando al extremo de sesiones.

    note important
    IMPORTANT
    Consulte la documentación de la API Crear sesión de autenticación para obtener detalles sobre:
    • Todos los parámetros necesarios, como serviceProvider
    • Todos los encabezados necesarios, como Authorization, AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales
    La aplicación de streaming no puede proporcionar todos los parámetros necesarios en una sola llamada al crear la sesión de autenticación.

  2. Indique la siguiente acción: La respuesta del extremo de sesiones contiene los datos necesarios para guiar a la aplicación de flujo continuo con respecto a la siguiente acción:

    • code que se puede usar para reanudar la sesión de autenticación en una aplicación secundaria.
    • El atributo actionName está establecido en "continuar".
    • El atributo actionType está establecido en "direct".
    note important
    IMPORTANT
    Consulte la documentación de la API Crear sesión de autenticación para obtener más información sobre la información proporcionada en una respuesta de sesión.
    El punto final de sesiones valida los datos de solicitud para garantizar que se cumplan las condiciones básicas:
    • Los parámetros y encabezados required deben ser válidos.
    Si la validación falla, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados.

  3. Mostrar código de autenticación: La aplicación de flujo continuo muestra code que se puede usar para reanudar la sesión de autenticación en una aplicación secundaria.

  4. Proporcione parámetros que faltan en la sesión de autenticación: La aplicación secundaria recopila todos los datos que faltan para reanudar la sesión de autenticación y llama al extremo de sesiones.

    note important
    IMPORTANT
    Consulte la documentación de la API Reanudar sesión de autenticación para obtener detalles sobre:
    • Todos los parámetros requeridos, como serviceProvider, mvpd, domainName y redirectUrl
    • Todos los encabezados necesarios, como Authorization, AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales

  5. Indique la siguiente acción: La respuesta del extremo de sesiones contiene los datos necesarios para guiar a la aplicación de flujo continuo con respecto a la siguiente acción.

    note important
    IMPORTANT
    Consulte la documentación de la API Reanudar sesión de autenticación para obtener más información sobre la información proporcionada en una respuesta de sesión.
    El punto final de sesiones valida los datos de solicitud para garantizar que se cumplan las condiciones básicas:
    • Los parámetros y encabezados required deben ser válidos.
    • La integración entre serviceProvider y mvpd proporcionados debe estar activa.
    Si la validación falla, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados.
    note tip
    TIP
    Sugerencia: la aplicación secundaria puede informar a los usuarios de que el code utilizado no es válido en caso de una respuesta de error que indique que falta una sesión de autenticación y aconsejarles que lo reintenten usando uno nuevo.

  6. Indique el perfil existente: La respuesta del extremo de sesiones contiene los siguientes datos:

    • El atributo actionName está establecido en "authorize".
    • El atributo actionType está establecido en "direct".

    Si el backend de Adobe Pass identifica un perfil válido, la aplicación de streaming no necesita volver a autenticarse con el MVPD seleccionado, ya que ya hay un perfil que se puede utilizar para flujos de decisiones posteriores.

  7. Abrir URL en el agente de usuario: La respuesta del extremo de sesiones contiene los siguientes datos:

    • url que se puede usar para iniciar la autenticación interactiva en la página de inicio de sesión de MVPD.
    • El atributo actionName está establecido en "autenticar".
    • El atributo actionType está establecido en "interactivo".

    Si el backend de Adobe Pass no identifica un perfil válido, la aplicación secundaria abre un agente de usuario para cargar el url proporcionado, realizando una solicitud al extremo Authenticate. Este flujo puede incluir varias redirecciones, lo que finalmente lleva al usuario a la página de inicio de sesión de MVPD y proporciona credenciales válidas.

  8. Autenticación de MVPD completa: Si el flujo de autenticación es correcto, la interacción del agente de usuario guarda un perfil normal en el servidor de Adobe Pass y alcanza el valor de redirectUrl proporcionado.

  9. Recuperar perfil para código específico: La aplicación de flujo continuo recopila todos los datos necesarios para recuperar información de perfil enviando una solicitud al extremo de perfiles.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar perfil para código específico para obtener detalles sobre:
    • Todos los parámetros necesarios, como serviceProvider y code
    • Todos los encabezados necesarios, como Authorization, AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales
    note tip
    TIP
    Sugerencia: la aplicación de streaming puede implementar un mecanismo de sondeo usando code para comprobar si el perfil regular se generó y guardó correctamente.

  10. Devuelve información sobre el perfil normal: La respuesta del extremo de perfiles contiene información sobre el perfil normal asociado a los parámetros y encabezados recibidos.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar perfil para código específico para obtener detalles sobre la información proporcionada en una respuesta de perfil.
    El extremo de perfiles valida los datos de solicitud para garantizar que se cumplan las condiciones básicas:
    • Los parámetros y encabezados required deben ser válidos.
    Si la validación falla, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b