Flujos de acceso temporales temporary-access-flows
TempPass permite a los programadores proporcionar acceso temporal a su contenido protegido sin pedir a los usuarios que se autentiquen con una cuenta MVPD válida.
Para obtener más información sobre la característica TempPass, consulte la documentación de TempPass.
Los flujos de acceso temporales le permiten consultar los siguientes escenarios:
- Recuperar decisiones de autorización utilizando TempPass básico
- Recuperar decisiones de autorización mediante TempPass promocional
- Consumir el número máximo de recursos mediante TempPass promocional
- Recuperar decisiones de autorización cuando caduca el TempPass básico o promocional
- Recuperar perfil para TempPass básico
- Recuperar perfil para TempPass promocional
Recuperar decisiones de autorización utilizando TempPass básico retrieve-authorization-decisions-using-basic-temppass
Requisitos previos prerequisites-retrieve-authorization-decisions-using-basic-temppass
Antes de recuperar las decisiones de autorización utilizando TempPass básico, asegúrese de que se cumplan los siguientes requisitos previos:
- La aplicación de streaming quiere proporcionar acceso temporal para reproducir contenido sin pedir al usuario que se autentique.
- La aplicación de streaming debe recuperar una decisión de autorización antes de reproducir un recurso seleccionado por el usuario.
- Debe haber una configuración válida de TempPass básico aplicado a la integración entre los
serviceProvider
ymvpd
proporcionados. - El tiempo de vida (TTL) configurado para el TempPass básico no ha caducado.
Flujo de trabajo workflow-retrieve-authorization-decisions-using-basic-temppass
Siga los pasos dados para implementar el flujo de autorización utilizando TempPass básico, como se muestra en el diagrama siguiente.
Recuperar decisiones de autorización utilizando TempPass básico
-
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
yresources
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
- Todos los parámetros necesarios, como
-
Validar TempPass básico: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass básico aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devuelve la decisión
Permit
con el token de medios: La respuesta del extremo de autorización de decisiones contiene una decisiónPermit
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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para TempPass básico no debe caducar.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
Iniciar flujo con token de medios: La aplicación de flujo usa el token de medios para reproducir el contenido.
Recuperar decisiones de autorización mediante TempPass promocional retrieve-authorization-decisions-using-promotional-temppass
Requisitos previos prerequisites-retrieve-authorization-decisions-using-promotional-temppass
Antes de recuperar las decisiones de autorización mediante TempPass promocional, asegúrese de que se cumplan los siguientes requisitos previos:
- La aplicación de streaming desea proporcionar acceso temporal para reproducir un número máximo de recursos sin solicitar al usuario que se autentique.
- La aplicación de streaming debe incluir información única sobre la identidad del usuario al recuperar una decisión de autorización.
- La aplicación de streaming debe recuperar una decisión de autorización antes de reproducir un recurso seleccionado por el usuario.
- Debe haber una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. - El tiempo de vida (TTL) configurado para el TempPass promocional no ha caducado.
- No se ha consumido el número máximo de recursos configurados para el TempPass promocional.
Flujo de trabajo workflow-retrieve-authorization-decisions-using-promotional-temppass
Siga los pasos dados para implementar el flujo de autorización mediante TempPass promocional, como se muestra en el diagrama siguiente.
Recuperar decisiones de autorización mediante TempPass promocional
-
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
yresources
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
El extremo Decisions Authorize requiere la presencia del encabezado AP-TempPass-Identity
al utilizar TempPass promocional. El encabezado incluye información única sobre la identidad del usuario que accede al contenido.Para obtener más información sobre el encabezado AP-TempPass-Identity
, consulte la documentación de AP-TempPass-Identity. - Todos los parámetros necesarios, como
-
Validar TempPass promocional: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devuelve la decisión
Permit
con el token de medios: La respuesta del extremo de autorización de decisiones contiene una decisiónPermit
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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para el TempPass promocional no debe caducar.
- No se debe consumir el número máximo de recursos configurados para el TempPass promocional.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
Iniciar flujo con token de medios: La aplicación de flujo usa el token de medios para reproducir el contenido.
Consumir el número máximo de recursos mediante TempPass promocional consume-maximum-number-of-resources-using-promotional-temppass
Requisitos previos prerequisites-consume-maximum-number-of-resources-using-promotional-temppass
Antes de consumir un número máximo de recursos con TempPass promocional, asegúrese de que se cumplan los siguientes requisitos previos:
- La aplicación de streaming desea proporcionar acceso temporal para reproducir un número máximo de recursos sin solicitar al usuario que se autentique.
- La aplicación de streaming debe incluir información única sobre la identidad del usuario al recuperar una decisión de autorización.
- La aplicación de streaming debe recuperar una decisión de autorización antes de reproducir un recurso seleccionado por el usuario.
- Debe haber una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. - El tiempo de vida (TTL) configurado para el TempPass promocional no ha caducado.
- El número máximo de recursos configurados para el TempPass promocional es 1.
Flujo de trabajo workflow-consume-maximum-number-of-resources-using-promotional-temppass
Siga los pasos dados para implementar el flujo de autorización al consumir un número máximo de recursos mediante TempPass promocional, como se muestra en el diagrama siguiente.
Consumir el número máximo de recursos mediante TempPass promocional
-
Recuperar perfil para TempPass promocional: La aplicación de streaming recopila todos los datos necesarios para recuperar información de perfil para TempPass promocional 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
ymvpd
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
La consulta de extremo de perfiles es opcional y se puede utilizar para determinar cuántos recursos se pueden seguir reproduciendo con el TempPass promocional. - Todos los parámetros necesarios, como
-
Validar TempPass promocional: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devuelve información sobre el perfil temporal: La respuesta del extremo de perfiles contiene información sobre el perfil temporal, incluido el atributo
type
establecido como "temporal".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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para el TempPass promocional no debe caducar.
- No se debe consumir el número máximo de recursos configurados para el TempPass promocional.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
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 de perfil temporal para continuar con los flujos de decisiones subsiguientes.
-
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
yresources
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
El extremo Decisions Authorize requiere la presencia del encabezado AP-TempPass-Identity
al utilizar TempPass promocional. El encabezado incluye información única sobre la identidad del usuario que accede al contenido.Para obtener más información sobre el encabezado AP-TempPass-Identity
, consulte la documentación de AP-TempPass-Identity. - Todos los parámetros necesarios, como
-
Validar TempPass promocional: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devuelve la decisión
Permit
con el token de medios: La respuesta del extremo de autorización de decisiones contiene una decisiónPermit
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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para el TempPass promocional no debe caducar.
- No se debe consumir el número máximo de recursos configurados para el TempPass promocional.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
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
yresources
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
El extremo Decisions Authorize requiere la presencia del encabezado AP-TempPass-Identity
al utilizar TempPass promocional. El encabezado incluye información única sobre la identidad del usuario que accede al contenido.Para obtener más información sobre el encabezado AP-TempPass-Identity
, consulte la documentación de AP-TempPass-Identity. - Todos los parámetros necesarios, como
-
Validar TempPass promocional: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devolver
Deny
decisión con detalles: La respuesta de extremo de autorización de decisiones contiene una decisiónDeny
y una carga de error que se adhiere a la documentación de Códigos de error mejorados.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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para el TempPass promocional no debe caducar.
- No se debe consumir el número máximo de recursos configurados para el TempPass promocional.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
Controlar los detalles de la decisión
Deny
: La aplicación de transmisión procesa la información de error de la respuesta y puede utilizarla para mostrar opcionalmente un mensaje específico en la interfaz de usuario.note tip TIP Sugerencia: La aplicación de streaming puede informar a los usuarios de que se ha superado el número máximo de recursos y aconsejarles que inicien un flujo de autenticación básico con una MVPD normal para seguir viendo.
Recuperar decisiones de autorización cuando caduca el TempPass básico o promocional retrieve-authorization-decisions-when-basic-or-promotional-temppass-expires
Requisitos previos prerequisites-retrieve-authorization-decisions-when-basic-or-promotional-temppass-expires
Antes de recuperar las decisiones de autorización cuando caduque TempPass básico o promocional, asegúrese de que se cumplan los siguientes requisitos previos:
- Debe haber una configuración válida de TempPass básico o promocional aplicado a la integración entre el
serviceProvider
proporcionado y elmvpd
. - El tiempo de vida (TTL) configurado para el básico o promocional: se ha superado el límite de duración de acceso temporal.
Flujo de trabajo workflow-retrieve-authorization-decisions-when-basic-or-promotional-temppass-expires
Siga los pasos dados para implementar el flujo de autorización cuando caduque TempPass básico o promocional, como se muestra en el diagrama siguiente.
Recuperar decisiones de autorización cuando caduca TempPass básico o promocional
-
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
yresources
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
El extremo Decisions Authorize requiere la presencia del encabezado AP-TempPass-Identity
al utilizar TempPass promocional. El encabezado incluye información única sobre la identidad del usuario que accede al contenido.Para obtener más información sobre el encabezado AP-TempPass-Identity
, consulte la documentación de AP-TempPass-Identity. - Todos los parámetros necesarios, como
-
Validar TempPass básico o promocional: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass básico o promocional aplicado a la integración entre
serviceProvider
ymvpd
proporcionados. -
Devolver
Deny
decisión con detalles: La respuesta de extremo de autorización de decisiones contiene una decisiónDeny
y una carga de error que se adhiere a la documentación de Códigos de error mejorados.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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para el TempPass básico o promocional no debe caducar.
- No se debe consumir el número máximo de recursos configurados para el TempPass promocional.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
Controlar los detalles de la decisión
Deny
: La aplicación de transmisión procesa la información de error de la respuesta y puede utilizarla para mostrar opcionalmente un mensaje específico en la interfaz de usuario.note tip TIP Sugerencia: La aplicación de streaming puede informar a los usuarios de que el acceso temporal ha caducado y aconsejarles que inicien un flujo de autenticación básico mediante una MVPD normal para seguir viendo.
Recuperar perfil para TempPass básico retrieve-profile-for-basic-temppass
Requisitos previos prerequisites-retrieve-profile-for-basic-temppass
Antes de recuperar el perfil para TempPass básico, asegúrese de que se cumplan los siguientes requisitos previos:
- La aplicación de streaming desea recuperar el perfil temporal para garantizar que el acceso temporal no haya caducado.
- Debe haber una configuración válida de TempPass básico aplicado a la integración entre los
serviceProvider
ymvpd
proporcionados. - El tiempo de vida (TTL) configurado para TempPass básico no debe caducar.
Flujo de trabajo workflow-retrieve-profile-information-for-basic-temppass
Siga los pasos dados para implementar el flujo de recuperación de perfiles para TempPass básico, como se muestra en el siguiente diagrama.
Recuperar perfil para TempPass básico
-
Recuperar perfil para TempPass básico: La aplicación de streaming recopila todos los datos necesarios para recuperar información de perfil para TempPass básico enviando una solicitud al extremo Profiles.
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
ymvpd
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
- Todos los parámetros necesarios, como
-
Validar TempPass básico: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass básico aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devuelve información sobre el perfil temporal: La respuesta del extremo de perfiles contiene información sobre el perfil temporal, incluido el atributo
type
establecido como "temporal".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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para TempPass básico no debe caducar.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
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 de perfil temporal para continuar con los flujos de decisiones subsiguientes.
Recuperar perfil para TempPass promocional retrieve-profile-for-promotional-temppass
Requisitos previos prerequisites-retrieve-profile-for-promotional-temppass
Antes de recuperar el perfil para TempPass promocional, asegúrese de que se cumplan los siguientes requisitos previos:
- La aplicación de streaming desea recuperar el perfil temporal para asegurarse de que el acceso temporal no haya caducado o para determinar cuántos recursos se pueden reproducir.
- Debe haber una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. - El tiempo de vida (TTL) configurado para el TempPass promocional no ha caducado.
- No se ha consumido el número máximo de recursos configurados para el TempPass promocional.
Flujo de trabajo workflow-retrieve-profile-information-for-promotional-temppass
Siga los pasos dados para implementar el flujo de recuperación de perfiles para TempPass promocional, como se muestra en el siguiente diagrama.
Recuperar perfil para TempPass promocional
-
Recuperar perfil para TempPass promocional: La aplicación de streaming recopila todos los datos necesarios para recuperar información de perfil para TempPass promocional 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
ymvpd
- Todos los encabezados necesarios, como
Authorization
yAP-Device-Identifier
- Todos los parámetros y encabezados opcionales
- Todos los parámetros necesarios, como
-
Validar TempPass promocional: El servidor de Adobe Pass comprueba si hay una configuración válida de TempPass promocional aplicada a la integración entre los
serviceProvider
ymvpd
proporcionados. -
Devuelve información sobre el perfil temporal: La respuesta del extremo de perfiles contiene información sobre el perfil temporal, incluido el atributo
type
establecido como "temporal".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
ymvpd
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 temporales: - El tiempo de vida (TTL) configurado para el TempPass promocional no debe caducar.
- No se debe consumir el número máximo de recursos configurados para el TempPass promocional.
Si falla la validación temporal del acceso, se generará una respuesta de error, que proporcionará información adicional que se ajustará a la documentación de Códigos de error mejorados. -
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 de perfil temporal para continuar con los flujos de decisiones subsiguientes.