@burgan-tech/morph-idm-runtime 0.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +245 -0
- package/burgan-tech-morph-idm-runtime-0.0.0.tgz +0 -0
- package/morph-idm/Extensions/.gitkeep +0 -0
- package/morph-idm/Functions/.gitkeep +0 -0
- package/morph-idm/Functions/user/function-validate-user.json +31 -0
- package/morph-idm/Functions/user/src/ValidateUser.csx +39 -0
- package/morph-idm/Mappings/device-register-evaluate-get-device-request.mapper.json +319 -0
- package/morph-idm/Mappings/device-register-evaluate-get-device-response.mapper.json +761 -0
- package/morph-idm/Mappings/device-register-new-device-call-device-start-request.mapper.json +762 -0
- package/morph-idm/Mappings/device-register-start.mapper.json +971 -0
- package/morph-idm/Mappings/device-start-request.mapper.json +20 -0
- package/morph-idm/Mappings/device-start.mapper.json +896 -0
- package/morph-idm/Mappings/device-update-request.mapper.json +883 -0
- package/morph-idm/Mappings/token-start-request.mapper.json +436 -0
- package/morph-idm/Schemas/approval-matrix/approval-matrix-master-1.0.0.json +98 -0
- package/morph-idm/Schemas/approval-matrix/approval-matrix-update-1.0.0.json +85 -0
- package/morph-idm/Schemas/client/client-master-1.0.0.json +293 -0
- package/morph-idm/Schemas/client/client-update-master-1.0.0.json +201 -0
- package/morph-idm/Schemas/consent/consent-master-1.0.0.json +151 -0
- package/morph-idm/Schemas/device/device-master-1.0.0.json +433 -0
- package/morph-idm/Schemas/device/device-register-master-1.0.0.json +300 -0
- package/morph-idm/Schemas/device/device-register-start-1.0.0.json +270 -0
- package/morph-idm/Schemas/device/device-start-1.0.0.json +281 -0
- package/morph-idm/Schemas/device/device-update-1.0.0.json +275 -0
- package/morph-idm/Schemas/headers-1.0.0.json +245 -0
- package/morph-idm/Schemas/organization/organization-master-1.0.0.json +386 -0
- package/morph-idm/Schemas/organization/organization-update-1.0.0.json +60 -0
- package/morph-idm/Schemas/privilege/privilege-master-1.0.0.json +84 -0
- package/morph-idm/Schemas/privilege/privilege-update-1.0.0.json +76 -0
- package/morph-idm/Schemas/scope/scope-group-master-1.0.0.json +52 -0
- package/morph-idm/Schemas/scope/scope-master-1.0.0.json +120 -0
- package/morph-idm/Schemas/token/token-master-1.0.0.json +346 -0
- package/morph-idm/Schemas/token/token-start-1.0.0.json +50 -0
- package/morph-idm/Schemas/transaction-limit/transaction-limit-master-1.0.0.json +175 -0
- package/morph-idm/Schemas/transaction-limit/transaction-limit-update-1.0.0.json +90 -0
- package/morph-idm/Schemas/user/person-master-1.0.0.json +211 -0
- package/morph-idm/Schemas/user/user-master-1.0.0.json +121 -0
- package/morph-idm/Tasks/.gitkeep +0 -0
- package/morph-idm/Tasks/call-device-start-1.0.0.json +21 -0
- package/morph-idm/Tasks/call-device-update-1.0.0.json +21 -0
- package/morph-idm/Tasks/client/client-create-rsa.json +26 -0
- package/morph-idm/Tasks/client/client-password-generator.json +14 -0
- package/morph-idm/Tasks/client/get-client-by-task.json +18 -0
- package/morph-idm/Tasks/consent/get-consent-by-task.json +18 -0
- package/morph-idm/Tasks/consent/get-multi-consents-by-task.json +25 -0
- package/morph-idm/Tasks/device/get-device-by-task.json +18 -0
- package/morph-idm/Tasks/get-device-1.0.0.json +20 -0
- package/morph-idm/Tasks/scope/get-scope-by-task.json +17 -0
- package/morph-idm/Tasks/scope/scope-by-user-task.json +25 -0
- package/morph-idm/Tasks/scope/scope-details-task.json +25 -0
- package/morph-idm/Tasks/token/send-token-to-main.json +20 -0
- package/morph-idm/Tasks/token/token-create-jwt.json +27 -0
- package/morph-idm/Tasks/user/get-user-by-task.json +18 -0
- package/morph-idm/Tasks/user/send-otp-task.json +25 -0
- package/morph-idm/Tasks/user/send-push-task.json +22 -0
- package/morph-idm/Tasks/user/user-password-generator.json +26 -0
- package/morph-idm/Tasks/user/verify-otp-task.json +22 -0
- package/morph-idm/Tasks/user/verify-push-task.json +22 -0
- package/morph-idm/Views/.gitkeep +0 -0
- package/morph-idm/Workflows/.gitkeep +0 -0
- package/morph-idm/Workflows/approval-matrix/approval-1.0.0.json +452 -0
- package/morph-idm/Workflows/approval-matrix/approval-matrix-1.0.0.json +184 -0
- package/morph-idm/Workflows/client/client-1.0.0.json +257 -0
- package/morph-idm/Workflows/client/client-update-1.0.0.json +202 -0
- package/morph-idm/Workflows/client/execute/client.http +377 -0
- package/morph-idm/Workflows/client/src/ClientCreateRsa.csx +198 -0
- package/morph-idm/Workflows/client/src/ClientCreateRsaByScript.csx +118 -0
- package/morph-idm/Workflows/client/src/CreateRsaByHttpCallMapping.csx +223 -0
- package/morph-idm/Workflows/client/src/PasswordGeneratorMapping.csx +26 -0
- package/morph-idm/Workflows/client/src/RsaExistsRule.csx +44 -0
- package/morph-idm/Workflows/client-manager/client-manager-1.0.0.json +217 -0
- package/morph-idm/Workflows/client-manager/execute/client-manager.http +214 -0
- package/morph-idm/Workflows/client-manager/src/ClientCreatedRule.csx +28 -0
- package/morph-idm/Workflows/client-manager/src/ClientExistsRule.csx +25 -0
- package/morph-idm/Workflows/client-manager/src/CreateClientSubFlowMapping.csx +63 -0
- package/morph-idm/Workflows/client-manager/src/GetClientForManagerMapping.csx +59 -0
- package/morph-idm/Workflows/consent/consent-1.0.0.json +424 -0
- package/morph-idm/Workflows/consent/execute/README.md +167 -0
- package/morph-idm/Workflows/consent/execute/consent-invitation-flow.http +283 -0
- package/morph-idm/Workflows/consent/execute/create-consent.http +780 -0
- package/morph-idm/Workflows/consent/src/AutoConsentRule.csx +29 -0
- package/morph-idm/Workflows/consent/src/ConsentTimeoutTimer.csx +14 -0
- package/morph-idm/Workflows/consent-selection/consent-selection-1.0.0.json +331 -0
- package/morph-idm/Workflows/consent-selection/src/AutoConsentCreatedRule.csx +28 -0
- package/morph-idm/Workflows/consent-selection/src/ConsentFetchMapping.csx +82 -0
- package/morph-idm/Workflows/consent-selection/src/ConsentSelectedMapping.csx +70 -0
- package/morph-idm/Workflows/consent-selection/src/CreateAutoConsentMapping.csx +150 -0
- package/morph-idm/Workflows/consent-selection/src/MultipleConsentsRule.csx +31 -0
- package/morph-idm/Workflows/consent-selection/src/NoConsentEligibleRule.csx +44 -0
- package/morph-idm/Workflows/consent-selection/src/SingleConsentRule.csx +45 -0
- package/morph-idm/Workflows/device/device-1.0.0.json +261 -0
- package/morph-idm/Workflows/device/device-migration-1.0.0.json +213 -0
- package/morph-idm/Workflows/device/device-register-1.0.0-documentation.md +646 -0
- package/morph-idm/Workflows/device/device-register-1.0.0-documentation.svg +36 -0
- package/morph-idm/Workflows/device/device-register-1.0.0.json +185 -0
- package/morph-idm/Workflows/device/execute/device-android.http +260 -0
- package/morph-idm/Workflows/device/execute/device-huawei.http +219 -0
- package/morph-idm/Workflows/device/execute/device-ios.http +325 -0
- package/morph-idm/Workflows/device/execute/device-web.http +284 -0
- package/morph-idm/Workflows/device/src/DeviceCreatedRule.csx +32 -0
- package/morph-idm/Workflows/device/src/DeviceFoundRule.csx +32 -0
- package/morph-idm/Workflows/device/src/DeviceNotFoundRule.csx +28 -0
- package/morph-idm/Workflows/device/src/DeviceUpdatedRule.csx +26 -0
- package/morph-idm/Workflows/device/src/NoUpdateRule.csx +19 -0
- package/morph-idm/Workflows/device/src/ReInstallRule.csx +19 -0
- package/morph-idm/Workflows/document-validation/_FF_document-validation.json +423 -0
- package/morph-idm/Workflows/document-validation/src/ApproveRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ClassifyRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ExtractRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/HitlRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/RejectRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/RunOcrRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/StartRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ToAggregateRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ToFraudRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ToReferentialRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ToSemanticRule.csx +16 -0
- package/morph-idm/Workflows/document-validation/src/ToStructuralRule.csx +16 -0
- package/morph-idm/Workflows/organization/execute/create-organization.http +280 -0
- package/morph-idm/Workflows/organization/organization-1.0.0-documentation.md +616 -0
- package/morph-idm/Workflows/organization/organization-1.0.0.json +181 -0
- package/morph-idm/Workflows/privilege/privilege-1.0.0.json +185 -0
- package/morph-idm/Workflows/scope/execute/scope-24-7-access.http +131 -0
- package/morph-idm/Workflows/scope/execute/scope-business-hours.http +138 -0
- package/morph-idm/Workflows/scope/execute/scope-corporate.http +165 -0
- package/morph-idm/Workflows/scope/execute/scope-individual.http +133 -0
- package/morph-idm/Workflows/scope/execute/scope-lifecycle-test.http +133 -0
- package/morph-idm/Workflows/scope/execute/scope-multi-systems.http +159 -0
- package/morph-idm/Workflows/scope/execute/scope-restricted.http +143 -0
- package/morph-idm/Workflows/scope/scope-1.0.0.json +142 -0
- package/morph-idm/Workflows/scope/scope-group-1.0.0.json +144 -0
- package/morph-idm/Workflows/scope-group/execute/create-scope-group.http +222 -0
- package/morph-idm/Workflows/token/execute/README.md +450 -0
- package/morph-idm/Workflows/token/execute/token.http +236 -0
- package/morph-idm/Workflows/token/oauth-authentication-workflow.json +406 -0
- package/morph-idm/Workflows/token/password-subflow.json +173 -0
- package/morph-idm/Workflows/token/scope-cdc-worker.1.0.0.json +46 -0
- package/morph-idm/Workflows/token/src/CreateRsaJwtMapping.csx +208 -0
- package/morph-idm/Workflows/token/src/ExpireTokenTimer.csx +14 -0
- package/morph-idm/Workflows/token/src/PrepareAuthorizationCodeRule.csx +16 -0
- package/morph-idm/Workflows/token/src/RequestInappropriateRule.csx +16 -0
- package/morph-idm/Workflows/token/src/SendJwtToMainMapping.csx +167 -0
- package/morph-idm/Workflows/token/token-1.0.0.json +356 -0
- package/morph-idm/Workflows/token/token-1.0.0.openapi.json.md +707 -0
- package/morph-idm/Workflows/token/token-exchange.1.0.0.json +45 -0
- package/morph-idm/Workflows/transaction-limit/transaction-limit-1.0.0.json +244 -0
- package/morph-idm/Workflows/transaction-limit/transaction-limit-authorization.json +502 -0
- package/morph-idm/Workflows/transaction-limit/transaction-limit-capture.json +142 -0
- package/morph-idm/Workflows/user/execute/README-LOGIN.md +535 -0
- package/morph-idm/Workflows/user/execute/create-user-1234567890.http +116 -0
- package/morph-idm/Workflows/user/execute/create-user-minimal.http +22 -0
- package/morph-idm/Workflows/user/execute/create-user-person-password.http +130 -0
- package/morph-idm/Workflows/user/execute/create-user-person.http +249 -0
- package/morph-idm/Workflows/user/execute/create-user-system.http +16 -0
- package/morph-idm/Workflows/user/execute/user-login.http +583 -0
- package/morph-idm/Workflows/user/execute/user-requests.http +51 -0
- package/morph-idm/Workflows/user/person-1.0.0.json +140 -0
- package/morph-idm/Workflows/user/person-cdc-worker.1.0.0.json +46 -0
- package/morph-idm/Workflows/user/person-upsert-1.0.0.json +129 -0
- package/morph-idm/Workflows/user/src/ApproveRule.csx +16 -0
- package/morph-idm/Workflows/user/src/AutoConsentCreatedRule.csx +20 -0
- package/morph-idm/Workflows/user/src/AutoConsentRequiredRule.csx +77 -0
- package/morph-idm/Workflows/user/src/CheckDeviceByUserReferenceMapping.csx +66 -0
- package/morph-idm/Workflows/user/src/ClientValidationFailRule.csx +28 -0
- package/morph-idm/Workflows/user/src/ClientValidationRule.csx +25 -0
- package/morph-idm/Workflows/user/src/ConsentSelectedRule.csx +24 -0
- package/morph-idm/Workflows/user/src/ConsentValidationRule.csx +36 -0
- package/morph-idm/Workflows/user/src/CreateAutoConsentMapping.csx +171 -0
- package/morph-idm/Workflows/user/src/DeviceFoundForLoginRule.csx +32 -0
- package/morph-idm/Workflows/user/src/DeviceNotFoundForLoginRule.csx +31 -0
- package/morph-idm/Workflows/user/src/GetClientMapping.csx +45 -0
- package/morph-idm/Workflows/user/src/GetConsentMapping.csx +27 -0
- package/morph-idm/Workflows/user/src/GetDeviceMapping.csx +52 -0
- package/morph-idm/Workflows/user/src/GetScopeMapping.csx +139 -0
- package/morph-idm/Workflows/user/src/GetScopesByUserMapping.csx +137 -0
- package/morph-idm/Workflows/user/src/GetUserMapping.csx +39 -0
- package/morph-idm/Workflows/user/src/GrantValidationFailRule.csx +48 -0
- package/morph-idm/Workflows/user/src/GrantValidationRule.csx +45 -0
- package/morph-idm/Workflows/user/src/IsIbWebClientWithDeviceRule.csx +42 -0
- package/morph-idm/Workflows/user/src/NonIbWebClientWithDeviceRule.csx +42 -0
- package/morph-idm/Workflows/user/src/OtpSentRule.csx +31 -0
- package/morph-idm/Workflows/user/src/OtpVerifiedRule.csx +31 -0
- package/morph-idm/Workflows/user/src/PushSentRule.csx +31 -0
- package/morph-idm/Workflows/user/src/PushVerifiedRule.csx +31 -0
- package/morph-idm/Workflows/user/src/RejectRule.csx +16 -0
- package/morph-idm/Workflows/user/src/ScopeFetchedRule.csx +35 -0
- package/morph-idm/Workflows/user/src/ScopeValidationFailRule.csx +67 -0
- package/morph-idm/Workflows/user/src/ScopeValidationRule.csx +67 -0
- package/morph-idm/Workflows/user/src/SendOtpMapping.csx +94 -0
- package/morph-idm/Workflows/user/src/SendPushMapping.csx +90 -0
- package/morph-idm/Workflows/user/src/TokenGenerationSuccessRule.csx +28 -0
- package/morph-idm/Workflows/user/src/TriggerConsentSelectionAsSubFlowMapping.csx +63 -0
- package/morph-idm/Workflows/user/src/TriggerTokenWorkflowAsSubFlowMapping.csx +42 -0
- package/morph-idm/Workflows/user/src/UserPasswordGeneratorMapping.csx +190 -0
- package/morph-idm/Workflows/user/src/UserValidationFailRule.csx +36 -0
- package/morph-idm/Workflows/user/src/UserValidationRule.csx +38 -0
- package/morph-idm/Workflows/user/src/VerifyOtpMapping.csx +65 -0
- package/morph-idm/Workflows/user/src/VerifyPushMapping.csx +65 -0
- package/morph-idm/Workflows/user/user-1.0.0.json +400 -0
- package/morph-idm/Workflows/user/user-force-update.1.0.0.json +46 -0
- package/morph-idm/Workflows/user/user-login-certificate.1.0.0.json +46 -0
- package/morph-idm/Workflows/user/user-login.1.0.0.json +1144 -0
- package/morph-idm/Workflows/user/user-password-reset.1.0.0.json +45 -0
- package/package.json +21 -0
- package/vnext.config.json +58 -0
|
@@ -0,0 +1,646 @@
|
|
|
1
|
+
# device-register (1.0.0)
|
|
2
|
+
|
|
3
|
+

|
|
4
|
+
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Cihaz Kayıt & Kimlik Doğrulama Akışı
|
|
8
|
+
|
|
9
|
+
## 📋 Genel Bakış
|
|
10
|
+
|
|
11
|
+
**Her uygulama açılışında** çağrılan operasyonel akış. Cihaz yaşam döngüsünü yönetir ve kimlik doğrulama gereksinimlerini (1FA vs 2FA) belirler.
|
|
12
|
+
|
|
13
|
+
## 🔐 Kimlik Doğrulama Mantığı
|
|
14
|
+
|
|
15
|
+
### Cihaz Sertifikası Tabanlı Kimlik Doğrulama
|
|
16
|
+
|
|
17
|
+
- Her uygulama kurulumu cihaz HSM'inde **anahtar çifti** (public/private) oluşturur
|
|
18
|
+
- **Private key**: Cihazı **asla terk etmez** (HSM korumalı)
|
|
19
|
+
- **Public key**: Device fact'te saklanır (JWS sertifikası)
|
|
20
|
+
- Her istek: Private key ile imzalanır, public key ile doğrulanır
|
|
21
|
+
|
|
22
|
+
### 1FA vs 2FA Kararı
|
|
23
|
+
|
|
24
|
+
| Senaryo | Koşul | Sonuç |
|
|
25
|
+
|---------|-------|-------|
|
|
26
|
+
| **1FA (Güvenilir Cihaz)** | Sertifika kayıtlı + public key geçerli + JWS imza doğru | Geçici login JWT döner |
|
|
27
|
+
| **2FA (Yeni/Güvenilmeyen)** | Cihaz kayıtlı değil VEYA sertifika geçersiz | Challenge token döner |
|
|
28
|
+
|
|
29
|
+
## 🔄 Akış Durumları
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
start ──► evaluate ──┬── no-update (1FA - Güvenilir)
|
|
33
|
+
├── reinstall (1.5FA - Tanıdık ama yeni sertifika)
|
|
34
|
+
└── new-device (2FA - Tamamen yeni)
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
## ✅ Güvenlik Faydaları
|
|
38
|
+
|
|
39
|
+
- **Şifresiz giriş** güvenilir cihazlar için
|
|
40
|
+
- **Phishing'e dayanıklı** (private key çalınamaz)
|
|
41
|
+
- **Replay attack korumalı** (timestamp + imza)
|
|
42
|
+
- **Cihaza bağlı** oturumlar
|
|
43
|
+
- **Sorunsuz UX** geri dönen kullanıcılar için
|
|
44
|
+
|
|
45
|
+
## 🔗 Entegrasyon
|
|
46
|
+
|
|
47
|
+
| Yön | Açıklama |
|
|
48
|
+
|-----|----------|
|
|
49
|
+
| **Çağıran** | Mobil/Web uygulama (açılışta) |
|
|
50
|
+
| **Çağırdığı** | `device` workflow (start/update transitions) |
|
|
51
|
+
| **Döndürdüğü** | Login JWT (1FA) veya Challenge (2FA) |
|
|
52
|
+
| **Sonraki** | `user-login` kimlik doğrulamayı devam ettirir |
|
|
53
|
+
|
|
54
|
+
---
|
|
55
|
+
|
|
56
|
+
## 🚀 Start Transition (Başlangıç Noktası)
|
|
57
|
+
|
|
58
|
+
### Genel Bilgi
|
|
59
|
+
|
|
60
|
+
| Özellik | Değer |
|
|
61
|
+
|---------|-------|
|
|
62
|
+
| **Key** | `start` |
|
|
63
|
+
| **Hedef State** | `evaluate` |
|
|
64
|
+
| **Trigger Type** | 0 (Manuel) |
|
|
65
|
+
| **Schema** | `device-register-start-1.0.0` |
|
|
66
|
+
| **Mapping** | `device-register-start.mapper.json` |
|
|
67
|
+
|
|
68
|
+
### Amaç
|
|
69
|
+
|
|
70
|
+
**Her uygulama açılışında** (mobil/web) tetiklenir ve şunları yapar:
|
|
71
|
+
|
|
72
|
+
1. Mevcut cihaz durumunu yakalar
|
|
73
|
+
2. Cihaz yaşam döngüsü kontrolünü başlatır
|
|
74
|
+
3. Kimlik doğrulama yolunu belirler
|
|
75
|
+
|
|
76
|
+
### Veri Akışı
|
|
77
|
+
|
|
78
|
+
```
|
|
79
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
80
|
+
│ HTTP Headers │
|
|
81
|
+
│ ├─ X-Device-Id: "abc123..." │
|
|
82
|
+
│ └─ X-Installation-Id: "xyz789..." │
|
|
83
|
+
└─────────────────────────────────────────────────────────────┘
|
|
84
|
+
+
|
|
85
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
86
|
+
│ Request Body (device-register-start schema) │
|
|
87
|
+
│ ├─ deviceInfo: { osName, osVersion, deviceModel, ... } │
|
|
88
|
+
│ ├─ deviceCertificatePublicKey: "MIIBIjAN..." │
|
|
89
|
+
│ ├─ pushToken: { platform, token, ... } │
|
|
90
|
+
│ ├─ appVersion: "2.5.1" │
|
|
91
|
+
│ └─ attribution: { source, campaign, ... } │
|
|
92
|
+
└─────────────────────────────────────────────────────────────┘
|
|
93
|
+
↓
|
|
94
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
95
|
+
│ Mapping (device-register-start.mapper.json) │
|
|
96
|
+
│ → Instance data'ya dönüştürülür │
|
|
97
|
+
└─────────────────────────────────────────────────────────────┘
|
|
98
|
+
↓
|
|
99
|
+
┌─────────────────────────────────────────────────────────────┐
|
|
100
|
+
│ evaluate state'e otomatik geçiş │
|
|
101
|
+
└─────────────────────────────────────────────────────────────┘
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
106
|
+
## 📊 Start Schema Alanları (device-register-start-1.0.0)
|
|
107
|
+
|
|
108
|
+
### Zorunlu Alanlar
|
|
109
|
+
|
|
110
|
+
#### 1. deviceInfo (object) ⚠️ ZORUNLU
|
|
111
|
+
|
|
112
|
+
Cihaz ve işletim sistemi hakkında detaylı bilgi.
|
|
113
|
+
|
|
114
|
+
| Alan | Tip | Zorunlu | Açıklama | Örnek |
|
|
115
|
+
|------|-----|---------|----------|-------|
|
|
116
|
+
| `osName` | string | ✅ | İşletim sistemi adı | `"iOS"`, `"Android"`, `"HarmonyOS"`, `"Windows"`, `"macOS"` |
|
|
117
|
+
| `osVersion` | string | ✅ | İşletim sistemi versiyonu | `"17.2.1"`, `"API 33"`, `"Windows 11"` |
|
|
118
|
+
| `deviceModel` | string | ✅ | Cihaz modeli | `"iPhone 14 Pro"`, `"Pixel 7"`, `"Galaxy S22"` |
|
|
119
|
+
| `manufacturer` | string | ✅ | Cihaz üreticisi | `"Apple"`, `"Samsung"`, `"Xiaomi"`, `"Huawei"`, `"Google"` |
|
|
120
|
+
| `screenResolution` | string | ❌ | Ekran çözünürlüğü | `"2532x1170"`, `"1920x1080"` |
|
|
121
|
+
| `language` | string | ❌ | Cihaz dil ayarı | `"tr-TR"`, `"en-US"` |
|
|
122
|
+
| `timezone` | string | ❌ | Cihaz saat dilimi | `"Europe/Istanbul"`, `"America/New_York"` |
|
|
123
|
+
|
|
124
|
+
**Örnek:**
|
|
125
|
+
```json
|
|
126
|
+
{
|
|
127
|
+
"deviceInfo": {
|
|
128
|
+
"osName": "iOS",
|
|
129
|
+
"osVersion": "17.2.1",
|
|
130
|
+
"deviceModel": "iPhone 14 Pro",
|
|
131
|
+
"manufacturer": "Apple",
|
|
132
|
+
"screenResolution": "2556x1179",
|
|
133
|
+
"language": "tr-TR",
|
|
134
|
+
"timezone": "Europe/Istanbul"
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
```
|
|
138
|
+
|
|
139
|
+
#### 2. deviceCertificatePublicKey (string) ⚠️ ZORUNLU
|
|
140
|
+
|
|
141
|
+
Cihaza özel base public key. İlk cihaz kaydı sırasında cihaz attestation için kullanılır.
|
|
142
|
+
|
|
143
|
+
- **Format**: Base64 encoded public key (JWK veya PEM)
|
|
144
|
+
- **Kaynak**: Cihaz HSM'inden (Secure Enclave / TEE)
|
|
145
|
+
- **Kullanım**:
|
|
146
|
+
- Cihaz kimliğinin kök tanımlayıcısı
|
|
147
|
+
- Kullanıcı/consent'ten bağımsız
|
|
148
|
+
- Her isteğin imza doğrulaması için
|
|
149
|
+
|
|
150
|
+
**Örnek:**
|
|
151
|
+
```json
|
|
152
|
+
{
|
|
153
|
+
"deviceCertificatePublicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..."
|
|
154
|
+
}
|
|
155
|
+
```
|
|
156
|
+
|
|
157
|
+
#### 3. appVersion (string) ⚠️ ZORUNLU
|
|
158
|
+
|
|
159
|
+
Bu cihazda yüklü uygulama versiyonu.
|
|
160
|
+
|
|
161
|
+
- **Format**: Semantic versioning (major.minor.patch)
|
|
162
|
+
- **Kullanım**:
|
|
163
|
+
- Zorunlu güncelleme kontrolü
|
|
164
|
+
- Versiyon bazlı özellik açma/kapama
|
|
165
|
+
- Hata takibi
|
|
166
|
+
|
|
167
|
+
**Örnek:**
|
|
168
|
+
```json
|
|
169
|
+
{
|
|
170
|
+
"appVersion": "2.5.1"
|
|
171
|
+
}
|
|
172
|
+
```
|
|
173
|
+
|
|
174
|
+
---
|
|
175
|
+
|
|
176
|
+
### Opsiyonel Alanlar
|
|
177
|
+
|
|
178
|
+
#### 4. pushToken (oneOf) 📱 OPSİYONEL
|
|
179
|
+
|
|
180
|
+
Platform bazlı push notification token. Cihaz platformuna göre **sadece BİR** aktif token olabilir.
|
|
181
|
+
|
|
182
|
+
##### 4.1 APNS (Apple Push Notification Service)
|
|
183
|
+
|
|
184
|
+
iOS/iPadOS/macOS cihazlar için.
|
|
185
|
+
|
|
186
|
+
| Alan | Tip | Zorunlu | Açıklama |
|
|
187
|
+
|------|-----|---------|----------|
|
|
188
|
+
| `platform` | string | ✅ | `"apns"` (sabit) |
|
|
189
|
+
| `token` | string | ✅ | APNS device token (64 karakter hex) |
|
|
190
|
+
| `environment` | enum | ❌ | `"production"` (App Store) veya `"sandbox"` (Development/TestFlight) |
|
|
191
|
+
| `bundleId` | string | ❌ | iOS app bundle identifier (örn: `"com.burgan.mobilebanking"`) |
|
|
192
|
+
|
|
193
|
+
**Örnek:**
|
|
194
|
+
```json
|
|
195
|
+
{
|
|
196
|
+
"pushToken": {
|
|
197
|
+
"platform": "apns",
|
|
198
|
+
"token": "a1b2c3d4e5f6...",
|
|
199
|
+
"environment": "production",
|
|
200
|
+
"bundleId": "com.burgan.mobilebanking"
|
|
201
|
+
}
|
|
202
|
+
}
|
|
203
|
+
```
|
|
204
|
+
|
|
205
|
+
##### 4.2 FCM (Firebase Cloud Messaging)
|
|
206
|
+
|
|
207
|
+
Google Play Services olan Android cihazlar için.
|
|
208
|
+
|
|
209
|
+
| Alan | Tip | Zorunlu | Açıklama |
|
|
210
|
+
|------|-----|---------|----------|
|
|
211
|
+
| `platform` | string | ✅ | `"fcm"` (sabit) |
|
|
212
|
+
| `token` | string | ✅ | FCM registration token |
|
|
213
|
+
| `projectId` | string | ❌ | Firebase project ID |
|
|
214
|
+
| `packageName` | string | ❌ | Android app package name |
|
|
215
|
+
|
|
216
|
+
**Örnek:**
|
|
217
|
+
```json
|
|
218
|
+
{
|
|
219
|
+
"pushToken": {
|
|
220
|
+
"platform": "fcm",
|
|
221
|
+
"token": "cLong-FCM-Token-Here...",
|
|
222
|
+
"projectId": "burgan-mobile-app",
|
|
223
|
+
"packageName": "com.burgan.mobilebanking"
|
|
224
|
+
}
|
|
225
|
+
}
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
##### 4.3 HMS (Huawei Mobile Services)
|
|
229
|
+
|
|
230
|
+
Google Play Services olmayan Huawei cihazlar için.
|
|
231
|
+
|
|
232
|
+
| Alan | Tip | Zorunlu | Açıklama |
|
|
233
|
+
|------|-----|---------|----------|
|
|
234
|
+
| `platform` | string | ✅ | `"hms"` (sabit) |
|
|
235
|
+
| `token` | string | ✅ | HMS Push token |
|
|
236
|
+
| `appId` | string | ❌ | Huawei AppGallery app ID |
|
|
237
|
+
| `packageName` | string | ❌ | Android app package name |
|
|
238
|
+
|
|
239
|
+
**Örnek:**
|
|
240
|
+
```json
|
|
241
|
+
{
|
|
242
|
+
"pushToken": {
|
|
243
|
+
"platform": "hms",
|
|
244
|
+
"token": "AAWNS...",
|
|
245
|
+
"appId": "123456789",
|
|
246
|
+
"packageName": "com.burgan.mobilebanking"
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
##### 4.4 WebPush (Web Push API)
|
|
252
|
+
|
|
253
|
+
Progressive Web Apps ve tarayıcılar için.
|
|
254
|
+
|
|
255
|
+
| Alan | Tip | Zorunlu | Açıklama |
|
|
256
|
+
|------|-----|---------|----------|
|
|
257
|
+
| `platform` | string | ✅ | `"webpush"` (sabit) |
|
|
258
|
+
| `endpoint` | string | ✅ | Push service endpoint URL |
|
|
259
|
+
| `keys.p256dh` | string | ❌ | Client public key for encryption (base64) |
|
|
260
|
+
| `keys.auth` | string | ❌ | Authentication secret (base64) |
|
|
261
|
+
| `browser` | string | ❌ | Browser name/version |
|
|
262
|
+
|
|
263
|
+
**Örnek:**
|
|
264
|
+
```json
|
|
265
|
+
{
|
|
266
|
+
"pushToken": {
|
|
267
|
+
"platform": "webpush",
|
|
268
|
+
"endpoint": "https://fcm.googleapis.com/fcm/send/...",
|
|
269
|
+
"keys": {
|
|
270
|
+
"p256dh": "BNcRdre...",
|
|
271
|
+
"auth": "tBHItJ..."
|
|
272
|
+
},
|
|
273
|
+
"browser": "Chrome 120"
|
|
274
|
+
}
|
|
275
|
+
}
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
---
|
|
279
|
+
|
|
280
|
+
#### 5. attribution (object) 📈 OPSİYONEL
|
|
281
|
+
|
|
282
|
+
Uygulama kurulum atıf ve yönlendirme takip verileri. **Sadece İLK kurulumda** gönderilir, sonraki açılışlarda `null`.
|
|
283
|
+
|
|
284
|
+
| Alan | Tip | Açıklama | Örnek |
|
|
285
|
+
|------|-----|----------|-------|
|
|
286
|
+
| `referrerCode` | string | Referans kodu (arkadaş daveti, affiliate, promosyon) | `"FRIEND123"`, `"SUMMER2024"` |
|
|
287
|
+
| `source` | string | Kurulum kaynağı | `"organic"`, `"google_ads"`, `"facebook_ads"`, `"app_store"`, `"qr_code"` |
|
|
288
|
+
| `campaign` | string | Pazarlama kampanya tanımlayıcısı | `"summer_2024"`, `"new_year_promo"` |
|
|
289
|
+
| `medium` | string | Pazarlama ortamı | `"cpc"`, `"social"`, `"email"`, `"sms"`, `"banner"` |
|
|
290
|
+
| `utmParameters` | object | UTM parametreleri (dijital kampanyalar için) | `{ utm_source, utm_medium, utm_campaign, ... }` |
|
|
291
|
+
| `clickId` | string | Reklam ağından click ID | `"gclid_abc..."` (Google), `"fbclid_xyz..."` (Facebook) |
|
|
292
|
+
| `installReferrer` | string | Google Play Install Referrer veya App Store attribution verisi | Raw referrer string |
|
|
293
|
+
| `attributionProvider` | string | Kullanılan attribution SDK/servisi | `"AppsFlyer"`, `"Adjust"`, `"Branch"`, `"Firebase"`, `"native"` |
|
|
294
|
+
| `attributionData` | object | Attribution provider'dan ham veri | Provider'a özel |
|
|
295
|
+
|
|
296
|
+
**Tam Örnek:**
|
|
297
|
+
```json
|
|
298
|
+
{
|
|
299
|
+
"attribution": {
|
|
300
|
+
"referrerCode": "FRIEND123",
|
|
301
|
+
"source": "google_ads",
|
|
302
|
+
"campaign": "summer_2024_acquisition",
|
|
303
|
+
"medium": "cpc",
|
|
304
|
+
"utmParameters": {
|
|
305
|
+
"utm_source": "google",
|
|
306
|
+
"utm_medium": "cpc",
|
|
307
|
+
"utm_campaign": "summer_2024",
|
|
308
|
+
"utm_term": "mobile banking app",
|
|
309
|
+
"utm_content": "banner_v2"
|
|
310
|
+
},
|
|
311
|
+
"clickId": "gclid_CjwKCAiA...",
|
|
312
|
+
"installReferrer": "utm_source=google&utm_medium=cpc&...",
|
|
313
|
+
"attributionProvider": "AppsFlyer",
|
|
314
|
+
"attributionData": {
|
|
315
|
+
"af_status": "Non-organic",
|
|
316
|
+
"media_source": "googleadwords_int",
|
|
317
|
+
"campaign": "Summer2024"
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
}
|
|
321
|
+
```
|
|
322
|
+
|
|
323
|
+
---
|
|
324
|
+
|
|
325
|
+
## 📝 Tam Request Örneği
|
|
326
|
+
|
|
327
|
+
```json
|
|
328
|
+
{
|
|
329
|
+
"deviceInfo": {
|
|
330
|
+
"osName": "iOS",
|
|
331
|
+
"osVersion": "17.2.1",
|
|
332
|
+
"deviceModel": "iPhone 14 Pro",
|
|
333
|
+
"manufacturer": "Apple",
|
|
334
|
+
"screenResolution": "2556x1179",
|
|
335
|
+
"language": "tr-TR",
|
|
336
|
+
"timezone": "Europe/Istanbul"
|
|
337
|
+
},
|
|
338
|
+
"deviceCertificatePublicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAw5Od...",
|
|
339
|
+
"pushToken": {
|
|
340
|
+
"platform": "apns",
|
|
341
|
+
"token": "a1b2c3d4e5f6789012345678901234567890123456789012345678901234",
|
|
342
|
+
"environment": "production",
|
|
343
|
+
"bundleId": "com.burgan.mobilebanking"
|
|
344
|
+
},
|
|
345
|
+
"appVersion": "2.5.1",
|
|
346
|
+
"attribution": {
|
|
347
|
+
"source": "organic",
|
|
348
|
+
"installReferrer": "utm_source=app_store"
|
|
349
|
+
}
|
|
350
|
+
}
|
|
351
|
+
```
|
|
352
|
+
|
|
353
|
+
---
|
|
354
|
+
|
|
355
|
+
## 🔍 Sonraki Adım: evaluate State
|
|
356
|
+
|
|
357
|
+
Start transition tamamlandıktan sonra akış otomatik olarak `evaluate` state'e geçer. Bu state'te:
|
|
358
|
+
|
|
359
|
+
1. `get-device` task'ı çağrılır
|
|
360
|
+
2. `deviceId` ile mevcut cihaz kaydı sorgulanır
|
|
361
|
+
3. Sonuç `registeredDevice` field'ına kaydedilir
|
|
362
|
+
4. Üç olası auto transition'dan biri tetiklenir:
|
|
363
|
+
- `no-update` → Cihaz kayıtlı, değişiklik yok (1FA)
|
|
364
|
+
- `reinstall` → Cihaz tanınıyor, sertifika yeni (1.5FA)
|
|
365
|
+
- `new-device` → Tamamen yeni cihaz (2FA)
|
|
366
|
+
|
|
367
|
+
---
|
|
368
|
+
|
|
369
|
+
## 🔄 States (Durumlar)
|
|
370
|
+
|
|
371
|
+
### 1. Değerlendir (`evaluate`) {#state-evaluate}
|
|
372
|
+
|
|
373
|
+
**Amaç:** Cihaz kayıt durumunu belirleyen karar merkezi.
|
|
374
|
+
|
|
375
|
+
| Özellik | Değer |
|
|
376
|
+
|---------|-------|
|
|
377
|
+
| **State Type** | 1 (Initial) |
|
|
378
|
+
| **On-Entry Task** | `get-device` |
|
|
379
|
+
|
|
380
|
+
**On-Entry Task Detayı:**
|
|
381
|
+
|
|
382
|
+
```
|
|
383
|
+
evaluate state'e giriş
|
|
384
|
+
↓
|
|
385
|
+
get-device task çağrılır
|
|
386
|
+
↓
|
|
387
|
+
deviceId ile mevcut cihaz kaydı sorgulanır
|
|
388
|
+
↓
|
|
389
|
+
Sonuç 'registeredDevice' field'ına kaydedilir
|
|
390
|
+
↓
|
|
391
|
+
Auto-transition rule'ları değerlendirilir
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
**İş Mantığı:**
|
|
395
|
+
1. `deviceId` ile device fact sorgusu yapılır
|
|
396
|
+
2. Sonuç `registeredDevice` field'ına kaydedilir
|
|
397
|
+
3. Üç senaryo auto-transition ile değerlendirilir
|
|
398
|
+
|
|
399
|
+
**⚠️ Kritik:** Bu state 1FA vs 2FA kimlik doğrulama yolunu belirler. Yanlış değerlendirme = güvenlik ihlali veya kötü kullanıcı deneyimi.
|
|
400
|
+
|
|
401
|
+
#### Transitions (Geçişler)
|
|
402
|
+
|
|
403
|
+
##### ✅ Güncelleme Yok → `no-update`
|
|
404
|
+
|
|
405
|
+
**Tetiklenme Koşulu:**
|
|
406
|
+
Cihaz **zaten kayıtlı** VE aynı `installationId` (uygulama yeniden kurulmamış).
|
|
407
|
+
|
|
408
|
+
**Rule Mantığı:**
|
|
409
|
+
```csharp
|
|
410
|
+
registeredDevice != null
|
|
411
|
+
&& registeredDevice.deviceId == deviceId
|
|
412
|
+
&& registeredDevice.installationId == installationId
|
|
413
|
+
```
|
|
414
|
+
|
|
415
|
+
**İş Anlamı:**
|
|
416
|
+
- Kullanıcı **bilinen, güvenilir cihazda** uygulamayı açtı
|
|
417
|
+
- Sertifika önceki oturumda **zaten doğrulanmış**
|
|
418
|
+
- Cihaz yaşam döngüsünde değişiklik yok
|
|
419
|
+
|
|
420
|
+
**Kimlik Doğrulama Yolu:** **1FA**
|
|
421
|
+
- Geçici login JWT döner
|
|
422
|
+
- Kullanıcı `user-login`'de şifre/OTP atlar
|
|
423
|
+
|
|
424
|
+
**Kullanım Senaryosu:** Ana cihazda günlük uygulama kullanımı
|
|
425
|
+
|
|
426
|
+
---
|
|
427
|
+
|
|
428
|
+
##### 🆕 Cihaz Yok → `new-device`
|
|
429
|
+
|
|
430
|
+
**Tetiklenme Koşulu:**
|
|
431
|
+
Mevcut cihaz kaydı bulunamadı (ilk kayıt).
|
|
432
|
+
|
|
433
|
+
**Rule Mantığı:**
|
|
434
|
+
```csharp
|
|
435
|
+
registeredDevice == null
|
|
436
|
+
```
|
|
437
|
+
|
|
438
|
+
**İş Anlamı:**
|
|
439
|
+
- Kullanıcı bu cihazda **ilk kez** uygulama kurdu
|
|
440
|
+
- Kayıtlı sertifika yok
|
|
441
|
+
- Tamamen **güvenilmeyen** cihaz
|
|
442
|
+
|
|
443
|
+
**Kimlik Doğrulama Yolu:** **2FA Zorunlu**
|
|
444
|
+
- Challenge token döner (login JWT DEĞİL)
|
|
445
|
+
- Kullanıcı `user-login`'de şifre + OTP sağlamalı
|
|
446
|
+
- Başarılı girişten sonra cihaz güvenilir olur
|
|
447
|
+
|
|
448
|
+
**Kullanım Senaryoları:**
|
|
449
|
+
- Yeni müşteri onboarding
|
|
450
|
+
- Kullanıcı yeni telefona geçti
|
|
451
|
+
- Cihaz sıfırlama sonrası temiz kurulum
|
|
452
|
+
|
|
453
|
+
---
|
|
454
|
+
|
|
455
|
+
##### 🔄 Yeniden Kurulum → `reinstall`
|
|
456
|
+
|
|
457
|
+
**Tetiklenme Koşulu:**
|
|
458
|
+
Cihaz **tanınıyor** AMA `installationId` **farklı** (uygulama yeniden kurulmuş).
|
|
459
|
+
|
|
460
|
+
**Rule Mantığı:**
|
|
461
|
+
```csharp
|
|
462
|
+
registeredDevice != null
|
|
463
|
+
&& registeredDevice.deviceId == deviceId
|
|
464
|
+
&& registeredDevice.installationId != installationId
|
|
465
|
+
```
|
|
466
|
+
|
|
467
|
+
**İş Anlamı:**
|
|
468
|
+
- Kullanıcı aynı cihazda uygulamayı **silip yeniden kurdu**
|
|
469
|
+
- Yeni uygulama instance = **yeni anahtar çifti** oluşturuldu
|
|
470
|
+
- Eski sertifika **geçersiz**, yeni public key sağlandı
|
|
471
|
+
|
|
472
|
+
**Güvenlik Değerlendirmesi:**
|
|
473
|
+
Aynı cihaz olsa bile, yeni HSM anahtarları kullanıcıyı **yeniden doğrulamamızı** gerektirir. Önlediği durumlar:
|
|
474
|
+
- Çalıntı cihaz senaryoları (hırsız uygulamayı yeniden kurdu)
|
|
475
|
+
- Ele geçirilmiş uygulama instance'ları
|
|
476
|
+
- Sertifika rotasyon saldırıları
|
|
477
|
+
|
|
478
|
+
**Kimlik Doğrulama Yolu:** **Hibrit (1.5FA)**
|
|
479
|
+
- Cihaz "tanıdık" ama sertifika "yeni"
|
|
480
|
+
- Tam 2FA'dan daha hafif doğrulama gerekebilir
|
|
481
|
+
- Mevcut cihaz kaydı yeni sertifika ile güncellenir
|
|
482
|
+
|
|
483
|
+
**Kullanım Senaryoları:**
|
|
484
|
+
- Kullanıcı uygulamayı silip yeniden kurdu
|
|
485
|
+
- Uygulama çöktü ve sıfırlanması gerekti
|
|
486
|
+
- OS güncellemesi uygulama yeniden kurulumunu zorladı
|
|
487
|
+
|
|
488
|
+
---
|
|
489
|
+
|
|
490
|
+
### 2. Güncelleme Yok (`no-update`) {#state-no-update}
|
|
491
|
+
|
|
492
|
+
**Amaç:** Değişiklik olmayan cihazlar için başarı bitiş noktası.
|
|
493
|
+
|
|
494
|
+
| Özellik | Değer |
|
|
495
|
+
|---------|-------|
|
|
496
|
+
| **State Type** | 3 (Final) |
|
|
497
|
+
| **State Sub Type** | 0 (Success) |
|
|
498
|
+
| **On-Entry Task** | Yok |
|
|
499
|
+
|
|
500
|
+
**Ne Olur:**
|
|
501
|
+
- Akış hemen tamamlanır (on-entry task yok)
|
|
502
|
+
- **Geçici login JWT** döner (kısa ömürlü, tek kullanımlık)
|
|
503
|
+
- Device fact **değiştirilmez** (zaten güncel)
|
|
504
|
+
|
|
505
|
+
**Client'a Dönen Yanıt:**
|
|
506
|
+
```json
|
|
507
|
+
{
|
|
508
|
+
"status": "trusted",
|
|
509
|
+
"authMethod": "1FA",
|
|
510
|
+
"loginToken": "eyJhbG...",
|
|
511
|
+
"expiresIn": 300
|
|
512
|
+
}
|
|
513
|
+
```
|
|
514
|
+
|
|
515
|
+
| Alan | Açıklama |
|
|
516
|
+
|------|----------|
|
|
517
|
+
| `status` | `"trusted"` - Cihaz güvenilir |
|
|
518
|
+
| `authMethod` | `"1FA"` - Tek faktörlü kimlik doğrulama |
|
|
519
|
+
| `loginToken` | Geçici JWT (5 dakika geçerli) |
|
|
520
|
+
| `expiresIn` | Token geçerlilik süresi (saniye) |
|
|
521
|
+
|
|
522
|
+
**Client Davranışı:**
|
|
523
|
+
Hemen `user-login`'i `loginToken` ile çağırır → şifre/OTP atlar → tam OAuth token'ları alır.
|
|
524
|
+
|
|
525
|
+
**Performans:** En hızlı yol (DB yazımı yok)
|
|
526
|
+
|
|
527
|
+
---
|
|
528
|
+
|
|
529
|
+
### 3. Yeniden Kurulum (`reinstall`) {#state-reinstall}
|
|
530
|
+
|
|
531
|
+
**Amaç:** Mevcut cihaz kaydını yeni sertifika ile günceller.
|
|
532
|
+
|
|
533
|
+
| Özellik | Değer |
|
|
534
|
+
|---------|-------|
|
|
535
|
+
| **State Type** | 3 (Final) |
|
|
536
|
+
| **State Sub Type** | 0 (Success) |
|
|
537
|
+
| **On-Entry Task** | `update-device` |
|
|
538
|
+
|
|
539
|
+
**On-Entry Task: `update-device`**
|
|
540
|
+
|
|
541
|
+
`device` workflow → `update` transition çağırır:
|
|
542
|
+
- Eski `installationId`'yi yenisiyle değiştirir
|
|
543
|
+
- JWS public key'i günceller (yeni HSM anahtar çifti)
|
|
544
|
+
- Push token'ı yeniler (değişmiş olabilir)
|
|
545
|
+
- `deviceInfo`'yu günceller (OS versiyonu, ekran boyutu, vb.)
|
|
546
|
+
|
|
547
|
+
**⚠️ Kritik:** `deviceId` korunur (değişmez) ama tüm güvenlik kimlik bilgileri döndürülür.
|
|
548
|
+
|
|
549
|
+
**Client'a Dönen Yanıt:**
|
|
550
|
+
```json
|
|
551
|
+
{
|
|
552
|
+
"status": "reinstalled",
|
|
553
|
+
"authMethod": "1.5FA",
|
|
554
|
+
"challengeToken": "xyz...",
|
|
555
|
+
"requiresVerification": true
|
|
556
|
+
}
|
|
557
|
+
```
|
|
558
|
+
|
|
559
|
+
| Alan | Açıklama |
|
|
560
|
+
|------|----------|
|
|
561
|
+
| `status` | `"reinstalled"` - Uygulama yeniden kuruldu |
|
|
562
|
+
| `authMethod` | `"1.5FA"` - Tam 2FA'dan hafif |
|
|
563
|
+
| `challengeToken` | Challenge token (login JWT DEĞİL) |
|
|
564
|
+
| `requiresVerification` | Doğrulama gerekli |
|
|
565
|
+
|
|
566
|
+
**Güvenlik Değiş-Tokuşu:**
|
|
567
|
+
- Cihaz "tanıdık" (`deviceId` biliniyor)
|
|
568
|
+
- Ama sertifika "güvenilmeyen" (yeni anahtarlar)
|
|
569
|
+
- SMS/Email OTP gerekebilir (tam şifre değil)
|
|
570
|
+
|
|
571
|
+
**Neden Yeni Oluşturma Yerine Güncelleme:**
|
|
572
|
+
Cihaz geçmişini, risk skorlamasını ve kullanıcı cihaz listesi tutarlılığını korur.
|
|
573
|
+
|
|
574
|
+
---
|
|
575
|
+
|
|
576
|
+
### 4. Yeni Cihaz (`new-device`) {#state-new-device}
|
|
577
|
+
|
|
578
|
+
**Amaç:** Sistemde yepyeni cihaz kaydı oluşturur.
|
|
579
|
+
|
|
580
|
+
| Özellik | Değer |
|
|
581
|
+
|---------|-------|
|
|
582
|
+
| **State Type** | 3 (Final) |
|
|
583
|
+
| **State Sub Type** | 0 (Success) |
|
|
584
|
+
| **On-Entry Task** | `call-device-start` |
|
|
585
|
+
|
|
586
|
+
**On-Entry Task: `call-device-start`**
|
|
587
|
+
|
|
588
|
+
`device` workflow → `start` transition çağırır:
|
|
589
|
+
- Yeni device fact kaydı oluşturur
|
|
590
|
+
- `deviceId` saklar (değişmez tanımlayıcı)
|
|
591
|
+
- `installationId` saklar (uygulama instance tanımlayıcısı)
|
|
592
|
+
- JWS public key kaydeder (cihaz HSM sertifikası)
|
|
593
|
+
- Push token saklar (APNS/FCM/HMS)
|
|
594
|
+
- Cihaz parmak izini yakalar (model, OS, ekran, vb.)
|
|
595
|
+
- Risk skorunu başlatır (varsayılan: güvenilmeyen)
|
|
596
|
+
|
|
597
|
+
**Client'a Dönen Yanıt:**
|
|
598
|
+
```json
|
|
599
|
+
{
|
|
600
|
+
"status": "new_device",
|
|
601
|
+
"authMethod": "2FA",
|
|
602
|
+
"challengeToken": "abc...",
|
|
603
|
+
"requiresVerification": true,
|
|
604
|
+
"verificationMethods": ["password", "sms_otp", "email_otp"]
|
|
605
|
+
}
|
|
606
|
+
```
|
|
607
|
+
|
|
608
|
+
| Alan | Açıklama |
|
|
609
|
+
|------|----------|
|
|
610
|
+
| `status` | `"new_device"` - Yeni cihaz |
|
|
611
|
+
| `authMethod` | `"2FA"` - İki faktörlü kimlik doğrulama |
|
|
612
|
+
| `challengeToken` | Challenge token (login JWT DEĞİL) |
|
|
613
|
+
| `requiresVerification` | Doğrulama zorunlu |
|
|
614
|
+
| `verificationMethods` | Mevcut doğrulama yöntemleri |
|
|
615
|
+
|
|
616
|
+
**Güvenlik Durumu:** **Maksimum Güvensizlik**
|
|
617
|
+
- Sıfır güven varsayımı
|
|
618
|
+
- Tam 2FA zorunlu (şifre + OTP)
|
|
619
|
+
- Cihaz ancak başarılı ilk girişten sonra "güvenilir" olur
|
|
620
|
+
- Dolandırıcılık tespit kuralları uygulanabilir
|
|
621
|
+
|
|
622
|
+
**Kullanım Senaryoları:**
|
|
623
|
+
- Müşteri onboarding (ilk uygulama kurulumu)
|
|
624
|
+
- Kullanıcı hesabına yeni cihaz ekliyor
|
|
625
|
+
- Kayıp/çalıntı cihaz değişimi
|
|
626
|
+
|
|
627
|
+
**Giriş Sonrası:**
|
|
628
|
+
Kullanıcı tam 2FA ile `user-login`'i tamamladıktan sonra, bu cihaz "güvenilir" statüsüne yükseltilir. Sonraki girişler 1FA yolunu (no-update state) kullanır.
|
|
629
|
+
|
|
630
|
+
---
|
|
631
|
+
|
|
632
|
+
## 📎 İlişkili Kaynaklar
|
|
633
|
+
|
|
634
|
+
| Kaynak | Açıklama |
|
|
635
|
+
|--------|----------|
|
|
636
|
+
| `Schemas/device/device-register-start-1.0.0.json` | Start şeması |
|
|
637
|
+
| `Workflows/device/device-1.0.0.json` | Device master workflow |
|
|
638
|
+
| `Mappings/device-register-start.mapper.json` | Start mapping |
|
|
639
|
+
| `Tasks/get-device-1.0.0.json` | Cihaz sorgulama task'ı |
|
|
640
|
+
|
|
641
|
+
---
|
|
642
|
+
|
|
643
|
+
**Versiyon:** 1.0.0
|
|
644
|
+
**Son Güncelleme:** 2024-12-04
|
|
645
|
+
**Yazar:** Morph.IDM Team
|
|
646
|
+
|