DocumentaciónAdobe PassAdobe Pass Authentication

Referencia de API de SDK para Android android-sdk-api-reference

Last update: Wed Jul 31 2024 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 intro

Este documento detalla los métodos y las llamadas de retorno expuestos por el SDK de Android para la autenticación de Adobe Pass, compatible con las versiones de autenticación de Adobe Pass 1.7 y posteriores. Los métodos y las funciones de devolución de llamada que se describen aquí se definen en los archivos de encabezado AccessEnabler.h y EntitlementDelegate.h.

Consulte https://tve.zendesk.com/hc/en-us/articles/204963219-Android-Native-AccessEnabler-Library para conocer el SDK de Android AccessEnabler más reciente.

Nota: El equipo de autenticación de Adobe Pass le recomienda usar solamente las API de autenticación de Adobe Pass public:

  • Las API públicas están disponibles y totalmente probadas en todos los tipos de clientes admitidos. Para cualquier característica pública, nos aseguramos de que cada tipo de cliente tenga una versión correspondiente de los métodos asociados.
  • Las API públicas deben ser lo más estables posible, admitir la compatibilidad con versiones anteriores y garantizar que las integraciones de socios no se rompan. Sin embargo, para las API que no sean públicas de non, nos reservamos el derecho de cambiar su firma en cualquier momento futuro. Si se encuentra con un flujo particular que no se puede admitir a través de una combinación de las llamadas públicas actuales a la API de autenticación de Adobe Pass, el mejor enfoque es hacérnoslo saber. Teniendo en cuenta sus necesidades, podemos modificar las API públicas y proporcionar una solución estable en el futuro.

API de Android api

Factory.getInstance getInstance

Descripción: crea una instancia del objeto de habilitación de acceso. Debe haber una sola instancia de Access Enabler por cada instancia de aplicación.

Llamada de API: constructor
static pública AccessEnabler getInstance(Context appContext, String softwareStatement, String redirectUrl)
throws AccessEnablerException

static pública AccessEnabler getInstance(Context appContext, String env_url, String softwareStatement, String redirectUrl)
throws AccessEnablerException

Disponibilidad: v3.1.2+

Parámetros:

  • appContext: contexto de aplicación de Android.
  • env_url: para realizar pruebas con el entorno de ensayo de Adobe, env_url se puede establecer en "sp.auth-staging.adobe.com"

Obsoleto:

    public static AccessEnabler getInstance(Context appContext)
        throws AccessEnablerException

setRequestor setRequestor

Descripción: establece la identidad del programador. A cada programador se le asigna un ID único al registrarse con el Adobe en el sistema de autenticación de Adobe Pass. Cuando se trata de SSO y tokens remotos, el estado de autenticación puede cambiar cuando la aplicación está en segundo plano. Se puede volver a llamar a setRequestor cuando la aplicación se pone en primer plano para sincronizar con el estado del sistema (recupere un token remoto si está habilitado el SSO o elimine el token local si se ha cerrado la sesión mientras tanto).

La respuesta del servidor contiene una lista de MVPD junto con información de configuración adjunta a la identidad del programador. El código Access Enabler utiliza internamente la respuesta del servidor. Solo el estado de la operación (es decir, SUCCESS/FAIL) se presenta a la aplicación a través de la llamada de retorno setRequestorComplete().

Si no se usa el parámetro urls, la llamada de red resultante se dirigirá a la dirección URL del proveedor de servicios predeterminado: el entorno de producción/versión de Adobe.

Si se proporciona un valor para el parámetro urls, la llamada de red resultante se dirigirá a todas las direcciones URL proporcionadas en el parámetro urls. Todas las solicitudes de configuración se activan simultáneamente en subprocesos independientes. El primer respondedor tiene prioridad al compilar la lista de MVPD. Para cada MVPD de la lista, el Habilitador de acceso recuerda la URL del proveedor de servicios asociado. Todas las solicitudes de derechos subsiguientes se dirigen a la URL asociada al proveedor de servicios emparejado con la MVPD de destino durante la fase de configuración.

Llamada de API: configuración del solicitante
public void setRequestor(String requestorId)

Disponibilidad: v3.0+

Llamada de API: configuración del solicitante
public void setRequestor(String requestorId, ArrayList<String> urls)

Disponibilidad: v3.0+

Parámetros:

  • requestorID: ID único asociado con el programador. Pase el ID único asignado por el Adobe a su sitio cuando se registró por primera vez en el servicio de autenticación de Adobe Pass.

  • signedRequestorID: Una copia del identificador del solicitante firmado digitalmente con su clave privada. .

  • urls: Parámetro opcional; de forma predeterminada, se utiliza el proveedor de servicios de Adobe (http://sp.auth.adobe.com/). Esta matriz permite especificar extremos para los servicios de autenticación y autorización proporcionados por el Adobe (se pueden utilizar diferentes instancias para la depuración). Puede utilizar esto para especificar varias instancias del proveedor de servicios de autenticación de Adobe Pass. Al hacerlo, la lista de MVPD se compone de los extremos de todos los proveedores de servicios. Cada MVPD está asociado con el proveedor de servicios más rápido; es decir, el proveedor que respondió primero y que admite ese MVPD.

Llamadas de retorno activadas: setRequestorComplete()

Obsoleto:

public void setRequestor(String requestorId, String signedRequestorId)

public void setRequestor (String requestorId, String signedRequestorId, ArrayList&lt;String> url)

Volver a la API de Android…

setRequestorComplete setRequestorComplete

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso que informa a la aplicación de que la fase de configuración ha finalizado. Esto indica que la aplicación puede empezar a emitir solicitudes de derechos. La aplicación no puede emitir solicitudes de asignación de derechos hasta que se complete la fase de configuración.

Llamada de retorno: configuración del solicitante completa
java public void setRequestorComplete(int status)

Disponibilidad: v1.0+

Parámetros:

  • status: puede tomar uno de los siguientes valores:

    • SDK >= 3.4.0

      • AccessEnablerConstants.ACCESS_ENABLER_STATUS_SUCCESS: la fase de configuración se completó correctamente
      • AccessEnablerConstants.ACCESS_ENABLER_STATUS_ERROR: error en la fase de configuración

    • SDK &lt; 3.4

      • AccessEnabler.ACCESS_ENABLER_STATUS_SUCCESS: la fase de configuración se completó correctamente
      • AccessEnabler.ACCESS_ENABLER_STATUS_ERROR: error en la fase de configuración

Activado por: setRequestor()

Volver a la API de Android…

setOptions setOptions

Descripción: configura las opciones globales del SDK. Acepta Map&lt;String, String> como argumento. Los valores del mapa se pasan al servidor junto con cada llamada de red que realice el SDK.

Los valores se pasan al servidor independientemente del flujo actual (autenticación/autorización). Si desea cambiar los valores, puede llamar a este método en cualquier momento.

Llamada de API: setOptions
public void setOptions(HashMap<String,String> options)

Disponibilidad: v1.9.2+

Parámetros:

  • options: un mapa<String, String> que contiene las opciones globales del SDK. Actualmente están disponibles las siguientes opciones:

    • applicationProfile: se puede usar para realizar configuraciones de servidor basadas en este valor.
    • ap_vi - El ID del Experience Cloud (visitorID). Este valor puede utilizarse posteriormente en informes de análisis avanzados.
    • ap_ai - El Advertising ID
    • device_info - Información del cliente como se describe aquí: Pasar la conexión y aplicación del dispositivo con información del cliente.

Volver al principio…

checkAuthentication checkAuthN

Descripción: Comprueba el estado de autenticación. Para ello, busca un token de autenticación válido en el espacio de almacenamiento del token local. Este método no realiza llamadas de red y se recomienda llamarlo en el subproceso principal. La aplicación la utiliza para consultar el estado de autenticación del usuario y actualizar la interfaz de usuario en consecuencia (es decir, actualizar la interfaz de usuario de inicio de sesión/cierre de sesión). El estado de autenticación se comunica a la aplicación mediante la llamada de retorno setAuthenticationStatus().

Si una MVPD admite la función "Autenticación por solicitante", se pueden almacenar varios tokens de autenticación en un dispositivo. Para obtener más información sobre esta característica, consulte la sección Directrices de almacenamiento en caché en la Información general técnica de Android.

Llamada de API: comprobar el estado de autenticación
public void checkAuthentication()

Disponibilidad: v1.0+

Parámetros: Ninguno

Llamadas de retorno activadas: setAuthenticationStatus()

Volver a la API de Android…

getAuthentication getAuthN

Descripción: inicia el flujo de trabajo de autenticación completo. Se inicia comprobando el estado de autenticación. Si no se ha autenticado ya, se inicia el flujo de autenticación estado-máquina:

  • Si el último intento de autenticación se realizó correctamente, se omite la fase de selección de MVPD y se activa la llamada de retorno navegarToUrl(). La aplicación utiliza esta llamada de retorno para crear una instancia del control WebView que presenta al usuario la página de inicio de sesión de la MVPD.
  • Si el último intento de autenticación no se realizó correctamente o si el usuario cerró la sesión explícitamente, se desencadenará la llamada de retorno displayProviderDialog(). La aplicación utiliza esta llamada de retorno para mostrar la interfaz de usuario de selección de MVPD. Además, la aplicación debe reanudar el flujo de autenticación informando a la biblioteca del Habilitador de acceso sobre la selección de MVPD del usuario mediante el método setSelectedProvider().

A medida que las credenciales del usuario se verifican en la página de inicio de sesión de MVPD, la aplicación debe supervisar las operaciones de redirección múltiples que se producen mientras el usuario se autentica en la página de inicio de sesión de MVPD. Cuando se especifican las credenciales correctas, el control WebView se redirige a una dirección URL personalizada definida por la constante AccessEnabler.ADOBEPASS_REDIRECT_URL. WebView no pretende cargar esta dirección URL. La aplicación debe interceptar esta URL e interpretar este evento como una señal de que la fase de inicio de sesión ha finalizado. Luego debe entregar el control al Habilitador de acceso para completar el flujo de autenticación (llamando al método getAuthenticationToken()).

Si una MVPD admite la función "Autenticación por solicitante", se pueden almacenar varios tokens de autenticación en un dispositivo (uno por programador). Para obtener más información sobre esta característica, consulte la sección Directrices de almacenamiento en caché en la Información general técnica de Android.

Por último, el estado de autenticación se comunica a la aplicación a través de la llamada de retorno setAuthenticationStatus().

Llamada de API: inicia el flujo de autenticación
public void getAuthentication()

Disponibilidad: v1.0+

Llamada de API: inicia el flujo de autenticación
public void getAuthentication(boolean forceAuthN, Map<String, Object> genericData)

Disponibilidad: v1.8+

Parámetros:

  • forceAuthn: Un indicador que especifica si el flujo de autenticación debe iniciarse, independientemente de si el usuario ya se ha autenticado o no.
  • datos: Mapa que contiene pares de clave-valor que se enviarán al servicio de pase de TV de pago. El Adobe de puede utilizar estos datos para habilitar futuras funciones sin cambiar el SDK.

Llamadas de retorno activadas: setAuthenticationStatus(), displayProviderDialog(), navigateToUrl(), sendTrackingData()

Volver a la API de Android…

displayProviderDialog displayProviderDialog

Descripción La llamada de retorno desencadenada por el Habilitador de acceso para informar a la aplicación de que es necesario crear una instancia de los elementos de la interfaz de usuario apropiados para permitir que el usuario seleccione la MVPD deseada. La llamada de retorno proporciona una lista de objetos MVPD con información adicional que puede ayudar a crear correctamente el panel de la interfaz de usuario de selección (como la URL que señala al logotipo de MVPD, un nombre para mostrar descriptivo, etc.)

Una vez que el usuario ha seleccionado la MVPD deseada, la aplicación de capa superior debe reanudar el flujo de autenticación llamando a setSelectedProvider() y pasándole el ID de la MVPD correspondiente a la selección del usuario.

NOTE
Cancelación del flujo de autenticación



Tenga en cuenta que este es un punto en el que el usuario tiene la capacidad de pulsar el botón "Atrás", lo que equivale a anular el flujo de autenticación. En este caso, la aplicación debe llamar al método setSelectedProvider() y pasar null como parámetro para que el Habilitador de acceso pueda restablecer su equipo de estado de autenticación.
Llamada de retorno: mostrar la IU de selección de MVPD
public void displayProviderDialog(ArrayList<Mvpd> mvpds)

Disponibilidad: v1.0+

Parámetros:

  • mvpds: lista de objetos MVPD que contienen información relacionada con MVPD que la aplicación puede utilizar para crear los elementos de la interfaz de usuario de selección de MVPD.

Activado por: getAuthentication(), getAuthorization()

Volver a la API de Android…

setSelectedProvider setSelectedProvider

Descripción: Su aplicación llama a este método para informar al Habilitador de acceso de la selección de MVPD del usuario. La aplicación puede utilizar este método para seleccionar o cambiar el proveedor de servicios utilizado para la autenticación.

Si la MVPD seleccionada es una MVPD TempPass, se autenticará automáticamente con esa MVPD sin necesidad de llamar posteriormente a getAuthentication().

Tenga en cuenta que esto no es posible en el caso del pase temporal promocional, en el que se proporcionan parámetros adicionales en el método getAuthentication().

Al pasar null como parámetro, Access Enabler supone que el usuario ha cancelado el flujo de autenticación (es decir, ha presionado el botón "Atrás"), y responde restableciendo el estado-máquina de autenticación y llamando a la llamada de retorno setAuthenticationStatus() con el código de error AccessEnablerConstants.PROVIDER_NOT_SELECTED_ERROR.

Llamada de API: establezca el proveedor seleccionado actualmente
public void setSelectedProvider(String mvpdId)

Disponibilidad: v1.0+

Parámetros: Ninguno

Llamadas de retorno activadas: setAuthenticationStatus(), sendTrackingData(), navigateToUrl()

Volver a la API de Android…

Obsoleto: A partir del SDK 3.0 de Android, navegarToUrl solo se usa si la ficha personalizada de Chrome no está presente en el dispositivo

Descripción: La devolución de llamada desencadenada por el Habilitador de acceso, que informa a la aplicación de que el usuario debe tener la página de inicio de sesión de MVPD para poder escribir sus credenciales. El Access Enabler pasa como parámetro la dirección URL de la página de inicio de sesión de MVPD. La aplicación debe crear una instancia de un control WebView y dirigirlo a esta dirección URL. Además, la aplicación debe supervisar las direcciones URL cargadas por el control WebView e interceptar la operación de redirección dirigida a la dirección URL personalizada definida por la constante AccessEnabler.ADOBEPASS_REDIRECT_URL (deprecated). Tras este evento, la aplicación debe cerrar u ocultar el control WebView y devolver el control a la biblioteca del Habilitador de acceso llamando al método getAuthenticationToken(). Access Enabler completa el flujo de autenticación recuperando el token de autenticación del servidor back-end y almacenándolo localmente en el almacenamiento de tokens.

WARNING
Anulando el flujo de autenticación
Tenga en cuenta que en este punto el usuario puede presionar el botón "Atrás", lo que equivale a anular el flujo de autenticación. En este caso, la aplicación debe llamar al método setSelectedProvider() pasando null como parámetro y dando la oportunidad al Habilitador de acceso de restablecer su equipo de estado de autenticación.
Callback: mostrar la página de inicio de sesión de MVPD
public void navegarToUrl(String url)

Disponibilidad: v1.0+

Parámetros:

  • url: Dirección URL que señala a la página de inicio de sesión de la MVPD

Activado por: getAuthentication(), setSelectedProvider()

Volver a la API de Android…

getAuthenticationToken getAuthNToken

Obsoleto: A partir del SDK 3.0 de Android, como Chrome Custom Tab se utiliza para la autenticación, este método ya no se utiliza desde la aplicación.

Descripción: completa el flujo de autenticación al solicitar el token de autenticación del servidor back-end. Su aplicación debería llamar a este método únicamente en respuesta a un evento en el que el control WebView que aloja la página de inicio de sesión de MVPD se redirija a la dirección URL personalizada definida por la constante AccessEnabler.ADOBEPASS_REDIRECT_URL.

Llamada de API: recuperar el token de autenticación
public void getAuthenticationToken()

Disponibilidad: v1.0+

Parámetros:

  • cookies: cookies configuradas en el dominio de destino (consulte la aplicación de demostración en el SDK para obtener una implementación de referencia).

Llamadas de retorno activadas: setAuthenticationStatus(), sendTrackingData()

Volver a la API de Android…

setAuthenticationStatus setAuthNStatus

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso, que informa
la aplicación del estado del flujo de autenticación. Hay muchos
lugares donde este flujo puede fallar, ya sea como resultado de la actividad del usuario
interacción o debido a otros escenarios imprevistos (por ejemplo, red
problemas de conectividad, etc.). Esta llamada de retorno informa a la aplicación de
el estado de éxito/error del flujo de autenticación, mientras que también
proporcionar información adicional sobre el motivo del error, cuando sea necesario.

Callback: informar del estado del flujo de autenticación
public void setAuthenticationStatus(int status, String errorCode)

Disponibilidad: v1.0+

Parámetros:

  • status: puede tomar uno de los siguientes valores:

    • AccessEnablerConstants.ACCESS_ENABLER_STATUS_SUCCESS: el flujo de autenticación se completó correctamente
    • AccessEnablerConstants.ACCESS_ENABLER_STATUS_ERROR - error en el flujo de autenticación

  • código: motivo del error. Si status es AccessEnablerConstants.ACCESS_ENABLER_STATUS_SUCCESS, entonces code es una cadena vacía (es decir, definida por la constante AccessEnablerConstants.USER_AUTHENTICATED). En caso de error, este parámetro puede tomar uno de los siguientes valores:

    • AccessEnablerConstants.USER_NOT_AUTHENTICATED_ERROR - El usuario no está autenticado. En respuesta a la llamada al método checkAuthentication() cuando no hay un token de autenticación válido en la caché de token local.
    • AccessEnablerConstants.PROVIDER_NOT_SELECTED_ERROR - AccessEnabler ha restablecido el estado-máquina de autenticación después de que la aplicación de capa superior pasara null a setSelectedProvider() para anular el flujo de autenticación. Es de suponer que el usuario ha cancelado el flujo de autenticación (es decir, ha presionado el botón "Atrás").
    • AccessEnablerConstants.GENERIC_AUTHENTICATION_ERROR: error en el flujo de autenticación debido a motivos como la no disponibilidad de la red o que el usuario canceló explícitamente el flujo de autenticación.

Activado por: checkAuthentication(), getAuthentication(), checkAuthorization()

Volver a la API de Android…

checkPreauthorizedResources checkPreauth

Obsoleto: A partir del SDK 3.6 de Android, la API preautorizada reemplaza a checkPreauthorizedResources, lo que proporciona códigos de error ampliados.

Descripción: La aplicación utiliza este método para determinar si el usuario ya tiene autorización para ver recursos protegidos específicos. El propósito principal de este método es recuperar información para utilizarla en la decoración de la interfaz de usuario (por ejemplo, para indicar el estado de acceso con los iconos de bloqueo y desbloqueo).

Llamada de API: establezca el proveedor seleccionado actualmente
public void checkPreauthorizedResources(ArrayList<String> resources)

Disponibilidad: v1.3+

Parámetros: El parámetro resources es una matriz de recursos cuya autorización debe comprobarse. Cada elemento de la lista debe ser una cadena que represente el ID de recurso. El id. de recurso está sujeto a las mismas limitaciones que el id. de recurso de la llamada getAuthorization(); es decir, debe ser un valor acordado establecido entre el programador y la MVPD o un fragmento de RSS multimedia.

Devolución de llamada desencadenada: preauthorizedResources()

Volver a la API de Android…

checkPreauthorizedResources checkPreauth2

Obsoleto: A partir del SDK 3.6 de Android, la API preautorizada reemplaza a checkPreauthorizedResources, lo que proporciona códigos de error ampliados.

Descripción: La aplicación utiliza este método para determinar si el usuario ya tiene autorización para ver recursos protegidos específicos. El propósito principal de este método es recuperar información para utilizarla en la decoración de la interfaz de usuario (por ejemplo, para indicar el estado de acceso con los iconos de bloqueo y desbloqueo).

Llamada de API: establezca el proveedor seleccionado actualmente
public void checkPreauthorizedResources(ArrayList<String> resources, boolean cache)

Disponibilidad: v3.1+

Parámetros: El parámetro resources es una matriz de recursos cuya autorización debe comprobarse. Cada elemento de la lista debe ser una cadena que represente el ID de recurso. El id. de recurso está sujeto a las mismas limitaciones que el id. de recurso de la llamada getAuthorization(); es decir, debe ser un valor acordado establecido entre el programador y la MVPD o un fragmento de RSS multimedia.

El parámetro cache especifica si se puede utilizar o no la respuesta de preautorización en caché. De forma predeterminada, la caché es verdadera, el SDK devolverá una respuesta almacenada en caché anteriormente si está disponible.

Devolución de llamada desencadenada: preauthorizedResources()

Volver a la API de Android…

preauthorizedResources preauthResources

Obsoleto: A partir del SDK 3.6 de Android, la API preautorizada reemplaza a checkPreauthorizedResources, lo que proporciona códigos de error ampliados. no se llamará a la devolución de llamada preauthorizedResources en la nueva API.

Descripción: devolución de llamada desencadenada por checkPreauthorizedResources(). Proporciona una lista de recursos que el usuario ya tiene autorización para ver.

Llamada de API: establezca el proveedor seleccionado actualmente
public void checkPreauthorizedResources(ArrayList<String> resources)

Disponibilidad: v1.3+

Parámetros: El parámetro resources es una matriz de recursos que el usuario ya tiene autorización para ver.

Activado por: checkPreauthorizedResources()

Volver a la API de Android…

checkAuthorization

Descripción: La aplicación utiliza este método para comprobar el estado de autorización. Se inicia comprobando primero el estado de autenticación. Si no se autentica, se activa la devolución de llamada setTokenRequestFailed() y se cierra el método. Si el usuario está autenticado, también almacena en déclencheur el flujo de autorización. Vea los detalles del método getAuthorization().

Llamada de API: comprobar el estado de autorización
public void checkAuthorization(String resourceId)

Disponibilidad: v1.0+

Llamada de API: comprobar el estado de autorización
public void checkAuthorization(String resourceId, Map<String, Object> genericData)

Disponibilidad: v1.8+

Parámetros:

  • resourceId: El identificador del recurso para el que el usuario solicita autorización.
  • datos: Mapa que contiene pares de clave-valor que se enviarán al servicio de pase de TV de pago. El Adobe de puede utilizar estos datos para habilitar futuras funciones sin cambiar el SDK.

Llamadas de retorno activadas: tokenRequestFailed(), setToken(),sendTrackingData(), setAuthenticationStatus()

Volver a la API de Android…

getAuthorization

Descripción: La aplicación utiliza este método para iniciar el flujo de autorización. Si el usuario aún no se ha autenticado, también inicia el flujo de autenticación. Si el usuario se autentica, el Habilitador de acceso procede a emitir solicitudes para el token de autorización (si no hay ningún token de autorización válido en la caché de tokens local) y para el token de medios de corta duración. Una vez obtenido el token de medios corto, el flujo de autorización se considera completo. La llamada de retorno setToken() se activa y el token de medios corto se entrega como parámetro a la aplicación. Si, por cualquier motivo, la autorización falla, la llamada de retorno tokenRequestFailed() se activa y se proporcionan el código de error y los detalles.

Llamada de API: iniciar el flujo de autorización
public void getAuthorization(String resourceId)

Disponibilidad: v1.0+

Llamada de API: iniciar el flujo de autorización
public void getAuthorization(String resourceId, Map<String, Object> genericData)

Disponibilidad: v1.8+

Parámetros:

  • resourceId: El identificador del recurso para el que el usuario solicita autorización.
  • datos: Mapa que contiene pares de clave-valor que se enviarán al servicio de pase de TV de pago. El Adobe de puede utilizar estos datos para habilitar futuras funciones sin cambiar el SDK.

Llamadas de retorno activadas: tokenRequestFailed(), setToken(), sendTrackingData()

WARNING
Se activaron devoluciones de llamadas adicionales
Este método también puede almacenar en déclencheur las siguientes devoluciones de llamadas (si también se inició el flujo de autenticación): setAuthenticationStatus(), displayProviderDialog(), navegarToUrl()

NOTA: utilice checkAuthorization() en lugar de getAuthorization() siempre que sea posible. El método getAuthorization() iniciará un flujo de autenticación completo (si el usuario no está autenticado) y esto podría llevar a una implementación complicada por parte del programador.

Volver a la API de Android…

setToken setToken

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso que informa a la aplicación de que el flujo de autorización se completó correctamente. El token de medios de corta duración también se entrega como parámetro.

Llamada de retorno: flujo de autorización completado correctamente
public void setToken(String token, String resourceId)

Disponibilidad: v1.0+

Parámetros:

  • token: El token de medios de corta duración
  • resourceId: El recurso para el que se obtuvo la autorización

Activado por: checkAuthorization(), getAuthorization()

Volver a la API de Android…

tokenRequestFailed tokenRequestFailed

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso que informa a la aplicación de capa superior de que el flujo de autorización ha fallado.

Callback: error del flujo de autorización
public void tokenRequestFailed(String resourceId,
Cadena errorCode, Cadena errorDescription)

Disponibilidad: v1.0+

Parámetros:

  • resourceId: El recurso para el que se obtuvo la autorización

  • errorCode: código de error asociado al escenario de error. Valores posibles:

    • AccessEnablerConstants.USER_NOT_AUTHORIZED_ERROR - El usuario no pudo autorizar el recurso dado

  • errorDescription: detalles adicionales acerca del escenario de error. Si esta cadena descriptiva no está disponible por algún motivo, la autenticación de Adobe Pass enviará una cadena vacía ("").

    Una MVPD puede utilizar esta cadena para pasar mensajes de error personalizados o mensajes relacionados con las ventas. Por ejemplo, si se deniega a un suscriptor la autorización para un recurso, la MVPD podría enviar un mensaje como: "Actualmente no tiene acceso a este canal en su paquete. Si desea actualizar el paquete, haga clic aquí." El mensaje lo pasa la autenticación de Adobe Pass a través de esta llamada de retorno al programador, que tiene la opción de mostrarlo o ignorarlo. La autenticación de Adobe Pass también puede utilizar este parámetro para notificar la condición que podría haber provocado un error. Por ejemplo, "Se produjo un error de red al comunicarse con el servicio de autorización del proveedor".

Activado por: checkAuthorization(), getAuthorization()

Volver a la API de Android…

cierre de sesión logout

Descripción: Utilice este método para iniciar el flujo de cierre de sesión. El cierre de sesión es el resultado de una serie de operaciones de redirección HTTP debido al hecho de que el usuario debe cerrar la sesión tanto desde los servidores de autenticación de Adobe Pass como desde los servidores de MVPD. Como resultado, este flujo no se puede completar con una simple solicitud HTTP emitida por la biblioteca del Habilitador de acceso. El SDK utiliza una pestaña personalizada Chrome para ejecutar las operaciones de redirección HTTP. Este flujo será visible para el usuario y se cerrará cuando se complete

Llamada de API: iniciar el flujo de cierre de sesión
public void logout()

Disponibilidad: v1.0+

Parámetros: Ninguno

Llamadas de retorno activadas:

  • navigateToUrl() para la versión del SDK anterior a 3.0
  • setAuthenticationStatus() para la versión del SDK > 3.0

Volver a la API de Android…

getSelectedProvider getSelectedProvider

Descripción: Utilice este método para determinar el proveedor seleccionado actualmente.

Llamada de API: determina la MVPD seleccionada actualmente
public void getSelectedProvider()

Disponibilidad: v1.0+

Parámetros: Ninguno

Llamadas de retorno activadas: selectedProvider()

Volver a la API de Android…

selectedProvider

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso que entrega información sobre la MVPD seleccionada actualmente a la aplicación.

Callback: información sobre la MVPD seleccionada actualmente.
public void selectedProvider(Mvpd mvpd)

Disponibilidad: v1.0+

Parámetros:

  • mvpd: objeto que contiene información sobre la MVPD seleccionada actualmente

Activado por: getSelectedProvider()

Volver a la API de Android…

getMetadata getMetadata

Descripción: Utilice este método para recuperar información expuesta como metadatos por la biblioteca del Habilitador de acceso. La aplicación puede tener acceso a esta información proporcionando un objeto MetadataKey compuesto.

Llamada de API: consultar los metadatos en AccessEnabler
public void getMetadata(MetadataKey metadataKey)

Disponibilidad: v1.0+

Hay dos tipos de metadatos disponibles para los programadores:

  • Metadatos estáticos (TTL del token de autenticación, TTL del token de autorización e ID de dispositivo)
  • Metadatos del usuario (información específica del usuario, como el ID de usuario y el código postal; pasados de una MVPD al dispositivo de un usuario durante los flujos de autenticación o autorización)

Parámetros:

  • metadataKey: Una estructura de datos que encapsula una clave y una variable args, con el significado siguiente:

    • Si la clave es METADATA_KEY_USER_META y args contiene un objeto SerializableNameValuePair con el nombre = METADATA_ARG_USER_META y el valor = [metadata_name], se realiza la consulta de los metadatos del usuario. La lista actual de tipos de metadatos de usuario disponibles:

      • zip - Código postal

      • householdID - Identificador del hogar. Si una MVPD no admite subcuentas, será idéntica a userID.

      • maxRating - Clasificación parental máxima para el usuario

      • userID: el identificador de usuario. Si una MVPD admite subcuentas y el usuario no es la cuenta principal, userID será diferente de householdID.

      • channelID: lista de canales que el usuario puede ver

    • Si la clave es METADATA_KEY_DEVICE_ID, se realiza la consulta para obtener el ID del dispositivo actual. Tenga en cuenta que esta función está desactivada de forma predeterminada y los programadores deben ponerse en contacto con el Adobe para obtener información sobre la habilitación y las tarifas.

    • Si la clave es METADATA_KEY_TTL_AUTHZ y args contiene un objeto SerializableNameValuePair con el nombre = METADATA_ARG_RESOURCE_ID y el valor = [resource_id], se realiza la consulta para obtener la hora de caducidad del token de autorización asociado al recurso especificado.

    • Si la clave es METADATA_KEY_TTL_AUTHN, se realiza la consulta para obtener el tiempo de caducidad del token de autenticación.

NOTE
Para SDK 3.4.0, las constantes : METADATA_KEY_USER_META, METADATA_KEY_DEVICE_ID, METADATA_KEY_TTL_AUTHZ, METADATA_KEY_TTL_AUTHN están disponibles en com.adobe.adobepass.accessenabler.api.profile.UserProfileService.
NOTE
Los metadatos de usuario reales disponibles para un programador dependen de lo que una MVPD ponga a disposición. Esta lista se ampliará a medida que haya nuevos metadatos disponibles y añadidos al sistema de autenticación de Adobe Pass.

Llamadas de retorno activadas: setMetadataStatus()

Más información: Metadatos de usuario

Volver a la API de Android…

setMetadataStatus setMetadaStatus

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso que entrega los metadatos solicitados mediante una llamada a getMetadata().

Callback: resultado de la solicitud de recuperación de metadatos
public void setMetadataStatus(MetadataKey key, MetadataStatus result)

Disponibilidad: v1.0+

Parámetros:

  • key: El objeto MetadataKey que contiene la clave para la cual se solicita el valor de los metadatos y los parámetros asociados (vea la aplicación de demostración para una implementación de referencia).

  • result: Un objeto compuesto que contiene los metadatos solicitados. El objeto tiene los campos siguientes:

    • simpleResult: una cadena que representa el valor de los metadatos cuando se realizó la solicitud para el TTL de autenticación, el TTL de autorización o el ID de dispositivo. Este valor es nulo si se realizó la solicitud de metadatos del usuario.

    • userMetadataResult: un objeto que contiene la representación Java de una carga útil de metadatos de usuario JSON.
      Por ejemplo:

          '{
          "street": "Main Avenue",
          "buildings": ["150", "320"]
          }'

se traduce a Java como:

          Map("street" -> "Main Avenue", "buildings" -> List("150", "320")))

La estructura real de los objetos de metadatos de usuario es similar a la siguiente:

          {
              updated: 1334243471,
              encrypted: ["encryptedProp"],
              data: {
                  zip: ["12345", "34567"],
                  maxRating: {
                      "MPAA": "PG-13",
                      "VCHIP": "TV-Y",
                      "URL": "http://exam.pl/e/manage/ratings"
                  },
                  householdID: "3456",
                  userID: "BgSdasfsdk23/dsaf3+saASesadgfsShggssd=",
                  channelID: ["channel-1", "channel-2"]
              }
          }

Este valor es nulo cuando se realizó la solicitud de metadatos simples (TTL de autenticación, TTL de autorización o ID de dispositivo).

  • cifrado: valor booleano que especifica si los metadatos recuperados están cifrados o no. Este parámetro solo es significativo para solicitudes de metadatos del usuario, no tiene significado para metadatos estáticos (por ejemplo, TTL de autenticación) que siempre se reciben sin cifrar. Si este parámetro se establece en True, depende del programador obtener el valor de metadatos de usuario sin cifrar realizando un descifrado RSA con la clave privada de la lista blanca (la misma clave privada que se utiliza para la firma del id. del solicitante en la llamada setRequestor).

Activado por: getMetadata()

Más información: Metadatos de usuario

Volver a la API de Android…

getVersion getVersion

Descripción: Este método se puede usar para recuperar la versión de la biblioteca AccessEnabler.

Llamada de API: obtener la versión de AccessEnabler
public static String getVersion()

Volver a la API de Android…

Seguimiento de eventos tracking

El activador de acceso déclencheur una llamada de retorno adicional que no está necesariamente relacionada con los flujos de derechos. La implementación de la función de devolución de llamada de seguimiento de eventos denominada sendTrackingData() es opcional, pero permite a la aplicación realizar un seguimiento de eventos específicos y compilar estadísticas como el número de intentos de autenticación/autorización correctos/fallidos. A continuación se muestra la especificación para la llamada de retorno sendTrackingData():

sendTrackingData sendTrackingData

Descripción: La llamada de retorno desencadenada por el Habilitador de acceso indica a la aplicación la ocurrencia de varios eventos, como la finalización o el error de los flujos de autenticación o autorización. sendTrackingData() también informa del tipo de dispositivo, el tipo de cliente del Access Enabler y el sistema operativo.

WARNING
El tipo de dispositivo y el sistema operativo se derivan del uso de una biblioteca Java pública (http://java.net/projects/user-agent-utils) y de la cadena del agente de usuario. Tenga en cuenta que esta información se proporciona solo como una forma grosera de desglosar las métricas operativas en categorías de dispositivos, pero que ese Adobe no puede responsabilizarse de los resultados incorrectos. Utilice la nueva funcionalidad en consecuencia.

  • Valores posibles para el tipo de dispositivo:

    • computer
    • tablet
    • mobile
    • gameconsole
    • unknown

  • Valores posibles para el tipo de cliente del Habilitador de acceso:

    • flash
    • html5
    • ios
    • android
Callback: seguimiento de eventos
public void sendTrackingData(Event event, ArrayList<String> data)

Disponibilidad: v1.0+

Parámetros:

  • event: el evento que se está rastreando. Existen tres tipos de eventos de seguimiento posibles:

    • authorizationDetection: cada vez que se devuelve una solicitud de token de autorización (el tipo de evento es EVENT_AUTHZ_DETECTION)
    • authenticationDetection: cada vez que se produce una comprobación de autenticación (el tipo de evento es EVENT_AUTHN_DETECTION)
    • mvpdSelection: cuando el usuario selecciona una MVPD en el formulario de selección de MVPD (el tipo de evento es EVENT_MVPD_SELECTION)

  • datos: datos adicionales asociados al evento del que se informó. Estos datos se presentan en forma de lista de valores.

A continuación se proporcionan instrucciones para interpretar los valores de data
matriz:

  • Para el tipo de evento EVENT_AUTHN_DETECTION:

    • 0 - Si la solicitud de token se realizó correctamente (verdadero/falso) y si lo anterior es verdadero:
    • 1 - cadena de ID de MVPD
    • 2 - GUID (md5 con hash)
    • 3: el token ya está en la caché (verdadero/falso)
    • 4 - Tipo de dispositivo
    • 5 - Tipo de cliente del Habilitador de acceso
    • 6 - Tipo de sistema operativo

  • Para el tipo de evento EVENT_AUTHZ_DETECTION

    • 0 - Si la solicitud de token se realizó correctamente (verdadero/falso) y si se realizó correctamente:
    • 1 - ID DE MVPD
    • 2 - GUID (md5 con hash)
    • 3: el token ya está en la caché (verdadero/falso)
    • 4 - Error
    • 5 - Detalles
    • 6 - Tipo de dispositivo
    • 7 - Tipo de cliente del Habilitador de acceso
    • 8 - Tipo de sistema operativo

  • Para el tipo de evento EVENT_MVPD_SELECTION

    • 0: ID de la MVPD seleccionada actualmente
    • 1 - Tipo de dispositivo
    • 2 - Tipo de cliente del Habilitador de acceso
    • 3 - Tipo de sistema operativo

Activado por: checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider()

Volver a la API de Android…

recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b