README.md (4054B)
[Android Components](../../../README.md) > Service > Firefox Sync - Logins
A library for integrating with Firefox Sync - Logins.
Before using this component
Products sending telemetry and using this component must request a data-review following this process. This component provides data collection using the Glean SDK. The list of metrics being collected is available in the metrics documentation.
Motivation
The Firefox Sync - Logins Component provides a way for Android applications to do the following:
- Retrieve the Logins (url / password) data type from Firefox Sync
Usage
Before using this component
The mozilla.appservices.logins component collects telemetry using the Glean SDK.
Applications that send telemetry via Glean must ensure they have received appropriate data-review following
the Firefox Data Collection process before integrating this component.
Details on the metrics collected by the mozilla.appservices.logins component are available
here
Setting up the dependency
Use Gradle to download the library from maven.mozilla.org (Setup repository):
implementation "org.mozilla.components:service-sync-logins:{latest-version}"
You will also need the Firefox Accounts component to be able to obtain the keys to decrypt the Logins data:
implementation "org.mozilla.components:fxa:{latest-version}
Known Issues
- Android 6.0 is temporary not supported and will probably crash the application.
API
This implements the login-related interfaces from mozilla.components.concept.storage.
FAQ
Which exceptions do I need to handle?
It depends, but probably only SyncAuthInvalid, but potentially IncorrectKey.
- You need to handle
SyncAuthInvalid. You can do this by refreshing the FxA authentication (you should only do this once, and not in e.g. a loop). Most/All consumers will need to do this.
IncorrectKey: If you're sure the key you have used is valid, the only way to handle this is likely to delete the file containing the database (as the data is unreadable without the key). On the bright side, for sync users it should all be pulled down on the next sync.
NoSuchRecord,InvalidRecordall indicate problems with either your code or the arguments given to various functions. You may trigger and handle these if you like (it may be more convenient in some scenarios), but code that wishes to completely avoid them should be able to.
The errors reported as "raw" LoginsApiException are things like Rust panics, errors reported by OpenSSL or SQLcipher, corrupt data on the server (things that are not JSON after decryption), bugs in our code, etc. You don't need to handle these, and it would likely be beneficial (but of course not necessary) to report them via some sort of telemetry, if any is available.
Can I use an in-memory SQLcipher connection with `DatabaseLoginsStorage`?
Just create a DatabaseLoginsStorage with the path :memory:, and it will work. You may also use a SQLite URI filename with the parameter mode=memory. See https://www.sqlite.org/inmemorydb.html for more options and further information.
What's `wipeLocal`?
wipeLocal deletes all local data from the database, bringing us back to the state prior to the first local write (or sync). That is, it returns it to an empty database.
License
This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/