capacitor-firebase-appcheck


Allows usage of native AppCheck tokens in a Capacitor Hybrid application.
From the Firebase Docs:
>App Check works alongside other Firebase services to help protect your backend resources from abuse, such as billing fraud or phishing.

Install

``bash
npm install capacitor-firebase-appcheck
npx cap sync
`

$3

You must enable AppCheck within your Firebase Project before installing this plugin. The location for both iOS and Android is the same, but the requirements for both are slightly different. See below for getting AppCheck set
up in your console (note, you only need to follow step one as this plugin takes the place of everything after):

Set up AppCheck on iOS with AppAttest (>iOS 14)

Set up AppCheck on iOS with DeviceCheck (

Set up AppCheck on Android with SafetyNet


$3

For iOS, you need to ensure firebase is set up in your project before continuing. You
can use this link to the iOS Firebase Docs to see how to set up your project.

$3

For Android, you also need to ensure firebase is set up in your project before continuing. You
can use this link to the Android Firebase Docs (Step 3) to see how to set up your project.

Usage

`typescript
// import firebase and appcheck
import { firebase } from 'firebase';
import { AppCheck } from 'capacitor-firebase-appcheck';

try {
// initialise AppCheck
AppCheck.initialize({
// enable debugging if in staging or dev environments. Default is false.
debug: true
});

// create custom appcheck provider
const appCheckCustomProvider = {
getToken: async () => {
// get the token from native
const { token, exp: expTimeMillis } = await AppCheck.getAppCheckToken();

return {
token,
expireTimeMillis
}
}
}

// activate appcheck [set true to refresh the token automatically on expiry]
firebase.appCheck().activate(appCheckCustomProvider, true);


} catch (err) {
// log any errors
console.error(err);
}
`

API

- capacitor-firebase-appcheck
- Install
- Prereqs
- iOS
- Android
- Usage
- API
- initialize(...)
- getAppCheckToken()
- Interfaces
- InitializationOptions
- AppCheckToken
- Contributors ✨




$3

`typescript
initialize(options?: InitializationOptions | undefined) => Promise
`

A method to initialise the AppCheck plugin. This must be called once and once only before
calling any other method. Returns true on success or false on failure. Check native logs to
see the actual problem.

| Param | Type |
| ------------- | ----------------------------------------------------------------------- |
| options | InitializationOptions |

Returns: boolean

Since: 1.0.0

--------------------




$3

`typescript
getAppCheckToken() => Promise
`

Get's the native AppCheck token from AppAttest/DeviceCheck on iOS[>=14/<14] or SafetyNet on Android.

Returns: Promise\<AppCheckToken\>

Since: 1.0.0

--------------------




$3


#### InitializationOptions

| Prop | Type | Description | Since |
| ----------- | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----- |
| debug | boolean | If debug is enabled, the native environment will log debug creds and use debug mode. Intended to be used with staging or development environmnets only. Do not set this to TRUE in production. | 1.0.0 |

#### AppCheckToken

| Prop | Type | Description | Since |
| ---- | ---- | ----------- | ----- |
| token | string | The token provided by the native environment to be sent to firebase. | 1.0.0 |
| exp` | number | The expiration date of the token in milliseconds since epoch [Unix time] | 1.0.0 |

Contributors ✨

Thanks goes to these wonderful people (emoji key):

Matt Milan 💻

This project follows the all-contributors specification. Contributions of any kind welcome!