Open the sign-in page

To sign in users, open a browser and display the Okta-hosted sign-in page.

To learn how to customize the sign-in page, see Style the Widget.

• Android
• iOS
• React Native

Before using the SDK, you have to create a new OktaOidc object. You can instantiate OktaOidc without parameters. If you do that, the SDK uses Okta.plist for configuration values. Alternatively, you can create the OktaOidc instance with a custom configuration.

import OktaOidc

// Use the default Okta.plist configuration
let oktaOidc = OktaOidc()

// Use configuration from another resource
let config = OktaOidcConfig(/* plist */)
// or: let config = OktaOidcConfig(/* dictionary */)

// Instantiate OktaOidc with custom configuration object
let oktaOidc = OktaOidc(configuration: config)

Start the authorization flow by simply calling signInWithBrowser on OktaOidc. After a successful sign-in, this operation returns a valid OktaOidcStateManager instance in its callback:

oktaOidc.signInWithBrowser(from: self) { stateManager, error in
    if let error = error {
        // Error
        return
    }
    
    // #1 Store instance of stateManager into the iOS keychain
    stateManager.writeToSecureStorage()

    // #2 Use tokens
    print(stateManager.accessToken)
    print(stateManager.idToken)
    print(stateManager.refreshToken)
}

To restore the OktaOidcStateManager object from the iOS keychain, do the following:

1. Create the OktaOidcConfig object with the same config data that you used for the browser sign-in process.
2. Call the OktaOidcStateManager.readFromSecureStorage function and pass the OktaOidcConfig object as a parameter:

let config = OktaOidcConfig(/* plist */)
authStateManager = OktaOidcStateManager.readFromSecureStorage(for: config)

Next: Get info about the user