Aprovisionamiento de teléfonos de escritorio

Un teléfono de escritorio descarga su archivo de configuración por HTTP(S) cuando arranca. MonoPbx genera ese archivo para cada teléfono a partir de una plantilla editable de su fabricante, con la cuenta SIP propia del teléfono, sus teclas BLF y de marcación rápida, y la suscripción de mensaje en espera.

La página es Administración, Teléfonos de escritorio. El teléfono debe existir como un dispositivo con una dirección MAC en una extensión (vea Extensiones y dispositivos). Si ningún dispositivo tiene todavía una MAC, la página le pide que agregue una en Dispositivos.

Teléfonos compatibles

Fabricante	Modelos	Archivo que solicita el teléfono
Yealink	T4x, T5x	<url><mac>.cfg
Fanvil	serie X	<url><mac>.cfg
Snom	D3xx, D7xx	un nombre de archivo que termina en la MAC
Grandstream	GXP21xx	cfg<mac>.xml

:::caution Verifique en sus teléfonos Las plantillas integradas se escribieron a partir de las guías de los fabricantes, sin un teléfono de por medio. Si un tipo de tecla o un parámetro no se adapta a su modelo, corrija la línea en Administración, Teléfonos de escritorio, Plantillas. La siguiente descarga usará el cambio. :::

Aprovisionar un teléfono

Teléfonos de escritorio: la dirección de aprovisionamiento para la opción 66 de DHCP y la lista de teléfonos aprovisionados.

1. Abra Administración, Teléfonos de escritorio y aprovisione el dispositivo. La consola muestra la dirección del teléfono (una URL con un token aleatorio largo) y, si la pidió, un inicio de sesión digest. Se muestran una sola vez. Regenerarlos produce nuevos valores y nuevas credenciales SIP.
2. Haga llegar la dirección al teléfono. Elija una vía:

Vía	Cuándo usarla
Opción 66 de DHCP	Teléfonos en la oficina. Configure la dirección que muestra la consola como opción 66 en su servidor DHCP. Solo funciona mientras esté abierta una ventana de primer arranque para ese dispositivo (una hora de forma predeterminada, 24 horas como máximo). La primera solicitud de esa MAC recibe su archivo y cierra la ventana. Ábrala justo antes de que arranque el teléfono, en una red en la que confíe.
Dirección propia del teléfono	Escriba o pegue la dirección del dispositivo en la página web del teléfono, o use el servicio de redirección del fabricante. Deje cerrada la ventana de primer arranque.
Enlace firmado	Un teléfono remoto, o uno que no puede usar la opción 66. Presione Enlace firmado en el cuadro de diálogo del teléfono y elija su duración (de 1 a 240 minutos). El enlace funciona una sola vez, pertenece a un dispositivo y a una MAC, y puede revocarse. Como máximo 5 enlaces sin usar por teléfono.

3. Reinicie el teléfono. Después de la primera descarga, usa desde entonces su propia dirección.

Teclas

Cada teléfono tiene una disposición de teclas de función. Agregue teclas en el cuadro de diálogo del teléfono:

Tipo	Valor	Qué hace la tecla
BLF	número de extensión	Una luz para la extensión. Al presionarla, contesta la llamada que suena en esa extensión.
Marcación rápida	número	Marca el número.
Línea	ninguno	Una tecla de línea adicional de la cuenta.
Estacionamiento compartido	dígito de órbita	Contesta la llamada estacionada en esa órbita.
Inicio / cierre de sesión en cola	número de cola, o ninguno para todas las colas	Inicia o cierra la sesión del agente.
Código de marcación	por ejemplo *61	Marca el código, con el prefijo de la empresa cuando se necesita.

Las últimas cuatro usan los códigos de marcación vigentes de la empresa al generar el archivo. Un código modificado llega a los teléfonos en su siguiente aprovisionamiento. Una tecla para una cola o una órbita que no existe se informa como advertencia al guardar la disposición.

Seguridad

• Una dirección MAC nunca basta para descargar un archivo. Se requiere el token de la dirección, una ventana de primer arranque abierta o un enlace firmado, y la MAC en el nombre del archivo debe pertenecer a ese token.
• Un archivo contiene solo las credenciales de ese teléfono.
• Use https. El HTTP simple transmite la contraseña SIP sin cifrar. La opción "Servir también los perfiles https por HTTP simple" existe para laboratorios y teléfonos que no confían en su certificado. Déjela desactivada en producción.
• El inicio de sesión digest opcional en la dirección propia del teléfono es un segundo factor. Úselo junto con https.
• Cada descarga y cada rechazo que nombre un dispositivo real queda registrado en auditoría.

Diagnóstico

Presione Diagnóstico en un teléfono.

• El registro por MAC muestra cada solicitud: served, o el motivo por el que se rechazó (token desconocido, MAC que no coincide, ventana de primer arranque cerrada o ya usada, dispositivo revocado, propietario desactivado, enlace firmado vencido o usado, inicio de sesión digest incorrecto). El teléfono solo ve un 404 vacío, así que este registro es donde debe mirar. Conserva 30 días y como máximo 200 entradas por MAC.
• La verificación de certificado revisa la cadena que este servidor presenta en la dirección del teléfono y la evalúa para el modelo del teléfono. Hallazgos típicos: la dirección usa una IP en lugar de un nombre, el certificado es autofirmado, falta el certificado intermedio (los teléfonos nunca lo descargan), el certificado venció o está por vencer, o el modelo podría no confiar en la raíz. Cada hallazgo indica cómo corregirlo. Solicite un certificado en Certificados y HTTPS.

Problemas comunes

• El teléfono recibe 404 al arrancar. Abra Diagnóstico y lea el último código del registro. Lo más común es que la ventana de primer arranque estuviera cerrada o ya usada, o que el teléfono tenga la dirección de otro dispositivo.
• Errores TLS en el teléfono. Ejecute la verificación de certificado. Use un nombre, no una IP, en la dirección, y suba la cadena completa.
• Se superó el límite de adivinanzas. Demasiadas solicitudes desconocidas desde una misma dirección reciben 429 durante el resto del minuto.