{"id":19214942,"url":"https://github.com/carekit-apple/ibm-hyperprotectsdk","last_synced_at":"2025-05-12T23:21:32.568Z","repository":{"id":115175471,"uuid":"246693739","full_name":"carekit-apple/IBM-HyperProtectSDK","owner":"carekit-apple","description":"The IBM Hyper Protect iOS SDK for CareKit is an addon for the CareKit framework that consumes IBM Hyper Protect Services for zero-trust persistent cloud storage and bi-directional synchronization across multiple devices with just 2 lines of code","archived":false,"fork":false,"pushed_at":"2020-09-02T23:03:59.000Z","size":780,"stargazers_count":12,"open_issues_count":1,"forks_count":5,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-04-20T19:37:18.199Z","etag":null,"topics":["ios-swift","mbaas","mongodb","security","typescript"],"latest_commit_sha":null,"homepage":"http://ibm.biz/hyperprotectservices","language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/carekit-apple.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-03-11T22:37:21.000Z","updated_at":"2024-05-04T09:49:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"26fbe980-ddcc-414e-9ac1-7fa40248850a","html_url":"https://github.com/carekit-apple/IBM-HyperProtectSDK","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carekit-apple%2FIBM-HyperProtectSDK","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carekit-apple%2FIBM-HyperProtectSDK/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carekit-apple%2FIBM-HyperProtectSDK/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carekit-apple%2FIBM-HyperProtectSDK/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carekit-apple","download_url":"https://codeload.github.com/carekit-apple/IBM-HyperProtectSDK/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253838082,"owners_count":21972091,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ios-swift","mbaas","mongodb","security","typescript"],"created_at":"2024-11-09T14:11:58.967Z","updated_at":"2025-05-12T23:21:32.560Z","avatar_url":"https://github.com/carekit-apple.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"# IBM Hyper Protect SDK for iOS\n\nThis SDK implements CareKit's Remote Synchronization API and must be coupled with the backend SDK [IBM-HyperProtectMBaaS](https://github.com/carekit-apple/IBM-HyperProtectMBaaS) on the server side.\n\n_Note, this is a pre-1.0 release and is still in beta_\n\n### Roadmap\n\n- [ ] Logging with OSLog\n- [ ] OAuth2 support with JWT\n- [x] Bi-directional Synchronization of other high level entities (Contact, CarePlan, Patient)\n- [ ] Comprehensive integration tests\n- [ ] Comprehensive system tests\n- [ ] OpenAPI Specification template\n- [ ] IBM Cloud Starter Kit support\n- [ ] Travis Build Support\n- [ ] Large object support ( \u003e 16 MB)\n\n### Getting Started\n\nThis package can be imported into XCode using Swift Package Manager:\n\n![spm-add-packages](./docs/spm-add-package.png)\n\n![spm-add-git-url](./docs/spm-add-git-url.png)\n\n![spm-git-master](./docs/spm-git-master.png)\n\n![spm-add-target](./docs/spm-add-target.png)\n\nNow import the package with\n\n```swift\nimport IBMHyperProtectSDK\n```\n\nand pass it in to your OCKStore:\n\n```swift\n\nlet remote = IBMMongoRemote(/* credentials and connection information */)\nlet store = OCKStore(name: \"SampleAppStore\", type:\n  inMemory, remote: remote)\n```\n\nBy default if no backend API information is passed in, it will default to `https://localhost:3000` . Pass in the `apiLocation` parameter to point to your IBM Hyper Protect MBaaS deployed locally for development or in IBM Cloud. If the MBaaS is deployed to the IBM Cloud, a certificate may be needed to go through the authentication challenge. This certificate may be added to your project folder. If no value is passed into `certificate`, it will default to `carekit-root`.\n\n### Contributing\n\nWe're always looking for contributors to help improve the CareKit and IBM Hyper Protect community. Please follow the [guide](./CONTRIBUTING.md)\n\n### Known Issues:\n\n* When using the IBM Hyper Protect SDK, you must also include CareKit in your app via SPM. Including CareKit using the traditional sub-project approach can cause runtime errors in the CoreData stack.\n* As XCode and iOS prevent insecure connections by default, you *must* use SSL/TLS (https) for your connections. There are work-arounds but given that security is a core tennant of this SDK, we do not recommend skipping SSL/TLS, even in developement/testing.\n* The backend of this SDK uses MongoDB which has a limit of 16 MB. An external object store must be used for objects larger than 16 MB (or segmented to fit the 16 MB limit). We are investigating GridFS support for larger objects.\n\n### Self-Paced Lab:\n\nDetailed end-to-end instructions for deploying the [IBM-HyperProtectMBaaS](https://github.com/carekit-apple/IBM-HyperProtectMBaaS) and the iOS SDK (this project) with a CareKit sample app are provided [here](https://github.com/THINKLab2020/carekit-hyperprotect-lab).","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarekit-apple%2Fibm-hyperprotectsdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarekit-apple%2Fibm-hyperprotectsdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarekit-apple%2Fibm-hyperprotectsdk/lists"}