Authentication

1. Create an Account

1. Navigate to the Presage Developer Admin Service Portal
2. Click Register and fill in your email, password, and other required fields.
3. Check your email for a confirmation link and follow it to activate your account.

2. Log In

1. Go to the Presage Developer Admin Portal Login
2. Enter your email and password, then click Submit.
3. After successful login you will be redirected to your Portal page, where you can manage your API key and Apps registered for OAuth Authentication.

3a. API Key

⚠️ Warning: API Keys are intended for quick testing and local development. For production workloads, use the OAuth 2.0 flow with short-lived tokens.

How to include your API Key

1. In your Dashboard, copy the Active API Key and then follow your platform's documentation:

• Swift (iOS)
• Android

3b. Register an OAuth App

Note: OAuth is currently only supported for iOS and Android. If you are using a different platform, please use the API Key method.

On your Account → Registered App for OAuth section:

1. Select your platform:

   • Apple
   • Android

2. Enter your App ID (bundle identifier or package name).

   • How to find your Apple Bundle ID
   • How to find your Android App ID

3. Provide your Org ID if you're registering an Apple App or your Signing Key SHA-256 fingerprint if registering an Android App:

   • Apple: Org ID (e.g. AB12CDE34F)
     • How to find your Org ID
   • Android: Certificate SHA-256 fingerprint

     • Android OAuth is currently documented for Play Store releases

     • How to find your Signing Key SHA-256 fingerprint

     • To get the SHA-256 fingerprint from your release keystore, run:

       keytool -list -v -keystore <path-to-keystore> -alias <key-alias> -storepass <store-password> | grep SHA256

       For example, for the debug keystore:

       keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android | grep SHA256

4. Click Register App ID.

4. Download Your Configuration File

Once your app appears in the Registered App(s) for OAuth table:

• Apple Click Download .plist to fetch a PresageService-Info.plist file and store it in the root of your App's repo. No additional code/configuration for authentication is needed.

• Android Click Download .xml to fetch a presage_services.xml file and store it at /src/main/res/xml/presage_services.xml. No additional code/configuration for authentication is needed.