Cómo obtener una muestra
Para obtener una muestra, envíe una solicitud al servicio web security en el servidor Spectrum™ Technology Platform. Puede acceder al WSDL de security aquí:
http://server:port/security/rest?_wadl
Este servicio web usa la autenticación básica, por lo que debe incluir un nombre de usuario de Spectrum™ Technology Platform y una contraseña válidos en la solicitud.
El servicio web security puede emitir tres tipos de muestras. En orden de los más seguros a los menos seguros, los tipos de muestra son:
- Muestra de sesión
- Muestra de cliente
- Muestra abierta
Cómo obtener una muestra de sesión
Una muestra de sesión se vincula a una sesión de usuario y solo la puede usar la computadora que solicitó la muestra. Como está vinculada a una sesión, la muestra no se validará si la sesión queda inactiva durante 30 minutos. La muestra de sesión es el tipo de muestra más segura y es el recomendado para autenticar Spectrum™ Technology Platform.
Para obtener una muestra de sesión, use esta URL:
http://server:port/security/rest/token/access/session/ttlInMinutes
Donde:
- servidor
- El nombre de host o la dirección IP del servidor Spectrum™ Technology Platform.
- puerto
- El puerto HTTP que usa Spectrum™ Technology Platform. De manera predeterminada es 8080.
- ttlInMinutes
- La cantidad de minutos para que la muestra expire, también conocido como la vida útil de la muestra. Si no desea que la muestra tenga una fecha de vencimiento, indique el valor 0.
Esta es una respuesta de muestra:
{
"access_token": "eyJlbmMiOiJBMTI4Q0JDLUhTMjU2IiwiYWxnIjoiZGlyIn0..ESnq4JNEBbVMKycd139z0w.NFXAskVY0seX",
"session": "09aa1fbb-71j3-43c7-ab8c-d800214283d4",
"username": "admin"
}
La respuesta contiene los siguientes elementos:
- access_token
- La muestra de seguridad.
- sesión
- La ID de sesión de la sesión a la que la muestra está vinculada. La muestra solo se aceptará si esta ID de sesión está incluida en la solicitud.
- El usuario que ejecutó el trabajo o servicio.
- El nombre de usuario de Spectrum™ Technology Platform usado para obtener la muestra. El nombre de usuario se devuelve solo para fines informativos y no es necesario cuando usa la muestra.
Cómo obtener una muestra de cliente
Una muestra de cliente es una muestra que solo puede usarla la computadora que la solicitó. Dado que no está vinculada a una sesión, no caducará si la sesión queda inactiva.
Para obtener una muestra de cliente, use esta URL:
http://server:port/security/rest/token/access/remotehost/ttlInMinutes
Donde:
- servidor
- El nombre de host o la dirección IP del servidor Spectrum™ Technology Platform.
- puerto
- El puerto HTTP que usa Spectrum™ Technology Platform. De manera predeterminada es 8080.
- ttlInMinutes
- La cantidad de minutos para que la muestra expire, también conocido como la vida útil de la muestra. Si no desea que la muestra tenga una fecha de vencimiento, indique el valor 0.
Esta es una respuesta de muestra:
{
"access_token": "eyJlbmMiOiJBMTI4Q0JDLUhTMjU2IiwiYWxnIjoiZGlyIn0..Gkp5r4crANhG-OE2lsGWfQ.PasvgfQto",
"username": "kristen5499"
}
La respuesta contiene los siguientes elementos:
- access_token
- La muestra de seguridad.
- El usuario que ejecutó el trabajo o servicio.
- El nombre de usuario de Spectrum™ Technology Platform usado para obtener la muestra. El nombre de usuario se devuelve solo para fines informativos y no es necesario cuando usa la muestra.
Cómo obtener una muestra abierta
Una muestra abierta no está vinculada a ningún usuario o computadora específico. Es el tipo de muestra menos seguro.
Para obtener una muestra abierta, use esta URL:
http://server:port/security/rest/token/access/ttlInMinutes
Donde:
- servidor
- El nombre de host o la dirección IP del servidor Spectrum™ Technology Platform.
- puerto
- El puerto HTTP que usa Spectrum™ Technology Platform. De manera predeterminada es 8080.
- ttlInMinutes
- La cantidad de minutos para que la muestra expire, también conocido como la vida útil de la muestra. Si no desea que la muestra tenga una fecha de vencimiento, indique el valor 0.
Esta es una respuesta de muestra:
{
"access_token": "eyJlbmMiOiJBMTI4Q0JDLUhTMjU2IiwiYWxnIjoiZGlyIn0..fI",
"username": "admin"
}
La respuesta contiene los siguientes elementos:
- access_token
- La muestra de seguridad.
- El usuario que ejecutó el trabajo o servicio.
- El nombre de usuario de Spectrum™ Technology Platform usado para obtener la muestra. El nombre de usuario se devuelve solo para fines informativos y no es necesario cuando usa la muestra.