Guía de Android SDK (heredada) android-sdk-cookbook

Establezca la identidad del solicitante.

Comprobación y obtención de autenticación con un proveedor de identidad concreto.

Compruebe y obtenga autorización para un recurso en particular.

Cerrar sesión.

Cree sus funciones de devolución de llamada:

• setRequestorComplete()

  Activado por setRequestor(), devuelve éxito o error.
  El éxito indica que se puede continuar con las llamadas de asignación de derechos.

• displayProviderDialog(mvpds)

  Activado por getAuthentication() solo si el usuario no ha seleccionado ningún proveedor (MVPD) y aún no se ha autenticado.
  El parámetro mvpds es una matriz de proveedores disponibles para el usuario.

• "setAuthenticationStatus(status, errorcode)"

  Activado por checkAuthentication() cada vez.
  Activado por getAuthentication() solo si el usuario ya se ha autenticado y ha seleccionado un proveedor.

  El estado devuelto es éxito o error, el código de error describe el tipo de error.

• navigationToUrl(url)

  Activado por getAuthentication() después de que el usuario seleccione un MVPD. El parámetro url proporciona la ubicación de la página de inicio de sesión de MVPD.

• sendTrackingData(event, data)

  Activado por checkAuthentication(), getAuthentication(), checkAuthorization(), getAuthorization(), setSelectedProvider().
  El parámetro event indica qué evento de asignación de derechos se produjo; el parámetro data es una lista de valores relacionados con el evento.

• setToken(token, recurso)

  Activado por checkAuthorization() y getAuthorization() tras una autorización correcta para ver un recurso.
  El parámetro token es el token de medios de corta duración; el parámetro resource es el contenido que el usuario tiene autorización para ver.

• "tokenRequestFailed(resource, code, description)"

  Activado por checkAuthorization() y getAuthorization() tras una autorización incorrecta.
  El parámetro resource es el contenido que el usuario intentaba ver; el parámetro code es el código de error que indica qué tipo de error se produjo; el parámetro description describe el error asociado con el código de error.

• selectedProvider(mvpd)

  Activado por getSelectedProvider().
  El parámetro mvpd proporciona información sobre el proveedor seleccionado por el usuario.

• "setMetadataStatus(metadata, key, arguments)"

  Activado por getMetadata().
  El parámetro metadata proporciona los datos específicos solicitados; el parámetro key es la clave utilizada en la solicitud getMetadata(); y el parámetro arguments es el mismo diccionario que se pasó a getMetadata().

• preauthorizedResources(resources)

  Activado por checkPreauthorizedResources().
  El parámetro authorizedResources presenta los recursos que el usuario tiene autorización para ver.

Inicie la aplicación de nivel superior.

Iniciar autenticación de Adobe Pass

a. Llame a getInstance para crear una sola instancia del activador de acceso de autenticación de Adobe Pass.

• Dependencia: autenticación de Adobe Pass nativa
  Biblioteca de Android (AccessEnabler)

b. Llame a setRequestor() para establecer la identificación del programador; pase requestorID del programador y (opcionalmente) una matriz de extremos de autenticación de Adobe Pass.

• Dependencia: ID de solicitante de autenticación de Adobe Pass válido
  (Póngase en contacto con el administrador de cuentas de autenticación de Adobe Pass para arreglarlo).

• Déclencheur: setRequestorComplete() callback

Llame a checkAuthentication() para comprobar si hay una autenticación existente sin iniciar el flujo de autenticación completo. Si esta llamada se realiza correctamente, puede continuar directamente al flujo de autorización. Si no es así, continúe con el flujo de autenticación.

• Dependencia: Una llamada correcta a setRequestor() (esta dependencia también se aplica a todas las llamadas subsiguientes).

• Déclencheur: setAuthenticationStatus() callback

Llame a getAuthentication() para iniciar el flujo de autenticación o para obtener confirmación de que el usuario ya se ha autenticado.
Déclencheur:

• La llamada de retorno setAuthenticationStatus(), si el usuario ya está autenticado. En este caso, continúe directamente al Flujo de autorización.
• La llamada de retorno displayProviderDialog(), si el usuario aún no se ha autenticado.

Presente al usuario la lista de proveedores enviados a displayProviderDialog().

Una vez que el usuario seleccione un proveedor, obtenga la dirección URL del MVPD del usuario de la llamada de retorno navigateToUrl(). Abra un control WebView y dirija ese control WebView a la dirección URL.

A través de la instancia WebView del paso anterior, el usuario aterriza en la página de inicio de sesión de MVPD e introduce las credenciales de inicio de sesión. Varias operaciones de redirección tienen lugar dentro de WebView.

Nota: En este momento, el usuario tiene la oportunidad de cancelar el flujo de autenticación. Si esto sucede, la capa de la interfaz de usuario es responsable de informar a AccessEnabler sobre este evento llamando a setSelectedProvider() con null como parámetro. Esto permite al AccessEnabler limpiar su estado interno y restablecer el flujo de autenticación.

Una vez que el usuario ha iniciado sesión correctamente, la capa de aplicación detecta la carga de una "URL de redireccionamiento personalizada" (por ejemplo: http://adobepass.android.app). Esta dirección URL personalizada es en realidad una dirección URL no válida que no está destinada a que WebView se cargue. Es una señal de que el flujo de autenticación se ha completado y de que WebView debe cerrarse.

Cierre el control WebView y llame a getAuthenticationToken(), que indica a AccessEnabler que recupere el token de autenticación del servidor back-end.

[Opcional] Llame a checkPreauthorizedResources(resources) para comprobar qué recursos puede ver el usuario. El parámetro resources es una matriz de recursos protegidos asociados al token de autenticación del usuario.
Déclencheur: preAuthorizedResources() devolución de llamada
Punto de ejecución: después del flujo de autenticación completado

Si la autenticación se ha realizado correctamente, continúe con el Flujo de autorización.

Llame a getAuthorization() para iniciar la autorización
Flujo.

Dependencia: ID de recurso válidos acordados con los MVPD.

Nota: Los ResourceID deben ser los mismos que se usan en cualquier otro dispositivo o plataforma, y serán los mismos en todas las MVPD.

Valide la autenticación y la autorización.

• Si la llamada getAuthorization() se realiza correctamente: el usuario tiene tokens AuthN y AuthZ válidos (el usuario está autenticado y autorizado para ver los medios solicitados).

• Si getAuthorization() produce un error: examine la excepción generada para determinar su tipo (AuthN, AuthZ o algo más):

  • Si se ha producido un error de autenticación (AuthN), reinicie el flujo de autenticación.
  • Si se trata de un error de autorización (AuthZ), el usuario no tiene autorización para ver los medios solicitados y se le debe mostrar algún tipo de mensaje de error.
  • Si se ha producido algún otro tipo de error (error de conexión, error de red, etc.), muestre un mensaje de error apropiado al usuario.

Valide el token de medios corto.
Utilice la biblioteca del Comprobador de tokens de medios de autenticación de Adobe Pass para comprobar el token de medios de corta duración devuelto desde la llamada de getAuthorization() anterior:

• Si la validación se realiza correctamente: Reproduzca el medio solicitado para el usuario.
• Si la validación falla: El token de AuthZ no era válido, la solicitud de medios debe rechazarse y se debe mostrar un mensaje de error al usuario.

Vuelva al flujo normal de aplicaciones.

Llame a logout() para cerrar la sesión del usuario.
AccessEnabler borra todos los valores en caché y tokens del MVPD actual para el solicitante actual, así como para los solicitantes con inicio de sesión único. Después de borrar la caché, AccessEnabler realiza una llamada al servidor para limpiar las sesiones del lado del servidor. Tenga en cuenta que, dado que la llamada al servidor podría provocar un redireccionamiento de SAML al IdP (esto permite la limpieza de la sesión en el lado del IdP), esta llamada debe seguir todas las redirecciones. Por este motivo, esta llamada debe controlarse dentro de un control WebView.

a. Siguiendo el mismo patrón que el flujo de trabajo de autenticación, el dominio AccessEnabler realiza una solicitud a la capa de aplicación de la interfaz de usuario (a través de la llamada de retorno navigateToUrl()) para crear un control WebView e indicar a ese control que cargue la dirección URL del extremo de cierre de sesión en el servidor back-end.

b. De nuevo, la interfaz de usuario debe supervisar la actividad del control WebView y detectar el momento en que el control, a medida que pasa por varias redirecciones, carga la dirección URL personalizada de la aplicación (es decir: http://adobepass.android.app/). Una vez que se produce este evento, la capa de aplicación de la interfaz de usuario cierra WebView y se completa el proceso de cierre de sesión.

Nota: El flujo de cierre de sesión difiere del flujo de autenticación en que el usuario no tiene que interactuar con WebView de ninguna manera. La capa de aplicación de la interfaz de usuario utiliza un WebView para asegurarse de que se siguen todas las redirecciones. Por lo tanto, es posible (y recomendado) hacer que el control WebView sea invisible (es decir, oculto) durante el proceso de cierre de sesión.