https://github.com/stanfordspezi/spezistorage
Spezi module to store information and credentials encrypted at rest
https://github.com/stanfordspezi/spezistorage
encryption spezi stanford storage swift xcode
Last synced: 4 months ago
JSON representation
Spezi module to store information and credentials encrypted at rest
- Host: GitHub
- URL: https://github.com/stanfordspezi/spezistorage
- Owner: StanfordSpezi
- License: mit
- Created: 2023-04-05T17:58:18.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2024-10-30T17:12:54.000Z (over 1 year ago)
- Last Synced: 2024-11-12T12:54:17.554Z (over 1 year ago)
- Topics: encryption, spezi, stanford, storage, swift, xcode
- Language: Swift
- Homepage: https://swiftpackageindex.com/StanfordSpezi/SpeziStorage/documentation/
- Size: 127 KB
- Stars: 5
- Watchers: 8
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Citation: CITATION.cff
Awesome Lists containing this project
README
# Spezi Storage
[](https://github.com/StanfordSpezi/SpeziStorage/actions/workflows/build-and-test.yml)
[](https://codecov.io/gh/StanfordSpezi/SpeziStorage)
[](https://doi.org/10.5281/zenodo.7804028)
[](https://swiftpackageindex.com/StanfordSpezi/SpeziStorage)
[](https://swiftpackageindex.com/StanfordSpezi/SpeziStorage)
The Spezi Storage framework provides two Modules that enable on-disk storage of information.
The [`LocalStorage`](https://swiftpackageindex.com/stanfordspezi/spezistorage/documentation/spezilocalstorage/localstorage) module can be used to store information that does not need to be encrypted.
Credentials, keys, and other sensitive information that needs to be encrypted may be stored by using the [`KeychainStorage`](https://swiftpackageindex.com/StanfordSpezi/SpeziStorage/documentation/spezikeychainstorage) module.
## Setup
You need to add the Spezi Storage Swift package to
[your app in Xcode](https://developer.apple.com/documentation/xcode/adding-package-dependencies-to-your-app#) or
[Swift package](https://developer.apple.com/documentation/xcode/creating-a-standalone-swift-package-with-xcode#Add-a-dependency-on-another-Swift-package).
> [!IMPORTANT]
> If your application is not yet configured to use Spezi, follow the [Spezi setup article](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi/initial-setup) to set up the core Spezi infrastructure.
You can configure the [`LocalStorage`](https://swiftpackageindex.com/stanfordspezi/spezistorage/documentation/spezilocalstorage/localstorage) or [`KeychainStorage`](https://swiftpackageindex.com/StanfordSpezi/SpeziStorage/documentation/spezikeychainstorage) module in the [`SpeziAppDelegate`](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi/speziappdelegate).
> [!IMPORTANT]
> If you use SpeziStorage on the macOS platform, ensure to add the [`Keychain Access Groups` entitlement](https://developer.apple.com/documentation/bundleresources/entitlements/keychain-access-groups) to the enclosing Xcode project via *PROJECT_NAME > Signing&Capabilities > + Capability*. The array of keychain groups can be left empty, only the base entitlement is required.
```swift
import Spezi
import SpeziLocalStorage
import SpeziKeychainStorage
class ExampleDelegate: SpeziAppDelegate {
override var configuration: Configuration {
Configuration {
LocalStorage()
KeychainStorage()
// ...
}
}
}
```
You can then use the `LocalStorage` or `KeychainStorage` class in any SwiftUI view.
```swift
struct ExampleStorageView: View {
@Environment(LocalStorage.self) var localStorage
@Environment(KeychainStorage.self) var keychainStorage
var body: some View {
// ...
}
}
```
Alternatively, it is common to use the `LocalStorage` or `KeychainStorage` module in other modules as a dependency: [Spezi Module dependencies](https://swiftpackageindex.com/stanfordspezi/spezi/documentation/spezi/module-dependency).
## Local Storage
The `LocalStorage` module enables the on-disk storage of data in mobile applications.
The `LocalStorage` module defaults to storing data encrypted supported by the `KeychainStorage` module.
The [`LocalStorageKey`](https://swiftpackageindex.com/stanfordspezi/spezistorage/documentation/spezilocalstorage/localstoragekey) type is used to define storage entries, and specify how data should be persisted.
## Keychain Storage
The `KeychainStorage` module allows for the encrypted storage of small chunks of sensitive user data, such as usernames and passwords for internet services, or cryptographic keys, using Apple's [Keychain documentation](https://developer.apple.com/documentation/security/keychain_services/keychain_items/using_the_keychain_to_manage_user_secrets).
Credentials can be stored in the Secure Enclave (if available) or the Keychain. Credentials stored in the Keychain can be made synchronizable between different instances of user devices.
### Handling Credentials
Use the `KeychainStorage` module to store a set of [`Credentials`](https://swiftpackageindex.com/stanfordspezi/spezistorage/documentation/spezikeychainstorage/credentials) instances in the Keychain associated with a server that is synchronizable between different devices.
### Handling Keys
Similar to `Credentials` instances, you can also use the `KeychainStorage` module to interact with cryptographic keys.
For more information, please refer to the [API documentation](https://swiftpackageindex.com/StanfordSpezi/SpeziStorage/documentation).
## The Spezi Template Application
The [Spezi Template Application](https://github.com/StanfordSpezi/SpeziTemplateApplication) provides a great starting point and example using the Spezi Storage module.
## Contributing
Contributions to this project are welcome. Please make sure to read the [contribution guidelines](https://github.com/StanfordSpezi/.github/blob/main/CONTRIBUTING.md) and the [contributor covenant code of conduct](https://github.com/StanfordSpezi/.github/blob/main/CODE_OF_CONDUCT.md) first.
## License
This project is licensed under the MIT License. See [Licenses](https://github.com/StanfordSpezi/SpeziStorage/tree/main/LICENSES) for more information.
