Para poder utilizar las API de BFC, se debe crear una sesión de autenticación. Para crear una sesión, se debe publicar un nombre de usuario y una contraseña en el recurso de inicio de sesión para la versión de la API de BFC deseada. Si el nombre del usuario y la contraseña son válidos, se devuelve un ID de sesión, el cual se deberá transferir para cada llamada de API de BFC en el encabezado de autorización. Si no hay actividad, las sesiones mantienen su validez durante 30 minutos. Cada solicitud al BFC restablecerá el tiempo de espera de la sesión, a menos que se incluya el encabezado X-CA-FC-runningClock y su valor sea true. Esto es útil para clientes con llamadas de sondeo desatendidas al BFC. Un cliente puede terminar una sesión publicando el ID de sesión en el recurso de cierre de sesión.
POST BFC/1.0/login
Content-Type:application/json
La carga útil es un objeto JSON con dos campos: username y password.
username
Si el nombre del usuario no es el nombre completo del cliente, se utilizará el cliente principal. Actualmente, el único cliente disponible en BFC es el cliente principal.
p. ej. joe (o core/joe)
password
La contraseña del usuario.
p. ej. MyPassword
{"username":"joe","password":"MyPassword"}
La carga útil devuelta es una cadena de JSON que representa el ID de la sesión. Por ejemplo:
"2f9b84766cdacd376125c7d57aaf6aa7"
POST/BFC//logout
Content-Type:application/json
Autorización: su ID de sesión
Su ID de sesión
| Copyright © 2012 CA. Todos los derechos reservados. |
|