DocumentaciónAdobe PassAdobe Pass Authentication

Flujos de acceso degradados degraded-access-flows

Last update: Mon Aug 05 2024 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.

La degradación proporciona la omisión temporal de extremos de autenticación y autorización de MVPD específicos. Normalmente, el programador inicia esta acción, pero independientemente de quién déclencheur un evento de degradación, la acción depende de los acuerdos previos realizados con las MVPD afectadas.

Para obtener más información sobre la característica de degradación, consulte la documentación de Degradación.

Los flujos de acceso degradados le permiten consultar los siguientes escenarios:

Realizar autenticación mientras se aplica la degradación perform-authentication-while-degradation-is-applied

Requisitos previos prerequisites-perform-authentication-while-degradation-is-applied

Antes de realizar el flujo de autenticación mientras se aplica la degradación, 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 con la MVPD.
IMPORTANT
Suposiciones
  • La aplicación de streaming no tiene un perfil válido para ese MVPD específico guardado en el backend de Adobe Pass.
  • Hay una regla de degradación AuthNAll aplicada a la integración entre los serviceProvider y mvpd proporcionados.

Flujo de trabajo workflow-perform-authentication-while-degradation-is-applied

Siga los pasos dados para implementar el flujo de autenticación mientras se aplica la degradación como se muestra en el diagrama siguiente.

Realizar autenticación mientras se aplica la degradación

Realizar autenticación mientras se aplica la degradación

  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 y AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales

  2. Comprobar reglas de degradación: El servidor de Adobe Pass comprueba si hay una regla de degradación AuthNAll aplicada a la integración entre los serviceProvider y mvpd proporcionados.

  3. 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:

    • El atributo actionName está establecido en "authorize".
    • 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.
    • La integración entre serviceProvider y mvpd proporcionados debe estar activa.
    Si la validación básica 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.
    El extremo de sesiones utiliza los datos de solicitud para comprobar si se cumplen las condiciones de acceso degradado:
    • La integración entre serviceProvider y mvpd proporcionados debe tener aplicada una regla de degradación AuthNAll.
    Si la validación del acceso degradado falla, la respuesta se establecerá de forma predeterminada en el flujo de autenticación básico.

  4. Continúe con los flujos de decisiones: La aplicación de transmisión puede continuar con los flujos de decisiones subsiguientes.

Recuperar decisiones de autorización mientras se aplica la degradación retrieve-authorization-decisions-while-degradation-is-applied

Requisitos previos prerequisites-retrieve-authorization-decisions-while-degradation-is-applied

Antes de recuperar las decisiones de autorización mientras se aplica la degradación, asegúrese de que se cumplen los siguientes requisitos previos:

  • La aplicación de streaming debe recuperar una decisión de autorización antes de reproducir un recurso seleccionado por el usuario.
IMPORTANT
Suposiciones
  • La aplicación de streaming no tiene un perfil válido para ese MVPD específico.
  • Hay una regla de degradación AuthZAll o AuthNAll aplicada a la integración entre los serviceProvider y mvpd proporcionados.

Flujo de trabajo workflow-retrieve-authorization-decisions-while-degradation-is-applied

Siga los pasos dados para implementar el flujo de autorización mientras se aplica la degradación como se muestra en el diagrama siguiente.

Recuperar decisiones de autorización mientras se aplica la degradación

Recuperar decisiones de autorización mientras se aplica la degradación

  1. Recuperar decisión de autorización: La aplicación de streaming recopila todos los datos necesarios para obtener una decisión de autorización para un recurso específico llamando al extremo Decisions Authorize.

    note important
    IMPORTANT
    Consulte Recuperar decisiones de autorización utilizando la documentación específica de la API mvpd para obtener más información sobre:
    • Todos los parámetros necesarios, como serviceProvider, mvpd y resources
    • Todos los encabezados necesarios, como Authorization y AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales

  2. Comprobar reglas de degradación: El servidor de Adobe Pass comprueba si hay una regla de degradación AuthZAll o AuthNAll aplicada a la integración entre serviceProvider y mvpd proporcionados.

  3. Devuelve la decisión Permit con el token de medios: La respuesta del extremo de autorización de decisiones contiene una decisión Permit y un token de medios.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar decisiones de autorización utilizando mvpd específica para obtener más información sobre la información proporcionada en una respuesta de decisión.
    El punto de conexión de autorización de decisiones valida los datos de solicitud para garantizar que se cumplen 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 básica 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.
    El extremo de autorización de decisiones utiliza los datos de solicitud para comprobar si se cumplen las condiciones de acceso degradado:
    • La integración entre serviceProvider y mvpd proporcionados debe tener aplicada una regla de degradación AuthZAll o AuthNAll.
    Si la validación del acceso degradado falla, la respuesta se establecerá de forma predeterminada en el flujo de autorización básico.

  4. Iniciar flujo con token de medios: La aplicación de flujo usa el token de medios para reproducir el contenido.

Recuperar decisiones de preautorización mientras se aplica la degradación retrieve-preauthorization-decisions-while-degradation-is-applied

Requisitos previos prerequisites-retrieve-preauthorization-decisions-while-degradation-is-applied

Antes de recuperar las decisiones de preautorización mientras se aplica la degradación, asegúrese de que se cumplen los siguientes requisitos previos:

  • La aplicación de streaming desea recuperar las decisiones de preautorización para mostrar una lista de recursos junto con sus estados asociados.
IMPORTANT
Suposiciones
  • La aplicación de streaming no tiene un perfil válido para ese MVPD específico.
  • Hay una regla de degradación AuthZAll o AuthNAll aplicada a la integración entre los serviceProvider y mvpd proporcionados.

Flujo de trabajo workflow-retrieve-preauthorization-decisions-while-degradation-is-applied

Siga los pasos dados para implementar el flujo de preautorización mientras se aplica la degradación como se muestra en el diagrama siguiente.

Recuperar decisiones de preautorización mientras se aplica la degradación

Recuperar decisiones de preautorización mientras se aplica la degradación

  1. Recuperar decisiones de preautorización: La aplicación de streaming recopila todos los datos necesarios para obtener decisiones de preautorización para una lista de recursos llamando al extremo Decisions Preauthorize.

    note important
    IMPORTANT
    Consulte Recuperar decisiones de preautorización utilizando la documentación específica de la API mvpd para obtener más información sobre:
    • Todos los parámetros necesarios, como serviceProvider, mvpd y resources
    • Todos los encabezados necesarios, como Authorization y AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales

  2. Comprobar reglas de degradación: El servidor de Adobe Pass comprueba si hay una regla de degradación AuthZAll o AuthNAll aplicada a la integración entre serviceProvider y mvpd proporcionados.

  3. Devolver decisiones de preautorización: La respuesta de extremo de preautorización de Decisions contiene una decisión Permit para cada recurso.

    note important
    IMPORTANT
    Consulte Recuperar decisiones de preautorización utilizando la documentación específica de la API mvpd para obtener más información sobre la información proporcionada en una respuesta de decisión.
    El extremo de preautorización de Decisions valida los datos de solicitud para garantizar que se cumplen 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 básica 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.
    El extremo de preautorización de Decisions utiliza los datos de solicitud para comprobar si se cumplen las condiciones de acceso degradado:
    • La integración entre serviceProvider y mvpd proporcionados debe tener aplicada una regla de degradación AuthZAll o AuthNAll.
    Si la validación del acceso degradado falla, la respuesta se establecerá de forma predeterminada en el flujo de preautorización básico.

  4. Controlar decisiones de preautorización: La aplicación de transmisión procesa la respuesta y puede utilizarla para mostrar opcionalmente el estado apropiado para cada recurso en la interfaz de usuario.

Recuperar perfil mientras se aplica degradación retrieve-profile-while-degradation-is-applied

IMPORTANT
La consulta del extremo de perfiles es opcional mientras se aplica la degradación.
La respuesta de extremo de sesiones indica a la aplicación que continúe con los flujos de decisiones mientras se aplica la degradación. Para obtener más información, consulte la sección Realizar autenticación mientras se aplica la degradación.

Requisitos previos prerequisites-retrieve-profile-while-degradation-is-applied

Antes de recuperar el perfil de una MVPD específica mientras se aplica la degradación, asegúrese de que se cumplen los siguientes requisitos previos:

  • La aplicación de streaming, que tiene un identificador mvpd seleccionado o almacenado en caché, desea recuperar el perfil de una MVPD específica.
IMPORTANT
Suposiciones
  • La aplicación de streaming no tiene un perfil válido para ese MVPD específico.
  • Hay una regla de degradación AuthNAll aplicada a la integración entre los serviceProvider y mvpd proporcionados.

Flujo de trabajo workflow-retrieve-profile-while-degradation-is-applied

Siga los pasos dados para implementar el flujo de recuperación de perfiles para una MVPD específica mientras se aplica la degradación como se muestra en el diagrama siguiente.

Recuperar perfil mientras se aplica la degradación

Recuperar perfil mientras se aplica la degradación

  1. Recuperar perfil para mvpd específico: La aplicación de streaming recopila todos los datos necesarios para recuperar información de perfil para esa MVPD específica enviando una solicitud al extremo de perfiles.

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar perfil para mvpd específica para obtener más información sobre lo siguiente:
    • Todos los parámetros necesarios, como serviceProvider y mvpd
    • Todos los encabezados necesarios, como Authorization y AP-Device-Identifier
    • Todos los parámetros y encabezados opcionales

  2. Comprobar reglas de degradación: El servidor de Adobe Pass comprueba si hay una regla de degradación AuthNAll aplicada a la integración entre los serviceProvider y mvpd proporcionados.

  3. Devolver información sobre el perfil degradado: La respuesta del extremo de perfiles contiene información sobre el perfil degradado, incluido el atributo type establecido como "degradado".

    note important
    IMPORTANT
    Consulte la documentación de la API Recuperar perfil para mvpd específica para obtener más información 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.
    • La integración entre serviceProvider y mvpd proporcionados debe estar activa.
    Si la validación básica 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.
    El extremo de perfiles utiliza los datos de solicitud para comprobar si se cumplen las condiciones de acceso degradado:
    • La integración entre serviceProvider y mvpd proporcionados debe tener aplicada una regla de degradación AuthNAll.
    Si la validación del acceso degradado falla, la respuesta se establecerá de forma predeterminada en el flujo básico de recuperación de perfiles.

  4. Continúe con los flujos de decisiones: Si la respuesta del extremo de perfiles contiene un perfil, la aplicación de transmisión utiliza la información del perfil degradado para continuar con los flujos de decisiones subsiguientes.

  5. Indique un nuevo flujo de autenticación básico: Si la respuesta del extremo de perfiles no contiene un perfil, la aplicación de transmisión indica al usuario que inicie un nuevo flujo de autenticación básico.

NOTE
Los pasos del flujo de recuperación de perfiles para un código de autenticación específico son los mismos que los indicados arriba, excepto que el punto final utilizado es el descrito en la documentación de Recuperar perfil para un código específico.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b