GuardpostKit

An iOS framework for integrating with Guardpost.

Requires iOS 13 or greater.

How to use

1. Get GuardpostKit into your project.
2. Import the module:

import GuardpostKit

3. Create a guardpost object, supplying the endpoint, SSO secret and URL scheme for the current app:

let guardpost = Guardpost(baseUrl: "https://guardpost.rwdev.io",
                        urlScheme: "com.razeware.guardpost-demo://",
                        ssoSecret: "<SSO_SECRET>")

4. Ensure that your app is registered for the specified URL scheme:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLName</key>
    <string>com.razeware.guardpost-demo</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>com.razeware.guardpost-demo</string>
    </array>
  </dict>
</array>

5. Use the currentUser property to determine whether a user is currently logged in. Their profile is stored in the keychain, so persists between restarts, and backups.
6. Use the login() method to initiate a login, providing a closure to handle the result of the login.
7. Use the logout() method to remove the user from the keychain.

Demo App

The demo app shows GuardpostKit in action.

Testing

There are a few tests written. There should probably be some more.

Requirements

This framework requires a minimum of iOS 13.