@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.
Files changed (206) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +245 -0
  3. package/burgan-tech-morph-idm-runtime-0.0.0.tgz +0 -0
  4. package/morph-idm/Extensions/.gitkeep +0 -0
  5. package/morph-idm/Functions/.gitkeep +0 -0
  6. package/morph-idm/Functions/user/function-validate-user.json +31 -0
  7. package/morph-idm/Functions/user/src/ValidateUser.csx +39 -0
  8. package/morph-idm/Mappings/device-register-evaluate-get-device-request.mapper.json +319 -0
  9. package/morph-idm/Mappings/device-register-evaluate-get-device-response.mapper.json +761 -0
  10. package/morph-idm/Mappings/device-register-new-device-call-device-start-request.mapper.json +762 -0
  11. package/morph-idm/Mappings/device-register-start.mapper.json +971 -0
  12. package/morph-idm/Mappings/device-start-request.mapper.json +20 -0
  13. package/morph-idm/Mappings/device-start.mapper.json +896 -0
  14. package/morph-idm/Mappings/device-update-request.mapper.json +883 -0
  15. package/morph-idm/Mappings/token-start-request.mapper.json +436 -0
  16. package/morph-idm/Schemas/approval-matrix/approval-matrix-master-1.0.0.json +98 -0
  17. package/morph-idm/Schemas/approval-matrix/approval-matrix-update-1.0.0.json +85 -0
  18. package/morph-idm/Schemas/client/client-master-1.0.0.json +293 -0
  19. package/morph-idm/Schemas/client/client-update-master-1.0.0.json +201 -0
  20. package/morph-idm/Schemas/consent/consent-master-1.0.0.json +151 -0
  21. package/morph-idm/Schemas/device/device-master-1.0.0.json +433 -0
  22. package/morph-idm/Schemas/device/device-register-master-1.0.0.json +300 -0
  23. package/morph-idm/Schemas/device/device-register-start-1.0.0.json +270 -0
  24. package/morph-idm/Schemas/device/device-start-1.0.0.json +281 -0
  25. package/morph-idm/Schemas/device/device-update-1.0.0.json +275 -0
  26. package/morph-idm/Schemas/headers-1.0.0.json +245 -0
  27. package/morph-idm/Schemas/organization/organization-master-1.0.0.json +386 -0
  28. package/morph-idm/Schemas/organization/organization-update-1.0.0.json +60 -0
  29. package/morph-idm/Schemas/privilege/privilege-master-1.0.0.json +84 -0
  30. package/morph-idm/Schemas/privilege/privilege-update-1.0.0.json +76 -0
  31. package/morph-idm/Schemas/scope/scope-group-master-1.0.0.json +52 -0
  32. package/morph-idm/Schemas/scope/scope-master-1.0.0.json +120 -0
  33. package/morph-idm/Schemas/token/token-master-1.0.0.json +346 -0
  34. package/morph-idm/Schemas/token/token-start-1.0.0.json +50 -0
  35. package/morph-idm/Schemas/transaction-limit/transaction-limit-master-1.0.0.json +175 -0
  36. package/morph-idm/Schemas/transaction-limit/transaction-limit-update-1.0.0.json +90 -0
  37. package/morph-idm/Schemas/user/person-master-1.0.0.json +211 -0
  38. package/morph-idm/Schemas/user/user-master-1.0.0.json +121 -0
  39. package/morph-idm/Tasks/.gitkeep +0 -0
  40. package/morph-idm/Tasks/call-device-start-1.0.0.json +21 -0
  41. package/morph-idm/Tasks/call-device-update-1.0.0.json +21 -0
  42. package/morph-idm/Tasks/client/client-create-rsa.json +26 -0
  43. package/morph-idm/Tasks/client/client-password-generator.json +14 -0
  44. package/morph-idm/Tasks/client/get-client-by-task.json +18 -0
  45. package/morph-idm/Tasks/consent/get-consent-by-task.json +18 -0
  46. package/morph-idm/Tasks/consent/get-multi-consents-by-task.json +25 -0
  47. package/morph-idm/Tasks/device/get-device-by-task.json +18 -0
  48. package/morph-idm/Tasks/get-device-1.0.0.json +20 -0
  49. package/morph-idm/Tasks/scope/get-scope-by-task.json +17 -0
  50. package/morph-idm/Tasks/scope/scope-by-user-task.json +25 -0
  51. package/morph-idm/Tasks/scope/scope-details-task.json +25 -0
  52. package/morph-idm/Tasks/token/send-token-to-main.json +20 -0
  53. package/morph-idm/Tasks/token/token-create-jwt.json +27 -0
  54. package/morph-idm/Tasks/user/get-user-by-task.json +18 -0
  55. package/morph-idm/Tasks/user/send-otp-task.json +25 -0
  56. package/morph-idm/Tasks/user/send-push-task.json +22 -0
  57. package/morph-idm/Tasks/user/user-password-generator.json +26 -0
  58. package/morph-idm/Tasks/user/verify-otp-task.json +22 -0
  59. package/morph-idm/Tasks/user/verify-push-task.json +22 -0
  60. package/morph-idm/Views/.gitkeep +0 -0
  61. package/morph-idm/Workflows/.gitkeep +0 -0
  62. package/morph-idm/Workflows/approval-matrix/approval-1.0.0.json +452 -0
  63. package/morph-idm/Workflows/approval-matrix/approval-matrix-1.0.0.json +184 -0
  64. package/morph-idm/Workflows/client/client-1.0.0.json +257 -0
  65. package/morph-idm/Workflows/client/client-update-1.0.0.json +202 -0
  66. package/morph-idm/Workflows/client/execute/client.http +377 -0
  67. package/morph-idm/Workflows/client/src/ClientCreateRsa.csx +198 -0
  68. package/morph-idm/Workflows/client/src/ClientCreateRsaByScript.csx +118 -0
  69. package/morph-idm/Workflows/client/src/CreateRsaByHttpCallMapping.csx +223 -0
  70. package/morph-idm/Workflows/client/src/PasswordGeneratorMapping.csx +26 -0
  71. package/morph-idm/Workflows/client/src/RsaExistsRule.csx +44 -0
  72. package/morph-idm/Workflows/client-manager/client-manager-1.0.0.json +217 -0
  73. package/morph-idm/Workflows/client-manager/execute/client-manager.http +214 -0
  74. package/morph-idm/Workflows/client-manager/src/ClientCreatedRule.csx +28 -0
  75. package/morph-idm/Workflows/client-manager/src/ClientExistsRule.csx +25 -0
  76. package/morph-idm/Workflows/client-manager/src/CreateClientSubFlowMapping.csx +63 -0
  77. package/morph-idm/Workflows/client-manager/src/GetClientForManagerMapping.csx +59 -0
  78. package/morph-idm/Workflows/consent/consent-1.0.0.json +424 -0
  79. package/morph-idm/Workflows/consent/execute/README.md +167 -0
  80. package/morph-idm/Workflows/consent/execute/consent-invitation-flow.http +283 -0
  81. package/morph-idm/Workflows/consent/execute/create-consent.http +780 -0
  82. package/morph-idm/Workflows/consent/src/AutoConsentRule.csx +29 -0
  83. package/morph-idm/Workflows/consent/src/ConsentTimeoutTimer.csx +14 -0
  84. package/morph-idm/Workflows/consent-selection/consent-selection-1.0.0.json +331 -0
  85. package/morph-idm/Workflows/consent-selection/src/AutoConsentCreatedRule.csx +28 -0
  86. package/morph-idm/Workflows/consent-selection/src/ConsentFetchMapping.csx +82 -0
  87. package/morph-idm/Workflows/consent-selection/src/ConsentSelectedMapping.csx +70 -0
  88. package/morph-idm/Workflows/consent-selection/src/CreateAutoConsentMapping.csx +150 -0
  89. package/morph-idm/Workflows/consent-selection/src/MultipleConsentsRule.csx +31 -0
  90. package/morph-idm/Workflows/consent-selection/src/NoConsentEligibleRule.csx +44 -0
  91. package/morph-idm/Workflows/consent-selection/src/SingleConsentRule.csx +45 -0
  92. package/morph-idm/Workflows/device/device-1.0.0.json +261 -0
  93. package/morph-idm/Workflows/device/device-migration-1.0.0.json +213 -0
  94. package/morph-idm/Workflows/device/device-register-1.0.0-documentation.md +646 -0
  95. package/morph-idm/Workflows/device/device-register-1.0.0-documentation.svg +36 -0
  96. package/morph-idm/Workflows/device/device-register-1.0.0.json +185 -0
  97. package/morph-idm/Workflows/device/execute/device-android.http +260 -0
  98. package/morph-idm/Workflows/device/execute/device-huawei.http +219 -0
  99. package/morph-idm/Workflows/device/execute/device-ios.http +325 -0
  100. package/morph-idm/Workflows/device/execute/device-web.http +284 -0
  101. package/morph-idm/Workflows/device/src/DeviceCreatedRule.csx +32 -0
  102. package/morph-idm/Workflows/device/src/DeviceFoundRule.csx +32 -0
  103. package/morph-idm/Workflows/device/src/DeviceNotFoundRule.csx +28 -0
  104. package/morph-idm/Workflows/device/src/DeviceUpdatedRule.csx +26 -0
  105. package/morph-idm/Workflows/device/src/NoUpdateRule.csx +19 -0
  106. package/morph-idm/Workflows/device/src/ReInstallRule.csx +19 -0
  107. package/morph-idm/Workflows/document-validation/_FF_document-validation.json +423 -0
  108. package/morph-idm/Workflows/document-validation/src/ApproveRule.csx +16 -0
  109. package/morph-idm/Workflows/document-validation/src/ClassifyRule.csx +16 -0
  110. package/morph-idm/Workflows/document-validation/src/ExtractRule.csx +16 -0
  111. package/morph-idm/Workflows/document-validation/src/HitlRule.csx +16 -0
  112. package/morph-idm/Workflows/document-validation/src/RejectRule.csx +16 -0
  113. package/morph-idm/Workflows/document-validation/src/RunOcrRule.csx +16 -0
  114. package/morph-idm/Workflows/document-validation/src/StartRule.csx +16 -0
  115. package/morph-idm/Workflows/document-validation/src/ToAggregateRule.csx +16 -0
  116. package/morph-idm/Workflows/document-validation/src/ToFraudRule.csx +16 -0
  117. package/morph-idm/Workflows/document-validation/src/ToReferentialRule.csx +16 -0
  118. package/morph-idm/Workflows/document-validation/src/ToSemanticRule.csx +16 -0
  119. package/morph-idm/Workflows/document-validation/src/ToStructuralRule.csx +16 -0
  120. package/morph-idm/Workflows/organization/execute/create-organization.http +280 -0
  121. package/morph-idm/Workflows/organization/organization-1.0.0-documentation.md +616 -0
  122. package/morph-idm/Workflows/organization/organization-1.0.0.json +181 -0
  123. package/morph-idm/Workflows/privilege/privilege-1.0.0.json +185 -0
  124. package/morph-idm/Workflows/scope/execute/scope-24-7-access.http +131 -0
  125. package/morph-idm/Workflows/scope/execute/scope-business-hours.http +138 -0
  126. package/morph-idm/Workflows/scope/execute/scope-corporate.http +165 -0
  127. package/morph-idm/Workflows/scope/execute/scope-individual.http +133 -0
  128. package/morph-idm/Workflows/scope/execute/scope-lifecycle-test.http +133 -0
  129. package/morph-idm/Workflows/scope/execute/scope-multi-systems.http +159 -0
  130. package/morph-idm/Workflows/scope/execute/scope-restricted.http +143 -0
  131. package/morph-idm/Workflows/scope/scope-1.0.0.json +142 -0
  132. package/morph-idm/Workflows/scope/scope-group-1.0.0.json +144 -0
  133. package/morph-idm/Workflows/scope-group/execute/create-scope-group.http +222 -0
  134. package/morph-idm/Workflows/token/execute/README.md +450 -0
  135. package/morph-idm/Workflows/token/execute/token.http +236 -0
  136. package/morph-idm/Workflows/token/oauth-authentication-workflow.json +406 -0
  137. package/morph-idm/Workflows/token/password-subflow.json +173 -0
  138. package/morph-idm/Workflows/token/scope-cdc-worker.1.0.0.json +46 -0
  139. package/morph-idm/Workflows/token/src/CreateRsaJwtMapping.csx +208 -0
  140. package/morph-idm/Workflows/token/src/ExpireTokenTimer.csx +14 -0
  141. package/morph-idm/Workflows/token/src/PrepareAuthorizationCodeRule.csx +16 -0
  142. package/morph-idm/Workflows/token/src/RequestInappropriateRule.csx +16 -0
  143. package/morph-idm/Workflows/token/src/SendJwtToMainMapping.csx +167 -0
  144. package/morph-idm/Workflows/token/token-1.0.0.json +356 -0
  145. package/morph-idm/Workflows/token/token-1.0.0.openapi.json.md +707 -0
  146. package/morph-idm/Workflows/token/token-exchange.1.0.0.json +45 -0
  147. package/morph-idm/Workflows/transaction-limit/transaction-limit-1.0.0.json +244 -0
  148. package/morph-idm/Workflows/transaction-limit/transaction-limit-authorization.json +502 -0
  149. package/morph-idm/Workflows/transaction-limit/transaction-limit-capture.json +142 -0
  150. package/morph-idm/Workflows/user/execute/README-LOGIN.md +535 -0
  151. package/morph-idm/Workflows/user/execute/create-user-1234567890.http +116 -0
  152. package/morph-idm/Workflows/user/execute/create-user-minimal.http +22 -0
  153. package/morph-idm/Workflows/user/execute/create-user-person-password.http +130 -0
  154. package/morph-idm/Workflows/user/execute/create-user-person.http +249 -0
  155. package/morph-idm/Workflows/user/execute/create-user-system.http +16 -0
  156. package/morph-idm/Workflows/user/execute/user-login.http +583 -0
  157. package/morph-idm/Workflows/user/execute/user-requests.http +51 -0
  158. package/morph-idm/Workflows/user/person-1.0.0.json +140 -0
  159. package/morph-idm/Workflows/user/person-cdc-worker.1.0.0.json +46 -0
  160. package/morph-idm/Workflows/user/person-upsert-1.0.0.json +129 -0
  161. package/morph-idm/Workflows/user/src/ApproveRule.csx +16 -0
  162. package/morph-idm/Workflows/user/src/AutoConsentCreatedRule.csx +20 -0
  163. package/morph-idm/Workflows/user/src/AutoConsentRequiredRule.csx +77 -0
  164. package/morph-idm/Workflows/user/src/CheckDeviceByUserReferenceMapping.csx +66 -0
  165. package/morph-idm/Workflows/user/src/ClientValidationFailRule.csx +28 -0
  166. package/morph-idm/Workflows/user/src/ClientValidationRule.csx +25 -0
  167. package/morph-idm/Workflows/user/src/ConsentSelectedRule.csx +24 -0
  168. package/morph-idm/Workflows/user/src/ConsentValidationRule.csx +36 -0
  169. package/morph-idm/Workflows/user/src/CreateAutoConsentMapping.csx +171 -0
  170. package/morph-idm/Workflows/user/src/DeviceFoundForLoginRule.csx +32 -0
  171. package/morph-idm/Workflows/user/src/DeviceNotFoundForLoginRule.csx +31 -0
  172. package/morph-idm/Workflows/user/src/GetClientMapping.csx +45 -0
  173. package/morph-idm/Workflows/user/src/GetConsentMapping.csx +27 -0
  174. package/morph-idm/Workflows/user/src/GetDeviceMapping.csx +52 -0
  175. package/morph-idm/Workflows/user/src/GetScopeMapping.csx +139 -0
  176. package/morph-idm/Workflows/user/src/GetScopesByUserMapping.csx +137 -0
  177. package/morph-idm/Workflows/user/src/GetUserMapping.csx +39 -0
  178. package/morph-idm/Workflows/user/src/GrantValidationFailRule.csx +48 -0
  179. package/morph-idm/Workflows/user/src/GrantValidationRule.csx +45 -0
  180. package/morph-idm/Workflows/user/src/IsIbWebClientWithDeviceRule.csx +42 -0
  181. package/morph-idm/Workflows/user/src/NonIbWebClientWithDeviceRule.csx +42 -0
  182. package/morph-idm/Workflows/user/src/OtpSentRule.csx +31 -0
  183. package/morph-idm/Workflows/user/src/OtpVerifiedRule.csx +31 -0
  184. package/morph-idm/Workflows/user/src/PushSentRule.csx +31 -0
  185. package/morph-idm/Workflows/user/src/PushVerifiedRule.csx +31 -0
  186. package/morph-idm/Workflows/user/src/RejectRule.csx +16 -0
  187. package/morph-idm/Workflows/user/src/ScopeFetchedRule.csx +35 -0
  188. package/morph-idm/Workflows/user/src/ScopeValidationFailRule.csx +67 -0
  189. package/morph-idm/Workflows/user/src/ScopeValidationRule.csx +67 -0
  190. package/morph-idm/Workflows/user/src/SendOtpMapping.csx +94 -0
  191. package/morph-idm/Workflows/user/src/SendPushMapping.csx +90 -0
  192. package/morph-idm/Workflows/user/src/TokenGenerationSuccessRule.csx +28 -0
  193. package/morph-idm/Workflows/user/src/TriggerConsentSelectionAsSubFlowMapping.csx +63 -0
  194. package/morph-idm/Workflows/user/src/TriggerTokenWorkflowAsSubFlowMapping.csx +42 -0
  195. package/morph-idm/Workflows/user/src/UserPasswordGeneratorMapping.csx +190 -0
  196. package/morph-idm/Workflows/user/src/UserValidationFailRule.csx +36 -0
  197. package/morph-idm/Workflows/user/src/UserValidationRule.csx +38 -0
  198. package/morph-idm/Workflows/user/src/VerifyOtpMapping.csx +65 -0
  199. package/morph-idm/Workflows/user/src/VerifyPushMapping.csx +65 -0
  200. package/morph-idm/Workflows/user/user-1.0.0.json +400 -0
  201. package/morph-idm/Workflows/user/user-force-update.1.0.0.json +46 -0
  202. package/morph-idm/Workflows/user/user-login-certificate.1.0.0.json +46 -0
  203. package/morph-idm/Workflows/user/user-login.1.0.0.json +1144 -0
  204. package/morph-idm/Workflows/user/user-password-reset.1.0.0.json +45 -0
  205. package/package.json +21 -0
  206. package/vnext.config.json +58 -0
@@ -0,0 +1,646 @@
1
+ # device-register (1.0.0)
2
+
3
+ ![Workflow Diagram](./device-register-1.0.0-documentation.svg)
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
+