Skip to content

README.md

Latest commit

 

History

History
executable file
·
49 lines (33 loc) · 3.16 KB

README.md

File metadata and controls

executable file
·
49 lines (33 loc) · 3.16 KB

Quickstart: Java for Android with FusionAuth

This project contains an Android application that works with a locally-running instance of FusionAuth, the authentication and authorization platform.

Setup

Prerequisites

You will need the following things properly installed on your computer.

  • Android Studio: The official IDE for Android will help you develop and install necessary tools to set it up.
    • At least Java 17 (which you can install via Android Studio)
  • Docker: The quickest way to stand up FusionAuth. Ensure you also have docker compose installed.
  • (Alternatively, you can Install FusionAuth Manually).

FusionAuth Installation via Docker

The root of this project directory (next to this README) are two files: a Docker compose file and an environment variables configuration file. Assuming you have Docker installed on your machine, you can stand up FusionAuth up on your machine with:

docker compose up -d

The FusionAuth configuration files also make use of a unique feature of FusionAuth, called Kickstart: when FusionAuth comes up for the first time, it will look at the Kickstart file and mimic API calls to configure FusionAuth for use when it is first run.

NOTE: If you ever want to reset the FusionAuth system, delete the volumes created by Docker Compose by executing docker compose down -v.

FusionAuth will be initially configured with these settings:

  • Your client Id is: e9fdb985-9173-4e01-9d73-ac2d60d1dc8e
  • Your client secret is: super-secret-secret-that-should-be-regenerated-for-production
  • Your example username is richard@example.com and your password is password.
  • Your admin username is admin@example.com and your password is password.
  • Your fusionAuthBaseUrl is http://localhost:9011/

You can log into the FusionAuth admin UI and look around if you want, but with Docker/Kickstart you don't need to.

Running the Android App

  • Open this project's complete-application folder in Android Studio.
  • Expose FusionAuth to the internet, via a tool like ngrok.
  • Update the tenant Issuer value to be the public FusionAuth URL.
  • Create new JWT signing keys.
  • Update the discovery_uri field in complete-application/app/res/raw/auth_config.json with the value of the public FusionAuth hostname.
  • Either connect a hardware device or create an Android Virtual Device to run the Android Emulator.
  • Build and run the app following Android Studio guidelines.

Further Information

Visit https://fusionauth.io/docs/quickstarts/quickstart-android-java-native for a step-by-step guide on how to build this Android app from scratch, including more details about the tenant and application settings.