אפליקציית מובייל למערכות בקרת כניסה: אינטגרציה וניהול מרחוק

ניהול מערכת בקרת כניסה (ACS) באמצעות אפליקציה ניידת

שילוב אפליקציה ניידת עם מערכת ACS נתקל בחומת אי-תאימות פרוטוקולים. לבקרים כמו Suprema BioStar, HID OSDP, Ironlogic Z-5R, RusGuard יש API ופורמט נתונים משלהם. אנו פותרים זאת על ידי יצירת ממשק אחיד על גבי REST או OSDP v2 שעובד היטב גם ל-iOS וגם ל-Android. בזכות גישה זו, לקוחות חוסכים עד 40% מזמן היישום, ונמנעים משכתיבת לוגיקה עבור כל בקר.

האפליקציה הניידת מטפלת בשלוש פונקציות קריטיות: ניטור אירועי כניסה בזמן אמת, שליטה מרחוק בדלתות, וניהול גמיש של הרשאות גישה. ללא זה, מאבטחים תקועים מול קונסולה ומחלקת משאבי אנוש ממלאת טפסים בנייר. עם האפליקציה שלנו, כל הפעולות מתבצעות בכמה הקשות, ועלות תקריות האבטחה יורדת עד 50% בזכות תגובה מיידית.

בעיות שאנו פותרים

עיכובים באירועים. שאילתות REST רגילות כל 2-5 שניות מפספסות אירועים בזמן עומס בקרוסלות. אנו משתמשים ב-WebSocket (BioStar 2 תומך ב-/ws/events) לזרם בזמן אמת. העיכוב שלנו בין מעבר להופעת האירוע באפליקציה הוא מתחת ל-500 אלפיות השנייה — פי 4 מהר יותר משאילתות.

אבטחת פתיחת דלת מרחוק. פתיחת דלת עם כפתור באפליקציה נוחה אך מסוכנת ללא הגנה. בקשה שמיירטה יכולה להיות משוחזרת. אנו מיישמים חתימת HMAC-SHA256 עם חותמת זמן, מה שהופך שחזור לבלתי אפשרי לאחר 30 שניות. כל פתיחה מתועדת בשרת.

ניהול כרטיסים והרשאות. הזנה ידנית של מספר כרטיס Mifare בן 10 ספרות מזמינה שגיאות. אנו מוסיפים קריאת NFC: המאבטח מקיש את הכרטיס לטלפון, והמספר נקלט אוטומטית. לאחר מכן בחירת דלתות ולוחות זמנים באמצעות טופס אינטואיטיבי. זמן הוספת הכרטיס יורד מ-30 ל-5 שניות, ושגיאות ההזנה יורדות לאפס.

איך אנחנו עושים את זה: טכנולוגיות ואינטגרציה

לאינטגרציה עם בקרים אנו משתמשים ב-REST API (Suprema BioStar 2, HID Mercury) או OSDP v2 על גבי TCP. בפרויקט Kotlin Multiplatform, מבנה אירוע הכניסה נראה כך:

data class AccessEvent(
    val id: Long,
    val timestamp: Instant,
    val deviceId: Long,
    val doorId: Long,
    val userId: Long?,
    val cardNumber: String?,
    val eventCode: Int,
    val temperature: Double?,
    val imageData: String?
)

זרם ה-WebSocket החי הוא רכיב סטנדרטי. קוד Kotlin באמצעות OkHttp:

class AcsEventStream(private val url: String, private val token: String) {
    fun observe(): Flow<AccessEvent> = callbackFlow {
        val client = OkHttpClient.Builder()
            .readTimeout(0, TimeUnit.MILLISECONDS)
            .build()
        val ws = client.newWebSocket(
            Request.Builder().url(url)
                .header("Authorization", "Bearer $token").build(),
            object : WebSocketListener() {
                override fun onMessage(webSocket: WebSocket, text: String) {
                    val event = Json.decodeFromString<AccessEvent>(text)
                    trySend(event)
                }

                override fun onFailure(webSocket: WebSocket, t: Throwable, response: Response?) {
                    close(t)
                }
            }
        )
        awaitClose {
            ws.close(1000, null)
        }
    }
}

למה אבטחת פתיחת דלת מרחוק היא קריטית

כל בקשה לפתיחת דלת חייבת להיות חתומה ומאומתת בצד השרת. היישום שלנו ב-Android/iOS:

suspend fun unlockDoor(doorId: Long) {
    val timestamp = System.currentTimeMillis()
    val payload = "$timestamp:$doorId:${authService.userId}"
    val signature = hmacSha256(payload, authService.apiSecret)
    api.unlockDoor(
        DoorUnlockRequest(
            doorId = doorId,
            timestamp = timestamp,
            signature = signature,
            reason = "manual_unlock_mobile"
        )
    )
}

השרת בודק: חותמת זמן ≤ 30 שניות, חתימה תואמת, ולמשתמש יש הרשאת data class AccessEvent( val id: Long, val timestamp: Instant, val deviceId: Long, val doorId: Long, val userId: Long?, val cardNumber: String?, val eventCode: Int, val temperature: Double?, val imageData: String? ) . ללא בדיקות אלה, תוקף שמיירט תעבורה יכול לשחזר את הבקשה.

איך לשלב NFC לקריאת כרטיסים

ב-Android אנו משתמשים ב-class AcsEventStream(private val url: String, private val token: String) { fun observe(): Flow<AccessEvent> = callbackFlow { val client = OkHttpClient.Builder() .readTimeout(0, TimeUnit.MILLISECONDS) .build() val ws = client.newWebSocket( Request.Builder().url(url) .header("Authorization", "Bearer $token").build(), object : WebSocketListener() { override fun onMessage(webSocket: WebSocket, text: String) { val event = Json.decodeFromString<AccessEvent>(text) trySend(event) } override fun onFailure(webSocket: WebSocket, t: Throwable, response: Response?) { close(t) } } ) awaitClose { ws.close(1000, null) } } } , וב-iOS — ב-suspend fun unlockDoor(doorId: Long) { val timestamp = System.currentTimeMillis() val payload = "$timestamp:$doorId:${authService.userId}" val signature = hmacSha256(payload, authService.apiSecret) api.unlockDoor(DoorUnlockRequest( doorId = doorId, timestamp = timestamp, signature = signature, reason = "manual_unlock_mobile" )) } . הקישו את הכרטיס לטלפון, האפליקציה קוראת את ה-UID ושולחת אותו לשרת כדי לקשר למשתמש. זה מקצר את זמן הוספת הכרטיס מ-30 ל-5 שניות ומבטל שגיאות הזנה.

מה כלול בעבודה

אנו מספקים לא רק אפליקציה, אלא חבילה מלאה: קוד מקור, תיעוד אינטגרציה ל-API, גישה לצד השרת (במידת הצורך), הדרכת מנהלים, ו-3 חודשי תמיכה לאחר ההשקה. הכל קבוע בחוזה, מה שמאפשר לכם לפתח את המערכת באופן עצמאי.

תהליך העבודה

לוחות זמנים משוערים

MVP עם פונקציות בסיסיות: זרם אירועים, פתיחת דלת מרחוק, ניהול כרטיסי NFC — בין 4 ל-7 שבועות. העלות מחושבת באופן אישי לאחר בחינת ה-API של המערכת הספציפית ודרישות האבטחה.

טעויות נפוצות בפיתוח אפליקציות ACS

• ללא הגנה מפני שחזור בקשות לפתיחת דלת.
• בדיקות הרשאות בצד השרת מתעלמות (הלקוח מחליט מה מותר).
• מרווחי שאילתות REST ארוכים במקום WebSocket.
• הזנה ידנית של מספר כרטיס ללא NFC.

יש לנו ניסיון של 5+ שנים בפיתוח אפליקציות ניידות ל-ACS ומעל 20 פרויקטים מיושמים ללקוחות ברוסיה ובמדינות חבר העמים. אנו מבטיחים אינטגרציה נכונה עם כל API ואבטחה התואמת להנחיות סקירת ה-App Store.

מעוניינים? קבלו ייעוץ לפרויקט שלכם — נעריך את מורכבות האינטגרציה ונציע פתרון. צרו קשר כדי לדון בפרטים.

הערה: הצוות שלנו מחזיק בהסמכות פיתוח ל-iOS ו-Android ויש לו ניסיון מעשי עם Suprema BioStar, HID ו-RusGuard.