ForgeRock SDK for iOS

Change Log · Support · Docs

---

The ForgeRock iOS SDK enables you to quickly integrate the ForgeRock Identity Platform into your iOS apps.

Use the SDKs to leverage Intelligent Authentication in ForgeRock's Access Management (AM) product, to easily step through each stage of an authentication tree by using callbacks.

Requirements

• ForgeRock Identity Platform
  • Access Management (AM) 6.5.2+
• iOS 10, 11, 12, 13
• Xcode 11.0 or later
• Swift 5.x or Objective-C
• CocoaPods dependency manager

Installation

pod 'FRAuth' // Authentication module for Access Manager
pod 'FRUI' // UI SDK demonstrates FRAuth SDK functionalities
pod 'FRProximity' // Add-on for FRAuth's Device Profile feature related to location, and BLE
pod 'FRAutheneticator' // Authenticator module that generates HOTP, TOTP, and Push registration/authentication

Getting Started

To try out the ForgeRock iOS SDK sample, perform these steps:

1. Setup an Access Management (AM) instance, as described in the documentation.
2. Clone this repo:

   git clone https://github.com/ForgeRock/forgerock-ios-sdk.git
   

3. Open the /SampleApps/FRExample.xcworkspace file in Xcode.
4. Open /FRExample/FRExample/Configs/FRAuthConfig.plist and edit the values to match your AM instance.
5. Ensure the active scheme is "FRExample-Swift", and then click the Run button.

Samples

ForgeRock provides these samples to help demonstrate SDK functionality:

• Swift Sample - /FRExample/

  This sample Swift app demonstrates authenticating to an AM instance, both with and without the FRUser automatic user interface.

  Other features include:

  • OAuth 2.0 access tokens
  • Logout
  • Collecting device information
  • Get the current user's details
  • Jailbreak detection

  Configure your AM instance settings in the /FRexampleObjC/FRexampleObjC/Configs/FRAuthConfig.plist file to use this sample application.

• Objective-C Sample - /FRexampleObjC/

  This sample Objective-C app demonstrates authenticating to an AM instance, both with and without the FRUser automatic user interface.

  Other features include:

  • Logout
  • Collecting device information
  • Get the current user's details
  • Jailbreak detection

  Configure your AM instance settings in the /FRExample/FRExample/Configs/FRAuthConfig.plist file to use this sample application.

• Authenticator App Sample - /FRAuthenticatorExample/ This Authenticator sample app demonstrates HMAC-based, and Time-based One-time Password, and Push Registration and Authentication with ForgeRock's Access Manager.

Documentation

Documentation for the SDKs is provided at https://sdks.forgerock.com, and includes topics such as:

• Introducting the SDK Features
• Preparing AM for use with the SDKS
• API Reference documentation

Support

If you encounter any issues, be sure to check our Troubleshooting pages.

Support tickets can be raised whenever you need our assistance; here are some examples of when it is appropriate to open a ticket (but not limited to):

• Suspected bugs or problems with ForgeRock software.
• Requests for assistance - please look at the Documentation and Knowledge Base first.

You can raise a ticket using BackStage, our customer support portal that provides one stop access to ForgeRock services.

BackStage shows all currently open support tickets and allows you to raise a new one by clicking New Ticket.

Contributing

If you would like to contribute to this project you can fork the repository, clone it to your machine and get started.

Disclaimer

This code is provided on an “as is” basis, without warranty of any kind, to the fullest extent permitted by law.

ForgeRock does not warrant or guarantee the individual success developers may have in implementing the code on their development platforms or in production configurations.

ForgeRock does not warrant, guarantee or make any representations regarding the use, results of use, accuracy, timeliness or completeness of any data or information relating to this code.

ForgeRock disclaims all warranties, expressed or implied, and in particular, disclaims all warranties of merchantability, and warranties related to the code, or any service or software related thereto.

ForgeRock shall not be liable for any direct, indirect or consequential damages or costs of any type arising out of any action taken by you or others related to the code.

License

This project is licensed under the MIT License - see the LICENSE file for details

---

© Copyright 2020 ForgeRock AS. All Rights Reserved