Seguridad
La clave de integración es un acceso a la agenda de una clínica, con datos de sus pacientes. Tratala como una contraseña.
La clave vive en tu servidor
- Guardala en una variable de entorno o en un gestor de secretos, nunca en el código fuente ni en un repositorio.
- Nunca en un navegador ni en una app de celular. Todo lo que corre en el dispositivo del usuario se puede leer: una clave en el JavaScript de una página o dentro de una app instalada es una clave publicada. Por eso la API no tiene CORS: un navegador no puede llamarla directamente.
- El esquema correcto es: el sitio de reservas le pide los horarios a tu servidor, y tu servidor, con la clave, se los pide a Odontosys.
- No la escribas en los registros. Para reconocer una clave alcanza con su prefijo (
osk_3f9k2m7q_…), que es público.
Navegador del paciente ──► tu servidor (con la clave) ──► api.odontosys.com
Una clave por sistema
Si la clínica conecta dos sistemas —el sitio de reservas y un asistente—, que cree una clave para cada uno. Así puede cortarle el acceso a uno sin tocar al otro, y en su Historial de actividad ve cuál hizo cada cosa.
Pedí sólo los permisos que usás
Una clave con citas:leer ve los nombres de todos los pacientes con cita y sus notas. Si tu integración sólo agenda, no la necesita. Ver Permisos.
Si la clave se filtra
- Avisale a la clínica para que la revoque en Configuración → Avanzado → API e integraciones. Deja de funcionar en menos de un minuto.
- Que cree una nueva y te la pase por un canal seguro.
- Actualizá la clave en tu servidor.
No hay forma de "recuperar" una clave: Odontosys no guarda el secreto, sólo una huella que sirve para reconocerlo. Si se pierde, se crea otra.
Lo que hace la API para protegerla
- Sólo atiende por HTTPS.
- No guarda el secreto, sólo su huella (un hash SHA-256): aunque alguien leyera la base de datos, no podría usar las claves.
- Responde lo mismo ante una clave mal copiada, desconocida, revocada o vencida, para no dar pistas.
- Bloquea por un minuto a la IP que prueba 10 claves equivocadas.
- Todo lo que la integración crea o elimina queda en el Historial de actividad de la clínica, con el nombre de la clave.