SMS OTP Authentication
by Sanal Santral Telekomünikasyon Ticaret A.Ş. https://www.sanalsantral.com.tr$ 114.76
In-App Purchases| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 489 |
| Technical Name |
auth_totp_sms |
| License | OPL-1 |
| Website | https://www.sanalsantral.com.tr |
| Availability |
Odoo Online
Odoo.sh
On Premise
|
| Odoo Apps Dependencies |
Discuss (mail)
|
| Lines of code | 489 |
| Technical Name |
auth_totp_sms |
| License | OPL-1 |
| Website | https://www.sanalsantral.com.tr |
SMS OTP System for Odoo 18
English
Overview
This module enables SMS-based One-Time Password (OTP) authentication for users in Odoo 18. It supports both UI and RPC logins with additional two-factor security over mobile SMS.
Features
- Login protection via SMS-based OTP codes
- Integration with external RPC login flows
- Automatic code sending and validation
Installation
- Place the module inside your Odoo
addonsor custom addons directory. - Update app list and install the auth_totp_sms module.
- Ensure an active SMS gateway module is configured.
Configuration
- Navigate to Settings > Technical Settings.
- Enable "Allow SMS Two-Factor Authentication for RPC".
- Ensure users have valid mobile numbers under their Contacts.
How It Works
When users log in:
- If SMS 2FA is enabled for them, they receive a 6-digit OTP over SMS.
- They are redirected to an OTP entry screen.
- After correct code entry, login is finalized.
RPC API Endpoints
1. Authenticate with SMS
POST /web/session/auth_rpc_smsRequest JSON:
{
"login": "user@example.com",
"password": "userpassword"
}
Response JSON:
{
"uid": null,
"need_sms": true,
"message": "SMS verification required."
}
2. Verify SMS Code
POST /web/session/verify_sms_codeRequest JSON:
{
"code": "123456"
}
Response JSON:
{
"uid": 3,
"message": "SMS verified and login complete."
}
Requirements
- Odoo 18
- Working SMS gateway integration
- Python 3.10+
Customizing the Security Notification Email
The security notification email can be customized by inheriting the QWeb template auth_totp_sms.account_security_setting_update in your own module. See docs/customizing-security-email.md for details.
Support
For questions or issues, contact yazilim@sanalsantral.com.tr.
License
This module is licensed under the Odoo Proprietary License v1.0 (OPL-1).
Türkçe
Genel Bakış
Bu modül, Odoo 18'de kullanıcılar için SMS tabanlı Tek Kullanımlık Şifre (OTP) kimlik doğrulamasını etkinleştirir. Hem arayüz hem de RPC girişlerini destekler; mobil SMS üzerinden ek iki faktörlü güvenlik sağlar.
Özellikler
- SMS tabanlı OTP kodlarıyla giriş koruması
- Harici RPC giriş akışlarıyla entegrasyon
- Otomatik kod gönderme ve doğrulama
Kurulum
- Modülü Odoo
addonsveya özel eklentiler dizinine yerleştirin. - Uygulama listesini güncelleyin ve auth_totp_sms modülünü kurun.
- Aktif bir SMS ağ geçidi modülünün yapılandırıldığından emin olun.
Yapılandırma
- Ayarlar > Teknik Ayarlar bölümüne gidin.
- "RPC için SMS İki Faktörlü Kimlik Doğrulamaya İzin Ver" seçeneğini etkinleştirin.
- Kullanıcıların Kişiler bölümünde geçerli cep telefonu numaraları olduğundan emin olun.
Nasıl Çalışır
Kullanıcılar giriş yaptığında:
- SMS 2FA etkinse 6 haneli OTP kodu SMS ile gönderilir.
- Kullanıcı OTP giriş ekranına yönlendirilir.
- Doğru kod girişinin ardından oturum açma tamamlanır.
RPC API Uç Noktaları
1. SMS ile Kimlik Doğrulama
POST /web/session/auth_rpc_smsİstek JSON:
{
"login": "kullanici@ornek.com",
"password": "kullanicisifre"
}
Yanıt JSON:
{
"uid": null,
"need_sms": true,
"message": "SMS doğrulaması gerekiyor."
}
2. SMS Kodunu Doğrulama
POST /web/session/verify_sms_codeİstek JSON:
{
"code": "123456"
}
Yanıt JSON:
{
"uid": 3,
"message": "SMS doğrulandı ve giriş tamamlandı."
}
Gereksinimler
- Odoo 18
- Çalışan SMS ağ geçidi entegrasyonu
- Python 3.10+
Güvenlik Bildirim E-postasını Özelleştirme
Güvenlik bildirimi e-postası, kendi modülünüzde auth_totp_sms.account_security_setting_update QWeb şablonunu kalıtarak özelleştirilebilir. Ayrıntılar için docs/customizing-security-email.md dosyasına bakın.
Destek
Sorularınız veya sorunlarınız için yazilim@sanalsantral.com.tr adresiyle iletişime geçin.
Lisans
Bu modül Odoo Özel Lisansı v1.0 (OPL-1) kapsamında lisanslanmıştır.
Deutsch
Überblick
Dieses Modul ermöglicht die SMS-basierte Einmalpasswort (OTP) Authentifizierung für Benutzer in Odoo 18. Es unterstützt sowohl UI- als auch RPC-Anmeldungen mit zusätzlicher Zwei-Faktor-Sicherheit über Mobil-SMS.
Funktionen
- Anmeldeschutz durch SMS-basierte OTP-Codes
- Integration in externe RPC-Anmeldeabläufe
- Automatisches Senden und Validieren von Codes
Installation
- Platzieren Sie das Modul im Odoo-
addons- oder benutzerdefinierten Addons-Verzeichnis. - App-Liste aktualisieren und das Modul auth_totp_sms installieren.
- Stellen Sie sicher, dass ein aktives SMS-Gateway-Modul konfiguriert ist.
Konfiguration
- Navigieren Sie zu Einstellungen > Technische Einstellungen.
- Aktivieren Sie „SMS-Zwei-Faktor-Authentifizierung für RPC erlauben".
- Stellen Sie sicher, dass Benutzer gültige Mobilnummern in ihren Kontakten hinterlegt haben.
Funktionsweise
Wenn sich Benutzer anmelden:
- Falls SMS 2FA aktiviert ist, erhalten sie einen 6-stelligen OTP-Code per SMS.
- Sie werden zu einer OTP-Eingabemaske weitergeleitet.
- Nach korrekter Codeeingabe wird die Anmeldung abgeschlossen.
RPC API Endpunkte
1. Authentifizierung mit SMS
POST /web/session/auth_rpc_smsAnfrage JSON:
{
"login": "benutzer@beispiel.de",
"password": "benutzerpasswort"
}
Antwort JSON:
{
"uid": null,
"need_sms": true,
"message": "SMS-Verifizierung erforderlich."
}
2. SMS-Code verifizieren
POST /web/session/verify_sms_codeAnfrage JSON:
{
"code": "123456"
}
Antwort JSON:
{
"uid": 3,
"message": "SMS verifiziert und Anmeldung abgeschlossen."
}
Voraussetzungen
- Odoo 18
- Funktionsfähige SMS-Gateway-Integration
- Python 3.10+
Sicherheits-E-Mail anpassen
Die Sicherheitsbenachrichtigungs-E-Mail kann angepasst werden, indem das QWeb-Template auth_totp_sms.account_security_setting_update in Ihrem eigenen Modul erweitert wird. Details finden Sie in docs/customizing-security-email.md.
Support
Bei Fragen oder Problemen wenden Sie sich an yazilim@sanalsantral.com.tr.
Lizenz
Dieses Modul ist unter der Odoo Proprietary License v1.0 (OPL-1) lizenziert.
Español
Descripción general
Este módulo habilita la autenticación de Contraseña de Un Solo Uso (OTP) por SMS para usuarios en Odoo 18. Admite inicios de sesión tanto desde la interfaz como por RPC, con seguridad de doble factor adicional vía SMS.
Características
- Protección de inicio de sesión mediante códigos OTP por SMS
- Integración con flujos de inicio de sesión RPC externos
- Envío y validación automática de códigos
Instalación
- Coloque el módulo dentro del directorio
addonso de addons personalizados de Odoo. - Actualice la lista de aplicaciones e instale el módulo auth_totp_sms.
- Asegúrese de que haya un módulo de puerta de enlace SMS activo configurado.
Configuración
- Vaya a Ajustes > Ajustes técnicos.
- Active "Permitir autenticación de dos factores por SMS para RPC".
- Asegúrese de que los usuarios tengan números de móvil válidos en sus Contactos.
Cómo funciona
Cuando los usuarios inician sesión:
- Si tienen SMS 2FA activado, reciben un OTP de 6 dígitos por SMS.
- Son redirigidos a una pantalla de introducción del OTP.
- Tras introducir el código correcto, el inicio de sesión se completa.
Endpoints de la API RPC
1. Autenticar con SMS
POST /web/session/auth_rpc_smsJSON de solicitud:
{
"login": "usuario@ejemplo.com",
"password": "contraseña"
}
JSON de respuesta:
{
"uid": null,
"need_sms": true,
"message": "Se requiere verificación por SMS."
}
2. Verificar código SMS
POST /web/session/verify_sms_codeJSON de solicitud:
{
"code": "123456"
}
JSON de respuesta:
{
"uid": 3,
"message": "SMS verificado e inicio de sesión completado."
}
Requisitos
- Odoo 18
- Integración con puerta de enlace SMS funcional
- Python 3.10+
Personalizar el correo de notificación de seguridad
El correo de notificación de seguridad puede personalizarse heredando el template QWeb auth_totp_sms.account_security_setting_update en su propio módulo. Consulte docs/customizing-security-email.md para más detalles.
Soporte
Para preguntas o problemas, contacte a yazilim@sanalsantral.com.tr.
Licencia
Este módulo está licenciado bajo la Licencia Propietaria de Odoo v1.0 (OPL-1).
العربية
نظرة عامة
يتيح هذا الوحدة مصادقة كلمة المرور لمرة واحدة (OTP) عبر الرسائل القصيرة SMS للمستخدمين في Odoo 18. يدعم تسجيل الدخول عبر الواجهة والـ RPC مع طبقة أمان إضافية بالتحقق الثنائي عبر الجوال.
المميزات
- حماية تسجيل الدخول عبر رموز OTP بالرسائل القصيرة
- التكامل مع تدفقات تسجيل الدخول عبر RPC الخارجية
- إرسال الرمز والتحقق منه تلقائياً
التثبيت
- ضع الوحدة داخل مجلد
addonsأو مجلد الإضافات المخصصة في Odoo. - حدّث قائمة التطبيقات وثبّت وحدة auth_totp_sms.
- تأكد من تهيئة وحدة بوابة SMS نشطة.
الإعداد
- انتقل إلى الإعدادات > الإعدادات التقنية.
- فعّل خيار "السماح بالمصادقة الثنائية عبر SMS لـ RPC".
- تأكد من أن المستخدمين لديهم أرقام جوال صالحة في جهات اتصالهم.
طريقة العمل
عند تسجيل دخول المستخدمين:
- إذا كان SMS 2FA مفعّلاً، يستلمون رمز OTP مكوناً من 6 أرقام عبر الرسائل القصيرة.
- يُعادون توجيههم إلى شاشة إدخال الرمز.
- بعد إدخال الرمز الصحيح، يكتمل تسجيل الدخول.
نقاط نهاية API عبر RPC
١. المصادقة عبر SMS
POST /web/session/auth_rpc_smsطلب JSON:
{
"login": "user@example.com",
"password": "userpassword"
}
استجابة JSON:
{
"uid": null,
"need_sms": true,
"message": "التحقق عبر SMS مطلوب."
}
٢. التحقق من رمز SMS
POST /web/session/verify_sms_codeطلب JSON:
{
"code": "123456"
}
استجابة JSON:
{
"uid": 3,
"message": "تم التحقق من SMS وإتمام تسجيل الدخول."
}
المتطلبات
- Odoo 18
- تكامل بوابة SMS يعمل بشكل صحيح
- Python 3.10+
تخصيص بريد إشعار الأمان
يمكن تخصيص بريد إشعار الأمان عن طريق وراثة قالب QWeb auth_totp_sms.account_security_setting_update في وحدتك الخاصة. راجع docs/customizing-security-email.md للتفاصيل.
الدعم الفني
للاستفسارات أو الإبلاغ عن مشاكل، تواصل عبر yazilim@sanalsantral.com.tr.
الترخيص
هذه الوحدة مرخّصة بموجب رخصة Odoo الخاصة v1.0 (OPL-1).
Русский
Обзор
Этот модуль обеспечивает аутентификацию с помощью одноразового пароля (OTP) через SMS для пользователей Odoo 18. Поддерживает вход как через интерфейс, так и через RPC с дополнительной двухфакторной защитой по мобильному SMS.
Возможности
- Защита входа с помощью SMS-кодов OTP
- Интеграция с внешними RPC-потоками аутентификации
- Автоматическая отправка и проверка кодов
Установка
- Поместите модуль в директорию
addonsили пользовательских дополнений Odoo. - Обновите список приложений и установите модуль auth_totp_sms.
- Убедитесь, что настроен активный модуль SMS-шлюза.
Настройка
- Перейдите в Настройки > Технические настройки.
- Включите «Разрешить двухфакторную аутентификацию по SMS для RPC».
- Убедитесь, что у пользователей указаны действительные номера мобильных телефонов в контактах.
Принцип работы
При входе пользователей:
- Если SMS 2FA включён, они получают 6-значный OTP-код по SMS.
- Пользователи перенаправляются на экран ввода OTP.
- После ввода верного кода вход завершается.
Конечные точки RPC API
1. Аутентификация через SMS
POST /web/session/auth_rpc_smsJSON запроса:
{
"login": "user@example.com",
"password": "userpassword"
}
JSON ответа:
{
"uid": null,
"need_sms": true,
"message": "Требуется подтверждение по SMS."
}
2. Проверка SMS-кода
POST /web/session/verify_sms_codeJSON запроса:
{
"code": "123456"
}
JSON ответа:
{
"uid": 3,
"message": "SMS подтверждён, вход выполнен."
}
Требования
- Odoo 18
- Работающая интеграция с SMS-шлюзом
- Python 3.10+
Настройка письма безопасности
Письмо с уведомлением безопасности можно настроить, унаследовав QWeb-шаблон auth_totp_sms.account_security_setting_update в своём модуле. Подробности в docs/customizing-security-email.md.
Поддержка
По вопросам или при возникновении проблем обращайтесь: yazilim@sanalsantral.com.tr.
Лицензия
Модуль лицензирован по Odoo Proprietary License v1.0 (OPL-1).
Français
Présentation
Ce module active l'authentification par mot de passe à usage unique (OTP) via SMS pour les utilisateurs d'Odoo 18. Il prend en charge les connexions via l'interface et via RPC, avec une sécurité à double facteur supplémentaire par SMS.
Fonctionnalités
- Protection de connexion par codes OTP par SMS
- Intégration avec les flux de connexion RPC externes
- Envoi et validation automatiques des codes
Installation
- Placez le module dans le répertoire
addonsou dans le répertoire des modules personnalisés d'Odoo. - Mettez à jour la liste des applications et installez le module auth_totp_sms.
- Assurez-vous qu'un module de passerelle SMS actif est configuré.
Configuration
- Accédez à Paramètres > Paramètres techniques.
- Activez « Autoriser l'authentification à deux facteurs par SMS pour RPC ».
- Assurez-vous que les utilisateurs ont des numéros de mobile valides dans leurs contacts.
Fonctionnement
Lors de la connexion des utilisateurs :
- Si le SMS 2FA est activé, ils reçoivent un OTP à 6 chiffres par SMS.
- Ils sont redirigés vers un écran de saisie du code OTP.
- Une fois le bon code saisi, la connexion est finalisée.
Points de terminaison de l'API RPC
1. Authentification par SMS
POST /web/session/auth_rpc_smsJSON de la requête :
{
"login": "utilisateur@exemple.fr",
"password": "motdepasse"
}
JSON de la réponse :
{
"uid": null,
"need_sms": true,
"message": "Vérification par SMS requise."
}
2. Vérifier le code SMS
POST /web/session/verify_sms_codeJSON de la requête :
{
"code": "123456"
}
JSON de la réponse :
{
"uid": 3,
"message": "SMS vérifié et connexion terminée."
}
Prérequis
- Odoo 18
- Intégration avec une passerelle SMS fonctionnelle
- Python 3.10+
Personnaliser l'e-mail de notification de sécurité
L'e-mail de notification de sécurité peut être personnalisé en héritant du template QWeb auth_totp_sms.account_security_setting_update dans votre propre module. Voir docs/customizing-security-email.md pour les détails.
Support
Pour toute question ou problème, contactez yazilim@sanalsantral.com.tr.
Licence
Ce module est licencié sous la Licence Propriétaire Odoo v1.0 (OPL-1).
Odoo Proprietary License v1.0 This software and associated files (the "Software") may only be used (executed, modified, executed after modifications) if you have purchased a valid license from the authors, typically via Odoo Apps, or if you have received a written agreement from the authors of the Software (see the COPYRIGHT file). You may develop Odoo modules that use the Software as a library (typically by depending on it, importing it and using its resources), but without copying any source code or material from the Software. You may distribute those modules under the license of your choice, provided that this license is compatible with the terms of the Odoo Proprietary License (For example: LGPL, MIT, or proprietary licenses similar to this one). It is forbidden to publish, distribute, sublicense, or sell copies of the Software or modified copies of the Software. The above copyright notice and this permission notice must be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
Please log in to comment on this module