Configuración de la conectividad del extremo de la API de REST

Para configurar la conectividad entre aplicaciones cliente y el extremo de la API de REST del servidor de 

BlackBerry 2FA

, debe configurar sus aplicaciones cliente para confiar en el servidor de 

BlackBerry 2FA

.

Las aplicaciones cliente se autentican mediante autenticación básica HTTP (nombre de usuario y contraseña) que se envían como encabezados en la solicitud. El extremo de la API de REST se protege mediante HTTPS autenticada por el usuario (https://

<nombrehost>

:

<puerto>

/

<prefijo>

/). El puerto predeterminado es 5443 y el prefijo predeterminado es "rest". Las siguientes solicitudes de REST son compatibles con el extremo:

Ruta	Tipo	Descripción	Notas
/ <prefijo> /twofactor	POST	Solicitud de autenticación en dos fases

El mensaje de solicitud se envía mediante HTTP POST y se le da formato JSON, con los siguientes parámetros:

Parámetro	Tipo	Descripción	Notas
nombre de usuario	Cadena	Nombre de usuario
contraseña	Cadena	Contraseña de usuario o contraseña de un solo uso y contraseña de usuario	Opcional, según la política
política	Valor entero	Opción de autenticación: 0: autenticación de factor único mediante contraseña de empresa 1: autenticación de dos factores con contraseña de empresa 2: autenticación de dos factores mediante contraseña de dispositivo pasiva 3: autenticación de dos factores mediante contraseña de dispositivo activa
oneTimePassword	Cadena	Contraseña de un solo uso	Opcional
messageTitle	Cadena	Cuadro de diálogo del texto del título	Opcional
mensaje	Cadena	Cuadro de diálogo del texto del mensaje	Opcional
confirmButtonText	Cadena	Cuadro de diálogo de texto del botón de confirmar	Opcional
declineButtonText	Cadena	Cuadro de diálogo de texto del botón de rechazar	Opcional
tiempo de espera	Valor entero	Cuadro de diálogo de tiempo de espera (segundos)	Opcional

El cuerpo del mensaje de respuesta tiene formato JSON, con el siguiente parámetro:

Parámetro	Tipo	Descripción	Notas
información	Cadena	Mensaje informativo

El mensaje de respuesta también incluye los siguientes códigos de estado HTTP:

Estado	Descripción	Notas
200	Aceptar	Autenticación correcta
400	Solicitud incorrecta	Parámetros no válidos
401	Sin autorización	La autenticación ha fallado
403	Declinada	Autenticación rechazada por el usuario
500	Error interno de servidor	Error interno