ForgeRock Developer Experience

Apple iOS tutorials

To complete these tutorials successfully, you must first configure your server.

Configure your server

Select your server environment below for instructions on creating the necessary configuration to successfully complete these tutorials:

Tutorial steps

There are two tutorials available for iOS, depending on your server environment:

ForgeRock logo

This tutorial guides you through creating a ForgeRock SDK-enabled iOS app from beginning to end.

It uses embedded login to implement user authentication journeys, meaning you get to design and implement the user interface to your requirements.

Step 1. Create a new app project

In this step, you set up your environment to create iOS applications using the freely-available Xcode IDE.

Step 2. Integrate the SDK into your app

In this step, You configure the project to use the ForgeRock SDK for iOS.

You can choose between CocoaPds (recommended), Swift Package Manager, or embedding the project manually.

Step 3. Initialize the SDK

In this step, you enable debug logging during development.

You then and add a call to the FRAuth.start() method, which initializes the SDK and loads the configuration you define in the next step.

Step 4. Configuration file properties

In this step, you learn about the settings you need to connect to your ForgeRock Identity Cloud or AM instance.

Step 5. Configure the SDK

In this step, you create a file to contain the settings you need to connect to your ForgeRock Identity Cloud or AM instance.

Step 6. Understand the authentication flow

In the step you learn how to handle authentication trees and their callbacks.

Step 7. Prerequisites for authentication

Verify that your source code is ready to perform authentication.

Step 8. Enable authentication

Learn how to start an authentication journey in your app.

Step 9. Collect the username and password

Implement UI controls to collect a username and password.

Step 10. Test authentication

Run the app and test that you can authenticate.

PingIdentity logo

Configure a sample iOS app to launch a browser to authenticate your users in PingOne, using centralized login.

After authenticating, PingOne redirects users back to your sample client application, that can then get OAuth 2.0 tokens and user info for the user.

Step 1. Download the ForgeRock SDK for iOS

In this step, you download the ForgeRock SDK for iOS repo, which contains the projects you will use.

Step 2. Configure the sample app

In this step, you configure the "FRExample" sample to connect to the OAuth 2.0 application you created in PingOne, using the centralized login method.

Step 3. Run the sample app and perform centralized login

In this final step, you run the sample app that you configured in the previous step.

The app performs a centralized login on your PingOne instance.