iOS Platform

This topic explains the prerequisites, the process of including and using Tally Authentication Library in the iOS application project, and the available API/methods.

Prerequisites

Tally Authentication Library uses Keychain to store login credentials locally. Mobile application developers should use the same provisioning profile across different versions of the application.

This allows the previously stored data to be used/consumed seamlessly while upgrading the application.

Tally Authentication Library Directory Structure

The directory structure of the Tally Authentication Library for iOS is shown below:

The library for iOS is contained in the TallyAuthenticationLibrary directory. This directory will further contain one file and five subdirectories. To support a specific mode (debug/release) and specific environment of execution (device/simulator), there are four subdirectories. Each subdirectory contains a specific TallyAuthenticationLibrary.a file.

Including the Library in iOS Project

1. Drag and drop the folder Images from the TallyAuthenticationLibrary directory to the application project.

● Select the check box Copy item into destination group’s folder .

● Select the check box Select add to targets .

2. Drag and drop the TallyAuthenticationLibrary.h file to the project.

● Select the check box Copy item into destination group’s folder .

● Select the check box Select Add to targets .

3. Add the file TallyAuthenticationLibrary.a from the corresponding folder to the project as per the environment (device/simulator) and mode (debug/release). To add the file:

● Select the application project to go to the project editor.

● Select the application target to go to the target editor.

● Select the build phases tab .

● Disclose the Link Binary with Libraries phase , and click the plus button in that phase.

● Select Add Other...

● Select the static library, and add it to the phase, to link the application to the static library.

Using the Library in iOS Development

1. Include the following statement in the implementation file of the class where the user authentication functionality is to be added.

#import "TallyAuthenticationLibrary.h"

2. Implement the following TallyAuthenticationDelegate protocol methods

● Specify that the interface implements TallyAuthenticationDelegate .

@interface BaseClassName : NSObject < TallyAuthenticationDelegate >

● Implement AuthenticationSuccessful delegate.

This delegate is called when the user is successfully authenticated.

/ /Implement cancel authentication library delegate method

-( void )AuthenticationSuccessful:( NSDictionary *)pAuthenticationDetails

{

NSLog ( @"User authentication successful with the following details" );

NSLog ( @" Tally.Net ID %@" , [pAuthenticationDetails objectForKey : @"TallyNetID" ]);

NSLog ( @"Library version %@" ,[pAuthenticationDetails objectForKey : @"LibraryVersion" ]);

NSLog( @"Session %@" , [pAuthenticationDetails objectForKey : @"SessionID" ]);

NSLog( @"Online mode %@" ,[pAuthenticationDetails objectForKey : @"OnlineMode" ]);

}

● Implement AuthenticationCancelled delegate.

This delegate is called when the user cancels the authentication process by tapping Cancel .

/ /Implement cancel authentication library delegate method

-( void )AuthenticationCancelled:( NSDictionary *)pAuthenticationDetails

{

NSLog ( @"User cancelled authentication. Last known status details are as follows" );

NSLog ( @"Error code is %@" ,[pAuthenticationDetails objectForKey : @"ErrorCode" ];

NSLog ( @"ErrorDescription is %@" ,[pAuthenticationDetails +

objectForKey : @"ErrorDescription" ]);

NSLog ( @"Library version is %@" , [pAuthenticationDetails +

objectForKey : @"LibraryVersion" ]);

NSLog ( @"Online mode is %@" , [pAuthenticationDetails objectForKey : @"OnlineMode" ]);

}

Note: When the AuthenticationSuccessful/AuthenticationCancelled delegates are called:

♦ The login screen is removed from the UIWindow.

♦ Tally Authentication Library sets the original UIViewController as the present UIViewController.

♦ Application developers need to set the new screen (UIViewController) in these delegates.

3. Create an object of the class TallyAuthenticationLibrary .

TallyAuthenticationLibrary * AuthObj = [[ TallyAuthenticationLibrary alloc] init ];

//Assuming the class which instantiated this objected has implemented the Authentication Library delegate

[AuthObj SetDelegate : self ];

OR

TallyAuthenticationLibrary * AuthObj = [[ TallyAuthenticationLibrary alloc]

initWithDelegate : self ];

4. Set the developer mode to yes when the application is in testing phase.

[AuthObj SetDeveloperMode : YES ];

5. Set the online mode before displaying the login screen.

[AuthObj SetOnlineMode : YES ];

OR

[AuthObj SetOnlineMode : NO ];

6. Call the ShowLoginScreen method to display the login screen.

This method returns yes if the login screen is displayed successfully or it returns no .

if ([AuthObj ShowLoginView ])

{

if ([AuthObj ShowLoginView ])

{

NSLog ( @"Login Screen displayed Successfully" );

}

else

{

NSLog( @"Displaying login screen failed, make sure you have set the delegate" );

}

NSLog( @"Login Screen displayed Successfully" );

}

Else

{

NSLog ( @"Displaying login screen failed, make sure you have set the delegate" );

}

Note: The login screen is not displayed if the AuthenticationLibraryDelegate is not set.

This library contains the following keys from which you can extract the details of authentication:

API/Methods Provided

API/Methods of TallyAuthenticationLibrary are listed below: