इंस्टॉलेशन
चरण 1 — Content Security Policy (CSP) कॉन्फ़िगर करें
Web SDK सुरक्षा और प्रदर्शन के लिए Web Workers का उपयोग करता है। अपने CSP में निम्नलिखित कॉन्फ़िगरेशन जोड़ें:
<meta
http-equiv="Content-Security-Policy"
content="
script-src 'self' 'unsafe-eval' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io *.launchdarkly.com *.newrelic.com bam.nr-data.net;
worker-src 'self' blob:;
child-src 'self' blob:;
style-src 'self' 'unsafe-inline' *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
font-src 'self' https://fonts.gstatic.com *.acesso.io *.unico.run *.unico.io *.unico.app;
img-src 'self' data: blob: *.acesso.io *.unico.run *.unico.io *.unico.app;
media-src 'self' data: *.acesso.io *.unico.run *.unico.io *.unico.app;
script-src-elem 'self' 'unsafe-inline' blob: *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app;
connect-src *.googleapis.com *.acesso.io *.unico.run *.unico.io *.unico.app *.sentry.io *.launchdarkly.com *.newrelic.com bam.nr-data.net"
/>
यदि आपके एप्लिकेशन में CSP है, तो SDK के सही कामकाज को सुनिश्चित करने के लिए यह कॉन्फ़िगरेशन अनिवार्य है।
'unsafe-eval'(script-src) — लाइवनेस डिटेक्शन इंजन द्वारा WebAssembly को compile करने और runtime पर अपनी सुरक्षा routines को dynamically evaluate करने के लिए आवश्यक है।'unsafe-inline'(style-src, script-src-elem) — SDK के inline styles और inline script bootstrapping के लिए आवश्यक है। इसे हटाने से capture UI टूट जाता है।*.acesso.io— Unico का legacy infrastructure domain, assets और API calls के लिए अभी भी आवश्यक है।*.unico.run/*.unico.io/*.unico.app— वर्तमान Unico service domains (CDN, API, और app subdomains)।*.googleapis.com(script-src, style-src, script-src-elem, connect-src) — Google Fonts stylesheet (@font-faceCSS viafonts.googleapis.com) और capture UI द्वारा उपयोग किए जाने वाले अन्य Google API resources को load करने के लिए आवश्यक है।fonts.gstatic.com(font-src) —fonts.googleapis.comसे लोड की गई स्टाइलशीट द्वारा संदर्भित Google Fonts की बाइनरी फ़ॉन्ट फ़ाइलें प्रदान करता है।*.sentry.io— Unico, SDK error tracking के लिए Sentry का उपयोग करता है। error reporting calls को allow करने के लिएscript-srcऔरconnect-srcमें आवश्यक है।*.launchdarkly.com— Unico, SDK behavior (जैसे, camera engine selection) को नियंत्रित करने वाले feature-flag evaluation के लिए LaunchDarkly का उपयोग करता है। flag streaming और evaluation calls को allow करने के लिएscript-srcऔरconnect-srcमें आवश्यक है।*.newrelic.com/bam.nr-data.net— Unico, SDK performance monitoring के लिए New Relic Browser का उपयोग करता है।script-src(agent script) औरconnect-src(beacon calls) में आवश्यक है।blob:(worker-src, child-src, script-src-elem) — आवश्यक है क्योंकि Web Workers और कुछ SDK sub-resources runtime पर Blob URLs के रूप में बनाए जाते हैं।
चरण 2 — पैकेज इंस्टॉल करें
Web SDK एक npm पैकेज या CDN के माध्यम से प्रदान किया जाता है।
- npm
- yarn
- CDN
npm install unico-webframe
yarn add unico-webframe
SDK डाउनलोड करें और इसे अपने प्रोजेक्ट में import करें:
चरण 3 — SDK import करें
इंस्टॉलेशन के बाद, SDK को अपने प्रोजेक्ट में import करें।
- npm से
- CDN से
import {
UnicoCheckBuilder,
SelfieCameraTypes,
UnicoThemeBuilder,
DocumentCameraTypes,
UnicoConfig,
LocaleTypes
} from 'unico-webframe'
import {
UnicoCheckBuilder,
SelfieCameraTypes,
UnicoThemeBuilder,
DocumentCameraTypes,
UnicoConfig,
LocaleTypes
} from 'UnicoCheckBuilder.min.js'
चरण 4 — अतिरिक्त रिसोर्स फ़ाइलें डाउनलोड करें
Liveness कैप्चर करने के लिए अतिरिक्त रिसोर्स फ़ाइलें आवश्यक हैं। अपने SDK संस्करण से मेल खाती फ़ाइल डाउनलोड करें और इसे अपने प्रोजेक्ट में शामिल करें:
रिसोर्स फ़ाइलें SDK के संस्करण से बंधी होती हैं। जब भी आप unico-webframe को अपग्रेड करें, आपको नीचे दी गई तालिका से मेल खाने वाले रिसोर्स को अवश्य फिर से डाउनलोड करना होगा — असंगत संस्करणों का उपयोग करने से liveness कैप्चर के दौरान runtime error आता है।
वैकल्पिक रूप से, SDK 3.18.0 से SDK initialization के समय इन फ़ाइलों को स्वचालित रूप से fetch कर सकता है, जिससे manual download की आवश्यकता समाप्त हो जाती है। setResourceDirectory विकल्प के लिए Initialization देखें।
| SDK संस्करण | FaceTec संसाधन |
|---|---|
| 3.23.7 | 9.7.114 |
| 3.23.3 → 3.23.6 | 9.7.107 |
| 3.23.0 → 3.23.1 | 9.7.102 |
| 3.22.6 → 3.22.7 | 9.7.100 |
| 3.22.5 | 9.7.99 |
| 3.22.3 → 3.22.4 | 9.7.98 |
| 3.22.2 | 9.7.96 |
| 3.22.1 | 9.7.93 |
| 3.22.0 | 9.7.90 |
| 3.21.3 → 3.21.4 | 9.7.85 |
| 3.21.2 | 9.7.82 |
| 3.21.1 | 9.7.80 |
| 3.20.10 → 3.21.0 | 9.7.76 |
| 3.20.9 | 9.7.75 |
| 3.20.8 | 9.7.73 |
| 3.20.7 | 9.7.68 |
| 3.20.5 → 3.20.6 | 9.7.65 |
| 3.20.3 → 3.20.4 | 9.7.64 |
| 3.20.2 | 9.7.63 |
| 3.20.1 | 9.7.61 |
| 3.20.0 | 9.7.55 |
| 3.19.0 → 3.19.3 | 9.7.45 → 9.7.51 |
| 3.18.x | 9.6.92 → 9.7.41 (legacy तालिका देखें) |
SDK के लिए AI फ़ाइलें भी डाउनलोड करें: models.zip.
सभी अतिरिक्त फ़ाइलें आपके प्रोजेक्ट के भीतर Web को दिखाई देने वाले एक public स्थान पर होस्ट होनी चाहिए।