Digital Authentication Framework: Appendix - Authentication With Warning (iOS)

Versions 2.0 and later of the Digital Authentication Framework require all applications to support Easy Activation.

Background

GD's Easy Activation (sometimes referred to as 'Activation Delegation') feature allows one GD application to use another to authorise its initial activation, instead of having the user enter an email address and 15-character Access Key. The application responding to an Easy Activation request must display the name and icon of the requesting application, and obtain confirmation from the user before proceeding.

For a DAF application to respond to Easy Activation requests, it must be able to display an application icon and warning message at the start of the authentication process. The user can confirm or reject the request at this stage; if it is confirmed, authentication proceeds in exactly the same way as an ordinary 'unlock' sequence.

UI changes

On iOS, UI is launched when DAFAppBase::getUIForAction:withResult: is called.

Version 2.0 of the DAF SDK added a new DAFUIAction value called GetAuthToken_WithWarning. This is similar to the GetAuthToken UI, except that:

It must display an icon and warning message to the user.
It must add an option for the user to cancel the requested operation.

This new UI can be made with additions to the existing 'Unlock' view controller, or using a separate piece of code, at the discretion of the application designer. The icon and warning message are properties of a DAFAuthenticationWarning object; see DAFAppBase::authWarning for the warning for the current operation.

If the user chooses to cancel the request, the UI controller should call DAFAppBase::cancelAuthenticateWithWarn:, and the appropriate action will be taken by the DAF support library. If the user accepts the request, the UI controller should proceed as for GetAuthToken (i.e. returning an authToken data block to be passed to DADevice::createSession).

Future releases of the DAF SDK may add other types of authentication request which require a warning. These will be reflected in new DAFAuthenticationWarning::DAFWarningReason values.