saltedge / sca-authenticator-ios

Salt Edge Authenticator - application that meets Strong Customer Authentication requirements (PSD2)
GNU General Public License v3.0
7 stars 6 forks source link
psd2 sca

Build Status CocoaPods Compatible GPLv3 license Gitter Twitter URL


Logo

Salt Edge Authenticator App - Strong Customer Authentication Solution


Explore our Wiki »

Salt Edge Authenticator iOS Client

Salt Edge Authenticator iOS Client - is a mobile client of Authenticator API of Bank (Service Provider) System system that implements Strong Customer Authentication/Dynamic Linking process.
The purpose of Authenticator iOS Client is to add possibility to authorize required actions for end-user.

You can download mobile application:

Get it on App Store

Source code

You can find related source code:

How it works

Prerequisites

SDK remote installation via CocoaPods

Add the pod to your Podfile

  pod 'SaltedgeAuthenticatorSDK', '~> 1.1.1'

To install pods, run next command in terminal:

pod install

Import SDK into your app

import SEAuthenticator

SDK local installation via CocoaPods

Copy required Salt Edge SDKs directories to your project

  1. Core module, required for both SDKs versions
  2. SDK v1
  3. SDK v2

Add Salt Edge SDK pods to your Podfile, specifying the path to SDK

  pod 'SaltedgeAuthenticatorCore', :path => 'path_to_SaltedgeAuthenticatorCore'
  pod 'SaltedgeAuthenticatorSDK', :path => 'path_to_SaltedgeAuthenticatorSDK'
  pod 'SaltedgeAuthenticatorSDKv2', :path => 'path_to_SaltedgeAuthenticatorSDKv2'

To install pods, run next command in terminal:

pod install

Import required SDKs into your app

  import SEAuthenticatorCore
  import SEAuthenticatorV2

How to build Salt Edge Authenticator app locally

You can install app from Apple App Store or build from source code.

  1. Fork this repository
  2. Open terminal
  3. Move to project directory sca-authenticator-ios/Example
  4. Command in terminal: bundle install (To install all required gems)
  5. Command in terminal: pod install (To install all required pods)

    If pod install fails on M1 Macs, do next:

    sudo arch -x86_64 gem install ffi
    arch -x86_64 pod update

    Also make sure you set the arm64 values in the "Build Settings" -> "Architectures" -> "Excluded Architectures".

  6. Open project's workspace file in Xcode (Example/Authenticator.xcworkspace)
  7. Create application.plist configuration file using application.example.plist
  8. If you have intent to use Firebase Crashlytics then generate GoogleService-info.plist and add it to project.
  9. Build and run application on target device or simulator

Contribute

In the spirit of free software, everyone is encouraged to help improve this project.

Contact us

Feel free to contact us

License

Salt Edge Authenticator (SCA solution) is multi-licensed, and can be used and distributed:

More information about licenses.

Additional permission under GNU GPL version 3 section 7
If you modify this Program, or any covered work, by linking or combining it with THIRD PARTY LIBRARY (or a modified version of that library), containing parts covered by the TERMS OF LIBRARY's LICENSE, the licensors of this Program grant you additional permission to convey the resulting work. {Corresponding Source for a non-source form of such a combination shall include the source code for the parts of LIBRARY used as well as that of the covered work.}

AppStore Legal Notice
APP_STORE_NOTICE


Copyright © 2019 Salt Edge. https://www.saltedge.com