Περιορισμός εγκατάστασης On-Premise με βάση την IP
Αυτή η σελίδα απευθύνεται σε διαχειριστές εγκατάστασης on-premise του MonoChat. Εξηγεί πώς να περιορίσετε την εφαρμογή web στα δικά σας δίκτυα σε επίπεδο δικτύου (nginx ή τείχος προστασίας), χωρίς να μπλοκάρετε τις υπηρεσίες που πρέπει να καλούν το MonoChat από το internet.
Το MonoChat δεν διαθέτει δική του λίστα επιτρεπόμενων IP. Ο περιορισμός ορίζεται στο nginx, στον load balancer ή στο τείχος προστασίας σας και ισχύει για ολόκληρη την εγκατάσταση, όχι για έναν μεμονωμένο χώρο εργασίας.
Τι να περιορίσετε και τι να αφήσετε ανοιχτό
| Να παραμείνει περιορισμένο στα δίκτυά σας | Να παραμείνει προσβάσιμο από το internet |
|---|---|
| Η εφαρμογή web και ό,τι δεν αναφέρεται στα δεξιά | Οι διαδρομές webhook και callback στους παρακάτω πίνακες |
Το endpoint DDP/WebSocket στο οποίο συνδέεται η εφαρμογή web (/websocket) |
Περιορίστε μαζί το web UI και το endpoint WebSocket: η εφαρμογή χρησιμοποιεί και τα δύο. Επιτρέψτε στους υπόλοιπους μόνο τις παρακάτω διαδρομές και μπλοκάρετε τις υπόλοιπες.
Διαδρομές που καλούν εξωτερικές υπηρεσίες
Κάθε διαδρομή παρακάτω καταχωρίζεται από τον διακομιστή του MonoChat. Μια διαδρομή που προκύπτει από μια ρύθμιση είναι το hookPath που ορίσατε στον διακομιστή (στο channelConnectors.<name> ή στο paymentSystemConnectors.<name> στις ρυθμίσεις του διακομιστή)· την κατάληξη προσθέτει ο κώδικας. Ανοίξτε μόνο τους connectors που χρησιμοποιείτε.
Κανάλια
| Διαδρομή | Καλείται από | Ορίζεται σε |
|---|---|---|
<hookPath>/webhooks (POST) | omni-message, για WhatsApp Cloud, WhatsApp Gupshup, Instagram, Messenger, Telegram, TikTok, Twilio SMS και Varan OTP | packages/app-connectors-om2-*/src/webhooks/webhook.ts; hookPath από channelConnectors.whatsappBusinessVegaCloud, whatsappBusinessVegaGupshup, instagramCastor, messengerRigel, telegramBotRegulus, tikTokTimir, twilioSms, varanOtp |
<hookPath>/webhooks, <hookPath>/sessions, <hookPath>/messages (POST) | Τα δικά σας συστήματα, μέσω του καναλιού Messages API | channelConnectors.messagesApi.hookPath, packages/app-connectors-messages-api/src/webhooks/webhook.ts |
<hookPath>/<token>/message, <hookPath>/<token>/info, <hookPath>/message, <hookPath>/info (POST) | Chatwoot | channelConnectors.chatwoot.hookPath, packages/app-connectors-chatwoot/src/webhook.ts |
<hookPath>/inbound (POST) | Ο πάροχος SIP (κανάλια generic SIP και Sonitel SIP) | channelConnectors.genericSip.hookPath, channelConnectors.sonitelSip.hookPath |
/api/facebook/channels/:channelId/flows/:flowId (POST) | WhatsApp, για τα WhatsApp Flows | server/api/whatsapp-flow.js |
Οι πάροχοι καναλιών (Meta, Telegram, TikTok, Twilio) δεν καλούν απευθείας το MonoChat. Καλούν τον webhook listener του omni-message, ο οποίος προωθεί στη διαδρομή /webhooks παραπάνω. Αν εκτελείτε μόνοι σας το omni-message, ο webhook listener του πρέπει να είναι προσβάσιμος από το internet στις εξής διαδρομές: /webhooks/meta-messenger, /webhooks/instagram-business, /webhooks/wab-cloud, /webhooks/wab-gupshup/:channelId, /webhooks/wab-360-dialog/:channelId, /webhooks/telegram-bot/:channelId, /webhooks/tiktok και /webhooks/twilio-sms/:channelId (apps/webhook-listener/src/modules/webhook-listeners/webhook-listeners.controller.ts στο omni-message). Το ίδιο το MonoChat πρέπει να είναι προσβάσιμο από το omni-message στις παραπάνω διαδρομές /webhooks.
Συστήματα πληρωμών
Οι πάροχοι πληρωμών κάνουν callback όταν ένας πελάτης πληρώνει και επαναφέρουν τον πελάτη στο MonoChat στη συνέχεια. Και τα δύο πρέπει να λειτουργούν από έξω από το δίκτυό σας.
| Connector | Διαδρομές κάτω από το hookPath του (paymentSystemConnectors.<name>.hookPath) |
|---|---|
| Stripe | /webhook/:clientId (POST), /return/success/:paymentSystemId, /return/cancel/:paymentSystemId |
| HyperPay | /pay/:clientId/:paymentSystemOrderId, /result/:clientId/:paymentSystemOrderId |
| Mamo | /webhook/:clientId (POST), /return/:clientId/:paymentSystemOrderId |
| Midtrans | /webhook/:clientId (POST), /return/:paymentSystemOrderId |
| Paymob | /webhook/:clientId (POST), /return/:paymentSystemOrderId |
| PayTabs | /callback/:clientId/:paymentSystemOrderId (POST), /return/:paymentSystemOrderId |
| Tabby | /webhook/:clientId (POST), /return/:paymentSystemOrderId/:status |
| Tamara | /webhook/:clientId (POST), /return/:paymentSystemOrderId/:status |
| Tap | /webhook/:clientId (POST), /return/:clientId/:paymentSystemOrderId |
| Telr | /webhook/:clientId/:paymentSystemOrderId (POST), /return/:paymentSystemOrderId/:status |
| Ziina | /return/:clientId/:paymentSystemOrderId/:status |
| iyzico | /:transactionId (POST) |
| JCC | /:status |
| MyFatoorah | το ίδιο το hookPath (POST), /:paymentSystemOrderId/:status (POST) |
| N-Genius | το ίδιο το hookPath (POST), /:paymentSystemOrderId/:status |
| Paywall | /:paymentSystemOrderId/:status |
| UniqoPay | το ίδιο το hookPath (POST), /:paymentSystemOrderId/:status (POST) |
| VakıfBank Sanal POS | /:status (GET και POST) |
| İş Yerim POS | το ίδιο το hookPath (GET και POST) |
Ο απλούστερος κανόνας είναι να ανοίξετε το <hookPath> και ό,τι βρίσκεται κάτω από αυτό για κάθε connector πληρωμών που χρησιμοποιείτε. Η πηγή κάθε connector είναι το packages/app-connectors-<name>/src/webhook.ts.
Άλλα endpoints του διακομιστή
| Διαδρομή | Χρήση | Ορίζεται σε |
|---|---|---|
/api/:slug/custom-functions/… (POST) | Κλήση προσαρμοσμένης συνάρτησης μέσω HTTP με token πρόσβασης | lib/managers/custom-function-sdk/_/server/endpoint.js |
/api/ai-agent/mcp, /api/ai-agent/events (POST) | Οι εκτελέσεις πρακτόρων AI αναφέρουν πίσω στο MonoChat | server/api/ai-agent.ts |
/api/channels-manager/facebook/auth, /api/channels-manager/tiktok/auth (GET) | Το αναδυόμενο παράθυρο που επιστρέφει μετά τη σύνδεση λογαριασμού Facebook ή TikTok | packages/app-managers-channel/src/webhook.ts |
/l/:_id (GET) | Σύντομοι σύνδεσμοι που στέλνετε στους πελάτες | server/api/short-link.js |
/api/status (GET) | Η εφαρμογή για κινητά ελέγχει τον διακομιστή και τις επιλογές σύνδεσής του | server/api/status.js |
/.well-known/assetlinks.json, /.well-known/apple-app-site-association (GET) | Σύνδεσμοι εφαρμογής Android και iOS | server/api/assetlinks.js, server/api/apple-app-site-association.js |
Ανοίξτε τα /api/:slug/custom-functions, /api/ai-agent, /l/ και τις δύο διαδρομές αναδυόμενου παραθύρου καναλιών, αν χρησιμοποιείτε αυτές τις λειτουργίες από έξω από το δίκτυό σας. Οι διαδρομές αναδυόμενου παραθύρου καναλιών ανοίγουν στο πρόγραμμα περιήγησης του ατόμου που συνδέει τον λογαριασμό, οπότε μπορούν να παραμείνουν περιορισμένες αν τα κανάλια συνδέονται μόνο από άτομα του δικτύου σας. Ανοίξτε το /api/status και τα δύο αρχεία /.well-known μόνο αν οι εκπρόσωποί σας χρησιμοποιούν την εφαρμογή MonoChat για κινητά από έξω από το δίκτυό σας.
Σύνδεση με πάροχο (OAuth)
Όταν ένας πάροχος σύνδεσης επαναφέρει το πρόγραμμα περιήγησης στο MonoChat, η ανακατεύθυνση είναι ένα κανονικό αίτημα προγράμματος περιήγησης του ατόμου που συνδέεται, οπότε ακολουθεί τον ίδιο περιορισμό με την εφαρμογή web. Κρατήστε προσβάσιμες τις διαδρομές ανακατεύθυνσης για τα άτομα που συνδέονται με αυτόν τον τρόπο. Οι διαδρομές είναι οι τιμέ ς redirectPath στο public.oauth.<provider> στις ρυθμίσεις του διακομιστή (τα προεπιλεγμένα παραδείγματα είναι /api/oauth/google/redirect, /api/oauth/microsoft/redirect, /api/oauth/facebook/redirect και /api/oauth/apple/redirect). Η σύνδεση με Apple επιστρέφει το πρόγραμμα περιήγησης με POST (responseMode: form_post), το οποίο δέχεται η ίδια διαδρομή. Για την εφαρμογή κινητών, ο διακομιστής απαντά επίσης στα /api/oauth/facebook/mobile, /api/oauth/microsoft/mobile και /auth/oauth-callback/<provider> (server/configs/oauth/mobile.ts).
Αν χρησιμοποιείτε την ενσωμάτωση Microsoft Marketplace, η διαδρομή στο microsoftMarketplace.redirectWebhookPath δέχεται το αίτημα του Microsoft Marketplace και πρέπει να είναι προσβάσιμη από το internet (server/configs/microsoft-marketplace/webook.ts).
Διοχέτευση της πραγματικής IP του πελάτη μέσω του proxy
Το MonoChat καταγράφει την IP του πελάτη για τις συνεδρίες και τα αρχεία καταγραφής κατάστασης. Πίσω από έναν reverse proxy ή load balancer βλέπει τη διεύθυνση του proxy, εκτός αν περάσετε την πραγματική.
- Ρυθμίστε το nginx (ή τον load balancer) να στέλνει την αρχική διεύθυνση στην κεφαλίδα
X-Forwarded-For, για παράδειγμαproxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;. - Ορίστε τη μεταβλητή περιβάλλοντος
HTTP_FORWARDED_COUNTστον διακομιστή του MonoChat στον αριθμό των proxies μπροστά από την εφαρμογή. Τη διαβάζει το framework Meteor και όχι ο κώδικας του MonoChat, οπότε ανήκει στις ρυθμίσεις της ανάπτυξής σας και όχι στο JSON ρυθμίσεων.
Έλεγχος της ρύθμισής σας
- Από ένα δίκτυο που δεν επιτρέπεται, ανοίξτε την εφαρμογή web. Πρέπει να απορριφθεί.
- Από ένα επιτρεπόμενο δίκτυο, συνδεθείτε και ανοίξτε τα εισερχόμενα. Τα μηνύματα πρέπει να φορτώνουν, γεγονός που αποδεικνύει ότι το endpoint WebSocket είναι ανοιχτό για εσάς.
- Στείλτε ένα δοκιμαστικό μήνυμα σε ένα συνδεδεμένο κανάλι από έξω από το δίκτυό σας και επιβεβαιώστε ότι φτάνει στα εισερχόμενα.
- Δημιουργήστε έναν σύνδεσμο πληρωμής για μια μικρή δοκιμαστική παραγγελία, πληρώστε τον και επιβεβαιώστε ότι η παραγγελία εμφανίζεται ως πληρωμένη.
Δοκιμάζετε τις διαδρομές μετά από κάθε αλλαγή στους κανόνες του proxy σας. Μια μπλοκαρισμένη διαδρομή webhook δεν εμφανίζει σφάλμα στο MonoChat: τα μηνύματα και οι επιβεβαιώσεις πληρωμών απλώς σταματούν να φτάνουν.