Skip to content


Repository files navigation


Version CircleCI Coverage Status License

📚 Documentation • 🚀 Getting Started • 💬 Feedback

Migrating from v1? Check the Migration Guide.


Getting Started


  • iOS 9+
  • Xcode 13.x / 14.x
  • Swift 4.x / 5.x

Lock.swift uses Auth0.swift 1.x.



Add the following line to your Podfile:

pod "Lock", "~> 2.24"

Then, run pod install.


Add the following line to your Cartfile:

github "auth0/Lock.swift" ~> 2.24

Then, run carthage bootstrap --use-xcframeworks --platform iOS.

Swift Package Manager

Open the following menu item in Xcode:

File > Add Packages...

In the Search or Enter Package URL search box enter this URL:

Then, select the dependency rule and press Add Package.

Configure the SDK

Head to the Auth0 Dashboard and create a new Native application.

Lock.swift needs the Client ID and Domain of the Auth0 application to communicate with Auth0. You can find these details in the settings page of your Auth0 application. If you are using a custom domain, use the value of your custom domain instead of the value from the settings page.

Configure Client ID and Domain with a plist

Create a plist file named Auth0.plist in your app bundle with the following content:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "">
<plist version="1.0">

Configure Client ID and Domain programmatically

For Classic Lock
    .classic(clientId: "YOUR_AUTH0_CLIENT_ID", domain: "YOUR_AUTH0_DOMAIN")
    // ...
For Passwordless Lock
    .passwordless(clientId: "YOUR_AUTH0_CLIENT_ID", domain: "YOUR_AUTH0_DOMAIN")
    // ...

Configure your app

Make sure Lock.swift can receive callback URLs.

Using the UIKit app lifecycle
// AppDelegate.swift

import Lock

// ...

func application(_ app: UIApplication,
                 open url: URL,
                 options: [UIApplication.OpenURLOptionsKey: Any]) -> Bool {
    return Lock.resumeAuth(url, options: options)
Using the UIKit app lifecycle with Scenes
// SceneDelegate.swift

import Lock

// ...

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    Lock.resumeAuth(url, options: [:])

Next steps

Learn how to use Lock.swift in Examples ↗

  • Lock Classic - handles authentication using Database, Social, and Enterprise connections.
  • Lock Passwordless - handles authentication using Passwordless and Social connections.



We appreciate feedback and contribution to this repo! Before you get started, please see the following:

Raise an issue

To provide feedback or report a bug, please raise an issue on our issue tracker.

Vulnerability reporting

Please do not report security vulnerabilities on the public GitHub issue tracker. The Responsible Disclosure Program details the procedure for disclosing security issues.

Auth0 Logo

Auth0 is an easy to implement, adaptable authentication and authorization platform. To learn more checkout Why Auth0?

This project is licensed under the MIT license. See the LICENSE file for more info.