Gailu SDK autentifikazioa (DPoP)
vitalera SDK v2-k DPoP (Demonstration of Proof-of-Possession) erabiltzen du autentifikatzeko. Honek tokenak gailuko gako kriptografiko batekin lotzen ditu, token-lapurreta eta berriz erreproduzitzeko erasoak saihestuz — osasun-informazio babestua kudeatzen duen gailu medikoen softwarerako funtsezkoa.
Nola funtzionatzen duen
- Hasieraketa —
VitaleraSdk.builder().clientId("your-org-license-key").build()deitzen duzunean, SDKak DPoP gako-bikote bat sortzen du (Android Keystore-an edo iOS Secure Enclave-n gordeta). - Aktibazioa — SDKak DPoP-rekin sinatutako aktibazio-eskaera bat bidaltzen du vitalera auth zerbitzura. Zerbitzariak erakundearen lizentzia-gakoa balioztatzen du eta DPoP-rekin lotutako sarbide-token bat itzultzen du erakundearen baimenekin batera.
- Baimenen cachea — Baimenak lokalean gordetzen dira 7 eguneko lineaz kanpoko grazia-aldirako. SDKak lineaz kanpo funtzionatzen du gordetako baimenak iraungita ez dauden bitartean.
- Berritze automatikoa — SDKak token-berritzea modu gardenean kudeatzen du. Inoiz ez duzu tokenak eskuz kudeatu behar.
Android (Kotlin)
val sdk = VitaleraSdk.builder()
.context(applicationContext)
.clientId("your-org-license-key") // Organization license key
.addProvider("omron")
.build() // suspend: DPoP key gen + activation
iOS (Swift)
let sdk = try await VitaleraSdk.companion.builder()
.clientId(clientId: "your-org-license-key") // Organization license key
.addProvider(providerName: "omron")
.build() // async: Secure Enclave key gen + activation
Lizentzia-gako bat lortzea
Jarri harremanetan sdk@vitalera.com helbidearekin erakundearen lizentzia-gako bat lortzeko. Gako bakoitza erakunde espezifiko batekin lotuta dago eta hornitzaile-modulu eta funtzionalitate eskuragarriak zehazten ditu.
Lineaz kanpoko funtzionamendua
SDKa gailu medikoen erabilera-kasuetarako diseinatuta dago, non Internet konektibitatea tartekakoa izan daitekeen. Hasierako aktibazioaren ondoren:
- Gailuen eskaneatze eta parekatzea guztiz lineaz kanpo funtzionatzen du.
- Behaketen bilketa BLE gailuetatik guztiz lineaz kanpo funtzionatzen du.
- Datuak lokalean gordetzen dira eta konektibitatea berreskuratzen denean sinkronizatzen dira.
- 7 eguneko grazia-aldiak SDKari aste batez zerbitzariarekin kontakturik gabe funtzionatzea ahalbidetzen dio.
Grazia-aldia konektibitate gabe iraungitzen bada, SDKak berraktibazio bat behar du funtzionamendua jarraitzeko.
Segurtasun-arkitektura
| Geruza | Mekanismoa |
|---|---|
| Gako-biltegia | Android Keystore / iOS Secure Enclave (hardware-an oinarritua) |
| Token-lotura | DPoP frogak token bakoitza gailuaren gako-bikotearekin lotzen du |
| Berriz erreproduzitzeko prebentzioa | DPoP froga bakoitzak jti bakarra eta iat denbora-zigilua du |
| Garraioa | TLS 1.2+ zerbitzariko komunikazio guztietarako |
Hurrengo urratsak
- SDKren ikuspegi orokorra — Arkitektura, moduluak eta hasiera azkarra
- Android SDK erabilera — Android integrazio-gida osoa
- iOS SDK erabilera — iOS integrazio-gida osoa
Laguntza behar duzu?
Jarri harremanetan support@vitalera.io helbidearekin SDK autentifikazio-laguntzarako.