Reference Apps

Refer to these reference apps while you implement Auth Connect.

Most of these demo applications use Capacitor for the native layer. While we suggest using Capacitor in your application as well, the logic contained within the applications themselves remains the same if you are using Cordova.

General#

Multiple Providers (Angular)#

The following demo app demonstrates the configuration required for several of the supported OIDC providers. It's suggested to start with this demo in order to establish the configuration for your provider. To do this:

  • Update the appropriate configuration in the environment files to match the configuration of your OIDC provider.
  • Update the appHost in the environment files to match the custom scheme you plan on using for your app. We suggest using something based on your bundle ID.
  • Update the AndroidManifest.xml and Info.plist files accordingly.
  • The demo app uses callback routes such as msauth://login. If the portion you are using after the protocol differs, update the appropriate service accordingly.

Note: This demo covers the "big four" providers. However, if you are using something else you can still use the application as a model to add your own provider by following the same basic pattern or by modifying one of the existing configurations to use something else.

Ionifits (Angular)#

Ionifits is an example implementation of a Human Resources app (the name is a play on Zenefits, by which it's inspired). It utilizes the complete Ionic enterprise stack, including a UI powered by Ionic Framework, native apps built with Capacitor, mobile CI/CD with Appflow, authentication powered by Auth Connect and Identity Vault, and encrypted data storage powered by Secure Storage.

Auth0 (Angular)#

  1. Simple: A login/logout experience in an Ionic Angular app. Used in a companion Auth0 article.

Azure AD B2C (Angular)#

  1. Simple: A login/logout experience that works on the web, iOS, and Android. See it in action in this short video. To view the Azure AD configuration details, see authentication.service.ts here.

  2. Advanced: Demonstrates the use of Auth Connect to perform an OAuth login and Identity Vault to store the resulting authentication tokens on the web, iOS, and Android. To view the Azure AD configuration details, see authentication.service.ts here.

  3. Advanced: Demonstrates a complete login/logout experience using Azure. This demo uses Ionic Identity Vault in order to securely store the tokens returned from Azure.